FileDialog.CustomPlaces FileDialog.CustomPlaces FileDialog.CustomPlaces FileDialog.CustomPlaces Property

Definition

Gets the custom places collection for this FileDialog instance.

public:
 property System::Windows::Forms::FileDialogCustomPlacesCollection ^ CustomPlaces { System::Windows::Forms::FileDialogCustomPlacesCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.FileDialogCustomPlacesCollection CustomPlaces { get; }
member this.CustomPlaces : System.Windows.Forms.FileDialogCustomPlacesCollection
Public ReadOnly Property CustomPlaces As FileDialogCustomPlacesCollection

Property Value

Examples

The following code example demonstrates how to use the CustomPlaces collection. To run this example, paste the following code into a Windows Form and call InitializeDialogAndButton from the form's constructor or Load event-handling method.

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

Remarks

On Windows XP, this property does not have any effect.

Applies to