Interfaccia IFileDialogCustomize (shobjidl_core.h)

Espone i metodi che consentono a un'applicazione di aggiungere controlli a una finestra di dialogo di file comune.

Ereditarietà

L'interfaccia IFileDialogCustomize eredita dall'interfaccia IUnknown . IFileDialogCustomize include anche questi tipi di membri:

Metodi

L'interfaccia IFileDialogCustomize dispone di questi metodi.

IFileDialogCustomize::AddCheckButton Aggiunge un pulsante di controllo (casella di controllo) alla finestra di dialogo.
IFileDialogCustomize::AddComboBox Aggiunge una casella combinata alla finestra di dialogo.
IFileDialogCustomize::AddControlItem Aggiunge un elemento a un controllo contenitore nella finestra di dialogo.
IFileDialogCustomize::AddEditBox Aggiunge un controllo casella di modifica alla finestra di dialogo.
IFileDialogCustomize::AddMenu Aggiunge un menu alla finestra di dialogo.
IFileDialogCustomize::AddPushButton Aggiunge un pulsante alla finestra di dialogo.
IFileDialogCustomize::AddRadioButtonList Aggiunge un gruppo di pulsanti di opzione (noto anche come pulsante di opzione) alla finestra di dialogo.
IFileDialogCustomize::AddSeparator Aggiunge un separatore alla finestra di dialogo, consentendo una separazione visiva dei controlli.
IFileDialogCustomize::AddText Aggiunge contenuto di testo alla finestra di dialogo.
IFileDialogCustomize::EnableOpenDropDown Abilita un elenco a discesa nel pulsante Apri o Salva nella finestra di dialogo.
IFileDialogCustomize::EndVisualGroup Arresta l'aggiunta di elementi a un gruppo visivo nella finestra di dialogo.
IFileDialogCustomize::GetCheckButtonState Ottiene lo stato corrente di un pulsante di controllo (casella di controllo) nella finestra di dialogo.
IFileDialogCustomize::GetControlItemState Ottiene lo stato corrente di un elemento in un controllo contenitore trovato nella finestra di dialogo.
IFileDialogCustomize::GetControlState Ottiene la visibilità corrente e gli stati abilitati di un determinato controllo.
IFileDialogCustomize::GetEditBoxText Ottiene il testo corrente in un controllo casella di modifica.
IFileDialogCustomize::GetSelectedControlItem Ottiene un elemento specifico dai controlli contenitore specificati nella finestra di dialogo.
IFileDialogCustomize::MakeProminent Inserisce un controllo nella finestra di dialogo in modo che si distingue rispetto ad altri controlli aggiunti.
IFileDialogCustomize::RemoveAllControlItems Non implementato. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem Rimuove un elemento da un controllo contenitore nella finestra di dialogo.
IFileDialogCustomize::SetCheckButtonState Imposta lo stato di un pulsante di controllo (casella di controllo) nella finestra di dialogo.
IFileDialogCustomize::SetControlItemState Imposta lo stato corrente di un elemento in un controllo contenitore trovato nella finestra di dialogo.
IFileDialogCustomize::SetControlItemText Imposta il testo di un elemento di controllo. Ad esempio, il testo che accompagna un pulsante di opzione o una voce in un menu.
IFileDialogCustomize::SetControlLabel Imposta il testo associato a un controllo, ad esempio il testo del pulsante o un'etichetta di casella di modifica.
IFileDialogCustomize::SetControlState Imposta la visibilità corrente e gli stati abilitati di un determinato controllo.
IFileDialogCustomize::SetEditBoxText Imposta il testo in un controllo casella di modifica presente nella finestra di dialogo.
IFileDialogCustomize::SetSelectedControlItem Imposta lo stato selezionato di un elemento specifico in un gruppo di pulsanti di opzione o in una casella combinata disponibile nella finestra di dialogo.
IFileDialogCustomize::StartVisualGroup Dichiara un gruppo visivo nella finestra di dialogo. Le chiamate successive a qualsiasi metodo "add" aggiungono tali elementi a questo gruppo.

Commenti

Quando implementare

IFileDialogControlEvents viene implementato dalla finestra di dialogo di apertura file comune (CLSID_FileOpenDialog) e dalla finestra di dialogo di salvataggio file (CLSID_FileSaveDialog).

I controlli vengono aggiunti alla finestra di dialogo prima che venga visualizzata la finestra di dialogo. Il layout è implicito nell'ordine in cui vengono aggiunte. Una volta visualizzata la finestra di dialogo, i controlli non possono essere aggiunti o rimossi, ma i controlli esistenti possono essere nascosti o disabilitati in qualsiasi momento. Le etichette possono anche essere modificate in qualsiasi momento.

I controlli contenitore sono controlli che possono avere elementi aggiunti. I controlli contenitore includono caselle combinate, menu, elenco a discesa associato al pulsante Apri e gruppi di pulsanti di opzione. L'ordine in cui gli elementi vengono visualizzati in un contenitore è l'ordine in cui sono stati aggiunti. Non c'è alcuna struttura per riordinarli. Gli ID hanno come ambito il controllo padre. I controlli contenitore, ad eccezione dei menu, hanno un elemento selezionato.

Gli elementi con un controllo contenitore non possono essere modificati dopo la creazione, ad eccezione dei relativi stati abilitati e visibili. Tuttavia, possono essere aggiunti e rimossi in qualsiasi momento. Ad esempio, se è necessario modificare il testo di un menu, è necessario rimuovere il menu corrente e aggiungerne un altro con il testo corretto.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)