CategoryNameCollection Classe

Definição

Namespace:

System.Drawing.Design

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

CategoryNameCollection.cs

Representa uma coleção de cadeias de caracteres de nome de categoria.

C#

public sealed class CategoryNameCollection : System.Collections.ReadOnlyCollectionBase

Herança

Object

ReadOnlyCollectionBase

CategoryNameCollection

Exemplos

O exemplo de código a seguir tenta recuperar o IToolboxService quando o controle é colocado no modo de design. Se o IToolboxService for recuperado, o código obterá os nomes de cada categoria de caixa de ferramentas e desenhará cada nome na superfície do controle.

C#

using System;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Drawing.Design;
using System.Data;
using System.Windows.Forms;

namespace ToolboxCategoryNamesControl
{
    public class ToolboxCategoryNamesControl : System.Windows.Forms.UserControl
    {		
        private System.Drawing.Design.IToolboxService toolboxService;
        private System.Drawing.Design.CategoryNameCollection categoryNames;

        public ToolboxCategoryNamesControl()
        {
            this.BackColor = System.Drawing.Color.Beige;
            this.Name = "Category Names Display Control";
            this.Size = new System.Drawing.Size(264, 200);
        }

        // Obtain or reset IToolboxService reference on each siting of control.
        public override System.ComponentModel.ISite Site
        {
            get
            {
                return base.Site;
            }
            set
            {
                base.Site = value;

                // If the component was sited, attempt to obtain
                // an IToolboxService instance.
                if( base.Site != null )
                {
                    toolboxService = (IToolboxService)this.GetService(typeof(IToolboxService));
                    // If an IToolboxService was located, update the category list.
                    if( toolboxService != null )
                        categoryNames = toolboxService.CategoryNames;
                }
                else
                {
                    toolboxService = null;
                }
            }
        }

        protected override void OnPaint(System.Windows.Forms.PaintEventArgs e)
        {
            if( categoryNames != null )
            {
                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.
                for( int i=0; i< categoryNames.Count; i++ )
                    e.Graphics.DrawString(categoryNames[i], new Font("Arial", 8), Brushes.Black, 10, 24+(10*i));
            }
        }
    }
}

Comentários

Essa coleção é usada para armazenar coleções de nomes de categorias de caixa de ferramentas.

Construtores

CategoryNameCollection(CategoryNameCollection)	Inicializa uma nova instância da classe CategoryNameCollection usando a coleção especificada.
CategoryNameCollection(String[])	Inicializa uma nova instância da classe CategoryNameCollection usando a matriz de nomes especificada.

Propriedades

Count	Obtém o número de elementos contidos na instância de ReadOnlyCollectionBase. (Herdado de ReadOnlyCollectionBase)
InnerList	Obtém a lista de elementos contidos na instância ReadOnlyCollectionBase. (Herdado de ReadOnlyCollectionBase)
Item[Int32]	Obtém o nome da categoria no índice especificado.

Métodos

Contains(String)	Indica se a categoria especificada está contida na coleção.
CopyTo(String[], Int32)	Copia os elementos da coleção para a matriz especificada no índice especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que itera pela instância ReadOnlyCollectionBase. (Herdado de ReadOnlyCollectionBase)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(String)	Obtém o índice do valor especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Métodos de Extensão

Aplica-se a

Confira também

• IToolboxService