GridViewColumn Klasse

Definition

Stellt eine Spalte dar, die Daten anzeigtRepresents a column that displays data.

public ref class GridViewColumn : System::Windows::DependencyObject, System::ComponentModel::INotifyPropertyChanged
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.ContentProperty("Header")]
[System.Windows.StyleTypedProperty(Property="HeaderContainerStyle", StyleTargetType=typeof(System.Windows.Controls.GridViewColumnHeader))]
public class GridViewColumn : System.Windows.DependencyObject, System.ComponentModel.INotifyPropertyChanged
type GridViewColumn = class
    inherit DependencyObject
    interface INotifyPropertyChanged
Public Class GridViewColumn
Inherits DependencyObject
Implements INotifyPropertyChanged
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird gezeigt, wie GridViewColumn Sie-Objekte GridViewfür einen definieren.The following example shows how to define GridViewColumn objects for a GridView.


<ListView ItemsSource="{Binding Source={StaticResource EmployeeData}, 
                                        XPath=Employee}">
  <ListView.View>       
    <GridView>
      <GridViewColumn Header="First Name"
               DisplayMemberBinding="{Binding XPath=FirstName}" />
      <GridViewColumn Header="Last Name"  
               CellTemplate="{StaticResource LastNameCellTemplate}"/>
      <GridViewColumn Header="Favorite City" 
               CellTemplateSelector="{DynamicResource 
                                      FavoriteCityTemplateSelector}"/>
    </GridView>
  </ListView.View>    
</ListView>

Hinweise

Eine GridViewColumn wirdGridView vom Ansichtsmodus verwendet, um eine Spalte mit Daten anzuzeigen.A GridViewColumn is used by the GridView view mode to display a column of data. Der ListView , der den GridView Ansichtsmodus implementiert, stellt die Daten für die Spalte bereit.The ListView that implements the GridView view mode provides the data for the column. Sie verwenden die Datenbindung, um die Daten für GridViewColumnanzugeben.You use data binding to specify the data for the GridViewColumn.

Sie können das DisplayMemberBinding verwenden, um die Daten zu definieren, die in einer Spalte angezeigt werden sollen.You can use the DisplayMemberBinding to define the data to display in a column. Sie können die Daten auch als Teil eines DataTemplate definieren, der durch die CellTemplate -Eigenschaft angegeben wird.You can also define the data as part of a DataTemplate that is specified by the CellTemplate property. Wenn verschiedene Zellen über unter DataTemplate schiedliche Objekte verfügen CellTemplateSelector , kann die- DataTemplateSelectorEigenschaft einen angeben.If different cells have different DataTemplate objects, the CellTemplateSelector property can specify a DataTemplateSelector. In der folgenden Liste werden die hier genannten Eigenschaften in der Rangfolge von der höchsten zur niedrigsten angezeigt:The following list shows the properties mentioned here, in their order of precedence from highest to lowest:

Die GridViewColumn -Klasse enthält außerdem Eigenschaften, die Sie zum Definieren und Anpassen des Spalten Headers für die Spalte verwenden können.The GridViewColumn class also contains properties that you can use to define and customize the column header for the column. Die Header -Eigenschaft kann den Inhalt des Spalten Headers definieren.The Header property can define the content of the column header. Andere Eigenschaften, wie HeaderTemplate z HeaderContainerStyle . b. und, können auch den Inhalt und den Stil für den Spaltenheader angeben.Other properties such as HeaderTemplate and HeaderContainerStyle can also specify content and style for the column header. Einige dieser Eigenschaften werden auch in anderen Klassen, z. b. GridViewColumnHeader der-Klasse, gefunden.Some of these properties are also found on other classes such as the GridViewColumnHeader class. Weitere Informationen zu den Eigenschaften, die zum Definieren von Stilen und Vorlagen für Spaltenüberschriften verwendet werden, sowie Informationen über die Rangfolge dieser Eigenschaften finden Sie unter Übersicht über GridView-Spalten Header Stile und-Vorlagen.For more information about the properties that are used to define styles and templates for column headers, and for information about the order of precedence for these properties, see GridView Column Header Styles and Templates Overview.

Die GridViewColumn-Klasse implementiert die INotifyPropertyChanged-Schnittstelle.The GridViewColumn class implements the INotifyPropertyChanged interface. Diese Schnittstelle bietet die Möglichkeit, die Ereignisse zu abonnieren, die auftreten, wenn eine Änderung an einem Eigenschafts Wert, ActualWidth z. b. dem Eigenschafts Wert, auftritt.This interface provides the ability to subscribe to the events that occur when a change occurs to a property value, such as the ActualWidth property value.

