FileDialog Schnittstelle

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

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

GuidAttribute

Implementiert

_IMsoDispObj

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.