IValueProvider::SetValue-Methode (uiautomationcore.h)

  • Artikel

Legt den Wert des Steuerelements fest.

Syntax

HRESULT SetValue(
  [in] LPCWSTR val
);

Parameter

[in] val

Typ: LPCWSTR

Der festzulegende Wert. Der Anbieter ist für das Konvertieren des Werts in den entsprechenden Datentyp verantwortlich.

Rückgabewert

Typ: HRESULT

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

Hinweise

Einzeilige Bearbeitungssteuerelemente unterstützen den programmgesteuerten Zugriff auf ihre Inhalte durch die Implementierung von IValueProvider. Mehrzeilige Bearbeitungssteuerelemente implementieren IValueProvider jedoch nicht. stattdessen ermöglichen sie den Zugriff auf ihre Inhalte, indem sie ITextProvider implementieren.

Steuerelemente wie ListItem und TreeItem müssen IValueProvider implementieren, wenn der Wert eines der Elemente bearbeitbar ist, unabhängig vom aktuellen Bearbeitungsmodus des Steuerelements. Das übergeordnete Steuerelement muss auch IValueProvider implementieren, wenn die untergeordneten Elemente bearbeitbar sind.

Anforderungen

Anforderung Wert
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

IValueProvider

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter