Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe DataGridViewComboBoxCell

Exibe uma caixa de combinação em um DataGridView controle.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public class DataGridViewComboBoxCell : DataGridViewCell

O tipo DataGridViewComboBoxCell expõe os membros a seguir.

  NomeDescrição
Método públicoDataGridViewComboBoxCellInicializa uma nova instância da classe DataGridViewComboBoxCell.
Superior

  NomeDescrição
Propriedade públicaAccessibilityObjectObtém DataGridViewCell.DataGridViewCellAccessibleObject atribuído a DataGridViewCell. (Herdado de DataGridViewCell.)
Propriedade públicaAutoCompleteObtém ou define um valor indicando se a célula corresponderão aos caracteres sendo inseridos na célula com uma seleção na lista suspensa.
Propriedade públicaColumnIndexObtém o índice da coluna para essa célula. (Herdado de DataGridViewCell.)
Propriedade públicaContentBoundsObtém o retângulo delimitador que inclui a área de conteúdo da célula. (Herdado de DataGridViewCell.)
Propriedade públicaContextMenuStripObtém ou define o menu de atalho associado com a célula. (Herdado de DataGridViewCell.)
Propriedade públicaDataGridViewObtém o DataGridView controle associado a esse elemento. (Herdado de DataGridViewElement.)
Propriedade públicaDataSourceObtém ou define a fonte de dados cujos dados contém as seleções possíveis mostradas na lista suspensa.
Propriedade públicaDefaultNewRowValueObtém o valor padrão para uma célula na linha para novos registros. (Herdado de DataGridViewCell.)
Propriedade públicaDisplayedObtém um valor que indica se a célula é exibido na tela. (Herdado de DataGridViewCell.)
Propriedade públicaDisplayMemberObtém ou define uma seqüência de caracteres que especifica onde reunir seleções para exibir na lista suspensa.
Propriedade públicaDisplayStyleObtém ou define um valor que determina como a caixa de combinação é exibida quando não estiver no modo de edição.
Propriedade públicaDisplayStyleForCurrentCellOnlyObtém ou define um valor indicando se a DisplayStyle o valor da propriedade se aplica à célula somente quando a célula atual for o DataGridView controle.
Propriedade públicaDropDownWidthObtém ou define a largura da parte na lista suspensa de uma caixa de combinação.
Propriedade públicaEditedFormattedValueObtém a atual, valor formatado de célula, independentemente da célula estiver em modo de edição e o valor não foi comprometido. (Herdado de DataGridViewCell.)
Propriedade públicaEditTypeObtém o tipo de controle de edição da célula hospedado. (Substitui DataGridViewCell.EditType.)
Propriedade públicaErrorIconBoundsObtém os limites do ícone de erro para a célula. (Herdado de DataGridViewCell.)
Propriedade públicaErrorTextObtém ou define o texto que descreve uma condição de erro associada com a célula. (Herdado de DataGridViewCell.)
Propriedade públicaFlatStyleObtém ou define a aparência de estilo plano da célula.
Propriedade públicaFormattedValueObtém o valor da célula como formatado para exibição. (Herdado de DataGridViewCell.)
Propriedade públicaFormattedValueTypeObtém o tipo de classe do valor formatado associado à célula. (Substitui DataGridViewCell.FormattedValueType.)
Propriedade públicaFrozenObtém um valor indicando se a célula estiver congelado. (Herdado de DataGridViewCell.)
Propriedade públicaHasStyleObtém um valor indicando se a propriedade de Style foi definida. (Herdado de DataGridViewCell.)
Propriedade públicaInheritedStateObtém o estado atual de célula como herdado de estado da sua linha e coluna. (Herdado de DataGridViewCell.)
Propriedade públicaInheritedStyleObtém o estilo atualmente aplicado à célula. (Herdado de DataGridViewCell.)
Propriedade públicaIsInEditModeObtém um valor indicando se essa célula está sendo editada atualmente. (Herdado de DataGridViewCell.)
Propriedade públicaItemsObtém os objetos que representam a seleção exibida na lista drop-down.
Propriedade públicaMaxDropDownItemsObtém ou define o número máximo de itens mostrados na lista drop-down.
Propriedade públicaOwningColumnObtém a coluna que contém essa célula. (Herdado de DataGridViewCell.)
Propriedade públicaOwningRowObtém a linha que contém essa célula. (Herdado de DataGridViewCell.)
Propriedade públicaPreferredSizeObtém o tamanho, em pixels, de uma área retangular em que a célula pode caber. (Herdado de DataGridViewCell.)
Propriedade públicaReadOnlyObtém ou define um valor indicando se os dados da célula podem ser editados. (Herdado de DataGridViewCell.)
Propriedade públicaResizableObtém um valor indicando se a célula pode ser redimensionada. (Herdado de DataGridViewCell.)
Propriedade públicaRowIndexObtém o índice da linha pai da célula. (Herdado de DataGridViewCell.)
Propriedade públicaSelectedObtém ou define um valor indicando se a célula foi selecionada. (Herdado de DataGridViewCell.)
Propriedade públicaSizeObtém o tamanho da célula. (Herdado de DataGridViewCell.)
Propriedade públicaSortedObtém ou define um valor que indica se os itens na caixa de combinação são classificados automaticamente.
Propriedade públicaStateObtém o estado do elemento de interface (UI) do usuário. (Herdado de DataGridViewElement.)
Propriedade públicaStyleObtém ou define o estilo para a célula. (Herdado de DataGridViewCell.)
Propriedade públicaTagObtém ou define o objeto que contém dados suplementares sobre a célula. (Herdado de DataGridViewCell.)
Propriedade públicaToolTipTextObtém ou define o texto de Dica associado com essa célula. (Herdado de DataGridViewCell.)
Propriedade públicaValueObtém ou define o valor associado com essa célula. (Herdado de DataGridViewCell.)
Propriedade públicaValueMemberObtém ou define uma seqüência de caracteres que especifica onde reunir os valores subjacentes usados na lista suspensa.
Propriedade públicaValueTypeObtém ou define o tipo de dados dos valores na célula. (Substitui DataGridViewCell.ValueType.)
Propriedade públicaVisibleObtém um valor indicando se a célula está em uma linha ou coluna que foi oculto. (Herdado de DataGridViewCell.)
Superior

  NomeDescrição
