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)