IFileDialogCustomize::GetControlItemState-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ruft den aktuellen Status eines Elements in einem Containersteuerelement ab, das im Dialogfeld gefunden wurde.

Syntax

HRESULT GetControlItemState(
  [in]  DWORD           dwIDCtl,
  [in]  DWORD           dwIDItem,
  [out] CDCONTROLSTATEF *pdwState
);

Parameter

[in] dwIDCtl

Art: DWORD

Die ID des Containersteuerelements.

[in] dwIDItem

Art: DWORD

Die ID des Elements.

[out] pdwState

Typ: CDCONTROLSTATEF*

Ein Zeiger auf eine Variable, die einen von weiteren Werten aus der CDCONTROLSTATE-Enumeration empfängt, die den aktuellen Zustand des Steuerelements angeben.

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 Steuerelementelements 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)

Share via