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 DataGridCheckBoxColumn

Representa um DataGrid coluna que hospeda CheckBox controles em suas células.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (em PresentationFramework.dll)
XMLNS para XAML http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public class DataGridCheckBoxColumn : DataGridBoundColumn
<DataGridCheckBoxColumn .../>

O tipo DataGridCheckBoxColumn expõe os membros a seguir.

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

  NomeDescrição
Propriedade públicaActualWidthObtém a largura atual da coluna, em unidades independentes de dispositivo (1/96 polegada por unidade). (Herdado de DataGridColumn.)
Propriedade públicaBindingObtém ou define a associação que associa a coluna com a propriedade na fonte de dados. (Herdado de DataGridBoundColumn.)
Propriedade públicaCanUserReorderObtém ou define um valor que indica se o usuário pode alterar a posição de exibição da coluna arrastando o seu cabeçalho. (Herdado de DataGridColumn.)
Propriedade públicaCanUserResizeObtém ou define um valor que indica se o usuário pode ajustar a largura da coluna com o mouse. (Herdado de DataGridColumn.)
Propriedade públicaCanUserSortObtém ou define um valor que indica se o usuário pode classificar a coluna clicando no seu cabeçalho. (Herdado de DataGridColumn.)
Propriedade públicaCellStyleObtém ou define o estilo que é usado para processar as células na coluna. (Herdado de DataGridColumn.)
Propriedade públicaClipboardContentBindingObtém ou define o objeto de vinculação para usar ao obter ou definir o conteúdo da célula para a área de transferência. (Herdado de DataGridBoundColumn.)
Propriedade protegidaDataGridOwnerObtém o DataGrid o controle que contém essa coluna. (Herdado de DataGridColumn.)
Propriedade públicaMembro estáticoDefaultEditingElementStyleObtém o valor padrão de EditingElementStyle propriedade.
Propriedade públicaMembro estáticoDefaultElementStyleObtém o valor padrão de ElementStyle propriedade.
Propriedade públicaDependencyObjectType Obtém o DependencyObjectType que envolve o tipo de instância da CLR. (Herdado de DependencyObject.)
Propriedade públicaDispatcherObtém o Dispatcher esse DispatcherObject está associado. (Herdado de DispatcherObject.)
Propriedade públicaDisplayIndexObtém ou define a posição de coluna em relação a outras colunas na exibição do DataGrid. (Herdado de DataGridColumn.)
Propriedade públicaDragIndicatorStyleObtém ou define o objeto de estilo para aplicar ao cabeçalho da coluna durante uma operação de arrastar. (Herdado de DataGridColumn.)
Propriedade públicaEditingElementStyleObtém ou define o estilo que é usado quando o elemento que a coluna exibe para uma célula no modo de edição de processamento. (Herdado de DataGridBoundColumn.)
Propriedade públicaElementStyleObtém ou define o estilo que é usado quando o elemento que a coluna exibe para uma célula que não esteja no modo de edição de processamento. (Herdado de DataGridBoundColumn.)
Propriedade públicaHeaderObtém ou define o conteúdo do cabeçalho da coluna. (Herdado de DataGridColumn.)
Propriedade públicaHeaderStringFormatObtém ou define o formato padrão para aplicar ao conteúdo do cabeçalho da coluna. (Herdado de DataGridColumn.)
Propriedade públicaHeaderStyleObtém ou define o estilo que é usado durante a renderização no cabeçalho da coluna. (Herdado de DataGridColumn.)
Propriedade públicaHeaderTemplateObtém ou define o modelo que define a representação visual do cabeçalho da coluna. (Herdado de DataGridColumn.)
Propriedade públicaHeaderTemplateSelectorObtém ou define o objeto que seleciona o modelo a ser usado no cabeçalho da coluna. (Herdado de DataGridColumn.)
Propriedade públicaIsAutoGeneratedObtém um valor que indica se a coluna é gerado automaticamente. (Herdado de DataGridColumn.)
Propriedade públicaIsFrozenObtém um valor que indica se a coluna é impedida de rolagem horizontal. (Herdado de DataGridColumn.)
Propriedade públicaIsReadOnlyObtém ou define um valor que indica se as células na coluna podem ser editadas. (Herdado de DataGridColumn.)
Propriedade públicaIsSealed Obtém um valor que indica se essa instância atualmente é selada (somente leitura). (Herdado de DependencyObject.)
Propriedade públicaIsThreeStateObtém ou define um valor que indica se o host CheckBox controles permitem três estados ou dois.
Propriedade públicaMaxWidthObtém ou define a restrição de largura máxima da coluna. (Herdado de DataGridColumn.)
Propriedade públicaMinWidthObtém ou define a restrição de largura mínima da coluna. (Herdado de DataGridColumn.)
Propriedade públicaSortDirectionObtém ou define a direção de classificação (ascendente ou descendente) da coluna. (Herdado de DataGridColumn.)
Propriedade públicaSortMemberPathObtém ou define um nome de propriedade, ou uma hierarquia de nomes de propriedade baseada na delimitação por ponto, que indica o membro pelo qual classificar. (Herdado de DataGridColumn.)
Propriedade públicaVisibilityObtém ou define a visibilidade da coluna. (Herdado de DataGridColumn.)
Propriedade públicaWidthObtém ou define a largura da coluna ou o modo de dimensionamento automático. (Herdado de DataGridColumn.)
Superior

  NomeDescrição
