CategoryNameCollection Class
Represents a collection of category name strings.
Assembly: System.Drawing (in System.Drawing.dll)
System.Collections.ReadOnlyCollectionBase
System.Drawing.Design.CategoryNameCollection
| Name | Description | |
|---|---|---|
![]() | CategoryNameCollection(CategoryNameCollection) | Initializes a new instance of the CategoryNameCollection class using the specified collection. |
![]() | CategoryNameCollection(String()) | Initializes a new instance of the CategoryNameCollection class using the specified array of names. |
| Name | Description | |
|---|---|---|
![]() | Count | Gets the number of elements contained in the ReadOnlyCollectionBase instance.(Inherited from ReadOnlyCollectionBase.) |
![]() | Item(Int32) | Gets the category name at the specified index. |
| Name | Description | |
|---|---|---|
![]() | Contains(String) | Indicates whether the specified category is contained in the collection. |
![]() | CopyTo(String(), Int32) | Copies the collection elements to the specified array at the specified index. |
![]() | Equals(Object) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | GetEnumerator() | Returns an enumerator that iterates through the ReadOnlyCollectionBase instance.(Inherited from ReadOnlyCollectionBase.) |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetType() | |
![]() | IndexOf(String) | Gets the index of the specified value. |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection.CopyTo(Array, Int32) | Copies the entire ReadOnlyCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.(Inherited from ReadOnlyCollectionBase.) |
![]() ![]() | ICollection.IsSynchronized | Gets a value indicating whether access to a ReadOnlyCollectionBase object is synchronized (thread safe).(Inherited from ReadOnlyCollectionBase.) |
![]() ![]() | ICollection.SyncRoot | Gets an object that can be used to synchronize access to a ReadOnlyCollectionBase object.(Inherited from ReadOnlyCollectionBase.) |
| Name | Description | |
|---|---|---|
![]() | AsParallel() | Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.) |
![]() | AsQueryable() | Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.) |
![]() | Cast(Of TResult)() | Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.) |
![]() | OfType(Of TResult)() | Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.) |
This collection is used to store collections of toolbox category names.
The following code example attempts to retrieve the IToolboxService when the control is sited in design mode. If the IToolboxService is retrieved, the code gets the names of each toolbox category and draws each name on the surface of the control.
Imports System Imports System.Collections Imports System.ComponentModel Imports System.ComponentModel.Design Imports System.Drawing Imports System.Drawing.Design Imports System.Data Imports System.Windows.Forms <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ Public Class ToolboxCategoryNamesControl Inherits System.Windows.Forms.UserControl Private toolboxService As System.Drawing.Design.IToolboxService Private categoryNames As System.Drawing.Design.CategoryNameCollection Public Sub New() Me.BackColor = System.Drawing.Color.Beige Me.Name = "Category Names Display Control" Me.Size = New System.Drawing.Size(264, 200) End Sub ' Obtain or reset IToolboxService reference on each siting of control. Public Overrides Property Site() As System.ComponentModel.ISite Get Return MyBase.Site End Get Set(ByVal Value As System.ComponentModel.ISite) MyBase.Site = Value ' If the component was sited, attempt to obtain ' an IToolboxService instance. If (MyBase.Site IsNot Nothing) Then toolboxService = CType(Me.GetService(GetType(IToolboxService)), IToolboxService) ' If an IToolboxService was located, update the category list. If (toolboxService IsNot Nothing) Then categoryNames = toolboxService.CategoryNames End If Else toolboxService = Nothing End If End Set End Property Protected Overrides Sub OnPaint(ByVal e As System.Windows.Forms.PaintEventArgs) If (categoryNames IsNot Nothing) Then e.Graphics.DrawString("IToolboxService category names list:", New Font("Arial", 9), Brushes.Black, 10, 10) ' categoryNames is a CategoryNameCollection obtained from ' the IToolboxService. CategoryNameCollection is a read-only ' string collection. ' Output each category name in the CategoryNameCollection. Dim i As Integer For i = 0 To categoryNames.Count - 1 e.Graphics.DrawString(categoryNames(i), New Font("Arial", 8), Brushes.Black, 10, 24 + 10 * i) Next i End If End Sub End Class
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.




