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(array<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(array<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<TResult>() | Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.) |
![]() | OfType<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.
#using <System.Windows.Forms.dll> #using <System.Data.dll> #using <System.Drawing.dll> #using <System.dll> using namespace System; using namespace System::Collections; using namespace System::ComponentModel; using namespace System::ComponentModel::Design; using namespace System::Drawing; using namespace System::Drawing::Design; using namespace System::Data; using namespace System::Windows::Forms; namespace ToolboxCategoryNamesControl { public ref class ToolboxCategoryNamesControl: public System::Windows::Forms::UserControl { private: System::Drawing::Design::IToolboxService^ toolboxService; System::Drawing::Design::CategoryNameCollection^ categoryNames; public: ToolboxCategoryNamesControl() { this->BackColor = System::Drawing::Color::Beige; this->Name = "Category Names Display Control"; this->Size = System::Drawing::Size( 264, 200 ); } property System::ComponentModel::ISite^ Site { // Obtain or reset IToolboxService^ reference on each siting of control. virtual System::ComponentModel::ISite^ get() override { return __super::Site; } virtual void set( System::ComponentModel::ISite^ value ) override { __super::Site = value; // If the component was sited, attempt to obtain // an IToolboxService^ instance. if ( __super::Site != nullptr ) { toolboxService = dynamic_cast<IToolboxService^>(this->GetService( IToolboxService::typeid )); // If an IToolboxService* was located, update the category list. if ( toolboxService != nullptr ) categoryNames = toolboxService->CategoryNames; } else toolboxService = nullptr; } } protected: [System::Security::Permissions::PermissionSetAttribute(System::Security::Permissions::SecurityAction::Demand, Name="FullTrust")] virtual void OnPaint( System::Windows::Forms::PaintEventArgs^ e ) override { if ( categoryNames != nullptr ) { e->Graphics->DrawString( "IToolboxService category names list:", gcnew System::Drawing::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. for ( int i = 0; i < categoryNames->Count; i++ ) e->Graphics->DrawString( categoryNames[ i ], gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, (float)10, (float)24 + (10 * i) ); } } }; }
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.




