IUIAutomationRegistrar::RegisterPattern-Methode (uiautomationcore.h)
Registriert ein Steuerelementmuster eines Drittanbieters.
Syntax
HRESULT RegisterPattern(
[in] const UIAutomationPatternInfo *pattern,
[out] PATTERNID *pPatternId,
[out] PROPERTYID *pPatternAvailablePropertyId,
[in] UINT propertyIdCount,
[out] PROPERTYID *pPropertyIds,
[in] UINT eventIdCount,
[out] EVENTID *pEventIds
);
Parameter
[in] pattern
Typ: UIAutomationPatternInfo*
Ein Zeiger auf eine Struktur, die Informationen zum zu registrierenden Steuerelementmuster enthält.
[out] pPatternId
Typ: PATTERNID*
Empfängt den Musterbezeichner.
[out] pPatternAvailablePropertyId
Typ: PROPERTYID*
Empfängt den Eigenschaftsbezeichner für das Muster. Dieser Wert kann mit Benutzeroberflächenautomatisierung Clientmethoden verwendet werden, um zu bestimmen, ob das Element das neue Muster unterstützt. Dies entspricht Werten wie UIA_IsInvokePatternAvailablePropertyId.
[in] propertyIdCount
Typ: UINT
Die Anzahl der vom Steuerelementmuster unterstützten Eigenschaften.
[out] pPropertyIds
Typ: PROPERTYID*
Empfängt ein Array von Bezeichnern für eigenschaften, die vom Muster unterstützt werden.
[in] eventIdCount
Typ: UINT
Die Anzahl der ereignisse, die vom Steuerelementmuster unterstützt werden.
[out] pEventIds
Typ: EVENTID*
Empfängt ein Array von Bezeichnern für Ereignisse, die durch das Muster ausgelöst werden.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die von dieser Methode abgerufenen Muster-, Eigenschafts- und Ereignis-IDs können in IAccessibleEx-Implementierungen verwendet werden.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | uiautomationcore.h (include UIAutomation.h) |