DataGridTemplateColumn Třída

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

Představuje sloupec, který je hostitelem DataGrid obsahu určeného šablonou v jeho buňkách.

public ref class DataGridTemplateColumn : System::Windows::Controls::DataGridColumn

public class DataGridTemplateColumn : System.Windows.Controls.DataGridColumn

type DataGridTemplateColumn = class
    inherit DataGridColumn

Public Class DataGridTemplateColumn
Inherits DataGridColumn

Dědičnost

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridTemplateColumn

Příklady

Následující příklad ukazuje, jak vytvořit DataGridTemplateColumn.

<Grid>
    <Grid.Resources>
        <!--DataTemplate for Published Date column defined in Grid.Resources.  PublishDate is a property on the ItemsSource of type DateTime -->
        <DataTemplate x:Key="DateTemplate" >
            <StackPanel Width="20" Height="30">
                <Border Background="LightBlue" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:MMM}}" FontSize="8" HorizontalAlignment="Center" />
                </Border>
                <Border Background="White" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:yyyy}}" FontSize="8" FontWeight="Bold" HorizontalAlignment="Center" />
                </Border>
            </StackPanel>
        </DataTemplate>
        <!--DataTemplate for the Published Date column when in edit mode. -->
        <DataTemplate x:Key="EditingDateTemplate">
            <DatePicker SelectedDate="{Binding PublishDate}"  />
        </DataTemplate>
    </Grid.Resources>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
            <!--Custom column that shows the published date-->
            <DataGridTemplateColumn Header="Publish Date" CellTemplate="{StaticResource DateTemplate}" CellEditingTemplate="{StaticResource EditingDateTemplate}" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

Následující obrázek znázorňuje výstup z předchozího XAML.

Poznámky

Tento DataGridTemplateColumn typ umožňuje vytvořit vlastní typy sloupců zadáním šablon buněk, které se mají použít při zobrazení a úpravách hodnot. Chcete-li zadat šablonu, která se používá k zobrazení obsahu buňky, která není v režimu úprav, nastavte CellTemplate vlastnost. Chcete-li určit šablonu, která se používá k zobrazení obsahu buňky, která je v režimu úprav, nastavte CellEditingTemplate vlastnost. Další informace o šablonách najdete v tématu Přehled šablon dat a stylování a šablonování.

Pro usnadnění je k dispozici DataGrid následující předdefinované typy sloupců:

Typ sloupce	Zobrazení dat
DataGridHyperlinkColumn	Slouží k zobrazení dat identifikátoru URI.
DataGridComboBoxColumn	Slouží k zobrazení dat výčtu.
DataGridTextColumn	Slouží k zobrazení textu.
DataGridCheckBoxColumn	Slouží k zobrazení logických dat.

Konstruktory

Name	Description
DataGridTemplateColumn()	Inicializuje novou instanci DataGridTemplateColumn třídy.

Pole

Name	Description
CellEditingTemplateProperty	Identifikuje CellEditingTemplate vlastnost závislosti.
CellEditingTemplateSelectorProperty	Identifikuje CellEditingTemplateSelector vlastnost závislosti.
CellTemplateProperty	Identifikuje CellTemplate vlastnost závislosti.
CellTemplateSelectorProperty	Identifikuje CellEditingTemplateSelector vlastnost závislosti.

Vlastnosti

