ListView Class

Stellt ein Steuerelement dar, das eine vertikale Liste mit Datenelementen anzeigt.

Vererbung

Object
  DependencyObject
    UIElement
      FrameworkElement
        Control
          ItemsControl
            Selector
              ListViewBase
                ListView

Syntax


public class ListView : ListViewBase


<ListView .../>
-or-
<ListView ...>
  oneOrMoreComponents
</ListView>

XAML Values

oneOrMoreComponents

Eine oder mehrere Komponenten, die die ItemsControl-Eigenschaften der Ansicht festlegen. ListView enthält z. B. möglicherweise Objektelemente, die Inline-Definitionen für die Eigenschaft GroupStyle, ItemTemplate, ItemContainerStyle oder ItemsPanel ausführen.

ListView könnte auch Objektelemente enthalten, die den eigentlichen Inhalt deklarieren, der angezeigt wird. Diese Objektelemente füllen die Items-Auflistung. Es ist jedoch häufiger, dass solche Inhalte aus einer Datenbindungsquelle stammen.

Attribute

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Member

ListViewKlasse hat diese Membertypen:

Konstruktoren

ListViewKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
ListView Initializes a new instance of the ListView class.

 

Ereignisse

ListViewKlasse hat diese Ereignisse.

EreignisBeschreibung
ContainerContentChanging Occurs when the data item associated with a UI container changes. (Geerbt von ListViewBase)
DataContextChanged Occurs when the value of the FrameworkElement.DataContext property changes. (Geerbt von FrameworkElement)
DoubleTapped Occurs when an otherwise unhandled DoubleTap interaction occurs over the hit test area of this element. (Geerbt von UIElement)
DragEnter Occurs when the input system reports an underlying drag event with this element as the target. (Geerbt von UIElement)
DragItemsStarting Occurs when a drag operation that involves one of the items in the view is initiated. (Geerbt von ListViewBase)
DragLeave Occurs when the input system reports an underlying drag event with this element as the origin. (Geerbt von UIElement)
DragOver Occurs when the input system reports an underlying drag event with this element as the potential drop target. (Geerbt von UIElement)
Drop Occurs when the input system reports an underlying drop event with this element as the drop target. (Geerbt von UIElement)
GotFocus Occurs when a UIElement receives focus. (Geerbt von UIElement)
Holding Occurs when an otherwise unhandled Hold interaction occurs over the hit test area of this element. (Geerbt von UIElement)
IsEnabledChanged Occurs when the IsEnabled property changes. (Geerbt von Control)
ItemClick Occurs when an item in the list view receives an interaction, and the IsItemClickEnabled property is true. (Geerbt von ListViewBase)
KeyDown Occurs when a keyboard key is pressed while the UIElement has focus. (Geerbt von UIElement)
KeyUp Occurs when a keyboard key is released while the UIElement has focus. (Geerbt von UIElement)
LayoutUpdated Occurs when the layout of the visual tree changes, due to layout-relevant properties changing value or some other action that refreshes the layout. (Geerbt von FrameworkElement)
Loaded Occurs when a FrameworkElement has been constructed and added to the object tree, and is ready for interaction. (Geerbt von FrameworkElement)
LostFocus Occurs when a UIElement loses focus. (Geerbt von UIElement)
ManipulationCompleted Occurs when a manipulation on the UIElement is complete. (Geerbt von UIElement)
ManipulationDelta Occurs when the input device changes position during a manipulation. (Geerbt von UIElement)
ManipulationInertiaStarting Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins. (Geerbt von UIElement)
ManipulationStarted Occurs when an input device begins a manipulation on the UIElement. (Geerbt von UIElement)
ManipulationStarting Occurs when the manipulation processor is first created. (Geerbt von UIElement)
PointerCanceled Occurs when a pointer that made contact abnormally loses contact. (Geerbt von UIElement)
PointerCaptureLost Occurs when pointer capture previously held by this element moves to another element or elsewhere. (Geerbt von UIElement)
PointerEntered Occurs when a pointer enters the hit test area of this element. (Geerbt von UIElement)
PointerExited Occurs when a pointer leaves the hit test area of this element. (Geerbt von UIElement)
PointerMoved Occurs when a pointer moves while the pointer remains within the hit test area of this element. (Geerbt von UIElement)
PointerPressed Occurs when the pointer device initiates a Press action within this element. (Geerbt von UIElement)
PointerReleased Occurs when the pointer device that previously initiated a Press action is released, while within this element. (Geerbt von UIElement)
PointerWheelChanged Occurs when the delta value of a pointer wheel changes. (Geerbt von UIElement)
RightTapped Occurs when a right-tap input stimulus happens while the pointer is over the element. (Geerbt von UIElement)
SelectionChanged Occurs when the currently selected item changes. (Geerbt von Selector)
SizeChanged Occurs when either the ActualHeight or the ActualWidth property changes value on a FrameworkElement. (Geerbt von FrameworkElement)
Tapped Occurs when an otherwise unhandled Tap interaction occurs over the hit test area of this element. (Geerbt von UIElement)
Unloaded Occurs when this object is no longer connected to the main object tree. (Geerbt von FrameworkElement)

 

