DataGridTextColumn Classe

Definizione

Rappresenta una colonna DataGrid che ospita contenuto testuale nelle celle.

public ref class DataGridTextColumn : System::Windows::Controls::DataGridBoundColumn
public class DataGridTextColumn : System.Windows.Controls.DataGridBoundColumn
type DataGridTextColumn = class
    inherit DataGridBoundColumn
Public Class DataGridTextColumn
Inherits DataGridBoundColumn
Ereditarietà

Esempio

Nell'esempio seguente viene creato un DataGrid con colonne di testo personalizzate e vengono utilizzati dati XML come origine. Nella figura precedente di questo argomento viene illustrato come viene visualizzato questo codice. Per altre informazioni sull'associazione a dati XML, vedere Procedura: Eseguire il binding ai dati XML usando un xmlDataProvider e le query XPath.

<Window.Resources>
    <XmlDataProvider x:Key="customerdata" Source="customers.xml" XPath="Data" />
</Window.Resources>
<Grid>
    <DataGrid AutoGenerateColumns="False" ItemsSource="{Binding Source={StaticResource customerdata}, XPath=Customer}">
        <DataGrid.Columns>
            <DataGridTextColumn Header="First Name" Binding="{Binding XPath=@FirstName}" FontFamily="Arial" FontStyle="Italic" />
            <DataGridTextColumn Header="Last Name" Binding="{Binding XPath=@LastName}" FontFamily="Arial" FontWeight="Bold" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

Commenti

Usare DataGridTextColumn per visualizzare colonne di dati come testo. La figura seguente mostra un esempio di due tipi di DataGridTextColumn.

two dataGridTextColumns

Per creare una colonna, aggiungerla all'insieme Columns. Per popolare la colonna, associare la colonna ai dati usando la proprietà Binding. La proprietà Binding viene applicata all'elemento TextBlock o TextBox creato nella colonna. Il DataContext per l'elemento in ogni cella è l'elemento di dati per la riga in cui si trova la cella. Pertanto, per configurare l'associazione è necessario impostare solo il Binding.Path. Facoltativamente, è possibile specificare un Binding.Converter se si desidera convertire i dati o il StringFormat. Per altre informazioni sul data binding, vedere data binding (WPF).

NotaDataGridTextColumn crea un elemento TextBlock nella modalità di non modifica e un elemento TextBox nella modalità di modifica.

È possibile personalizzare il DataGridTextColumn impostando proprietà, ad esempio Width, Header, FontSizee IsReadOnly.

Se si desidera visualizzare altri tipi di dati, DataGrid fornisce i tipi di colonna seguenti:

Tipo di colonna Visualizzazione dati
DataGridHyperlinkColumn Usare per visualizzare i dati URI.
DataGridComboBoxColumn Utilizzare per visualizzare i dati di enumerazione.
DataGridCheckBoxColumn Utilizzare per visualizzare i dati booleani.

Se si vogliono usare altri controlli nella DataGrid, è possibile creare tipi di colonna personalizzati usando DataGridTemplateColumn.

Costruttori

DataGridTextColumn()

Inizializza una nuova istanza della classe DataGridTextColumn.

Campi

FontFamilyProperty

Identifica la proprietà di dipendenza FontFamily.

FontSizeProperty

Identifica la proprietà di dipendenza FontSize.

FontStyleProperty

Identifica la proprietà di dipendenza FontStyle.

FontWeightProperty

Identifica la proprietà di dipendenza FontWeight.

ForegroundProperty

Identifica la proprietà di dipendenza Foreground.

Proprietà

ActualWidth

Ottiene la larghezza corrente della colonna, in unità indipendenti dal dispositivo (1/96 pollici per unità).

(Ereditato da DataGridColumn)
Binding

Ottiene o imposta l'associazione che associa la colonna a una proprietà nell'origine dati.

(Ereditato da DataGridBoundColumn)
CanUserReorder

Ottiene o imposta un valore che indica se l'utente può modificare la posizione di visualizzazione della colonna trascinando l'intestazione di colonna.

(Ereditato da DataGridColumn)
CanUserResize