Método protegidoCancelCellEditFaz com que a célula que está sendo editada para reverter para o valor original, não-editado. (Herdado de DataGridColumn.)
Método públicoCheckAccessDetermina se o segmento de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject.)
Método públicoClearValue(DependencyProperty)Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador da DependencyProperty. (Herdado de DependencyObject.)
Método públicoClearValue(DependencyPropertyKey)Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por uma DependencyPropertyKey. (Herdado de DependencyObject.)
Método públicoCoerceValueConverte o valor especificado propriedade de dependência. Isso é feito chamando qualquer CoerceValueCallback especificada na metadados de propriedade para a propriedade de dependência conforme ela existe na chamada de função DependencyObject. (Herdado de DependencyObject.)
Método protegidoCommitCellEditExecuta qualquer validação necessária antes de sair do modo de edição de célula. (Herdado de DataGridColumn.)
Método públicoEqualsDetermina se um fornecido DependencyObject é equivalente à atual DependencyObject. (Herdado de DependencyObject.)
Método protegidoFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método protegidoGenerateEditingElementObtém um CheckBox controle está vinculado à coluna Binding o valor da propriedade. (Substitui DataGridColumn.GenerateEditingElement(DataGridCell, Object).)
Método protegidoGenerateElementObtém somente leitura CheckBox controle está vinculado à coluna Binding o valor da propriedade. (Substitui DataGridColumn.GenerateElement(DataGridCell, Object).)
Método públicoGetCellContent(DataGridRow)Recupera o Content o valor da propriedade para a célula na interseção desta coluna e a linha especificada. (Herdado de DataGridColumn.)
Método públicoGetCellContent(Object)Obtém o Content o valor da propriedade para a célula na interseção da coluna e a linha que representa o item de dados especificado. (Herdado de DataGridColumn.)
Método públicoGetHashCodeObtém um código de hash para este DependencyObject. (Herdado de DependencyObject.)
Método públicoGetLocalValueEnumeratorCria um enumerador especializado para determinar quais propriedades de dependência localmente têm definir valores nessa DependencyObject. (Herdado de DependencyObject.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoGetValueRetorna o valor atual de efetivo de um propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject.)
Método públicoInvalidatePropertyAvalia o valor efetivo de propriedade de dependência especificado (Herdado de DependencyObject.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoNotifyPropertyChangedNotifica o DataGrid que contém esta coluna em que uma propriedade de coluna foi alterado. (Herdado de DataGridColumn.)
Método protegidoOnBindingChangedNotifica o DataGrid quando o valor da Binding as alterações de propriedade. (Herdado de DataGridBoundColumn.)
Método protegidoOnCoerceIsReadOnlyDetermina o valor da IsReadOnly propriedade com base em regras de propriedade da grade de dados que contém essa coluna. (Herdado de DataGridBoundColumn.)
Método públicoOnCopyingCellClipboardContentGera o evento CopyingCellClipboardContent. (Herdado de DataGridColumn.)
Método públicoOnPastingCellClipboardContentGera o evento PastingCellClipboardContent. (Herdado de DataGridColumn.)
Método protegidoOnPropertyChangedChamado sempre que o valor efetivo de qualquer propriedade de dependência sobre isso DependencyObject foi atualizado. A propriedade de dependência específicos que alterado é relatada nos dados de evento. (Herdado de DependencyObject.)
Método protegidoPrepareCellForEditChamado quando uma célula na coluna entra em modo de edição. (Substitui DataGridColumn.PrepareCellForEdit(FrameworkElement, RoutedEventArgs).)
Método públicoReadLocalValueRetorna o valor de local de um propriedade de dependência, se ele existir. (Herdado de DependencyObject.)
Método protegidoRefreshCellContentAtualiza o conteúdo de uma célula na coluna em resposta a uma alteração de valor de propriedade de coluna. (Substitui DataGridBoundColumn.RefreshCellContent(FrameworkElement, String).)
Método públicoSetCurrentValueDefine o valor de um propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject.)
Método públicoSetValue(DependencyProperty, Object)Define o valor de local de um propriedade de dependência, especificado por seu identificador de propriedade de dependência. (Herdado de DependencyObject.)
Método públicoSetValue(DependencyPropertyKey, Object)Define o valor de local de somente leitura propriedade de dependência, especificado pelo DependencyPropertyKey identificador de propriedade de dependência. (Herdado de DependencyObject.)
Método protegidoShouldSerializePropertyRetorna um valor que indica se os processos de serialização devem serializar o valor para o fornecido propriedade de dependência. (Herdado de DependencyObject.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Método públicoVerifyAccessImpõe que o segmento de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject.)
Superior

  NomeDescrição