Methoden

The ListView Klasse hat diese Methoden. Es erbt auch Methoden von Object Klasse.

MethodeBeschreibung
AddHandler Adds a routed event handler for a specified routed event, adding the handler to the handler collection on the current element. Specify handledEventsToo as true to have the provided handler be invoked even if the event is handled elsewhere. (Geerbt von UIElement)
ApplyTemplate Loads the relevant control template so that its parts can be referenced. (Geerbt von Control)
Arrange Positions child objects and determines a size for a UIElement. Parent objects that implement custom layout for their child elements should call this method from their layout override implementations to form a recursive layout update. (Geerbt von UIElement)
ArrangeOverride Provides the behavior for the Arrange pass of layout. Classes can override this method to define their own Arrange pass behavior. (Geerbt von FrameworkElement)
CancelDirectManipulations Cancels ongoing direct manipulation processing (system-defined panning/zooming) on any ScrollViewer parent that contains the current UIElement. (Geerbt von UIElement)
CapturePointer Sets pointer capture to a UIElement. Once captured, only the element that has capture will fire pointer-related events. (Geerbt von UIElement)
ClearContainerForItemOverride Undoes the effects of the PrepareContainerForItemOverride method. (Geerbt von ItemsControl)
ClearValue Clears the local value of a dependency property. (Geerbt von DependencyObject)
CompleteViewChange Changes related aspects of presentation when the overall view for a SemanticZoom changes. (Geerbt von ListViewBase)
CompleteViewChangeFrom Completes item-wise operations that are related to a view change when the ListViewBase instance is the source view and the new view is a potentially different implementing view. (Geerbt von ListViewBase)
CompleteViewChangeTo Completes item-wise operations that are related to a view change when the ListViewBase instance is the destination view and the source view is a potentially different implementing view. (Geerbt von ListViewBase)
ContainerFromIndex Returns the container for the item at the specified index within the ItemCollection. (Geerbt von ItemsControl)
ContainerFromItem Returns the container corresponding to the specified item. (Geerbt von ItemsControl)
FindName Retrieves an object that has the specified identifier name. (Geerbt von FrameworkElement)
FindSubElementsForTouchTargeting Enables a UIElement subclass to expose child elements that assist with resolving touch targeting. (Geerbt von UIElement)
Focus Attempts to set the focus on the control. (Geerbt von Control)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Geerbt von DependencyObject)
GetBindingExpression Returns the BindingExpression that represents the binding on the specified property. (Geerbt von FrameworkElement)
GetContainerForItemOverride Creates or identifies the element that is used to display the given item. (Geerbt von ItemsControl)
GetTemplateChild Retrieves the named element in the instantiated ControlTemplate visual tree. (Geerbt von Control)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Geerbt von DependencyObject)
GoToElementStateCore When implemented in a derived class, enables per-state construction of a visual tree for a control template in code, rather than by loading XAML for all states at control startup. (Geerbt von FrameworkElement)
IndexFromContainer Returns the index to the item that has the specified, generated container. (Geerbt von ItemsControl)
InitializeViewChange Initializes the changes to related aspects of presentation (such as scrolling UI or state) when the overall view for a SemanticZoom is about to change. (Geerbt von ListViewBase)
InvalidateArrange Invalidates the arrange state (layout) for a UIElement. After the invalidation, the UIElement will have its layout updated, which will occur asynchronously. (Geerbt von UIElement)
InvalidateMeasure Invalidates the measurement state (layout) for a UIElement. (Geerbt von UIElement)
IsItemItsOwnContainerOverride Determines whether the specified item is (or is eligible to be) its own container. (Geerbt von ItemsControl)
ItemFromContainer Returns the item that corresponds to the specified, generated container. (Geerbt von ItemsControl)
LoadMoreItemsAsync Initiates the asynchronous request to load more data items, in accordance with the active incremental loading settings. (Geerbt von ListViewBase)
MakeVisible Forces content in the view to scroll until the item that's specified by SemanticZoomLocation is visible. Also focuses the item if it finds the item. (Geerbt von ListViewBase)
Measure Updates the DesiredSize of a UIElement. Typically, objects that implement custom layout for their layout children call this method from their own MeasureOverride implementations to form a recursive layout update. (Geerbt von UIElement)
MeasureOverride Provides the behavior for the Measure pass of the layout cycle. Classes can override this method to define their own Measure pass behavior. (Geerbt von FrameworkElement)
OnApplyTemplate Invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in your app. Override this method to influence the default post-template logic of a class. (Geerbt von FrameworkElement)
OnCreateAutomationPeer When implemented in a derived class, returns class-specific AutomationPeer implementations for the Microsoft UI Automation infrastructure. (Geerbt von UIElement)
OnDisconnectVisualChildren Override this method to implement how layout and logic should behave when items are removed from a class-specific content or children property. (Geerbt von UIElement)
OnDoubleTapped Called before the DoubleTapped event occurs. (Geerbt von Control)
OnDragEnter Called before the DragEnter event occurs. (Geerbt von Control)
OnDragLeave Called before the DragLeave event occurs. (Geerbt von Control)
OnDragOver Called before the DragOver event occurs. (Geerbt von Control)
OnDrop Called before the Drop event occurs. (Geerbt von Control)
OnGotFocus Called before the GotFocus event occurs. (Geerbt von Control)
OnGroupStyleSelectorChanged Invoked when the value of the GroupStyleSelector property changes. (Geerbt von ItemsControl)
OnHolding Called before the Holding event occurs. (Geerbt von Control)
OnItemContainerStyleChanged Invoked when the value of the ItemContainerStyle property changes. (Geerbt von ItemsControl)
OnItemContainerStyleSelectorChanged Invoked when the value of the ItemContainerStyleSelector property changes. (Geerbt von ItemsControl)
OnItemsChanged Invoked when the value of the Items property changes. (Geerbt von ItemsControl)
OnItemTemplateChanged Invoked when the value of the ItemTemplate property changes. (Geerbt von ItemsControl)
OnItemTemplateSelectorChanged Invoked when the value of the ItemTemplateSelector property changes. (Geerbt von ItemsControl)
OnKeyDown Called before the KeyDown event occurs. (Geerbt von Control)
OnKeyUp Called before the KeyUp event occurs. (Geerbt von Control)
OnLostFocus Called before the LostFocus event occurs. (Geerbt von Control)
OnManipulationCompleted Called before the ManipulationCompleted event occurs. (Geerbt von Control)
OnManipulationDelta Called before the ManipulationDelta event occurs. (Geerbt von Control)
OnManipulationInertiaStarting Called before the ManipulationInertiaStarting event occurs. (Geerbt von Control)
OnManipulationStarted Called before the ManipulationStarted event occurs. (Geerbt von Control)
OnManipulationStarting Called before the ManipulationStarting event occurs. (Geerbt von Control)
OnPointerCanceled Called before the PointerCanceled event occurs. (Geerbt von Control)
OnPointerCaptureLost Called before the PointerCaptureLost event occurs. (Geerbt von Control)
OnPointerEntered Called before the PointerEntered event occurs. (Geerbt von Control)
OnPointerExited Called before the PointerExited event occurs. (Geerbt von Control)
OnPointerMoved Called before the PointerMoved event occurs. (Geerbt von Control)
OnPointerPressed Called before the PointerPressed event occurs. (Geerbt von Control)
OnPointerReleased Called before the PointerReleased event occurs. (Geerbt von Control)
OnPointerWheelChanged Called before the PointerWheelChanged event occurs. (Geerbt von Control)
OnRightTapped Called before the RightTapped event occurs. (Geerbt von Control)
OnTapped Called before the Tapped event occurs. (Geerbt von Control)
PrepareContainerForItemOverride Prepares the specified element to display the specified item. (Geerbt von ItemsControl)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Geerbt von DependencyObject)
ReleasePointerCapture Releases pointer captures for capture of one specific pointer by this UIElement. (Geerbt von UIElement)
ReleasePointerCaptures Releases all pointer captures held by this element. (Geerbt von UIElement)
RemoveHandler Removes the specified routed event handler from this UIElement. Typically the handler in question was added by AddHandler. (Geerbt von UIElement)
ScrollIntoView(Object) Scrolls the list to bring the specified data item into view. (Geerbt von ListViewBase)
ScrollIntoView(Object, ScrollIntoViewAlignment) Scrolls the list to bring the specified data item into view with the specified alignment. (Geerbt von ListViewBase)
SelectAll Selects all the items in a view. (Geerbt von ListViewBase)
SetBinding Attaches a binding to a FrameworkElement, using the provided binding object. (Geerbt von FrameworkElement)
SetDesiredContainerUpdateDuration Sets the maximum target time between two render passes when a ListViewBase is updating its UI with data items during initial load or scrolling. (Geerbt von ListViewBase)
SetValue Sets the local value of a dependency property on a DependencyObject. (Geerbt von DependencyObject)
StartViewChangeFrom Initializes item-wise operations that are related to a view change when the ListViewBase instance is the source view and the pending destination view is a potentially different implementing view. (Geerbt von ListViewBase)
StartViewChangeTo Initializes item-wise operations that are related to a view change when the source view is a different view and the pending destination view is the ListViewBase instance. (Geerbt von ListViewBase)
TransformToVisual Returns a transform object that can be used to transform coordinates from the UIElement to the specified object. (Geerbt von UIElement)
UpdateLayout Ensures that all positions of child objects of a UIElement are properly updated for layout. (Geerbt von UIElement)

 

