IFileDialogCustomize::SetControlItemState-Methode (shobjidl_core.h)

  • Artikel

Legt den aktuellen Zustand eines Elements in einem Containersteuerelement fest, das im Dialogfeld gefunden wird.

Syntax

HRESULT SetControlItemState(
  [in] DWORD           dwIDCtl,
  [in] DWORD           dwIDItem,
  [in] CDCONTROLSTATEF dwState
);

Parameter

[in] dwIDCtl

Art: DWORD

Die ID des Containersteuerelements.

[in] dwIDItem

Art: DWORD

Die ID des Elements.

[in] dwState

Typ: CDCONTROLSTATEF

Mindestens ein Wert aus der CDCONTROLSTATE-Enumeration , die den neuen Zustand des Steuerelements angibt.

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)