UiaProviderFromIAccessible-Funktion (uiautomationcoreapi.h)
Erstellt einen Microsoft-Benutzeroberflächenautomatisierungsanbieter basierend auf dem angegebenen Microsoft Active Accessibility-Objekt.
Syntax
HRESULT UiaProviderFromIAccessible(
[in] IAccessible *pAccessible,
[in] long idChild,
[in] DWORD dwFlags,
[out] IRawElementProviderSimple **ppProvider
);
Parameter
[in] pAccessible
Typ: IAccessible*
Ein Zeiger auf das Microsoft Active Accessibility-Objekt.
[in] idChild
Typ: long
Die untergeordnete ID des Microsoft Active Accessibility-Objekts.
[in] dwFlags
Art: DWORD
Einer der folgenden Werte:
UIA_PFIA_DEFAULT
UIA_PFIA_UNWRAP_BRIDGE
[out] ppProvider
Typ: IRawElementProviderSimple**
Der neue Benutzeroberflächenautomatisierungsanbieter.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Benutzeroberflächenautomatisierung bietet Abwärtskompatibilität für Microsoft Active Accessibility-Anbieter, indem für sie ein Proxy bereitgestellt wird, der als Microsoft Active Accessibility to UI Automation-Proxy bezeichnet wird. Dieser Proxy wird automatisch erstellt, wenn ein Fenster auf eine WM_GETOBJECT Nachricht antwortet, indem ein Microsoft Active-Barrierefreiheitsanbieter zurückgegeben wird. Verwenden Sie UiaProviderFromIAccessible , wenn Sie manuell einen Microsoft Active Accessibility to UI Automation-Proxy erstellen müssen. beispielsweise beim Implementieren der IAccessibleEx-Schnittstelle .
Einige Eigenschaften, z. B. LabeledBy, müssen als Benutzeroberflächenautomatisierungsanbieter ausgedrückt werden. Ein IAccessibleEx-Anbieter kann UiaProviderFromIAccessible verwenden, um ein IAccessible-Objekt umzuschließen und es als Wert der LabeledBy-Eigenschaft zurückzugeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiautomationcoreapi.h |
| Bibliothek | Uiautomationcore.lib |
| DLL | Uiautomationcore.dll |