Freigeben über


FileDialog Schnittstelle

Definition

Ermöglicht den Zugriff auf Dateidialogfeldfunktionalität, die der Funktionalität der Standarddialogfelder Öffnen und Speichern in Microsoft Office-Anwendungen entspricht.

public interface class FileDialog : Microsoft::Office::Core::_IMsoDispObj
[System.Runtime.InteropServices.Guid("000C0362-0000-0000-C000-000000000046")]
public interface FileDialog : Microsoft.Office.Core._IMsoDispObj
[<System.Runtime.InteropServices.Guid("000C0362-0000-0000-C000-000000000046")>]
type FileDialog = interface
    interface _IMsoDispObj
Public Interface FileDialog
Implements _IMsoDispObj
Attribute
Implementiert

Hinweise

Mit den Dialogfeldern, die dieses Objekt bereitstellt, können Benutzer Ihrer Lösungen problemlos die Dateien und Ordner angeben, die ihre Lösung verwenden soll.

Verwenden Sie die FileDialog-Eigenschaft, um ein FileDialog-Objekt zurückzugeben. Die FileDialog-Eigenschaft ist Bestandteil des Application-Objekts jeder einzelnen Office-Anwendung. Die -Eigenschaft verwendet ein einzelnes Argument, DialogType, das den Typ des FileDialog-Objekts bestimmt, das die Eigenschaft zurückgibt. Es gibt vier Typen von FileDialog-Objekten :

Jede Hostanwendung kann nur eine einzelne Instanz des FileDialog-Objekts instanziieren. Dadurch bleiben viele Eigenschaften des FileDialog-Objekts auch dann erhalten, wenn Sie mehrere FileDialog-Objekte erstellen. Stellen Sie daher sicher, dass Sie alle Eigenschaften entsprechend ihrem Zweck festgelegt haben, bevor Sie das Dialogfeld anzeigen.

Um ein Dateidialogfeld mithilfe des FileDialog-Objekts anzuzeigen, müssen Sie die Show() -Methode verwenden. Sobald ein Dialogfeld angezeigt wird, wird kein Code ausgeführt, bis der Benutzer das Dialogfeld schließt.

Eigenschaften

AllowMultiSelect

Bestimmt, ob der Benutzer mehrere Dateien aus einem Dateidialogfeld auswählen darf.

Application

Gibt ein Application-Objekt zurück, das die Containeranwendung für das -Objekt darstellt.

ButtonName

Dient zum Zurückgeben oder Festlegen einer Zeichenfolge , die den Text darstellt, der auf der Aktionsschaltfläche eines Dateidialogfelds angezeigt wird.

Creator

Gibt eine 32-Bit-Ganzzahl, die die Anwendung angibt, in der das angegebene Objekt erstellt wurde.

DialogType

Gibt eine MsoFileDialogType Konstante zurück, die den Typ des Dateidialogfelds darstellt, das vom FileDialog Objekt angezeigt werden soll.

FilterIndex

Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der den Standarddateifilter eines Dateidialogfelds angibt.

Filters

Gibt eine FileDialogFilters Auflistung zurück.

InitialFileName

Dient zum Zurückgeben oder Festlegen einer Zeichenfolge , die den Pfad und/oder Dateinamen darstellt, der anfänglich in einem Dateidialogfeld angezeigt wird.

InitialView

Gibt eine MsoFileDialogView Konstante zurück, die die anfängliche Darstellung von Dateien und Ordnern in einem Dateidialogfeld darstellt, oder legt sie fest.

Item

Gibt den einem -Objekt zugeordneten Text zurück.

Parent

Gibt das Parent-Objekt für das angegebene Objekt zurück.

SelectedItems

Gibt eine FileDialogSelectedItems Auflistung zurück.

Title

Gibt den Titel eines Dateidialogfelds zurück, das mithilfe des -Objekts angezeigt wird, oder legt den FileDialog Titel fest.

Methoden

Execute()

Führt die Prozedur oder den integrierten Befehl aus, die dem angegebenen Befehlsleisten-Steuerelement zugewiesen ist.

Show()

Zeigt ein Dateidialogfeld an und gibt eine ganze Zahl zurück, die angibt, ob der Benutzer die Aktionsschaltfläche (-1) oder die Schaltfläche zum Abbrechen (0) gedrückt hat.

Gilt für: