This documentation is archived and is not being maintained.
CategoryNameCollection Class
Visual Studio 2010
Represents a collection of category name strings.
System::Object
System.Collections::ReadOnlyCollectionBase
System.Drawing.Design::CategoryNameCollection
System.Collections::ReadOnlyCollectionBase
System.Drawing.Design::CategoryNameCollection
Assembly: System.Drawing (in System.Drawing.dll)
The CategoryNameCollection type exposes the following members.
| 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.) |
![]() | InnerList | Gets the list of elements contained in the ReadOnlyCollectionBase instance. (Inherited from ReadOnlyCollectionBase.) |
![]() | Item | Gets the category name at the specified index. |
| Name | Description | |
|---|---|---|
![]() | Contains | Indicates whether the specified category is contained in the collection. |
![]() | CopyTo | 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.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetEnumerator | Returns an enumerator that iterates through the ReadOnlyCollectionBase instance. (Inherited from ReadOnlyCollectionBase.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | IndexOf | Gets the index of the specified value. |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection::CopyTo | 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.) |
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) ); } } }; }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show:

