FileDialogCustomPlacesCollection.Add Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение.
Перегрузки
Add(Guid) |
Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение. |
Add(String) |
Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение. |
Add(Guid)
Добавляет в коллекцию FileDialogCustomPlacesCollection пользовательское размещение.
public:
void Add(Guid knownFolderGuid);
public void Add (Guid knownFolderGuid);
override this.Add : Guid -> unit
Public Sub Add (knownFolderGuid As Guid)
Параметры
Примеры
В следующем примере кода показано, как использовать метод 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 пользовательское размещение.
public:
void Add(System::String ^ path);
public void Add (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. Последняя добавленная будет находиться в верхней части.