Ottiene o imposta un valore che indica se l'utente può regolare la larghezza della colonna utilizzando il mouse.

(Ereditato da DataGridColumn)
CanUserSort

Ottiene o imposta un valore che indica se l'utente può ordinare la colonna facendo clic sull'intestazione di colonna.

(Ereditato da DataGridColumn)
CellStyle

Ottiene o imposta lo stile utilizzato per il rendering delle celle nella colonna.

(Ereditato da DataGridColumn)
ClipboardContentBinding

Ottiene o imposta l'oggetto di associazione da utilizzare per ottenere o impostare il contenuto della cella per gli Appunti.

(Ereditato da DataGridBoundColumn)
DataGridOwner

Ottiene il controllo DataGrid che contiene questa colonna.

(Ereditato da DataGridColumn)
DefaultEditingElementStyle

Valore predefinito della proprietà EditingElementStyle.

DefaultElementStyle

Valore predefinito della proprietà ElementStyle.

DependencyObjectType

Ottiene il DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza.

(Ereditato da DependencyObject)
Dispatcher

Ottiene il Dispatcher a cui è associato questo DispatcherObject.

(Ereditato da DispatcherObject)
DisplayIndex

Ottiene o imposta la posizione di visualizzazione della colonna rispetto alle altre colonne nella DataGrid.

(Ereditato da DataGridColumn)
DragIndicatorStyle

Ottiene o imposta l'oggetto stile da applicare all'intestazione di colonna durante un'operazione di trascinamento.

(Ereditato da DataGridColumn)
EditingElementStyle

Ottiene o imposta lo stile utilizzato durante il rendering dell'elemento visualizzato dalla colonna per una cella in modalità di modifica.

(Ereditato da DataGridBoundColumn)
ElementStyle

Ottiene o imposta lo stile utilizzato durante il rendering dell'elemento visualizzato dalla colonna per una cella che non è in modalità di modifica.

(Ereditato da DataGridBoundColumn)
FontFamily

Ottiene o imposta la famiglia di caratteri per il contenuto delle celle nella colonna.

FontSize

Ottiene o imposta la dimensione del carattere per il contenuto delle celle nella colonna.

FontStyle

Ottiene o imposta lo stile del tipo di carattere per il contenuto delle celle nella colonna.

FontWeight

Ottiene o imposta lo spessore del carattere per il contenuto delle celle nella colonna.

Foreground

Ottiene o imposta il Brush utilizzato per disegnare il contenuto di testo delle celle nella colonna.

Header

Ottiene o imposta il contenuto dell'intestazione di colonna.

(Ereditato da DataGridColumn)
HeaderStringFormat

Ottiene o imposta il modello di formato da applicare al contenuto dell'intestazione di colonna.

(Ereditato da DataGridColumn)
HeaderStyle

Ottiene o imposta lo stile utilizzato per il rendering dell'intestazione di colonna.

(Ereditato da DataGridColumn)
HeaderTemplate

Ottiene o imposta il modello che definisce la rappresentazione visiva dell'intestazione di colonna.

(Ereditato da DataGridColumn)
HeaderTemplateSelector

Ottiene o imposta l'oggetto che seleziona il modello da utilizzare per l'intestazione di colonna.

(Ereditato da DataGridColumn)
IsAutoGenerated

Ottiene un valore che indica se la colonna viene generata automaticamente.

(Ereditato da DataGridColumn)
IsFrozen

Ottiene un valore che indica se la colonna non può scorrere orizzontalmente.

(Ereditato da DataGridColumn)
IsReadOnly

Ottiene o imposta un valore che indica se è possibile modificare le celle della colonna.

(Ereditato da DataGridColumn)
IsSealed

Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura).

(Ereditato da DependencyObject)
MaxWidth

Ottiene o imposta il vincolo di larghezza massima della colonna.

(Ereditato da DataGridColumn)
MinWidth

Ottiene o imposta il vincolo di larghezza minima della colonna.

(Ereditato da DataGridColumn)
SortDirection

Ottiene o imposta la direzione di ordinamento (crescente o decrescente) della colonna.

