Share via


IFileDialogCustomize::SetControlItemText-Methode (shobjidl_core.h)

Legt den Text eines Steuerelementelements fest. Beispielsweise der Text, der ein Optionsfeld oder ein Element in einem Menü begleitet.

Syntax

HRESULT SetControlItemText(
  [in] DWORD   dwIDCtl,
  [in] DWORD   dwIDItem,
  [in] LPCWSTR pszLabel
);

Parameter

[in] dwIDCtl

Art: DWORD

Die ID des Containersteuerelements.

[in] dwIDItem

Art: DWORD

Die ID des Elements.

[in] pszLabel

Typ: LPCWSTR

Ein Zeiger auf einen Puffer mit Null-Endung, der eine Unicode-Zeichenfolge mit dem Text enthält.

Rückgabewert

Typ: HRESULT

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

Hinweise

Der Standardzustand eines Steuerelements ist aktiviert und sichtbar. Elemente in Steuerelementgruppen können nicht geändert werden, nachdem sie erstellt wurden, mit Ausnahme ihrer aktivierten und sichtbaren Zustände.

Containersteuerelemente umfassen Optionsschaltflächengruppen, Kombinationsfelde, Dropdownlisten auf der Schaltfläche Öffnen oder Speichern sowie Menüs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)