Eigenschaften

Der ListViewKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

ActualHeight

SchreibgeschütztGets the rendered height of a FrameworkElement. (Geerbt von FrameworkElement)

ActualWidth

SchreibgeschütztGets the rendered width of a FrameworkElement. (Geerbt von FrameworkElement)

AllowDrop

Lese-/SchreibzugriffGets or sets a value that determines whether this UIElement can be a drop target for purposes of drag-and-drop operations. (Geerbt von UIElement)

Background

Lese-/SchreibzugriffGets or sets a brush that provides the background of the control. (Geerbt von Control)

BaseUri

SchreibgeschütztGets a Uniform Resource Identifier (URI) that represents the base Uniform Resource Identifier (URI) for an XAML-constructed object at XAML load time. This property is useful for Uniform Resource Identifier (URI) resolution at run time. (Geerbt von FrameworkElement)

BorderBrush

Lese-/SchreibzugriffGets or sets a brush that describes the border background of a control. (Geerbt von Control)

BorderThickness

Lese-/SchreibzugriffGets or sets the border thickness of a control. (Geerbt von Control)

CacheMode

Lese-/SchreibzugriffGets or sets a value that indicates that rendered content should be cached as a composited bitmap when possible. (Geerbt von UIElement)

CanDragItems

Lese-/SchreibzugriffGets or sets a value that indicates whether items in the view can be dragged as data payload. (Geerbt von ListViewBase)

