IValueProvider::SetValue-Methode (uiautomationcore.h)
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
Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter