IUIAutomation::GetPatternProgrammaticName-Methode (uiautomationclient.h)

Artikel
03/03/2024

Ruft den registrierten programmgesteuerten Namen eines Steuerelementmusters ab.

Syntax

HRESULT GetPatternProgrammaticName(
  [in]          PATTERNID pattern,
  [out, retval] BSTR      *name
);

Parameter

[in] pattern

Typ: PATTERNID

Der Bezeichner des Steuerelementmusters. Eine Liste der Steuerelementmuster-IDs finden Sie unter Steuerelementmusterbezeichner.

[out, retval] name

Typ: BSTR*

Empfängt den registrierten programmgesteuerten Namen.

Rückgabewert

Typ: HRESULT

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

Hinweise

Der programmgesteuerte Name ist nur für Debugging- und Diagnosezwecke vorgesehen. Die Zeichenfolge ist nicht lokalisiert.

Diese Eigenschaft sollte nicht in Zeichenfolgenvergleichen verwendet werden. Um festzustellen, ob zwei Steuerelementmuster identisch sind, vergleichen Sie die Steuerelementmusterbezeichner direkt.

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 [nur Desktop-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 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)

Freigeben über