FileDialogCustomPlacesCollection Class

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.Primitives.dll

Represents a collection of Windows Vista custom places for the FileDialog class.

public ref class FileDialogCustomPlacesCollection : System::Collections::ObjectModel::Collection<System::Windows::Forms::FileDialogCustomPlace ^>

public class FileDialogCustomPlacesCollection : System.Collections.ObjectModel.Collection<System.Windows.Forms.FileDialogCustomPlace>

type FileDialogCustomPlacesCollection = class
    inherit Collection<FileDialogCustomPlace>

Public Class FileDialogCustomPlacesCollection
Inherits Collection(Of FileDialogCustomPlace)

Inheritance

Object

Collection<FileDialogCustomPlace>

FileDialogCustomPlacesCollection

Examples

The following code example demonstrates how to use the FileDialogCustomPlacesCollection. 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 or Windows Server 2003, this class does not have any effect.

Constructors

FileDialogCustomPlacesCollection()

Initializes a new instance of the FileDialogCustomPlacesCollection class.

Properties

Count	Gets the number of elements actually contained in the Collection<T>. (Inherited from Collection<T>)
Item[Int32]	Gets or sets the element at the specified index. (Inherited from Collection<T>)
Items	Gets a IList<T> wrapper around the Collection<T>. (Inherited from Collection<T>)

Methods

Add(Guid)	Adds a custom place to the FileDialogCustomPlacesCollection collection.
Add(String)	Adds a custom place to the FileDialogCustomPlacesCollection collection.
Add(T)	Adds an object to the end of the Collection<T>. (Inherited from Collection<T>)
Clear()	Removes all elements from the Collection<T>. (Inherited from Collection<T>)
ClearItems()	Removes all elements from the Collection<T>. (Inherited from Collection<T>)
Contains(T)	Determines whether an element is in the Collection<T>. (Inherited from Collection<T>)
CopyTo(T[], Int32)	Copies the entire Collection<T> to a compatible one-dimensional Array, starting at the specified index of the target array. (Inherited from Collection<T>)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetEnumerator()	Returns an enumerator that iterates through the Collection<T>. (Inherited from Collection<T>)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
IndexOf(T)	Searches for the specified object and returns the zero-based index of the first occurrence within the entire Collection<T>. (Inherited from Collection<T>)
Insert(Int32, T)	Inserts an element into the Collection<T> at the specified index. (Inherited from Collection<T>)
InsertItem(Int32, T)	Inserts an element into the Collection<T> at the specified index. (Inherited from Collection<T>)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
Remove(T)	Removes the first occurrence of a specific object from the Collection<T>. (Inherited from Collection<T>)
RemoveAt(Int32)	Removes the element at the specified index of the Collection<T>. (Inherited from Collection<T>)
RemoveItem(Int32)	Removes the element at the specified index of the Collection<T>. (Inherited from Collection<T>)
SetItem(Int32, T)	Replaces the element at the specified index. (Inherited from Collection<T>)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Extension Methods

See also

• FileDialogCustomPlace