IFileDialogCustomize::SetControlItemState method (shobjidl_core.h)

Article
02/22/2024

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

Syntax

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

Parameters

[in] dwIDCtl

Type: DWORD

The ID of the container control.

[in] dwIDItem

Type: DWORD

The ID of the item.

[in] dwState

Type: CDCONTROLSTATEF

One or more values from the CDCONTROLSTATE enumeration that indicate the new 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

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)

Share via