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)

Weitere Informationen

IUIAutomationRegistrar