CanReorderItems

Lese-/SchreibzugriffGets or sets a value that indicates whether items in the view can be reordered through user interaction. (Geerbt von ListViewBase)

CharacterSpacing

Lese-/SchreibzugriffGets or sets the uniform spacing between characters, in units of 1/1000 of an em. (Geerbt von Control)

Clip

Lese-/SchreibzugriffGets or sets the RectangleGeometry used to define the outline of the contents of a UIElement. (Geerbt von UIElement)

CompositeMode

Lese-/SchreibzugriffGets or sets a property that declares alternate composition and blending modes for the element in its parent layout and window. This is relevant for elements that are involved in a mixed XAML / Microsoft DirectX UI. (Geerbt von UIElement)

DataContext

Lese-/SchreibzugriffGets or sets the data context for a FrameworkElement when it participates in data binding. (Geerbt von FrameworkElement)

DataFetchSize

Lese-/SchreibzugriffGets or sets the amount of data to fetch for virtualizing/prefetch operations. (Geerbt von ListViewBase)

DefaultStyleKey

Lese-/SchreibzugriffGets or sets the key that references the default style for the control. Authors of custom controls use this property to change the default for the style that their control uses. (Geerbt von Control)

DesiredSize

SchreibgeschütztGets the size that this UIElement computed during the measure pass of the layout process. (Geerbt von UIElement)

Dispatcher

SchreibgeschütztGets the CoreDispatcher that this object is associated with. (Geerbt von DependencyObject)

DisplayMemberPath

Lese-/SchreibzugriffGets or sets the name or path of the property that is displayed for each data item. (Geerbt von ItemsControl)

FlowDirection

Lese-/SchreibzugriffGets or sets the direction in which text and other UI elements flow within any parent element that controls their layout. This property can be set to either LeftToRight or RightToLeft. Setting FlowDirection to RightToLeft on any element sets the alignment to the right, the reading order to right-to-left and the layout of the control to flow from right to left. (Geerbt von FrameworkElement)

FocusState

SchreibgeschütztGets a value that specifies whether this control has focus, and the mode by which focus was obtained. (Geerbt von Control)

FontFamily

Lese-/SchreibzugriffGets or sets the font used to display text in the control. (Geerbt von Control)

FontSize

Lese-/SchreibzugriffGets or sets the size of the text in this control. (Geerbt von Control)

FontStretch

Lese-/SchreibzugriffGets or sets the degree to which a font is condensed or expanded on the screen. (Geerbt von Control)

FontStyle

Lese-/SchreibzugriffGets or sets the style in which the text is rendered. (Geerbt von Control)

FontWeight

Lese-/SchreibzugriffGets or sets the thickness of the specified font. (Geerbt von Control)

Footer

Lese-/SchreibzugriffGets or sets the content for the list footer. (Geerbt von ListViewBase)

FooterTemplate

Lese-/SchreibzugriffGets or sets the DataTemplate used to display the content of the view footer. (Geerbt von ListViewBase)

FooterTransitions

Lese-/SchreibzugriffGets or sets the collection of Transition style elements that apply to the view footer. (Geerbt von ListViewBase)

Foreground

Lese-/SchreibzugriffGets or sets a brush that describes the foreground color. (Geerbt von Control)

GroupStyle

SchreibgeschütztGets a collection of GroupStyle objects that define the appearance of each level of groups. (Geerbt von ItemsControl)

GroupStyleSelector

Lese-/SchreibzugriffGets or sets a reference to a custom GroupStyleSelector logic class. The GroupStyleSelector returns different GroupStyle values to use for content based on the characteristics of that content. (Geerbt von ItemsControl)

