FileDialogCustomPlacesCollection.Add Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.Primitives.dll

Ajoute un emplacement personnalisé à la collection FileDialogCustomPlacesCollection.

Surcharges

Add(Guid)	Ajoute un emplacement personnalisé à la collection FileDialogCustomPlacesCollection.
Add(String)	Ajoute un emplacement personnalisé à la collection FileDialogCustomPlacesCollection.

Add(Guid)

Ajoute un emplacement personnalisé à la collection FileDialogCustomPlacesCollection.

public:
 void Add(Guid knownFolderGuid);

public void Add (Guid knownFolderGuid);

override this.Add : Guid -> unit

Public Sub Add (knownFolderGuid As Guid)

Paramètres

knownFolderGuid

Guid

Guid qui représente un dossier connu Windows Vista.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode Add. Pour exécuter cet exemple, collez le code suivant dans un Windows Form et appelez InitializeDialogAndButton à partir du constructeur ou Load de la méthode de gestion des événements du formulaire.

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

Remarques

Le dossier est ajouté aux emplacements personnalisés uniquement pour un particulier FileDialog et n’est pas un changement à l’échelle du système ou de l’application.

Les dossiers sont positionnés dans les emplacements personnalisés dans l’ordre où ils sont ajoutés au FileDialog. Le dernier ajouté se trouve en haut. Si vous ajoutez un emplacement personnalisé à la collection qui n’existe pas sur l’ordinateur exécutant l’application, l’emplacement personnalisé ne s’affiche pas. Les GUID ne respectent pas la casse. Pour obtenir la liste des dossiers connus Windows Vista disponibles, consultez GUID des dossiers connus pour les emplacements personnalisés de la boîte de dialogue de fichiers ou le fichier KnownFolders.h dans le Kit de développement logiciel (SDK) Windows.

Voir aussi

• FileDialogCustomPlace
• Guids de dossier connus pour les emplacements personnalisés de la boîte de dialogue de fichiers

Add(String)

Ajoute un emplacement personnalisé à la collection FileDialogCustomPlacesCollection.

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

public void Add (string? path);

override this.Add : string -> unit

Public Sub Add (path As String)

Paramètres

path

String

Un chemin d'accès au dossier pointant sur l'emplacement personnalisé.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode Add. Pour exécuter cet exemple, collez le code suivant dans un Windows Form et appelez InitializeDialogAndButton à partir du constructeur ou Load de la méthode de gestion des événements du formulaire.

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

Remarques

Le dossier est ajouté aux emplacements personnalisés uniquement pour un particulier FileDialog et n’est pas un changement à l’échelle du système ou de l’application.

Les dossiers sont positionnés dans les emplacements personnalisés dans l’ordre où ils sont ajoutés au FileDialog. Le dernier ajouté se trouve en haut.

Voir aussi

• FileDialogCustomPlace