Método públicoAdjustCellBorderStyleAltera o estilo da borda da célula de entrada de acordo com os critérios específicos. (Herdado de DataGridViewCell.)
Método protegidoBorderWidthsRetorna Rectangle que representa as larguras de todas as margens da célula. (Herdado de DataGridViewCell.)
Método protegidoClickUnsharesRowIndica se a linha da célula será unshared quando a célula for clicado. (Herdado de DataGridViewCell.)
Método públicoCloneCria uma cópia exata dessa célula. (Substitui DataGridViewCell.Clone().)
Método protegidoContentClickUnsharesRowIndica se a linha da célula será unshared quando o conteúdo da célula é clicado. (Herdado de DataGridViewCell.)
Método protegidoContentDoubleClickUnsharesRowIndica se a linha da célula será unshared quando o conteúdo da célula é clicado duas vezes. (Herdado de DataGridViewCell.)
Método protegidoCreateAccessibilityInstanceCria um novo objeto acessível para DataGridViewCell. (Herdado de DataGridViewCell.)
Método públicoDetachEditingControlRemove o controle de edição de célula de DataGridView. (Substitui DataGridViewCell.DetachEditingControl().)
Método públicoDispose()Libera os recursos usados por DataGridViewCell. (Herdado de DataGridViewCell.)
Método protegidoDispose(Boolean)Libera os recursos não gerenciados usados pelo DataGridViewCell e opcionalmente libera os recursos gerenciados. (Herdado de DataGridViewCell.)
Método protegidoDoubleClickUnsharesRowIndica se a linha da célula será unshared quando a célula é clicado duas vezes. (Herdado de DataGridViewCell.)
Método protegidoEnterUnsharesRowIndica se a linha pai será unshared quando o foco se mover para a célula. (Herdado de DataGridViewCell.)
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalizeLibera os recursos não gerenciados e executa outras operações de limpeza antes que DataGridViewCell é recuperado pela coleta de lixo. (Herdado de DataGridViewCell.)
Método protegidoGetClipboardContentRecupera o valor formatado da célula para copiar a Clipboard. (Herdado de DataGridViewCell.)
Método públicoGetContentBounds(Int32)Retorna o retângulo delimitador que inclui a área de conteúdo da célula usando Graphics e um estilo padrão da célula atualmente aplicado para a célula. (Herdado de DataGridViewCell.)
Método protegidoGetContentBounds(Graphics, DataGridViewCellStyle, Int32)Retorna o retângulo delimitador que inclui a área de conteúdo da célula, que é calculada usando Graphics especificados e o estilo de célula. (Substitui DataGridViewCell.GetContentBounds(Graphics, DataGridViewCellStyle, Int32).)
Método públicoGetEditedFormattedValueRetorna o atual, valor formatado de célula, independentemente da célula estiver em modo de edição e o valor não foi comprometido. (Herdado de DataGridViewCell.)
Método protegidoGetErrorIconBoundsRetorna o retângulo delimitador que inclui o ícone de erro de célula, se um é exibido. (Substitui DataGridViewCell.GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32).)
Método protegidoGetErrorTextRetorna uma cadeia de caracteres que representa o erro para a célula. (Herdado de DataGridViewCell.)
Método protegidoGetFormattedValueObtém o valor formatado de dados da célula. (Substitui DataGridViewCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts).)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetInheritedContextMenuStripObtém o menu de atalho herdado para a célula atual. (Herdado de DataGridViewCell.)
Método públicoGetInheritedStateRetorna um valor que indica o estado atual de célula como herdado de estado da sua linha e coluna. (Herdado de DataGridViewCell.)
Método públicoGetInheritedStyleObtém o estilo aplicado à célula. (Herdado de DataGridViewCell.)
Método protegidoGetPreferredSizeCalcula o tamanho preferido, em pixels, da célula. (Substitui DataGridViewCell.GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size).)
Método protegidoGetSizeObtém o tamanho da célula. (Herdado de DataGridViewCell.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoGetValueObtém o valor da célula. (Herdado de DataGridViewCell.)
Método públicoInitializeEditingControlAnexa e inicializa o controle de edição hospedado. (Substitui DataGridViewCell.InitializeEditingControl(Int32, Object, DataGridViewCellStyle).)
Método protegidoKeyDownUnsharesRowIndica se a linha pai é unshared se o usuário pressiona uma tecla quando o foco estiver na célula. (Herdado de DataGridViewCell.)
Método públicoKeyEntersEditModeDetermina se o modo de edição deve ser iniciado com base na chave determinada. (Substitui DataGridViewCell.KeyEntersEditMode(KeyEventArgs).)
Método protegidoKeyPressUnsharesRowIndica se uma linha será unshared se uma chave é pressionada enquanto uma célula na linha tem foco. (Herdado de DataGridViewCell.)
Método protegidoKeyUpUnsharesRowIndica se a linha pai é unshared quando o usuário liberar uma chave quando o foco estiver na célula. (Herdado de DataGridViewCell.)
Método protegidoLeaveUnsharesRowIndica se uma linha será unshared quando o foco deixar uma célula na linha. (Herdado de DataGridViewCell.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoMouseClickUnsharesRowIndica se uma linha será unshared se o usuário clica em um botão do mouse quando o cursor está em uma célula na linha. (Herdado de DataGridViewCell.)
Método protegidoMouseDoubleClickUnsharesRowIndica se uma linha será unshared se o usuário clica duas vezes em uma célula na linha. (Herdado de DataGridViewCell.)
Método protegidoMouseDownUnsharesRowIndica se uma linha será unshared quando o usuário pressiona um botão do mouse quando o cursor está em uma célula na linha. (Herdado de DataGridViewCell.)
Método protegidoMouseEnterUnsharesRowIndica se uma linha será unshared quando o ponteiro do mouse se move sobre uma célula na linha. (Herdado de DataGridViewCell.)
Método protegidoMouseLeaveUnsharesRowIndica se uma linha será unshared quando o ponteiro do mouse sai da linha. (Herdado de DataGridViewCell.)
Método protegidoMouseMoveUnsharesRowIndica se uma linha será unshared quando o ponteiro do mouse se move sobre uma célula na linha. (Herdado de DataGridViewCell.)
Método protegidoMouseUpUnsharesRowIndica se uma linha será unshared quando o usuário liberar um botão do mouse quando o cursor está em uma célula na linha. (Herdado de DataGridViewCell.)
Método protegidoOnClickChamado quando a célula for clicado. (Herdado de DataGridViewCell.)
Método protegidoOnContentClickChamado quando o conteúdo da célula são clicados. (Herdado de DataGridViewCell.)
Método protegidoOnContentDoubleClickChamado quando o conteúdo da célula é clicado duas vezes. (Herdado de DataGridViewCell.)
Método protegidoOnDataGridViewChangedChamado quando o DataGridView propriedade da célula é alterado. (Substitui DataGridViewCell.OnDataGridViewChanged().)
Método protegidoOnDoubleClickChamado quando a célula é clicado duas vezes. (Herdado de DataGridViewCell.)
Método protegidoOnEnterChamado quando o foco mover para uma célula. (Substitui DataGridViewCell.OnEnter(Int32, Boolean).)
Método protegidoOnKeyDownChamado quando uma tecla de caractere for pressionada quando o foco estiver em uma célula. (Herdado de DataGridViewCell.)
Método protegidoOnKeyPressChamado quando uma chave for pressionada quando o foco estiver em uma célula. (Herdado de DataGridViewCell.)
Método protegidoOnKeyUpChamado quando uma tecla de caractere é liberada quando o foco estiver em uma célula. (Herdado de DataGridViewCell.)
Método protegidoOnLeaveChamado quando o foco se mover de uma célula. (Substitui DataGridViewCell.OnLeave(Int32, Boolean).)
Método protegidoOnMouseClickChamado quando o usuário clica em um botão do mouse quando o cursor está em uma célula. (Substitui DataGridViewCell.OnMouseClick(DataGridViewCellMouseEventArgs).)
Método protegidoOnMouseDoubleClickChamado quando o usuário clicar duas vezes em um botão do mouse quando o cursor está em uma célula. (Herdado de DataGridViewCell.)
Método protegidoOnMouseDownChamado quando o usuário pressiona um botão do mouse quando o cursor está em uma célula. (Herdado de DataGridViewCell.)
Método protegidoOnMouseEnterChamado quando o ponteiro do mouse se move sobre uma célula. (Substitui DataGridViewCell.OnMouseEnter(Int32).)
Método protegidoOnMouseLeaveChamado quando o ponteiro do mouse sai da célula. (Substitui DataGridViewCell.OnMouseLeave(Int32).)
Método protegidoOnMouseMoveChamado quando o ponteiro do mouse se move dentro de uma célula. (Substitui DataGridViewCell.OnMouseMove(DataGridViewCellMouseEventArgs).)
Método protegidoOnMouseUpChamado quando o usuário liberar um botão do mouse quando o cursor está em uma célula. (Herdado de DataGridViewCell.)
Método protegidoPaintPinta atual DataGridViewComboBoxCell. (Substitui DataGridViewCell.Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts).)
Método protegidoPaintBorderPinta a borda de DataGridViewCellatual. (Herdado de DataGridViewCell.)
Método protegidoPaintErrorIconPinta o ícone de erro de DataGridViewCellatual. (Herdado de DataGridViewCell.)
Método públicoParseFormattedValueConverter um valor formatado para exibição para um valor real da célula. (Substitui DataGridViewCell.ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter).)
Método públicoPositionEditingControlDefina o local e tamanho do controle de edição hospedado por uma célula no controle de DataGridView . (Herdado de DataGridViewCell.)
Método públicoPositionEditingPanelDefina o local e tamanho do painel de edição hospedado pela célula, e retorna os limites normais do controle de edição dentro do painel de edição. (Herdado de DataGridViewCell.)
Método protegidoRaiseCellClickGera o evento DataGridView.CellClick. (Herdado de DataGridViewElement.)
Método protegidoRaiseCellContentClickGera o evento DataGridView.CellContentClick. (Herdado de DataGridViewElement.)
Método protegidoRaiseCellContentDoubleClickGera o evento DataGridView.CellContentDoubleClick. (Herdado de DataGridViewElement.)
Método protegidoRaiseCellValueChangedGera o evento DataGridView.CellValueChanged. (Herdado de DataGridViewElement.)
Método protegidoRaiseDataErrorGera o evento DataGridView.DataError. (Herdado de DataGridViewElement.)
Método protegidoRaiseMouseWheelGera o evento Control.MouseWheel. (Herdado de DataGridViewElement.)
Método protegidoSetValueDefina o valor da célula. (Herdado de DataGridViewCell.)
Método públicoToStringRetorna uma cadeia de caracteres que descreve o objeto atual. (Substitui DataGridViewCell.ToString().)
Superior

O DataGridViewComboBoxCell classe é um tipo especializado de DataGridViewCell usado para exibir um controle de caixa de combinação, que é um campo de edição combinado com um campo de lista de seleção. Atualmente selecionada DataGridViewComboBoxCell hosts um DataGridViewComboBoxEditingControl no qual o usuário pode alterar o valor da célula, supondo que a célula ReadOnly propriedade estiver definida como false.

Ao contrário do ComboBox controle, o DataGridViewComboBoxCell não tem SelectedIndex e SelectedValue propriedades. Em vez disso, selecionar um valor de uma lista drop-down define a célula Value propriedade.

O DataGridViewComboBoxColumn é o tipo de coluna especializado para armazenar células desse tipo. Por padrão, o DataGridViewComboBoxColumn.CellTemplate é inicializado para um novo DataGridViewComboBoxCell. Para as células dentro de uma coluna de padrão após uma existente DataGridViewComboBoxCell, defina a coluna CellTemplate propriedade para a célula a ser usada como padrão.

As propriedades relacionadas a célula da coluna são invólucros para as propriedades nomeadas da mesma forma da célula de modelo. Alterando os valores de propriedade da célula modelo afetará somente células com base no modelo que são adicionadas depois da alteração. Alterando os valores das propriedades relacionadas a célula da coluna, no entanto, irá atualizar a célula do modelo e todas as outras células na coluna e atualizar a exibição da coluna, se necessário.

Normalmente, você trabalhará com o DataGridViewComboBoxColumn digite a menos que deseje substituir valores de coluna para células específicas. As diretrizes descritas na DataGridViewComboBoxColumn tópico de visão geral de classe para preencher a lista drop-down se aplica a ocorrências de célula e de coluna.

Observações para herdeiros

Quando você deriva de DataGridViewComboBoxCell e adicionar novas propriedades à classe derivada, certifique-se de substituir o Clone método para copiar as novas propriedades durante operações de clonagem. Você também deve chamar a classe base Clone método para que as propriedades da classe base são copiadas para a nova célula.

O exemplo de código a seguir demonstra o DataGridViewComboBoxColumn classe, que usa a DataGridViewComboBoxCell classe. Você pode definir a célula DataSource, ValueMember, e DisplayMember propriedades da mesma forma que as propriedades da coluna correspondentes estão definidas neste exemplo. Este exemplo é parte de um maior exemplo disponível na DataGridViewComboBoxColumn tópico de visão geral de classe.


private DataGridViewComboBoxColumn CreateComboBoxColumn()
{
    DataGridViewComboBoxColumn column =
        new DataGridViewComboBoxColumn();
    {
        column.DataPropertyName = ColumnName.TitleOfCourtesy.ToString();
        column.HeaderText = ColumnName.TitleOfCourtesy.ToString();
        column.DropDownWidth = 160;
        column.Width = 90;
        column.MaxDropDownItems = 3;
        column.FlatStyle = FlatStyle.Flat;
    }
    return column;
}

