DataGridCheckBoxColumn Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
public ref class DataGridCheckBoxColumn : System::Windows::Controls::DataGridBoundColumnpublic class DataGridCheckBoxColumn : System.Windows.Controls.DataGridBoundColumntype DataGridCheckBoxColumn = class
inherit DataGridBoundColumnPublic Class DataGridCheckBoxColumn
Inherits DataGridBoundColumn- Herança
Exemplos
O exemplo a seguir mostra como adicionar um DataGridCheckBoxColumn. Este exemplo usa um banco de dados como origem e exibe uma coluna de dados boolianos.
<DataGrid Name="DG1" AutoGenerateColumns="False" ItemsSource="{Binding}">
<DataGrid.Columns>
<DataGridCheckBoxColumn Header="Online Order?" IsThreeState="True" Binding="{Binding OnlineOrderFlag}" />
</DataGrid.Columns>
</DataGrid>
Comentários
Use DataGridCheckBoxColumn para exibir colunas de dados boolianos como um CheckBox. A ilustração a seguir mostra um exemplo de DataGridCheckBoxColumn.
Para preencher a coluna, associe a coluna aos dados usando a Binding propriedade. A Binding propriedade é aplicada ao CheckBox elemento criado na coluna. O DataContext elemento para cada célula é o item de dados da linha em que a célula está. Portanto, para configurar a associação, você só precisa definir o Binding.Path. Opcionalmente, você pode especificar um Binding.Converter se a fonte de dados e o destino forem tipos diferentes. Para obter mais informações sobre a associação de dados, consulte Associação de Dados (WPF).
Você pode personalizar as DataGridCheckBoxColumn propriedades por configuração, como Width, Header, IsThreeStatee IsReadOnly.
Se você quiser exibir outros tipos de dados, DataGrid fornecerá os seguintes tipos de coluna:
| Tipo de coluna | Exibição de dados |
|---|---|
| DataGridHyperlinkColumn | Use para exibir dados de URI. |
| DataGridComboBoxColumn | Use para exibir dados de enumeração. |
| DataGridTextColumn | Use para exibir texto. |
Se você quiser usar outros controles em seu DataGrid, você pode criar seus próprios tipos de coluna usando DataGridTemplateColumn.
Construtores
| Nome | Description |
|---|---|
| DataGridCheckBoxColumn() |
Inicializa uma nova instância da classe DataGridCheckBoxColumn. |
Campos
| Nome | Description |
|---|---|
| IsThreeStateProperty |
Identifica a IsThreeState propriedade de dependência. |
Propriedades
| Nome | Description |
|---|---|
| ActualWidth |
Obtém a largura atual da coluna, em unidades independentes do dispositivo (1/96 polegada por unidade). (Herdado de DataGridColumn) |
| Binding |
Obtém ou define a associação que associa a coluna a uma propriedade na fonte de dados. (Herdado de DataGridBoundColumn) |
| CanUserReorder |
Obtém ou define um valor que indica se o usuário pode alterar a posição de exibição da coluna arrastando o cabeçalho da coluna. (Herdado de DataGridColumn) |
| CanUserResize |
Obtém ou define um valor que indica se o usuário pode ajustar a largura da coluna usando o mouse. (Herdado de DataGridColumn) |
| CanUserSort |
Obtém ou define um valor que indica se o usuário pode classificar a coluna clicando no cabeçalho da coluna. (Herdado de DataGridColumn) |
| CellStyle |
Obtém ou define o estilo usado para renderizar células na coluna. (Herdado de DataGridColumn) |
| ClipboardContentBinding |
Obtém ou define o objeto de associação a ser usado ao obter ou definir o conteúdo da célula para a área de transferência. (Herdado de DataGridBoundColumn) |
| DataGridOwner |
Obtém o DataGrid controle que contém esta coluna. (Herdado de DataGridColumn) |
| DefaultEditingElementStyle |
Obtém o valor padrão da EditingElementStyle propriedade. |
| DefaultElementStyle |
Obtém o valor padrão da ElementStyle propriedade. |
| DependencyObjectType |
Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject) |
| Dispatcher |
Obtém o Dispatcher que DispatcherObject está associado. (Herdado de DispatcherObject) |
| DisplayIndex |
Obtém ou define a posição de exibição da coluna relativa às outras colunas no DataGrid. (Herdado de DataGridColumn) |
| DragIndicatorStyle |
Obtém ou define o objeto de estilo a ser aplicado ao cabeçalho da coluna durante uma operação de arrastar. (Herdado de DataGridColumn) |
| EditingElementStyle |
Obtém ou define o estilo usado ao renderizar o elemento que a coluna exibe para uma célula no modo de edição. (Herdado de DataGridBoundColumn) |
| ElementStyle |
Obtém ou define o estilo usado ao renderizar o elemento que a coluna exibe para uma célula que não está no modo de edição. (Herdado de DataGridBoundColumn) |
| Header |
Obtém ou define o conteúdo do cabeçalho da coluna. (Herdado de DataGridColumn) |
| HeaderStringFormat |
Obtém ou define o padrão de formato a ser aplicado ao conteúdo do cabeçalho da coluna. (Herdado de DataGridColumn) |
| HeaderStyle |
Obtém ou define o estilo usado ao renderizar o cabeçalho da coluna. (Herdado de DataGridColumn) |
| HeaderTemplate |
Obtém ou define o modelo que define a representação visual do cabeçalho da coluna. (Herdado de DataGridColumn) |
| HeaderTemplateSelector |
Obtém ou define o objeto que seleciona qual modelo usar para o cabeçalho de coluna. (Herdado de DataGridColumn) |
| IsAutoGenerated |
Obtém um valor que indica se a coluna é gerada automaticamente. (Herdado de DataGridColumn) |
| IsFrozen |
Obtém um valor que indica se a coluna é impedida de rolar horizontalmente. (Herdado de DataGridColumn) |
| IsReadOnly |
Obtém ou define um valor que indica se as células na coluna podem ser editadas. (Herdado de DataGridColumn) |
| IsSealed |
Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject) |
| IsThreeState |
Obtém ou define um valor que indica se os controles hospedados CheckBox habilitam três ou dois estados. |
| MaxWidth |
Obtém ou define a restrição de largura máxima da coluna. (Herdado de DataGridColumn) |
| MinWidth |
Obtém ou define a restrição de largura mínima da coluna. (Herdado de DataGridColumn) |
| SortDirection |
Obtém ou define a direção de classificação (crescente ou decrescente) da coluna. (Herdado de DataGridColumn) |
| SortMemberPath |
Obtém ou define um nome de propriedade, ou uma hierarquia delimitada por período de nomes de propriedade, que indica o membro pelo qual classificar. (Herdado de DataGridColumn) |
| Visibility |
Obtém ou define a visibilidade da coluna. (Herdado de DataGridColumn) |
| Width |
Obtém ou define a largura da coluna ou o modo de dimensionamento automático. (Herdado de DataGridColumn) |
Métodos
| Nome | Description |
|---|---|
| CancelCellEdit(FrameworkElement, Object) |
Faz com que a célula que está sendo editada reverta para o valor original não editado. (Herdado de DataGridColumn) |
| CheckAccess() |
Determina se o thread de chamada tem acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject) |
| CoerceValue(DependencyProperty) |
Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer CoerceValueCallback função especificada nos metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject) |
| CommitCellEdit(FrameworkElement) |
Executa qualquer validação necessária antes de sair do modo de edição de célula. (Herdado de DataGridColumn) |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente ao atual DependencyObject. (Herdado de DependencyObject) |
| GenerateEditingElement(DataGridCell, Object) |
Obtém um CheckBox controle associado ao valor da propriedade da Binding coluna. |
| GenerateElement(DataGridCell, Object) |
Obtém um controle somente CheckBox leitura associado ao valor da propriedade da Binding coluna. |
| GetCellContent(DataGridRow) |
Recupera o valor da Content propriedade da célula na interseção desta coluna e da linha especificada. (Herdado de DataGridColumn) |
| GetCellContent(Object) |
Obtém o Content valor da propriedade da célula na interseção desta coluna e da linha que representa o item de dados especificado. (Herdado de DataGridColumn) |
| GetHashCode() |
Obtém um código hash para isso DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente.DependencyObject (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| NotifyPropertyChanged(String) |
Notifica o DataGrid que contém esta coluna de que uma propriedade de coluna foi alterada. (Herdado de DataGridColumn) |
| OnBindingChanged(BindingBase, BindingBase) |
Notifica quando o DataGrid valor da Binding propriedade é alterado. (Herdado de DataGridBoundColumn) |
| OnCoerceIsReadOnly(Boolean) |
Determina o valor da IsReadOnly propriedade com base nas regras de propriedade da grade de dados que contém essa coluna. (Herdado de DataGridBoundColumn) |
| OnCopyingCellClipboardContent(Object) |
Aciona o evento CopyingCellClipboardContent. (Herdado de DataGridColumn) |
| OnPastingCellClipboardContent(Object, Object) |
Aciona o evento PastingCellClipboardContent. (Herdado de DataGridColumn) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Invocado sempre que o valor efetivo de qualquer propriedade de dependência tiver DependencyObject sido atualizado. A propriedade de dependência específica que foi alterada é relatada nos dados do evento. (Herdado de DependencyObject) |
| PrepareCellForEdit(FrameworkElement, RoutedEventArgs) |
Chamado quando uma célula na coluna entra no modo de edição. |
| ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject) |
| RefreshCellContent(FrameworkElement, String) |
Atualiza o conteúdo de uma célula na coluna em resposta a uma alteração de valor de propriedade de coluna. |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente leitura, especificada pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| VerifyAccess() |
Impõe que o thread de chamada tenha acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
Eventos
| Nome | Description |
|---|---|
| CopyingCellClipboardContent |
Ocorre depois que o conteúdo da área de transferência da célula é preparado. (Herdado de DataGridColumn) |
| PastingCellClipboardContent |
Ocorre antes que o conteúdo da área de transferência seja movido para a célula. (Herdado de DataGridColumn) |