Evento públicoCopyingCellClipboardContentOcorre depois que o conteúdo da área de transferência da célula está preparado. (Herdado de DataGridColumn.)
Evento públicoPastingCellClipboardContentOcorre antes que o conteúdo da área de transferência é movido para a célula. (Herdado de DataGridColumn.)
Superior

  NomeDescrição
Campo públicoMembro estáticoIsThreeStatePropertyIdentifica o IsThreeState propriedade de dependência.
Superior

Use DataGridCheckBoxColumn para exibir as colunas de dados booleanas como um CheckBox. A ilustração a seguir mostra um exemplo de DataGridCheckBoxColumn.

A DataGridCheckBox column

Para preencher a coluna, vincular a coluna de dados usando o Binding propriedade. O Binding propriedade é aplicada para o CheckBox elemento criado na coluna. O DataContext para o elemento em cada célula é o item de dados para a linha a célula estiver em. Portanto, para configurar a ligação você só tem que definir a Binding.Path. Opcionalmente, você pode especificar um Binding.Converter se sua fonte de dados e de destino são os diferentes tipos. Para obter mais informações, consulte Associação de dados (WPF).

Você pode personalizar o DataGridCheckBoxColumn , definindo propriedades, como Width, Header, IsThreeState, e IsReadOnly.

Se você desejar exibir outros tipos de dados, DataGrid fornece os seguintes tipos de coluna:

Tipo de coluna

Exibição de dados

DataGridHyperlinkColumn

Use para exibir dados URI.

DataGridComboBoxColumn

Use para exibir dados de enumeração.

DataGridTextColumn

Use para exibir o texto.

Se você quiser usar outros controles em seu DataGrid, você pode criar seus próprios tipos de coluna usando DataGridTemplateColumn.

O exemplo a seguir mostra como adicionar um DataGridCheckBoxColumn. Este exemplo usa um banco de dados como a fonte e exibe uma coluna de dados booleanos.


<DataGrid Name="DG1" AutoGenerateColumns="False" ItemsSource="{Binding}">
    <DataGrid.Columns>
        <DataGridCheckBoxColumn Header="Online Order?" IsThreeState="True" Binding="{Binding OnlineOrderFlag}" />
    </DataGrid.Columns>
</DataGrid>


.NET Framework

Com suporte em: 4.5, 4

.NET Framework Client Profile

Com suporte em: 4

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
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft