DataGridCheckBoxColumn 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.
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 seguinte mostra como adicionar um DataGridCheckBoxColumn. Este exemplo utiliza uma base de dados como fonte e apresenta 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>
Observações
Use DataGridCheckBoxColumn para mostrar colunas de dados booleanos como um CheckBox. A ilustração seguinte mostra um exemplo de DataGridCheckBoxColumn.
Para preencher a coluna, vincule a coluna aos dados usando a Binding propriedade . A Binding propriedade é aplicada ao CheckBox elemento criado na coluna. O DataContext para o elemento em cada célula é o elemento de dados para a linha em que a célula está. Portanto, para configurar a ligação, basta definir o Binding.Path. Opcionalmente, pode especificar se Binding.Converter a sua fonte de dados e o destino são de tipos diferentes. Para mais informações sobre ligação de dados, consulte Data Binding (WPF).
Pode personalizar o DataGridCheckBoxColumn definindo propriedades, como Width, Header, IsThreeState, e IsReadOnly.
Se quiser apresentar outros tipos de dados, DataGrid fornece os seguintes tipos de colunas:
| Tipo de Coluna | Exibição de dados |
|---|---|
| DataGridHyperlinkColumn | Use para mostrar dados de URI. |
| DataGridComboBoxColumn | Use para mostrar dados de enumeração. |
| DataGridTextColumn | Usa para mostrar texto. |
Se quiser usar outros controlos no seu DataGrid, pode criar os seus próprios tipos de coluna usando DataGridTemplateColumn.
Construtores
| Name | Description |
|---|---|
| DataGridCheckBoxColumn() |
Inicializa uma nova instância da DataGridCheckBoxColumn classe. |
Campos
| Name | Description |
|---|---|
| IsThreeStateProperty |
Identifica a IsThreeState propriedade de dependência. |
Propriedades
| Name | Description |
|---|---|
| ActualWidth |
Obtém a largura atual da coluna, em unidades independentes do dispositivo (1/96 de polegada por unidade). (Herdado de DataGridColumn) |
| Binding |
Obtém ou define a ligação que associa a coluna a uma propriedade na fonte de dados. (Herdado de DataGridBoundColumn) |
| CanUserReorder |
Recebe ou define um valor que indica se o utilizador pode alterar a posição de exibição da coluna arrastando o cabeçalho da coluna. (Herdado de DataGridColumn) |
| CanUserResize |
Recebe ou define um valor que indica se o utilizador pode ajustar a largura da coluna usando o rato. (Herdado de DataGridColumn) |
| CanUserSort |
Recebe ou define um valor que indica se o utilizador pode ordenar a coluna clicando no cabeçalho da coluna. (Herdado de DataGridColumn) |
| CellStyle |
Obtém ou define o estilo que é usado para renderizar células na coluna. (Herdado de DataGridColumn) |
| ClipboardContentBinding |
Obtém ou define o objeto de ligação para usar ao obter ou definir o conteúdo da célula para a área de transferência. (Herdado de DataGridBoundColumn) |
| DataGridOwner |
Obtém o DataGrid controlo 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 envolve o tipo CLR desta instância. (Herdado de DependencyObject) |
| Dispatcher |
Percebe o Dispatcher que isto DispatcherObject está associado. (Herdado de DispatcherObject) |
| DisplayIndex |
Obtém ou define a posição de exibição da coluna em relação às outras colunas do DataGrid. (Herdado de DataGridColumn) |
| DragIndicatorStyle |
Obtém ou define o objeto style para aplicar ao cabeçalho da coluna durante uma operação de arrasto. (Herdado de DataGridColumn) |
| EditingElementStyle |
Obtém ou define o estilo que é usado ao renderizar o elemento que a coluna apresenta para uma célula em modo de edição. (Herdado de DataGridBoundColumn) |
| ElementStyle |
Obtém ou define o estilo usado ao renderizar o elemento que a coluna apresenta para uma célula que não está em 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 aplicar 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 da coluna. (Herdado de DataGridColumn) |
| IsAutoGenerated |
Obtém um valor que indica se a coluna é gerada automaticamente. (Herdado de DataGridColumn) |
| IsFrozen |
Recebe um valor que indica se a coluna está impedida de deslocar-se horizontalmente. (Herdado de DataGridColumn) |
| IsReadOnly |
Recebe ou define um valor que indica se as células da coluna podem ser editadas. (Herdado de DataGridColumn) |
| IsSealed |
Recebe um valor que indica se esta instância está atualmente selada (apenas leitura). (Herdado de DependencyObject) |
| IsThreeState |
Recebe ou define um valor que indica se os controlos alojados CheckBox permitem três estados ou dois. |
| MaxWidth |
Obtém ou define a restrição máxima de largura 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 ordenação (ascendente ou descendente) da coluna. (Herdado de DataGridColumn) |
| SortMemberPath |
Obtém ou define um nome de propriedade, ou uma hierarquia delimitada por períodos de nomes de propriedades, que indica o membro por que se deve ordenar. (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 automático de dimensionamento. (Herdado de DataGridColumn) |
Métodos
| Name | Description |
|---|---|
| CancelCellEdit(FrameworkElement, Object) |
Faz com que a célula que está a ser editada volte ao valor original, não editado. (Herdado de DataGridColumn) |
| CheckAccess() |
Determina se o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey. (Herdado de DependencyObject) |
| CoerceValue(DependencyProperty) |
Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject. (Herdado de DependencyObject) |
| CommitCellEdit(FrameworkElement) |
Realiza qualquer validação necessária antes de sair do modo de edição de células. (Herdado de DataGridColumn) |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject. (Herdado de DependencyObject) |
| GenerateEditingElement(DataGridCell, Object) |
Obtém um CheckBox controlo que está ligado ao valor da propriedade da Binding coluna. |
| GenerateElement(DataGridCell, Object) |
Obtém um controlo de apenas CheckBox leitura que está ligado ao valor da propriedade da Binding coluna. |
| GetCellContent(DataGridRow) |
Recupera o Content valor da propriedade da célula na interseção desta coluna com a linha especificada. (Herdado de DataGridColumn) |
| GetCellContent(Object) |
Obtém o Content valor da propriedade da célula na interseção desta coluna com a linha que representa o elemento de dados especificado. (Herdado de DataGridColumn) |
| GetHashCode() |
Obtém um código de hash para isto DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject. (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Devolve 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 atual Object. (Herdado de Object) |
| NotifyPropertyChanged(String) |
Notifica o DataGrid que contém esta coluna que uma propriedade da coluna mudou. (Herdado de DataGridColumn) |
| OnBindingChanged(BindingBase, BindingBase) |
Notifica quando DataGrid o valor da Binding propriedade muda. (Herdado de DataGridBoundColumn) |
| OnCoerceIsReadOnly(Boolean) |
Determina o valor da IsReadOnly propriedade com base nas regras da propriedade da grelha de dados que contém esta coluna. (Herdado de DataGridBoundColumn) |
| OnCopyingCellClipboardContent(Object) |
Eleva o CopyingCellClipboardContent evento. (Herdado de DataGridColumn) |
| OnPastingCellClipboardContent(Object, Object) |
Eleva o PastingCellClipboardContent evento. (Herdado de DataGridColumn) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada nos dados do evento. (Herdado de DependencyObject) |
| PrepareCellForEdit(FrameworkElement, RoutedEventArgs) |
Chamada quando uma célula na coluna entra em modo de edição. |
| ReadLocalValue(DependencyProperty) |
Devolve o valor local de uma propriedade de dependência, se esta existir. (Herdado de DependencyObject) |
| RefreshCellContent(FrameworkElement, String) |
Atualiza o conteúdo de uma célula na coluna em resposta a uma alteração no valor da propriedade da coluna. |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor de uma propriedade de dependência sem alterar a sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| VerifyAccess() |
Faz cumprir que o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
evento
| Name | Description |
|---|---|
| CopyingCellClipboardContent |
Ocorre depois de preparar o conteúdo da prancheta da célula. (Herdado de DataGridColumn) |
| PastingCellClipboardContent |
Ocorre antes de o conteúdo da prancheta ser transferido para a célula. (Herdado de DataGridColumn) |