Header

Lese-/SchreibzugriffGets or sets the content for the list header. (Geerbt von ListViewBase)

HeaderTemplate

Lese-/SchreibzugriffGets or sets the DataTemplate used to display the content of the view header. (Geerbt von ListViewBase)

HeaderTransitions

Lese-/SchreibzugriffGets or sets the collection of Transition style elements that apply to the view header. (Geerbt von ListViewBase)

Height

Lese-/SchreibzugriffGets or sets the suggested height of a FrameworkElement. (Geerbt von FrameworkElement)

HorizontalAlignment

Lese-/SchreibzugriffGets or sets the horizontal alignment characteristics that are applied to a FrameworkElement when it is composed in a layout parent, such as a panel or items control. (Geerbt von FrameworkElement)

HorizontalContentAlignment

Lese-/SchreibzugriffGets or sets the horizontal alignment of the control's content. (Geerbt von Control)

IncrementalLoadingThreshold

Lese-/SchreibzugriffGets or sets the threshold range that governs when the ListViewBase class will begin to prefetch more items. (Geerbt von ListViewBase)

IncrementalLoadingTrigger

Lese-/SchreibzugriffGets or sets a value that indicates the conditions for prefetch operations by the ListViewBase class. (Geerbt von ListViewBase)

IsActiveView

Lese-/SchreibzugriffGets or sets a value that indicates whether the ListViewBase instance is the active view in its owning SemanticZoom. (Geerbt von ListViewBase)

IsDoubleTapEnabled

Lese-/SchreibzugriffGets or sets a value that determines whether the DoubleTapped event can originate from that element. (Geerbt von UIElement)

IsEnabled

Lese-/SchreibzugriffGets or sets a value indicating whether the user can interact with the control. (Geerbt von Control)

IsGrouping

SchreibgeschütztGets a value that indicates whether the control is using grouping. (Geerbt von ItemsControl)

IsHitTestVisible

Lese-/SchreibzugriffGets or sets whether the contained area of this UIElement can return true values for hit testing. (Geerbt von UIElement)

IsHoldingEnabled

Lese-/SchreibzugriffGets or sets a value that determines whether the Holding event can originate from that element. (Geerbt von UIElement)

IsItemClickEnabled

Lese-/SchreibzugriffGets or sets a value that indicates whether items in the view fire an ItemClick event in response to interaction. (Geerbt von ListViewBase)

IsRightTapEnabled

Lese-/SchreibzugriffGets or sets a value that determines whether the RightTapped event can originate from that element. (Geerbt von UIElement)

IsSwipeEnabled

Lese-/SchreibzugriffGets or sets a value that indicates whether the view supports discrete input processing for a swipe interaction. (Geerbt von ListViewBase)

IsSynchronizedWithCurrentItem

Lese-/SchreibzugriffGets or sets a value that indicates whether a Selector should keep the SelectedItem synchronized with the current item in the Items property. (Geerbt von Selector)

IsTabStop

Lese-/SchreibzugriffGets or sets a value that indicates whether a control is included in tab navigation. (Geerbt von Control)

IsTapEnabled

Lese-/SchreibzugriffGets or sets a value that determines whether the Tapped event can originate from that element. (Geerbt von UIElement)

IsZoomedInView

Lese-/SchreibzugriffGets or sets a value that indicates whether the ListViewBase instance is the zoomed-in view in its owning SemanticZoom. (Geerbt von ListViewBase)

ItemContainerGenerator

SchreibgeschütztGets the ItemContainerGenerator associated with this ItemsControl. (Geerbt von ItemsControl)

ItemContainerStyle

Lese-/SchreibzugriffGets or sets the style that is used when rendering the item containers. (Geerbt von ItemsControl)

ItemContainerStyleSelector

Lese-/SchreibzugriffGets or sets a reference to a custom StyleSelector logic class. The StyleSelector returns different Style values to use for the item container based on characteristics of the object being displayed. (Geerbt von ItemsControl)

ItemContainerTransitions

Lese-/SchreibzugriffGets or sets the collection of Transition style elements that apply to the item containers of an ItemsControl. (Geerbt von ItemsControl)

Items

SchreibgeschütztGets the collection used to generate the content of the control. (Geerbt von ItemsControl)

ItemsPanel

Lese-/SchreibzugriffGets or sets the template that defines the panel that controls the layout of items. (Geerbt von ItemsControl)

ItemsPanelRoot

SchreibgeschütztGets the Panel specified by ItemsPanel. (Geerbt von ItemsControl)

ItemsSource

Lese-/SchreibzugriffGets or sets an object source used to generate the content of the ItemsControl. (Geerbt von ItemsControl)

ItemTemplate

Lese-/SchreibzugriffGets or sets the DataTemplate used to display each item. (Geerbt von ItemsControl)

ItemTemplateSelector

