Control.ControlCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa uma coleção de Control objetos.
public: ref class Control::ControlCollection : ICloneable, System::Collections::IListpublic: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : ICloneable, System.Collections.IList[System.ComponentModel.ListBindable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
interface IList
interface ICollection
interface IEnumerable
interface ICloneable[<System.ComponentModel.ListBindable(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Control.ControlCollection = class
inherit ArrangedElementCollection
interface IList
interface ICollection
interface IEnumerable
interface ICloneablePublic Class Control.ControlCollection
Implements ICloneable, IListPublic Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList- Herança
-
Control.ControlCollection
- Herança
- Derivado
- Atributos
- Implementações
Exemplos
O exemplo de código seguinte remove a Control do Control.ControlCollection da classe Panel derivada se for membro da coleção. O exemplo exige que tenhas criado um Panel, um Button, e pelo menos um RadioButton controlo sobre um Form. Os RadioButton controlos são adicionados ao Panel controlo, e o controlo Panel adicionado ao Form. Quando o botão é clicado, o botão de rádio nomeado radioButton2 é removido do Control.ControlCollection.
// Remove the RadioButton control if it exists.
private:
void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
if ( panel1->Controls->Contains( removeButton ) )
{
panel1->Controls->Remove( removeButton );
}
}
// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
if(panel1.Controls.Contains(removeButton))
{
panel1.Controls.Remove(removeButton);
}
}
' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles RemoveButton.Click
If Panel1.Controls.Contains(RemoveButton) Then
Panel1.Controls.Remove(RemoveButton)
End If
End Sub
Observações
Os Addmétodos , Remove, e RemoveAt permitem adicionar e remover controlos individuais da coleção. Também podes usar os AddRange métodos ou Clear para adicionar ou remover todos os controlos da coleção.
Pode determinar se a Control é membro da coleção passando o controlo para o Contains método. Para obter o valor do índice da localização de a Control na coleção, passa o controlo para o IndexOf método. A coleção pode ser copiada para um array chamando o CopyTo método.
Construtores
| Name | Description |
|---|---|
| Control.ControlCollection(Control) |
Inicializa uma nova instância da Control.ControlCollection classe. |
Propriedades
| Name | Description |
|---|---|
| Count |
Obtém o número de elementos contidos na coleção. |
| Count |
Obtém o número de elementos na coleção. (Herdado de ArrangedElementCollection) |
| IsReadOnly |
Recebe um valor que indica se este objeto de coleção é apenas de leitura. |
| IsReadOnly |
Recebe um valor que indica se a coleção é apenas de leitura. (Herdado de ArrangedElementCollection) |
| Item[Int32] |
Indica o Control na localização indexada especificada na coleção. |
| Item[String] |
Indica a Control com a chave especificada na coleção. |
| Owner |
Fica com o controlo que detém isto Control.ControlCollection. |
Métodos
| Name | Description |
|---|---|
| Add(Control) |
Adiciona o controlo especificado à coleção de controlos. |
| AddRange(Control[]) |
Adiciona um conjunto de objetos de controlo à coleção. |
| Clear() |
Remove todos os controlos da coleção. |
| Contains(Control) |
Determina se o controlo especificado é membro da coleção. |
| ContainsKey(String) |
Determina se contém Control.ControlCollection um item com a chave especificada. |
| CopyTo(Array, Int32) |
Copia os elementos da coleção para um array, começando num índice particular do array. |
| CopyTo(Array, Int32) |
Copia todo o conteúdo desta coleção para uma unidimensional Arraycompatível , começando no índice especificado do array alvo. (Herdado de ArrangedElementCollection) |
| Equals(Object) |
Especifica se o objeto de coleção atual e o objeto especificado são iguais. |
| Equals(Object) |
Determina se duas ArrangedElementCollection instâncias são iguais. (Herdado de ArrangedElementCollection) |
| Find(String, Boolean) |
Procura controlos pela sua Name propriedade e constrói um conjunto de todos os controlos que correspondem. |
| GetChildIndex(Control, Boolean) |
Recupera o índice do controlo filho especificado dentro da coleção de controlo e, opcionalmente, abre uma exceção se o controlo especificado não estiver dentro da coleção de controlo. |
| GetChildIndex(Control) |
Recupera o índice do controlo filho especificado dentro da coleção de controlos. |
| GetEnumerator() |
Recupera uma referência a um objeto enumerador que é usado para iterar sobre um Control.ControlCollection. |
| GetHashCode() |
Devolve o código de hash para esta instância. |
| GetHashCode() |
Devolve o código de hash para esta instância. (Herdado de ArrangedElementCollection) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IndexOf(Control) |
Recupera o índice do controlo especificado na coleção de controlos. |
| IndexOfKey(String) |
Recupera o índice da primeira ocorrência do item especificado dentro da coleção. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| Remove(Control) |
Remove o controlo especificado da coleção de controlos. |
| RemoveAt(Int32) |
Remove um controlo da coleção de controlo na localização indexada especificada. |
| RemoveByKey(String) |
Remove o controlo filho com a chave especificada. |
| SetChildIndex(Control, Int32) |
Define o índice do controlo filho especificado na coleção para o valor do índice especificado. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICloneable.Clone() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Para uma descrição deste elemento, veja Clone(). |
| ICollection.IsSynchronized |
Para uma descrição deste membro, veja a propriedade IsSynchronized . (Herdado de ArrangedElementCollection) |
| ICollection.SyncRoot |
Para uma descrição deste membro, veja a propriedade SyncRoot . (Herdado de ArrangedElementCollection) |
| IList.Add(Object) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Para uma descrição deste elemento, veja Add(Object). |
| IList.Clear() |
Para uma descrição deste elemento, veja o Clear() método. (Herdado de ArrangedElementCollection) |
| IList.Contains(Object) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Para uma descrição deste elemento, veja Contains(Object). |
| IList.Contains(Object) |
Para uma descrição deste elemento, veja o Contains(Object) método. (Herdado de ArrangedElementCollection) |
| IList.IndexOf(Object) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Para uma descrição deste elemento, veja IndexOf(Object). |
| IList.IndexOf(Object) |
Para uma descrição deste elemento, veja o IndexOf(Object) método. (Herdado de ArrangedElementCollection) |
| IList.Insert(Int32, Object) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Para uma descrição deste elemento, veja Insert(Int32, Object). |
| IList.Insert(Int32, Object) |
Para uma descrição deste elemento, veja o Insert(Int32, Object) método. (Herdado de ArrangedElementCollection) |
| IList.IsFixedSize |
Para uma descrição deste membro, veja a propriedade IsFixedSize . (Herdado de ArrangedElementCollection) |
| IList.Item[Int32] |
Para uma descrição deste membro, veja a propriedade Item[Int32] . (Herdado de ArrangedElementCollection) |
| IList.Remove(Object) |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Para uma descrição deste elemento, veja Remove(Object). |
| IList.RemoveAt(Int32) |
Para uma descrição deste elemento, veja o RemoveAt(Int32) método. (Herdado de ArrangedElementCollection) |
Métodos da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |