Edit

IFileDialogCustomize::AddControlItem method (shobjidl_core.h)

  • Article

Adds an item to a container control in the dialog.

Syntax

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

Parameters

[in] dwIDCtl

Type: DWORD

The ID of the container control to which the item is to be added.

[in] dwIDItem

Type: DWORD

The ID of the item.

[in] pszLabel

Type: LPCWSTR

A pointer to a buffer that contains the item's text, which can be either a label or, in the case of a drop-down list, the item itself. This text is a null-terminated Unicode string.

Return value

Type: HRESULT

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

Remarks

The default state for this 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)