win-wrap 0.3.4

用于Rust的Windows API的高级封装
Documentation
/*
 * Copyright (c) 2024. The RigelA open source project team and
 * its contributors reserve all rights.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * http://www.apache.org/licenses/LICENSE-2.0
 * Unless required by applicable law or agreed to in writing, software distributed under the
 * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and limitations under the License.
 */

pub mod container;
pub mod legacy;
pub mod range;
pub mod table;
pub mod text;
pub mod toggle;
pub mod value;

use crate::uia::element::UiAutomationElement;
use std::{fmt::Formatter, sync::Weak};
use windows::Win32::UI::Accessibility::{IUIAutomation6, UIA_PATTERN_ID};
use windows_core::Interface;

/// 模式错误结构
pub struct PatternError {
    /// 错误信息
    message: String,
}

impl From<String> for PatternError {
    /// 从字符串创建
    fn from(value: String) -> Self {
        Self { message: value }
    }
}

impl std::fmt::Debug for PatternError {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.message)
    }
}

pub trait PatternCreator<I: Interface>: TryFrom<I> + Sized {
    /// 模式的ID
    const PATTERN: UIA_PATTERN_ID;

    /**

    从UI元素获取此模式。
    `value` UI元素。
    */
    fn obtain(value: &UiAutomationElement) -> Result<Self, PatternError>
    where
        <Self as TryFrom<I>>::Error: std::fmt::Debug,
    {
        let pattern = unsafe { value.get_raw().GetCurrentPattern(Self::PATTERN) };
        let pattern = pattern
            .map_err(|e| -> PatternError {
                format!("Can't get the Pattern({:?}). ({})", Self::PATTERN, e).into()
            })?
            .cast::<I>()
            .unwrap();
        Self::try_from(pattern).map_err(|e| format!("Can't create pattern. ({:?})", e).into())
    }
}

pub trait PatternCreatorWithAutomation<I: Interface>:
    TryFrom<(I, Weak<IUIAutomation6>)> + Sized
{
    /// 模式的ID
    const PATTERN: UIA_PATTERN_ID;

    /**

    从UI元素获取此模式。
    `value` UI元素。
    */
    fn obtain(value: &UiAutomationElement) -> Result<Self, PatternError>
    where
        <Self as TryFrom<(I, Weak<IUIAutomation6>)>>::Error: std::fmt::Debug,
    {
        let pattern = unsafe { value.get_raw().GetCurrentPattern(Self::PATTERN) };
        let pattern = pattern
            .map_err(|e| -> PatternError {
                format!("Can't get the Pattern({:?}). ({})", Self::PATTERN, e).into()
            })?
            .cast::<I>()
            .unwrap();
        Self::try_from((pattern, value.get_aut()))
            .map_err(|e| format!("Can't create pattern. ({:?})", e).into())
    }
}