FileDialogCustomPlacesCollection.Add Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.
Sobrecargas
| Name | Description |
|---|---|
| Add(Guid) |
Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção. |
| Add(String) |
Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção. |
Add(Guid)
Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.
public:
void Add(Guid knownFolderGuid);
public void Add(Guid knownFolderGuid);
override this.Add : Guid -> unit
Public Sub Add (knownFolderGuid As Guid)
Parâmetros
Exemplos
O exemplo de código seguinte demonstra como usar o Add método. Para executar este exemplo, cole o seguinte código num formulário Windows e chame InitializeDialogAndButton do construtor do formulário ou do método de gestão de eventos 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
Observações
A pasta é adicionada a locais personalizados apenas para um determinado FileDialog caso e não é uma alteração a nível de sistema ou aplicação.
As pastas estão posicionadas nos locais personalizados pela ordem em que são adicionadas ao FileDialogarquivo . A última adicionada ficará no topo. Se adicionar um local personalizado à coleção que não existe no computador que executa a aplicação, o local personalizado não será mostrado. Os GUIDs são indiferentes a maiúsculas minúsculas. Para uma lista das pastas Windows Vista conhecidas disponíveis, veja Known Folder GUIDs para File Dialog Custom Places ou o ficheiro KnownFolders.h no SDK Windows.
Ver também
- FileDialogCustomPlace
- Guids de Pastas Conhecidas para Locais Personalizados de Diálogos de Ficheiros
Aplica-se a
Add(String)
Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.
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)
Parâmetros
- path
- String
Um caminho de pasta para o local personalizado.
Exemplos
O exemplo de código seguinte demonstra como usar o Add método. Para executar este exemplo, cole o seguinte código num formulário Windows e chame InitializeDialogAndButton do construtor do formulário ou do método de gestão de eventos 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
Observações
A pasta é adicionada a locais personalizados apenas para um determinado FileDialog caso e não é uma alteração a nível de sistema ou aplicação.
As pastas estão posicionadas nos locais personalizados pela ordem em que são adicionadas ao FileDialogarquivo . A última adicionada ficará no topo.