IFileDialogCustomize::AddControlItem-Methode (shobjidl_core.h)

  • Artikel

Fügt einem Containersteuerelement im Dialogfeld ein Element hinzu.

Syntax

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

Parameter

[in] dwIDCtl

Art: DWORD

Die ID des Containersteuerelements, dem das Element hinzugefügt werden soll.

[in] dwIDItem

Art: DWORD

Die ID des Elements.

[in] pszLabel

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der den Text des Elements enthält, der entweder eine Bezeichnung oder im Fall einer Dropdownliste das Element selbst sein kann. Dieser Text ist eine Unicode-Zeichenfolge mit NULL-Endung.

Rückgabewert

Typ: HRESULT

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

Hinweise

Der Standardzustand für dieses Element 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 Optionsfeldgruppen, Kombinationsfelder, 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 (shobjidl.h einschließen)