private void SetAlternateChoicesUsingDataSource(DataGridViewComboBoxColumn comboboxColumn)
{
    {
        comboboxColumn.DataSource = RetrieveAlternativeTitles();
        comboboxColumn.ValueMember = ColumnName.TitleOfCourtesy.ToString();
        comboboxColumn.DisplayMember = comboboxColumn.ValueMember;
    }
}

private DataTable RetrieveAlternativeTitles()
{
    return Populate("SELECT distinct TitleOfCourtesy FROM Employees");
}

string connectionString =
    "Integrated Security=SSPI;Persist Security Info=False;" +
    "Initial Catalog=Northwind;Data Source=localhost";

private DataTable Populate(string sqlCommand)
{
    SqlConnection northwindConnection = new SqlConnection(connectionString);
    northwindConnection.Open();

    SqlCommand command = new SqlCommand(sqlCommand, northwindConnection);
    SqlDataAdapter adapter = new SqlDataAdapter();
    adapter.SelectCommand = command;

    DataTable table = new DataTable();
    table.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(table);

    return table;
}

// Using an enum provides some abstraction between column index
// and column name along with compile time checking, and gives
// a handy place to store the column names.
enum ColumnName
{
    EmployeeId,
    LastName,
    FirstName,
    Title,
    TitleOfCourtesy,
    BirthDate,
    HireDate,
    Address,
    City,
    Region,
    PostalCode,
    Country,
    HomePhone,
    Extension,
    Photo,
    Notes,
    ReportsTo,
    PhotoPath,
    OutOfOffice
};


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft