DataGridComboBoxColumn Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
public ref class DataGridComboBoxColumn : System::Windows::Controls::DataGridColumn
public class DataGridComboBoxColumn : System.Windows.Controls.DataGridColumn
type DataGridComboBoxColumn = class
inherit DataGridColumn
Public Class DataGridComboBoxColumn
Inherits DataGridColumn
- Dědičnost
Příklady
Následující příklad ukazuje, jak naplnit rozevírací seznam pro každý ComboBox sloupec hodnotami výčtu. Vybraná položka v rozevíracím seznamu je vázána nastavením SelectedItemBinding vlastnosti na vlastnost objektu zobrazeného v každém řádku.
<NavigationWindow x:Class="DataGrid_CustomColumns.Window1"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:core="clr-namespace:System;assembly=mscorlib"
xmlns:local="clr-namespace:DataGrid_CustomColumns"
Title="Customers" Height="300" Width="300" ShowsNavigationUI="False" >
<NavigationWindow.Resources>
<!--Create list of enumeration values-->
<ObjectDataProvider x:Key="myEnum" MethodName="GetValues" ObjectType="{x:Type core:Enum}">
<ObjectDataProvider.MethodParameters>
<x:Type Type="local:OrderStatus"/>
</ObjectDataProvider.MethodParameters>
</ObjectDataProvider>
<!--Create an instance of the converter for Email-->
<local:EmailConverter x:Key="EmailConverter" />
</NavigationWindow.Resources>
<NavigationWindow.Content>
<Grid>
<DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
<DataGrid.Columns>
<DataGridComboBoxColumn Header="Order Status" SelectedItemBinding="{Binding Status}" ItemsSource="{Binding Source={StaticResource myEnum}}" />
</DataGrid.Columns>
</DataGrid>
</Grid>
</NavigationWindow.Content>
</NavigationWindow>
public partial class Window1 : NavigationWindow
{
Class Window1
public Window1()
{
InitializeComponent();
//GetData() creates a collection of Customer data from a database
ObservableCollection<Customer> custdata = GetData();
//Bind the DataGrid to the customer data
DG1.DataContext = custdata;
}
Public Sub New()
' This call is required by the Windows Form Designer.
InitializeComponent()
' Add any initialization after the InitializeComponent() call.
'GetData() creates a collection of Customer data from a database
Dim custdata As ObservableCollection(Of Customer) = GetData()
'Bind the DataGrid to the customer data
DG1.DataContext = custdata
End Sub
//Defines the customer object
public class Customer
{
public string FirstName { get; set; }
public string LastName { get; set; }
public Uri Email { get; set; }
public bool IsMember { get; set; }
public OrderStatus Status { get; set; }
}
'Defines the customer object
Public Class Customer
Public Property FirstName() As String
Public Property LastName() As String
Public Property Email() As Uri
Public Property IsMember() As Boolean
Public Property Status() As OrderStatus
End Class
public enum OrderStatus { None, New, Processing, Shipped, Received };
Public Enum OrderStatus
None
[New]
Processing
Shipped
Received
End Enum
Poznámky
Slouží DataGridComboBoxColumn k zobrazení dat, ze kterých si můžete vybrat sadu položek, například výčtu. DataGridComboBoxColumn umožňuje uživatelům vybrat položku z rozevíracího seznamu. Následující obrázek znázorňuje DataGridComboBoxColumn.
Pokud chcete rozevírací seznam naplnit, nejprve nastavte ItemsSource vlastnost pro ComboBox vlastnost pomocí jedné z následujících možností:
Statický prostředek. Další informace naleznete v tématu StaticResource Markup Extension.
Entita kódu x:Static. Další informace naleznete v tématu x:Static Markup Extension.
Vložená kolekce ComboBoxItem typů.
ItemsSource Po nastavení vytvořte vazbu vybrané položky v ComboBox datové položce pro řádek, ve které je buňka. Vazbu můžete nastavit pomocí jedné z následujících vlastností:
| Vlastnictví | Description |
|---|---|
| TextBinding | Nastaví cestu vazby textu pro aktuálně vybranou položku. |
| SelectedItemBinding | Nastaví cestu vazby objektu, který je aktuálně vybrán. |
| SelectedValueBinding | Nastaví cestu vazby na hodnotu vybrané položky určené SelectedValuePath vlastností. |
Pokud je vlastnost nastavena IsReadOnly na true, uživatelé nemohou upravit sloupec a nebudou moci zobrazit rozevírací seznam.
Pokud chcete zobrazit další typy dat, DataGrid zadejte následující typy sloupců:
| Typ sloupce | Zobrazení dat |
|---|---|
| DataGridHyperlinkColumn | Slouží k zobrazení dat identifikátoru URI. |
| DataGridCheckBoxColumn | Slouží k zobrazení logických dat. |
| DataGridTextColumn | Slouží k zobrazení textu. |
Pokud chcete ve svém DataGridovládacím prvku použít jiné ovládací prvky, můžete vytvořit vlastní typy sloupců pomocí DataGridTemplateColumn.
Konstruktory
| Name | Description |
|---|---|
| DataGridComboBoxColumn() |
Inicializuje novou instanci DataGridComboBoxColumn třídy. |
Pole
| Name | Description |
|---|---|
| DisplayMemberPathProperty |
Identifikuje DisplayMemberPath vlastnost závislosti. |
| EditingElementStyleProperty |
Identifikuje EditingElementStyle vlastnost závislosti. |
| ElementStyleProperty |
Identifikuje ElementStyle vlastnost závislosti. |
| ItemsSourceProperty |
Identifikuje ItemsSource vlastnost závislosti. |
| SelectedValuePathProperty |
Identifikuje SelectedValuePath 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) |
| CellStyle |
Získá nebo nastaví styl, který se používá k vykreslení buněk ve sloupci. (Zděděno od DataGridColumn) |
| 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. |
| DataGridOwner |
DataGrid Získá ovládací prvek, který obsahuje tento sloupec. (Zděděno od DataGridColumn) |
| DefaultEditingElementStyle |
Získá výchozí hodnotu EditingElementStyle vlastnosti. |
| DefaultElementStyle |
Získá výchozí hodnotu ElementStyle. |
| 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) |
| DisplayMemberPath |
Získá nebo nastaví cestu k hodnotě ve zdrojovém objektu za účelem poskytnutí vizuální reprezentace objektu. |
| 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) |
| EditingElementStyle |
Získá nebo nastaví styl, který se používá při vykreslování prvku, který sloupec zobrazí pro buňku v režimu úprav. |
| ElementStyle |
Získá nebo nastaví styl, který se používá při vykreslování prvku, který sloupec zobrazuje pro buňku, která není v režimu úprav. |
| 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) |
| ItemsSource |
Získá nebo nastaví kolekci, která se používá k vygenerování obsahu ovládacího prvku pole se seznamem. |
| 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) |
| SelectedItemBinding |
Získá nebo nastaví vazbu pro aktuálně vybranou položku. |
| SelectedValueBinding |
Získá nebo nastaví hodnotu vybrané položky získané pomocí SelectedValuePath. |
| SelectedValuePath |
Získá nebo nastaví cestu, která se používá k získání z objektu SelectedValueSelectedItem. |
| 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) |
| TextBinding |
Získá nebo nastaví vazbu pro text v části ComboBox textového pole ovládacího prvku. |
| TextBlockComboBoxStyleKey |
Získá klíč prostředku pro styl, který se má použít pro pole se seznamem jen pro čtení. |
| 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 upravená buňka sloupce vrátí k zadané hodnotě. |
| 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 provede jakékoli požadované ověření. |
| 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á ovládací prvek pole se seznamem, který je vázán na sloupec SelectedItemBinding, SelectedValueBindinga TextBinding hodnoty. |
| GenerateElement(DataGridCell, Object) |
Získá ovládací prvek pole se seznamem jen pro čtení, který je vázán na sloupec SelectedItemBinding, SelectedValueBindinga TextBinding hodnoty. |
| 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) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| 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) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| 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 vlastností z DataGrid tohoto sloupce. |
| 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) |
| OnSelectedItemBindingChanged(BindingBase, BindingBase) |
Upozorní, DataGrid kdy se SelectedItemBinding vlastnost změní. |
| OnSelectedValueBindingChanged(BindingBase, BindingBase) |
Upozorní, DataGrid kdy se SelectedValueBinding vlastnost změní. |
| OnTextBindingChanged(BindingBase, BindingBase) |
Upozorní, DataGrid kdy se TextBinding vlastnost změní. |
| PrepareCellForEdit(FrameworkElement, RoutedEventArgs) |
Volá se, když buňka ve sloupci přejde do režimu úprav. |
| 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 vazby. |
| 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) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| 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) |