Lese-/SchreibzugriffGets or sets a reference to a custom DataTemplateSelector logic class. The DataTemplateSelector referenced by this property returns a template to apply to items. (Geerbt von ItemsControl)

Language

Lese-/SchreibzugriffGets or sets localization/globalization language information that applies to a FrameworkElement, and also to all child elements of the current FrameworkElement in the object representation and in UI. (Geerbt von FrameworkElement)

ManipulationMode

Lese-/SchreibzugriffGets or sets the ManipulationModes value used for UIElement behavior and interaction with gestures. Setting this value enables handling the manipulation events from this element in app code. (Geerbt von UIElement)

Margin

Lese-/SchreibzugriffGets or sets the outer margin of a FrameworkElement. (Geerbt von FrameworkElement)

MaxHeight

Lese-/SchreibzugriffGets or sets the maximum height constraint of a FrameworkElement. (Geerbt von FrameworkElement)

MaxWidth

Lese-/SchreibzugriffGets or sets the maximum width constraint of a FrameworkElement. (Geerbt von FrameworkElement)

MinHeight

Lese-/SchreibzugriffGets or sets the minimum height constraint of a FrameworkElement. (Geerbt von FrameworkElement)

MinWidth

Lese-/SchreibzugriffGets or sets the minimum width constraint of a FrameworkElement. (Geerbt von FrameworkElement)

Name

Lese-/SchreibzugriffGets or sets the identifying name of the object. When a XAML processor creates the object tree from XAML markup, run-time code can refer to the XAML-declared object by this name. (Geerbt von FrameworkElement)

Opacity

Lese-/SchreibzugriffGets or sets the degree of the object's opacity. (Geerbt von UIElement)

Padding

Lese-/SchreibzugriffGets or sets the padding inside a control. (Geerbt von Control)

Parent

SchreibgeschütztGets the parent object of this FrameworkElement in the object tree. (Geerbt von FrameworkElement)

PointerCaptures

SchreibgeschütztGets the set of all captured pointers, represented as Pointer values. (Geerbt von UIElement)

Projection

Lese-/SchreibzugriffGets or sets the perspective projection (3-D effect) to apply when rendering this element. (Geerbt von UIElement)

RenderSize

SchreibgeschütztGets the final render size of a UIElement. (Geerbt von UIElement)

RenderTransform

Lese-/SchreibzugriffGets or sets transform information that affects the rendering position of a UIElement. (Geerbt von UIElement)

RenderTransformOrigin

Lese-/SchreibzugriffGets or sets the origin point of any possible render transform declared by RenderTransform, relative to the bounds of the UIElement. (Geerbt von UIElement)

RequestedTheme

Lese-/SchreibzugriffGets or sets the UI theme that is used by the UIElement (and its child elements) for resource determination. The UI theme you specify with RequestedTheme can override the app-level RequestedTheme. (Geerbt von FrameworkElement)

Resources

Lese-/SchreibzugriffGets the locally defined resource dictionary. In XAML, you can establish resource items as child object elements of a frameworkElement.Resources property element, through XAML implicit collection syntax. (Geerbt von FrameworkElement)

SelectedIndex

Lese-/SchreibzugriffGets or sets the index of the selected item. (Geerbt von Selector)

SelectedItem

Lese-/SchreibzugriffGets or sets the selected item. (Geerbt von Selector)

SelectedItems

SchreibgeschütztGets the currently selected items. (Geerbt von ListViewBase)

SelectedValue

Lese-/SchreibzugriffGets or sets the value of the selected item, obtained by using the SelectedValuePath. (Geerbt von Selector)

SelectedValuePath

Lese-/SchreibzugriffGets or sets the property path that is used to get the SelectedValue property of the SelectedItem property. (Geerbt von Selector)

SelectionMode

Lese-/SchreibzugriffGets or sets the selection behavior for a ListViewBase instance. (Geerbt von ListViewBase)

SemanticZoomOwner

Lese-/SchreibzugriffGets or sets the SemanticZoom instance that hosts the ListViewBase. (Geerbt von ListViewBase)

ShowsScrollingPlaceholders

Lese-/SchreibzugriffGets or sets a value that indicates whether the view shows placeholder UI for items during scrolling. (Geerbt von ListViewBase)

Style

Lese-/SchreibzugriffGets or sets an instance Style that is applied for this object during layout and rendering. (Geerbt von FrameworkElement)

TabIndex

Lese-/SchreibzugriffGets or sets a value that determines the order in which elements receive focus when the user navigates through controls by pressing the Tab key. (Geerbt von Control)

TabNavigation

Lese-/SchreibzugriffGets or sets a value that modifies how tabbing and TabIndex work for this control. (Geerbt von Control)

Tag

Lese-/SchreibzugriffGets or sets an arbitrary object value that can be used to store custom information about this object. (Geerbt von FrameworkElement)

Template

Lese-/SchreibzugriffGets or sets a control template. The control template defines the visual appearance of a control in UI, and is defined in XAML markup. (Geerbt von Control)

