Sdílet prostřednictvím


Jak vrátit vlastnosti z poskytovatele automatizace uživatelského rozhraní

Toto téma obsahuje ukázkový kód, který ukazuje, jak zprostředkovatel Microsoft UI Automation vrací vlastnosti prvku uživatelského rozhraní klientským aplikacím.

Chcete-li načíst hodnotu vlastnosti zprostředkovatele, UI Automation volá implementaci poskytovatele metodou IRawElementProviderSimple::GetPropertyValue, přičemž předává ID vlastnosti k načtení a ukazatel na strukturu VARIANT. Pokud zprostředkovatel podporuje zadanou vlastnost, zkopíruje datový typ a hodnotu vlastnosti do VARIANT struktury. Pokud vlastnost není podporována, poskytovatel nastaví vt člen struktury VARIANT na VT_EMPTY.

IFACEMETHODIMP Provider::GetPropertyValue(PROPERTYID propertyId, VARIANT* pRetVal)
{
    // The Name property is typically the same as the Caption property of the 
    // control window, if it has one. Here, the Name is overridden for the 
    // sake of illustration. 
    if (propertyId == UIA_NamePropertyId) 
    {
        pRetVal->vt = VT_BSTR;
        pRetVal->bstrVal = SysAllocString(L"Custom button");
    }
    
    else if (propertyId == UIA_ControlTypePropertyId) 
    {
        pRetVal->vt = VT_I4;
        pRetVal->lVal = UIA_ButtonControlTypeId; 
    }

    else if (propertyId == UIA_IsContentElementPropertyId) 
    {
        pRetVal->vt = VT_BOOL;
        pRetVal->lVal = TRUE; 
    }

    else if (propertyId == UIA_IsControlElementPropertyId) 
    {
        pRetVal->vt = VT_BOOL;
        pRetVal->lVal = TRUE; 
    }

    //
    // Return other properties as appropriate for the control type. 
    //

    else
    {
        pRetVal->vt = VT_EMPTY;
        // UI Automation will attempt to get the property from the  
        // provider for window that hosts the control.
    }
    return S_OK;
}

koncepční

Přehled vlastností automatizace uživatelského rozhraní

How-To témata pro poskytovatele automatizace uživatelského rozhraní