Konstruktoren

GridViewColumn()

Initialisiert eine neue Instanz der GridViewColumn-Klasse.Initializes a new instance of the GridViewColumn class.

Felder

CellTemplateProperty

Bezeichnet die CellTemplate-Abhängigkeitseigenschaft.Identifies the CellTemplate dependency property.

CellTemplateSelectorProperty

Bezeichnet die CellTemplateSelector-Abhängigkeitseigenschaft.Identifies the CellTemplateSelector dependency property.

HeaderContainerStyleProperty

Bezeichnet die HeaderContainerStyle-Abhängigkeitseigenschaft.Identifies the HeaderContainerStyle dependency property.

HeaderProperty

Bezeichnet die Header-Abhängigkeitseigenschaft.Identifies the Header dependency property.

HeaderStringFormatProperty

Bezeichnet die HeaderStringFormat-Abhängigkeitseigenschaft.Identifies the HeaderStringFormat dependency property.

HeaderTemplateProperty

Bezeichnet die HeaderTemplate-Abhängigkeitseigenschaft.Identifies the HeaderTemplate dependency property.

HeaderTemplateSelectorProperty

Bezeichnet die HeaderTemplateSelector-Abhängigkeitseigenschaft.Identifies the HeaderTemplateSelector dependency property.

WidthProperty

Bezeichnet die Width-Abhängigkeitseigenschaft.Identifies the Width dependency property.

Eigenschaften

ActualWidth

Ruft die tatsächliche Breite einer GridViewColumn ab.Gets the actual width of a GridViewColumn.

CellTemplate

Ruft die Vorlage ab, mit der der Inhalt einer Spaltenzelle angezeigt wird, oder legt diese fest.Gets or sets the template to use to display the contents of a column cell.

CellTemplateSelector

Ruft einen DataTemplateSelector ab, der die Vorlage bestimmt, mit der Zellen in einer Spalte angezeigt werden sollen, oder legt diesen fest.Gets or sets a DataTemplateSelector that determines the template to use to display cells in a column.

DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
DisplayMemberBinding

Ruft das Datenelement ab, an das für diese Spalte eine Bindung erstellt werden soll, oder legt dieses fest.Gets or sets the data item to bind to for this column.

Header

Ruft den Inhalt des Headers einer GridViewColumn ab oder legt diesen fest.Gets or sets the content of the header of a GridViewColumn.

HeaderContainerStyle

Ruft den Stil ab, der für die Überschrift der GridViewColumn verwendet werden soll, oder legt diesen fest.Gets or sets the style to use for the header of the GridViewColumn.

HeaderStringFormat

Ruft eine kombinierte Zeichenfolge ab, die angibt, wie die Header-Eigenschaft formatiert werden soll, wenn sie als Zeichenfolge angezeigt wird, oder legt diese fest.Gets or sets a composite string that specifies how to format the Header property if it is displayed as a string.

HeaderTemplate

Ruft die Vorlage ab, die zum Anzeigen des Inhalts des Spaltenkopfs verwendet werden soll, oder legt diese fest.Gets or sets the template to use to display the content of the column header.

HeaderTemplateSelector

Ruft den DataTemplateSelector ab, der die Logik zum Auswählen der Vorlage bereitstellt, mit der der Spaltenkopf angezeigt werden soll, oder legt diesen fest.Gets or sets the DataTemplateSelector that provides logic to select the template to use to display the column header.

IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)
Width

Ruft die Breite der Spalte ab oder legt diese fest.Gets or sets the width of the column.

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnHeaderStringFormatChanged(String, String)

Tritt ein, wenn sich die HeaderStringFormat-Eigenschaft ändert.Occurs when the HeaderStringFormat property changes.

OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
OnPropertyChanged(PropertyChangedEventArgs)

Löst das INotifyPropertyChanged.PropertyChanged-Ereignis aus.Raises the INotifyPropertyChanged.PropertyChanged event.

ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

(Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Erstellt eine Zeichenfolgendarstellung der GridViewColumn.Creates a string representation of the GridViewColumn.

VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

INotifyPropertyChanged.PropertyChanged

Tritt ein, wenn der Wert einer GridViewColumn-Eigenschaft geändert wird.Occurs when the value of any GridViewColumn property changes.

Gilt für:

Siehe auch