FileDialogCustomPlacesCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.Primitives.dll

Aggiunge una posizione personalizzata all'insieme FileDialogCustomPlacesCollection.

Overload

Add(Guid)	Aggiunge una posizione personalizzata all'insieme FileDialogCustomPlacesCollection.
Add(String)	Aggiunge una posizione personalizzata all'insieme FileDialogCustomPlacesCollection.

Add(Guid)

Aggiunge una posizione personalizzata all'insieme FileDialogCustomPlacesCollection.

public:
 void Add(Guid knownFolderGuid);

public void Add (Guid knownFolderGuid);

override this.Add : Guid -> unit

Public Sub Add (knownFolderGuid As Guid)

Parametri

knownFolderGuid

Guid

Oggetto Guid che rappresenta una cartella nota di Windows Vista.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo Add. Per eseguire questo esempio, incollare il codice seguente in un Windows Form e chiamare InitializeDialogAndButton dal costruttore del modulo o Load dal metodo di gestione degli eventi.

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

Commenti

La cartella viene aggiunta a posizioni personalizzate solo per un particolare FileDialog e non è una modifica a livello di sistema o applicazione.

Le cartelle vengono posizionate nelle posizioni personalizzate nell'ordine in cui vengono aggiunte a FileDialog. L'ultimo aggiunto sarà nella parte superiore. Se si aggiunge una posizione personalizzata alla raccolta che non esiste nel computer che esegue l'applicazione, la posizione personalizzata non verrà visualizzata. I GUID non fanno distinzione tra maiuscole e minuscole. Per un elenco delle cartelle note di Windows Vista disponibili, vedere GUID di cartelle note per le posizioni personalizzate della finestra di dialogo file o il file KnownFolders.h in Windows SDK.

Vedi anche

• FileDialogCustomPlace
• Guid di cartelle note per le posizioni personalizzate della finestra di dialogo file

Add(String)

Aggiunge una posizione personalizzata all'insieme FileDialogCustomPlacesCollection.

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

public void Add (string? path);

override this.Add : string -> unit

Public Sub Add (path As String)

Parametri

path

String

Percorso della cartella della posizione personalizzata.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo Add. Per eseguire questo esempio, incollare il codice seguente in un Windows Form e chiamare InitializeDialogAndButton dal costruttore del modulo o Load dal metodo di gestione degli eventi.

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

Commenti

La cartella viene aggiunta a posizioni personalizzate solo per un particolare FileDialog e non è una modifica a livello di sistema o applicazione.

Le cartelle vengono posizionate nelle posizioni personalizzate nell'ordine in cui vengono aggiunte a FileDialog. L'ultimo aggiunto sarà nella parte superiore.

Vedi anche

• FileDialogCustomPlace