Name	Description
ActualWidth	Získá aktuální šířku sloupce v jednotkách nezávislých na zařízení (1/96 palce na jednotku). (Zděděno od DataGridColumn)
CanUserReorder	Získá nebo nastaví hodnotu, která označuje, zda uživatel může změnit pozici zobrazení sloupce přetažením záhlaví sloupce. (Zděděno od DataGridColumn)
CanUserResize	Získá nebo nastaví hodnotu, která určuje, zda uživatel může upravit šířku sloupce pomocí myši. (Zděděno od DataGridColumn)
CanUserSort	Získá nebo nastaví hodnotu, která označuje, zda uživatel může řadit sloupec kliknutím na záhlaví sloupce. (Zděděno od DataGridColumn)
CellEditingTemplate	Získá nebo nastaví šablonu pro zobrazení obsahu buňky, která je v režimu úprav.
CellEditingTemplateSelector	Získá nebo nastaví objekt, který určuje, kterou šablonu použít k zobrazení obsahu buňky, která je v režimu úprav.
CellStyle	Získá nebo nastaví styl, který se používá k vykreslení buněk ve sloupci. (Zděděno od DataGridColumn)
CellTemplate	Získá nebo nastaví šablonu pro zobrazení obsahu buňky, která není v režimu úprav.
CellTemplateSelector	Získá nebo nastaví objekt, který určuje, kterou šablonu použít k zobrazení obsahu buňky, která není v režimu úprav.
ClipboardContentBinding	Získá nebo nastaví objekt vazby, který se má použít při získávání nebo nastavení obsahu buňky pro schránku. (Zděděno od DataGridColumn)
DataGridOwner	DataGrid Získá ovládací prvek, který obsahuje tento sloupec. (Zděděno od DataGridColumn)
DependencyObjectType	DependencyObjectType Získá ten, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject)
DisplayIndex	Získá nebo nastaví pozici zobrazení sloupce vzhledem k ostatním sloupcům v objektu DataGrid. (Zděděno od DataGridColumn)
DragIndicatorStyle	Získá nebo nastaví objekt stylu, který se použije na záhlaví sloupce během operace přetažení. (Zděděno od DataGridColumn)
Header	Získá nebo nastaví obsah záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderStringFormat	Získá nebo nastaví formát vzor použít na obsah záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderStyle	Získá nebo nastaví styl, který se používá při vykreslování záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderTemplate	Získá nebo nastaví šablonu, která definuje vizuální reprezentaci záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderTemplateSelector	Získá nebo nastaví objekt, který vybere šablonu, která se má použít pro záhlaví sloupce. (Zděděno od DataGridColumn)
IsAutoGenerated	Získá hodnotu, která určuje, zda je sloupec automaticky generován. (Zděděno od DataGridColumn)
IsFrozen	Získá hodnotu, která označuje, zda je sloupec znemožněno posouvání vodorovně. (Zděděno od DataGridColumn)
IsReadOnly	Získá nebo nastaví hodnotu, která určuje, zda buňky ve sloupci lze upravit. (Zděděno od DataGridColumn)
IsSealed	Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
MaxWidth	Získá nebo nastaví omezení maximální šířky sloupce. (Zděděno od DataGridColumn)
MinWidth	Získá nebo nastaví omezení minimální šířky sloupce. (Zděděno od DataGridColumn)
SortDirection	Získá nebo nastaví směr řazení (vzestupně nebo sestupně) sloupce. (Zděděno od DataGridColumn)
SortMemberPath	Získá nebo nastaví název vlastnosti nebo hierarchii názvů vlastností oddělených tečkami, která označuje člena, podle kterého se má řadit. (Zděděno od DataGridColumn)
Visibility	Získá nebo nastaví viditelnost sloupce. (Zděděno od DataGridColumn)
Width	Získá nebo nastaví šířku sloupce nebo režim automatické velikosti. (Zděděno od DataGridColumn)

Metody

Name	Description
CancelCellEdit(FrameworkElement, Object)	Způsobí, že se buňka, která se upravuje, vrátí k původní, needitované hodnotě. (Zděděno od DataGridColumn)
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject. (Zděděno od DependencyObject)
CommitCellEdit(FrameworkElement)	Před ukončením režimu úprav buněk provede jakékoli požadované ověření. (Zděděno od DataGridColumn)
Equals(Object)	Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject. (Zděděno od DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Získá prvek definovaný CellEditingTemplate , který je vázán na hodnotu vlastnosti sloupce Binding .
GenerateElement(DataGridCell, Object)	Získá prvek definovaný CellTemplate , který je vázán na hodnotu vlastnosti sloupce Binding .
GetCellContent(DataGridRow)	Content Načte hodnotu vlastnosti pro buňku v průsečíku tohoto sloupce a zadaného řádku. (Zděděno od DataGridColumn)
GetCellContent(Object)	Content Získá hodnotu vlastnosti pro buňku v průsečíku tohoto sloupce a řádku, který představuje zadanou datnou položku. (Zděděno od DataGridColumn)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject. (Zděděno od DependencyObject)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
NotifyPropertyChanged(String)	Upozorní DataGrid uživatele, který obsahuje tento sloupec, že se změnila vlastnost sloupce. (Zděděno od DataGridColumn)
OnCoerceIsReadOnly(Boolean)	Určuje hodnotu IsReadOnly vlastnosti na základě pravidel DataGrid vlastnosti, která obsahuje tento sloupec. (Zděděno od DataGridColumn)
OnCopyingCellClipboardContent(Object)	CopyingCellClipboardContent Vyvolá událost. (Zděděno od DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	PastingCellClipboardContent Vyvolá událost. (Zděděno od DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní vlastnost závislosti, která se změnila, je hlášena v datech události. (Zděděno od DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Při přepsání v odvozené třídě nastaví obsah buňky podle potřeby pro úpravy. (Zděděno od DataGridColumn)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
RefreshCellContent(FrameworkElement, String)	Aktualizuje obsah buňky ve sloupci v reakci na změnu hodnoty vlastnosti šablony.
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnot. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou jeho identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou identifikátorem DependencyPropertyKey vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která určuje, zda procesy serializace mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)

Událost

Name	Description
CopyingCellClipboardContent	Nastane po přípravě obsahu schránky buňky. (Zděděno od DataGridColumn)
PastingCellClipboardContent	Nastane před přesunutím obsahu schránky do buňky. (Zděděno od DataGridColumn)

Viz také

• DataGrid