IFileDialogCustomize::GetControlItemState method (shobjidl_core.h)

Gets the current state of an item in a container control found in the dialog.

Syntax

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

Parameters

[in] dwIDCtl

Type: DWORD

The ID of the container control.

[in] dwIDItem

Type: DWORD

The ID of the item.

[out] pdwState

Type: CDCONTROLSTATEF*

A pointer to a variable that receives one of more values from the CDCONTROLSTATE enumeration that indicate the current state of the control.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The default state of a control item is enabled and visible. Items in control groups cannot be changed after they have been created, with the exception of their enabled and visible states.

Container controls include option button groups, combo boxes, drop-down lists on the Open or Save button, and menus.

Requirements