IRawElementProviderFragment::GetRuntimeId-Methode (uiautomationcore.h)

Artikel
08/26/2023

Ruft den Laufzeitbezeichner eines Elements ab.

Syntax

HRESULT GetRuntimeId(
  [out, retval] SAFEARRAY **pRetVal
);

Parameter

[out, retval] pRetVal

Typ: SAFEARRAY**

Empfängt einen Zeiger auf den Laufzeitbezeichner. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Implementierungen sollten NULL für ein Element der obersten Ebene zurückgeben, das in einem Fenster gehostet wird. Andere Elemente sollten ein Array zurückgeben, das UiaAppendRuntimeId (definiert in Uiautomationcoreapi.h) enthält, gefolgt von einem Wert, der innerhalb einer instance des Fragments eindeutig ist.

Beispiele

Die folgende Implementierung für ein Listenelement gibt einen Laufzeitbezeichner zurück, der aus der UiaAppendRuntimeId-Konstante und dem Index des Elements innerhalb der Liste besteht.

HRESULT STDMETHODCALLTYPE ListItemProvider::GetRuntimeId(SAFEARRAY ** pRetVal)
{
    if (pRetVal == NULL) 
    {
        return E_INVALIDARG;
    }
    
    int rId[] = { UiaAppendRuntimeId, m_itemIndex };
    SAFEARRAY *psa = SafeArrayCreateVector(VT_I4, 0, 2);
    if (psa == NULL)
    {
        return E_OUTOFMEMORY;
    }
    
    for (LONG i = 0; i < 2; i++)
    {
        SafeArrayPutElement(psa, &i, (void*)&(rId[i]));
    }
    
    *pRetVal = psa;
    return S_OK;
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (include UIAutomation.h)

Weitere Informationen

Bewährte Methoden für die Verwendung sicherer Arrays

Konzept

IRawElementProviderFragment

Referenz

Freigeben über