DataGridCheckBoxColumn Classe

Definição

Representa uma coluna DataGrid que hospeda controles CheckBox em suas células.Represents a DataGrid column that hosts CheckBox controls in its cells.

public ref class DataGridCheckBoxColumn : System::Windows::Controls::DataGridBoundColumn
public class DataGridCheckBoxColumn : System.Windows.Controls.DataGridBoundColumn
type DataGridCheckBoxColumn = class
    inherit DataGridBoundColumn
Public Class DataGridCheckBoxColumn
Inherits DataGridBoundColumn
Herança

Exemplos

O exemplo a seguir mostra como adicionar um DataGridCheckBoxColumn.The following example shows how to add a DataGridCheckBoxColumn. Este exemplo usa um banco de dados como a origem e exibe uma coluna de dado booliano.This example uses a database as the source and displays a column of Boolean data.

<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.Use DataGridCheckBoxColumn to display columns of Boolean data as a CheckBox. A ilustração a seguir mostra um exemplo de DataGridCheckBoxColumn.The following illustration shows an example of DataGridCheckBoxColumn.

Uma coluna DataGridCheckBoxA DataGridCheckBox column

Para preencher a coluna, associe a coluna aos dados usando a propriedade Binding.To populate the column, bind the column to the data by using the Binding property. A propriedade Binding é aplicada ao elemento CheckBox criado na coluna.The Binding property is applied to the CheckBox element created in the column. O DataContext para o elemento em cada célula é o item de dados para a linha em que a célula está.The DataContext for the element in each cell is the data item for the row the cell is in. Portanto, para configurar a associação, você só precisa definir o Binding.Path.Therefore, to set up the binding you only have to set the Binding.Path. Opcionalmente, você pode especificar um Binding.Converter se a fonte de dados e o destino forem tipos diferentes.Optionally, you can specify a Binding.Converter if your data source and target are different types. Para obter mais informações sobre vinculação de dados, consulte vinculação de dados (WPF).For more information about data binding, see Data Binding (WPF).

Você pode personalizar o DataGridCheckBoxColumn definindo propriedades, como Width, Header, IsThreeStatee IsReadOnly.You can customize the DataGridCheckBoxColumn by setting properties, such as Width, Header, IsThreeState, and IsReadOnly.

Se você quiser exibir outros tipos de dados, DataGrid fornecerá os seguintes tipos de coluna:If you want to display other types of data, DataGrid provides the following column types:

Tipo de colunaColumn Type Exibição de dadosData Display
DataGridHyperlinkColumn Use para exibir dados de URI.Use to display URI data.
DataGridComboBoxColumn Use para exibir dados de enumeração.Use to display enumeration data.
DataGridTextColumn Use para exibir texto.Use to display text.

Se você quiser usar outros controles em seu DataGrid, poderá criar seus próprios tipos de coluna usando DataGridTemplateColumn.If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

Construtores

DataGridCheckBoxColumn()

Inicializa uma nova instância da classe DataGridCheckBoxColumn.Initializes a new instance of the DataGridCheckBoxColumn class.

Campos

IsThreeStateProperty

Identifica a propriedade de dependência IsThreeState.Identifies the IsThreeState dependency property.

Propriedades

ActualWidth

Obtém a largura atual da coluna, em unidades independentes de dispositivo (1/96 polegada por unidade)device-independent units (1/96th inch per unit).Gets the current width of the column, in unidades independentes de dispositivo (1/96 polegada por unidade)device-independent units (1/96th inch per unit).

(Herdado de DataGridColumn)
Binding

Obtém ou define a associação que associa a coluna com a propriedade na fonte de dados.Gets or sets the binding that associates the column with a property in the data source.

(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 seu cabeçalho.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(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.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Herdado de DataGridColumn)
CanUserSort

Obtém ou define um valor que indica se o usuário pode classificar a coluna clicando no seu cabeçalho.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Herdado de DataGridColumn)
CellStyle

Obtém ou define o estilo usado para renderizar as células da coluna.Gets or sets the style that is used to render cells in the column.

(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.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Herdado de DataGridBoundColumn)
DataGridOwner

Obtém o controle DataGrid que contém esta coluna.Gets the DataGrid control that contains this column.

(Herdado de DataGridColumn)
DefaultEditingElementStyle

Obtém o valor padrão da propriedade EditingElementStyle.Gets the default value of the EditingElementStyle property.

DefaultElementStyle

Obtém o valor padrão da propriedade ElementStyle.Gets the default value of the ElementStyle property.

DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLRCLR dessa instância.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Herdado de DependencyObject)
Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Herdado de DispatcherObject)
DisplayIndex

Obtém ou define a posição de exibição da coluna em relação às outras colunas do DataGrid.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Herdado de DataGridColumn)
DragIndicatorStyle

Obtém ou define o objeto de estilo para aplicar ao cabeçalho de coluna durante uma operação de arrastar.Gets or sets the style object to apply to the column header during a drag operation.

