FileDialogCustomPlacesCollection.Add Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.Primitives.dll

Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение.

Перегрузки

Add(Guid)	Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение.
Add(String)	Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение.

Add(Guid)

Исходный код:

FileDialogCustomPlacesCollection.cs

Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение.

public:
 void Add(Guid knownFolderGuid);

public void Add (Guid knownFolderGuid);

override this.Add : Guid -> unit

Public Sub Add (knownFolderGuid As Guid)

Параметры

knownFolderGuid

Guid

Объект , Guid представляющий известную папку Windows Vista.

Примеры

В следующем примере кода показано, как использовать метод Add. Чтобы запустить этот пример, вставьте следующий код в Форму Windows Forms и вызовите InitializeDialogAndButton из конструктора формы или Load метода обработки событий.

private OpenFileDialog openFileDialog1;
private Button button1;

private void InitializeDialogAndButton()
{
    this.openFileDialog1 = new System.Windows.Forms.OpenFileDialog();
    this.button1 = new System.Windows.Forms.Button();
    this.button1.Location = new System.Drawing.Point(53, 37);
    this.button1.AutoSize = true;
    this.button1.Text = "Show dialog with custom places.";
    this.button1.UseVisualStyleBackColor = true;
    this.button1.Click += new System.EventHandler(this.button1_Click);
    this.Controls.Add(this.button1);
}

private void button1_Click(object sender, EventArgs e)
{
    // Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB");

    // Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(
        new FileDialogCustomPlace(
        new Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")));

    // Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add(@"c:\Windows");

    openFileDialog1.ShowDialog();
}

Private openFileDialog1 As OpenFileDialog
Private WithEvents button1 As Button

Private Sub InitializeDialogAndButton() 
    Me.openFileDialog1 = New System.Windows.Forms.OpenFileDialog()
    Me.button1 = New System.Windows.Forms.Button()
    Me.button1.Location = New System.Drawing.Point(53, 37)
    Me.button1.AutoSize = True
    Me.button1.Text = "Show dialog with custom places."
    Me.button1.UseVisualStyleBackColor = True

    Me.Controls.Add(Me.button1)

End Sub


Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click

    ' Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB")

    ' Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(New FileDialogCustomPlace _
        (New Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")))

    ' Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add("c:\Windows")

    openFileDialog1.ShowDialog()

End Sub

Комментарии

Папка добавляется в пользовательские места только для определенного FileDialog и не является изменением масштаба системы или приложения.

Папки размещаются в пользовательских местах в порядке их добавления в FileDialog. Последняя добавленная будет находиться в верхней части. Если добавить пользовательское место в коллекцию, которая не существует на компьютере, на котором выполняется приложение, пользовательское место не будет отображаться. Идентификаторы GUID не учитывают регистр. Список доступных известных папок Windows Vista см. в разделе Известные guid папки для пользовательских расположений диалогового окна файлов или файл KnownFolders.h в windows SDK.

См. также раздел

• FileDialogCustomPlace
• Guid известных папок для пользовательских расположений диалогового окна файлов

Add(String)

Исходный код:

FileDialogCustomPlacesCollection.cs

Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение.

public:
 void Add(System::String ^ path);

public void Add (string? path);

override this.Add : string -> unit

Public Sub Add (path As String)

Параметры

path

String

Путь к папке для пользовательского размещения.

Примеры

В следующем примере кода показано, как использовать метод Add. Чтобы запустить этот пример, вставьте следующий код в Форму Windows Forms и вызовите InitializeDialogAndButton из конструктора формы или Load метода обработки событий.

private OpenFileDialog openFileDialog1;
private Button button1;

private void InitializeDialogAndButton()
{
    this.openFileDialog1 = new System.Windows.Forms.OpenFileDialog();
    this.button1 = new System.Windows.Forms.Button();
    this.button1.Location = new System.Drawing.Point(53, 37);
    this.button1.AutoSize = true;
    this.button1.Text = "Show dialog with custom places.";
    this.button1.UseVisualStyleBackColor = true;
    this.button1.Click += new System.EventHandler(this.button1_Click);
    this.Controls.Add(this.button1);
}

private void button1_Click(object sender, EventArgs e)
{
    // Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB");

    // Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(
        new FileDialogCustomPlace(
        new Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")));

    // Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add(@"c:\Windows");

    openFileDialog1.ShowDialog();
}

Private openFileDialog1 As OpenFileDialog
Private WithEvents button1 As Button

Private Sub InitializeDialogAndButton() 
    Me.openFileDialog1 = New System.Windows.Forms.OpenFileDialog()
    Me.button1 = New System.Windows.Forms.Button()
    Me.button1.Location = New System.Drawing.Point(53, 37)
    Me.button1.AutoSize = True
    Me.button1.Text = "Show dialog with custom places."
    Me.button1.UseVisualStyleBackColor = True

    Me.Controls.Add(Me.button1)

End Sub


Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click

    ' Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB")

    ' Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(New FileDialogCustomPlace _
        (New Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")))

    ' Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add("c:\Windows")

    openFileDialog1.ShowDialog()

End Sub

Комментарии

Папка добавляется в пользовательские места только для определенного FileDialog и не является изменением масштаба системы или приложения.

Папки размещаются в пользовательских местах в порядке их добавления в FileDialog. Последняя добавленная будет находиться в верхней части.

См. также раздел

• FileDialogCustomPlace