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) |