Transitions

Lese-/SchreibzugriffGets or sets the collection of Transition style elements that apply to a UIElement. (Geerbt von UIElement)

Triggers

SchreibgeschütztGets the collection of triggers for animations that are defined for a FrameworkElement. Not commonly used. (Geerbt von FrameworkElement)

UseLayoutRounding

Lese-/SchreibzugriffGets or sets a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels. (Geerbt von UIElement)

VerticalAlignment

Lese-/SchreibzugriffGets or sets the vertical alignment characteristics that are applied to a FrameworkElement when it is composed in a parent object such as a panel or items control. (Geerbt von FrameworkElement)

VerticalContentAlignment

Lese-/SchreibzugriffGets or sets the vertical alignment of the control's content. (Geerbt von Control)

Visibility

Lese-/SchreibzugriffGets or sets the visibility of a UIElement. A UIElement that is not visible is not rendered and does not communicate its desired size to layout. (Geerbt von UIElement)

Width

Lese-/SchreibzugriffGets or sets the width of a FrameworkElement. (Geerbt von FrameworkElement)

 

Hinweise

Um eine Auflistung von Daten anzuzeigen, die einen vertikalen Bildlauf durchführen, verwenden Sie eine ListView. Um eine Auflistung anzuzeigen, die einen horizontalen Bildlauf durchführt, verwenden Sie eine GridView-Klasse.

ListView ist ein ItemsControl, sodass es eine Auflistung mit Elementen eines beliebigen Typs enthalten kann. Um die Ansicht zu füllen, fügen Sie Elemente der Items-Auflistung hinzu, oder legen Sie die ItemsSource-Eigenschaft auf eine Datenquelle fest.

Standardmäßig wird ein Datenelement in ListView als Zeichenfolgendarstellung des Datenobjekts angezeigt, an das es gebunden ist. Um genau anzugeben, wie Elemente in einer ListView angezeigt werden, erstellen Sie eine DataTemplate zur Definition des Layouts von Steuerelementen zur Anzeige eines einzelnen Elements. Die Steuerelemente im Layout können an Eigenschaften eines Datenobjekts gebunden werden oder verfügen über inline definierten Inhalt. Sie weisen die DataTemplate der ItemTemplate-Eigenschaft der ListView zu. Allgemeine Vorlagen, die Sie in der App verwenden können, finden Sie unter Elementvorlagen für Listenlayouts.

Hinweis  

Wenn Sie die ListView füllen, indem Sie die ItemsSource-Eigenschaft festlegen, wird ItemTemplate auf jedes Element angewendet. Wenn Sie die Items-Auflistung direkt füllen, wird ItemTemplate nur angewendet, wenn das Element kein ListViewItem ist. Weitere Informationen finden Sie in den Beispielen.

Standardmäßig kann ein Benutzer ein einzelnes Element in einer ListView auswählen. Sie können die SelectionMode-Eigenschaft auf einen ListViewSelectionMode-Enumerationswert festlegen, um Mehrfachauswahl zu ermöglichen oder Auswahl zu deaktivieren. Sie können den ListView-Interaktionsmodus auch ändern, damit Elemente auf einen Mausklick wie eine Schaltfläche reagieren, anstatt ausgewählt zu werden.

Diese Tabelle zeigt, mit welchen Methoden ein Benutzer mit ListView interagieren kann, und wie Sie auf die Interaktion reagieren können.

Um diese Interaktion zu ermöglichen:Verwenden Sie diese Einstellungen:Behandeln dieses Ereignisses:Verwenden Sie diese Eigenschaft, um das ausgewählte Element abzurufen:
Keine Interaktion SelectionMode = None, IsItemClickEnabled = FalseNicht zutreffendNicht zutreffend
Einfachauswahl SelectionMode = Single, IsItemClickEnabled = False SelectionChanged SelectedItem, SelectedIndex
Zusammenhängende Mehrfachauswahl SelectionMode = Multiple, IsItemClickEnabled = False SelectionChanged SelectedItems
Unzusammenhängende Mehrfachauswahl SelectionMode = Extended, IsItemClickEnabled = False SelectionChanged SelectedItems
Klicken SelectionMode = None, IsItemClickEnabled = True ItemClick Nicht zutreffend

 

Vorsicht  Das PointerWheelChanged-Ereignis wird nicht von einer ListView nach oben übergeben. Dies bedeutet, dass ein Steuerelement mit einem integrierten ListView keine Meldungen zu Mausänderungen empfängt, wenn der Mauszeiger über ListView ist. Wenn Sie beispielsweise eine ListView innerhalb eines ScrollViewer platzieren, können Sie im ScrollViewer keinen Bildlauf mit dem Mausrad durchführen, wenn sich der Mauszeiger über der ListView befindet.

