Freigeben über


IFileDialogCustomize-Schnittstelle (shobjidl_core.h)

Macht Methoden verfügbar, die einer Anwendung das Hinzufügen von Steuerelementen zu einem allgemeinen Dateidialogfeld ermöglichen.

Vererbung

Die IFileDialogCustomize-Schnittstelle erbt von der IUnknown-Schnittstelle . IFileDialogCustomize verfügt auch über die folgenden Membertypen:

Methoden

Die IFileDialogCustomize-Schnittstelle verfügt über diese Methoden.

 
IFileDialogCustomize::AddCheckButton

Fügt dem Dialogfeld eine Kontrollkästchenschaltfläche (Kontrollkästchen) hinzu.
IFileDialogCustomize::AddComboBox

Fügt dem Dialogfeld ein Kombinationsfeld hinzu.
IFileDialogCustomize::AddControlItem

Fügt einem Containersteuerelement im Dialogfeld ein Element hinzu.
IFileDialogCustomize::AddEditBox

Fügt dem Dialogfeld ein Bearbeitungsfeld-Steuerelement hinzu.
IFileDialogCustomize::AddMenu

Fügt dem Dialogfeld ein Menü hinzu.
IFileDialogCustomize::AddPushButton

Fügt dem Dialogfeld eine Schaltfläche hinzu.
IFileDialogCustomize::AddRadioButtonList

Fügt dem Dialogfeld eine Optionsschaltfläche (auch als Optionsfeld bezeichnet) hinzu.
IFileDialogCustomize::AddSeparator

Fügt dem Dialogfeld ein Trennzeichen hinzu, das eine visuelle Trennung von Steuerelementen ermöglicht.
IFileDialogCustomize::AddText

Fügt dem Dialogfeld Textinhalt hinzu.
IFileDialogCustomize::EnableOpenDropDown

Aktiviert eine Dropdownliste für die Schaltfläche Öffnen oder Speichern im Dialogfeld.
IFileDialogCustomize::EndVisualGroup

Beendet das Hinzufügen von Elementen zu einer visuellen Gruppe im Dialogfeld.
IFileDialogCustomize::GetCheckButtonState

Ruft den aktuellen Zustand einer Kontrollkästchen (Kontrollkästchen) im Dialogfeld ab.
IFileDialogCustomize::GetControlItemState

Ruft den aktuellen Zustand eines Elements in einem Containersteuerelement ab, das im Dialogfeld gefunden wurde.
IFileDialogCustomize::GetControlState

Ruft die aktuelle Sichtbarkeit und aktivierten Zustände eines bestimmten Steuerelements ab.
IFileDialogCustomize::GetEditBoxText

Ruft den aktuellen Text in einem Bearbeitungsfeld-Steuerelement ab.
IFileDialogCustomize::GetSelectedControlItem

Ruft ein bestimmtes Element aus angegebenen Containersteuerelementen im Dialogfeld ab.
IFileDialogCustomize::MakeProminent

Platziert ein Steuerelement im Dialogfeld so, dass es sich im Vergleich zu anderen hinzugefügten Steuerelementen abhebt.
IFileDialogCustomize::RemoveAllControlItems

Nicht implementiert. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem

Entfernt ein Element aus einem Containersteuerelement im Dialogfeld.
IFileDialogCustomize::SetCheckButtonState

Legt den Status einer Kontrollkästchenschaltfläche (Kontrollkästchen) im Dialogfeld fest.
IFileDialogCustomize::SetControlItemState

Legt den aktuellen Zustand eines Elements in einem Containersteuerelement fest, das im Dialogfeld gefunden wird.
IFileDialogCustomize::SetControlItemText

Legt den Text eines Steuerelementelements fest. Beispielsweise der Text, der ein Optionsfeld oder ein Element in einem Menü begleitet.
IFileDialogCustomize::SetControlLabel

Legt den Text fest, der einem Steuerelement zugeordnet ist, z. B. Schaltflächentext oder eine Beschriftung des Bearbeitungsfelds.
IFileDialogCustomize::SetControlState

Legt die aktuelle Sichtbarkeit und den aktivierten Status eines bestimmten Steuerelements fest.
IFileDialogCustomize::SetEditBoxText

Legt den Text in einem Bearbeitungsfeld-Steuerelement fest, das im Dialogfeld gefunden wird.
IFileDialogCustomize::SetSelectedControlItem

Legt den ausgewählten Zustand eines bestimmten Elements in einer Optionsschaltflächengruppe oder einem Kombinationsfeld im Dialogfeld fest.
IFileDialogCustomize::StartVisualGroup

Deklariert eine visuelle Gruppe im Dialogfeld. Nachfolgende Aufrufe einer beliebigen "add"-Methode fügen diese Elemente dieser Gruppe hinzu.

Hinweise

Wann muss implementiert werden?

IFileDialogControlEvents wird durch das Allgemeine Dialogfeld zum Öffnen der Datei (CLSID_FileOpenDialog) und das Dialogfeld zum Speichern von Dateien (CLSID_FileSaveDialog) implementiert.

Steuerelemente werden dem Dialogfeld hinzugefügt, bevor das Dialogfeld angezeigt wird. Ihr Layout wird durch die Reihenfolge impliziert, in der sie hinzugefügt werden. Sobald das Dialogfeld angezeigt wird, können Steuerelemente nicht hinzugefügt oder entfernt werden, aber die vorhandenen Steuerelemente können jederzeit ausgeblendet oder deaktiviert werden. Auch deren Bezeichnungen können jederzeit geändert werden.

Containersteuerelemente sind Steuerelemente, denen Elemente hinzugefügt werden können. Containersteuerelemente umfassen Kombinationsfelder, Menüs, die Dropdownliste, die an die Schaltfläche Öffnen angefügt ist, und alle Optionsschaltflächengruppen. Die Reihenfolge, in der Elemente in einem Container angezeigt werden, ist die Reihenfolge, in der sie hinzugefügt wurden. Es gibt keine Möglichkeit, sie neu anzuordnen. IDs sind auf das übergeordnete Steuerelement ausgerichtet. Containersteuerelemente, mit Ausnahme von Menüs, verfügen über ein ausgewähltes Element.

Elemente mit einem Containersteuerelement können nicht geändert werden, nachdem sie erstellt wurden, mit Ausnahme ihrer aktivierten und sichtbaren Zustände. Sie können jedoch jederzeit hinzugefügt und entfernt werden. Wenn Sie beispielsweise den Text eines Menüs ändern müssten, müssten Sie das aktuelle Menü entfernen und ein anderes mit dem richtigen Text hinzufügen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)