(Ereditato da DataGridColumn)
SortMemberPath

Ottiene o imposta un nome di proprietà o una gerarchia delimitata da punti di nomi di proprietà, che indica il membro da ordinare.

(Ereditato da DataGridColumn)
Visibility

Ottiene o imposta la visibilità della colonna.

(Ereditato da DataGridColumn)
Width

Ottiene o imposta la larghezza della colonna o la modalità di ridimensionamento automatico.

(Ereditato da DataGridColumn)

Metodi

CancelCellEdit(FrameworkElement, Object)

Determina la modifica della cella di colonna per ripristinare il valore specificato.

CancelCellEdit(FrameworkElement, Object)

Fa sì che la cella venga modificata ripristinando il valore originale non modificato.

(Ereditato da DataGridColumn)
CheckAccess()

Determina se il thread chiamante ha accesso a questo DispatcherObject.

(Ereditato da DispatcherObject)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un identificatore di DependencyProperty.

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un DependencyPropertyKey.

(Ereditato da DependencyObject)
CoerceValue(DependencyProperty)

Forza il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati delle proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObject.

(Ereditato da DependencyObject)
CommitCellEdit(FrameworkElement)

Esegue qualsiasi convalida necessaria prima di uscire dalla modalità di modifica.

CommitCellEdit(FrameworkElement)

Esegue qualsiasi convalida necessaria prima di uscire dalla modalità di modifica delle celle.

(Ereditato da DataGridColumn)
Equals(Object)

Determina se un DependencyObject specificato è equivalente all'DependencyObjectcorrente.

(Ereditato da DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Ottiene un controllo TextBox associato al valore della proprietà Binding della colonna.

GenerateElement(DataGridCell, Object)

Ottiene un controllo TextBlock di sola lettura associato al valore della proprietà Binding della colonna.

GetCellContent(DataGridRow)

Recupera il valore della proprietà Content per la cella in corrispondenza dell'intersezione di questa colonna e della riga specificata.

(Ereditato da DataGridColumn)
GetCellContent(Object)

Ottiene il valore della proprietà Content per la cella all'intersezione di questa colonna e la riga che rappresenta l'elemento di dati specificato.

(Ereditato da DataGridColumn)
GetHashCode()

Ottiene un codice hash per questo DependencyObject.

(Ereditato da DependencyObject)
GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObject.

(Ereditato da DependencyObject)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un DependencyObject.

(Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)

Rivaluta il valore effettivo per la proprietà di dipendenza specificata.

(Ereditato da DependencyObject)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
NotifyPropertyChanged(String)

Notifica al DataGrid che contiene questa colonna che una proprietà della colonna è stata modificata.

(Ereditato da DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Notifica al DataGrid quando cambia il valore della proprietà Binding.

(Ereditato da DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Determina il valore della proprietà IsReadOnly in base alle regole delle proprietà della griglia dei dati che contiene questa colonna.

(Ereditato da DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)

Genera l'evento CopyingCellClipboardContent.

(Ereditato da DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Genera l'evento PastingCellClipboardContent.

(Ereditato da DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in questo DependencyObject è stato aggiornato. La proprietà di dipendenza specifica modificata viene segnalata nei dati dell'evento.

(Ereditato da DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Chiamato quando una cella nella colonna entra in modalità di modifica.

ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.

(Ereditato da DependencyObject)
RefreshCellContent(FrameworkElement, String)

Aggiorna il contenuto di una cella nella colonna in risposta a una modifica del valore della proprietà della colonna.

SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza.

(Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.

(Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata.

(Ereditato da DependencyObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
VerifyAccess()

Impone che il thread chiamante abbia accesso a questo DispatcherObject.

(Ereditato da DispatcherObject)

Eventi

CopyingCellClipboardContent

Si verifica dopo la preparazione del contenuto degli Appunti delle celle.

(Ereditato da DataGridColumn)
PastingCellClipboardContent

Si verifica prima che il contenuto degli Appunti venga spostato nella cella.

(Ereditato da DataGridColumn)

Si applica a