Método IFileDialogCustomize::AddControlItem (shobjidl_core.h)

Agrega un elemento a un control contenedor en el cuadro de diálogo.

Sintaxis

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

Parámetros

[in] dwIDCtl

Tipo: DWORD

Identificador del control de contenedor al que se va a agregar el elemento.

[in] dwIDItem

Tipo: DWORD

Identificador del elemento.

[in] pszLabel

Tipo: LPCWSTR

Puntero a un búfer que contiene el texto del elemento, que puede ser una etiqueta o, en el caso de una lista desplegable, el propio elemento. Este texto es una cadena Unicode terminada en null.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El estado predeterminado de este elemento está habilitado y visible. Los elementos de los grupos de control no se pueden cambiar una vez creados, con la excepción de sus estados habilitados y visibles.

Los controles de contenedor incluyen grupos de botones de opción, cuadros combinados, listas desplegables en el botón Abrir o Guardar y menús.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)