(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.Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(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.Gets or sets the style that is used when rendering the element that the column displays for a cell that is not in editing mode.

(Herdado de DataGridBoundColumn)
Header

Obtém ou define o conteúdo do cabeçalho da coluna.Gets or sets the content of the column header.

(Herdado de DataGridColumn)
HeaderStringFormat

Obtém ou define o padrão de formato a ser aplicado ao conteúdo do cabeçalho de coluna.Gets or sets the format pattern to apply to the content of the column header.

(Herdado de DataGridColumn)
HeaderStyle

Obtém ou define o estilo usado ao renderizar o cabeçalho de coluna.Gets or sets the style that is used when rendering the column header.

(Herdado de DataGridColumn)
HeaderTemplate

Obtém ou define o modelo que define a representação visual do cabeçalho de coluna.Gets or sets the template that defines the visual representation of the column header.

(Herdado de DataGridColumn)
HeaderTemplateSelector

Obtém ou define o objeto que seleciona qual modelo usar para o cabeçalho de coluna.Gets or sets the object that selects which template to use for the column header.

(Herdado de DataGridColumn)
IsAutoGenerated

Obtém um valor que indica se a coluna é somente autogerenciada.Gets a value that indicates whether the column is auto-generated.

(Herdado de DataGridColumn)
IsFrozen

Obtém um valor que indica se a coluna está impedida de rolar horizontalmente.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Herdado de DataGridColumn)
IsReadOnly

Obtém ou define um valor que indica se as células na coluna podem ser editadas.Gets or sets a value that indicates whether cells in the column can be edited.

(Herdado de DataGridColumn)
IsSealed

Obtém um valor que indica se essa instância está validada no momento (somente leitura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Herdado de DependencyObject)
IsThreeState

Obtém ou define um valor que indica se os controles CheckBox hospedados habilitam três ou dois estados.Gets or sets a value that indicates whether the hosted CheckBox controls enable three states or two.

MaxWidth

Obtém ou define a restrição de largura máxima da coluna.Gets or sets the maximum width constraint of the column.

(Herdado de DataGridColumn)
MinWidth

Obtém ou define a restrição de largura mínima da coluna.Gets or sets the minimum width constraint of the column.

(Herdado de DataGridColumn)
SortDirection

Obtém ou define a direção da classificação (crescente ou decrescente) da coluna.Gets or sets the sort direction (ascending or descending) of the column.

(Herdado de DataGridColumn)
SortMemberPath

Obté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.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Herdado de DataGridColumn)
Visibility

Obtém ou define a visibilidade da coluna.Gets or sets the visibility of the column.

(Herdado de DataGridColumn)
Width

Obtém ou define a largura da coluna ou o modo de dimensionamento automático.Gets or sets the column width or automatic sizing mode.

(Herdado de DataGridColumn)

Métodos

CancelCellEdit(FrameworkElement, Object)

Faz com que a célula que está sendo editada reverta para o valor original não editado.Causes the cell being edited to revert to the original, unedited value.

(Herdado de DataGridColumn)
CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Herdado de DependencyObject)
CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada.Coerces the value of the specified dependency property. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Herdado de DependencyObject)
CommitCellEdit(FrameworkElement)

Realiza a validação necessária antes de sair do modo de edição da célula.Performs any required validation before exiting cell editing mode.

(Herdado de DataGridColumn)
Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Herdado de DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Obtém um controle CheckBox associado ao valor da propriedade Binding da coluna.Gets a CheckBox control that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Obtém um novo controle somente leitura CheckBox associado ao valor da propriedade Binding da coluna.Gets a read-only CheckBox control that is bound to the column's Binding property value.

GetCellContent(DataGridRow)

Recupera o valor da propriedade Content da célula na interseção dessa coluna e da linha especificada.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Herdado de DataGridColumn)
GetCellContent(Object)

Obtém o valor da propriedade Content da célula na interseção dessa coluna e da linha que representa o item de dados especificado.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Herdado de DataGridColumn)
GetHashCode()

Obtém o código hash para esse DependencyObject.Gets a hash code for this DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Herdado de DependencyObject)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificada.Re-evaluates the effective value for the specified dependency property.

(Herdado de DependencyObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
NotifyPropertyChanged(String)

Notifica o DataGrid que contém essa coluna de que uma propriedade da coluna foi alterada.Notifies the DataGrid that contains this column that a column property has changed.

(Herdado de DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Notifica o DataGrid quando o valor da propriedade Binding é alterado.Notifies the DataGrid when the value of the Binding property changes.

(Herdado de DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Determina o valor da propriedade IsReadOnly com base nas regras de propriedade da grade de dados que contém essa coluna.Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Herdado de DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)

Aciona o evento CopyingCellClipboardContent.Raises the CopyingCellClipboardContent event.

(Herdado de DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Aciona o evento PastingCellClipboardContent.Raises the PastingCellClipboardContent event.

(Herdado de DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizada.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. A propriedade de dependência específica que mudou é relatada os dados do evento.The specific dependency property that changed is reported in the event data.

(Herdado de DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Chamado quando uma célula na coluna entra em modo de edição.Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.Returns the local value of a dependency property, if it exists.

(Herdado de DependencyObject)
RefreshCellContent(FrameworkElement, String)

Atualiza o conteúdo de uma célula na coluna em resposta a uma alteração de valor da propriedade de coluna.Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.Sets the value of a dependency property without changing its value source.

(Herdado de DependencyObject)
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

(Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(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.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Herdado de DependencyObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)

Eventos

CopyingCellClipboardContent

Ocorre depois que o conteúdo da Área de Transferência é preparado.Occurs after the cell clipboard content is prepared.

(Herdado de DataGridColumn)
PastingCellClipboardContent

Ocorre antes de o conteúdo da área de transferência ser movido para a célula.Occurs before the clipboard content is moved to the cell.

(Herdado de DataGridColumn)

Aplica-se a

Veja também