Metodo IFileDialogCustomize::AddControlItem (shobjidl_core.h)

Aggiunge un elemento a un controllo contenitore nella finestra di dialogo.

Sintassi

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

Parametri

[in] dwIDCtl

Tipo: DWORD

ID del controllo contenitore a cui aggiungere l'elemento.

[in] dwIDItem

Tipo: DWORD

ID dell'elemento.

[in] pszLabel

Tipo: LPCWSTR

Puntatore a un buffer contenente il testo dell'elemento, che può essere un'etichetta o, nel caso di un elenco a discesa, l'elemento stesso. Questo testo è una stringa Unicode con terminazione null.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Lo stato predefinito per questo elemento è abilitato e visibile. Non è possibile modificare gli elementi nei gruppi di controllo dopo la creazione, ad eccezione dei relativi stati abilitati e visibili.

I controlli contenitore includono gruppi di pulsanti di opzione, caselle combinate, elenchi a discesa nel pulsante Apri o Salva e menu.

Requisiti