ListView unterstützt die Datenvirtualisierung, um die Leistung bei großen Datasets zu verbessern. Die Virtualisierung von direktem Zugriff wird unterstützt, wenn die Datenquelle die Schnittstelle IObservableVector oder die Schnittstelle INotifyCollectionChanged implementiert. Virtualisierung für inkrementelles Laden wird unterstützt, wenn die Datenquelle die ISupportIncrementalLoading-Schnittstelle implementiert. Wenn inkrementelles Laden unterstützt wird, können Sie diese Member verwenden, um das Laden von Daten zu steuern: DataFetchSize, IncrementalLoadingThreshold, IncrementalLoadingTrigger, LoadMoreItemsAsync.

Windows 8:  Wenn das Datenelement unter Windows 8 in einem ausgewählten ListViewItem ersetzt wird, wird der Wert SelectedIndex nicht gelöscht. In Windows 8.1 wird der SelectedIndex-Wert gelöscht.

ListView implementiert die ISemanticZoomInformation-Schnittstelle, damit sie als Ansicht in einem SemanticZoom-Steuerelement verwendet werden kann. Wenn sie in einem SemanticZoom-Steuerelement verwendet wird, legen Sie die angefügte ScrollViewer.IsVerticalScrollChainingEnabled-Eigenschaft im ScrollViewer, der sich in der Steuerelementvorlage von ListView befindet, immer folgendermaßen auf false fest: <ListView ScrollViewer.IsVerticalScrollChainingEnabled="False">. Diese Member haben nur dann Auswirkungen, wenn ListView in einem SemanticZoom-Steuerelement gehostet wird: IsActiveView, IsZoomedInView, SemanticZoomOwner, CompleteViewChange, CompleteViewChangeFrom, CompleteViewChangeTo, InitializeViewChange, MakeVisible, StartViewChangeFrom, StartViewChangeTo.

Weitere Informationen finden Sie in den folgenden Themen:

Weitere Codebeispiele, die das ListView-Steuerelement anzeigen, finden Sie hier:

Auswahlverhalten und CollectionViewSource

Listensteuerelemente, die von Selector abgeleitet werden, weisen ein Standardauswahlverhalten auf, das von der Elementquelle abhängig ist (der Typ, der für ItemsSource verwendet wird). Wenn die Elementquelle eine CollectionViewSource-Instanz ist, wird im Auswahlsteuerelement standardmäßig das aktuelle Element ausgewählt. Wenn die Liste zum ersten Mal angezeigt wird, wird die Auswahl standardmäßig auf das erste Element als aktuelles Element festgelegt. Wenn das erste Element in diesem Fall nicht aktiviert sein soll, legen Sie IsSynchronizedWithCurrentItem auf false im ListView fest.

Beispiele

In diesem Beispiel wird die ItemTemplate einer ListView inline definiert. Da ItemsSource festgelegt ist, wird ItemTemplate auf jedes Element angewendet.


<ListView x:Name="itemListView"
          Margin="120,0,0,60"
          ItemsSource="{Binding Source={StaticResource itemsViewSource}}"
          SelectionChanged="ItemListView_SelectionChanged">
    <ListView.ItemTemplate>
        <DataTemplate>
            <Grid Height="110" Margin="6">
                <Grid.ColumnDefinitions>
                    <ColumnDefinition Width="Auto"/>
                    <ColumnDefinition Width="*"/>
                </Grid.ColumnDefinitions>
                <Border Background="{StaticResource ListViewItemPlaceholderBackgroundThemeBrush}" Width="110" Height="110">
                    <Image Source="{Binding Image}" Stretch="UniformToFill"/>
                </Border>
                <StackPanel Grid.Column="1" VerticalAlignment="Top" Margin="10,0,0,0">
                    <TextBlock Text="{Binding Title}" Style="{StaticResource TitleTextStyle}" TextWrapping="NoWrap"/>
                    <TextBlock Text="{Binding Subtitle}" Style="{StaticResource CaptionTextStyle}" TextWrapping="NoWrap"/>
                    <TextBlock Text="{Binding Description}" Style="{StaticResource BodyTextStyle}" MaxHeight="60"/>
                </StackPanel>
            </Grid>
        </DataTemplate>
    </ListView.ItemTemplate>          
</ListView>


In dieser ListView wird ItemTemplate auf das erste Element (eine Zeichenfolge), jedoch nicht auf das zweite Element (ein ListViewItem) angewendet. Weitere Informationen finden Sie in den Hinweisen.


<ListView>
    <ListView.ItemTemplate>
        <DataTemplate>
            <Grid>
                <Border Background="LightGray" Height="200" Width="200">
                    <TextBlock Text="{Binding}" 
                               FontSize="48" Foreground="Green" />
                </Border>
            </Grid>
        </DataTemplate>
    </ListView.ItemTemplate>
    <ListView.Items>
        <x:String>One</x:String>
        <ListViewItem>Two</ListViewItem>
    </ListView.Items>
</ListView>

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadaten

Windows.winmd

Siehe auch

ListViewBase
ISemanticZoomInformation

 

 

Anzeigen:
© 2014 Microsoft