Pivot Class

July 26, 2012

The Pivot control provides a quick way to manage the navigation of views within an application. The control can be used as a navigation interface for filtering large sets or switching between views.

Inheritance Hierarchy

System.Object
  System.Windows.DependencyObject
    System.Windows.UIElement
      System.Windows.FrameworkElement
        System.Windows.Controls.Control
          System.Windows.Controls.ItemsControl
            Microsoft.Phone.Controls.Primitives.TemplatedItemsControl<PivotItem>
              Microsoft.Phone.Controls.Pivot

Namespace: Microsoft.Phone.Controls
Assembly: Microsoft.Phone.Controls (in Microsoft.Phone.Controls.dll)
XMLNS for XAML: Not mapped to an xmlns.

Syntax

[TemplatePartAttribute(Name = "PivotItemPresenter", Type = typeof(ItemsPresenter))]
[StyleTypedPropertyAttribute(Property = "ItemContainerStyle", StyleTargetType = typeof(PivotItem))]
[TemplatePartAttribute(Name = "HeadersListElement", Type = typeof(PivotHeadersControl))]
public class Pivot : TemplatedItemsControl<PivotItem>

XAML Object Element Usage

<Pivot .../>

The Pivot type exposes the following members.

Constructors

	Name	Description
	Pivot	Initializes a new instance of the Pivot type.

Top

Properties

	Name	Description
	ActualHeight	(Inherited from FrameworkElement.)
	ActualWidth	(Inherited from FrameworkElement.)
	AllowDrop	(Inherited from UIElement.)
	Background	(Inherited from Control.)
	BorderBrush	(Inherited from Control.)
	BorderThickness	(Inherited from Control.)
	CacheMode	(Inherited from UIElement.)
	Clip	(Inherited from UIElement.)
	Cursor	(Inherited from FrameworkElement.)
	DataContext	(Inherited from FrameworkElement.)
	DefaultStyleKey	(Inherited from Control.)
	DesiredSize	(Inherited from UIElement.)
	Dispatcher	(Inherited from DependencyObject.)
	DisplayMemberPath	(Inherited from ItemsControl.)
	FlowDirection	(Inherited from FrameworkElement.)
	FontFamily	(Inherited from Control.)
	FontSize	(Inherited from Control.)
	FontStretch	(Inherited from Control.)
	FontStyle	(Inherited from Control.)
	FontWeight	(Inherited from Control.)
	Foreground	(Inherited from Control.)
	HeaderTemplate	Gets or sets the template for the Header property of PivotItem children.
	Height	(Inherited from FrameworkElement.)
	HorizontalAlignment	(Inherited from FrameworkElement.)
	HorizontalContentAlignment	(Inherited from Control.)
	IsEnabled	(Inherited from Control.)
	IsHitTestVisible	(Inherited from UIElement.)
	IsTabStop	(Inherited from Control.)
	ItemContainerGenerator	(Inherited from ItemsControl.)
	ItemContainerStyle	Gets or sets the ItemContainerStyle. (Inherited from TemplatedItemsControl<T>.)
	Items	(Inherited from ItemsControl.)
	ItemsPanel	(Inherited from ItemsControl.)
	ItemsSource	(Inherited from ItemsControl.)
	ItemTemplate	(Inherited from ItemsControl.)
	Language	(Inherited from FrameworkElement.)
	Margin	(Inherited from FrameworkElement.)
	MaxHeight	(Inherited from FrameworkElement.)
	MaxWidth	(Inherited from FrameworkElement.)
	MinHeight	(Inherited from FrameworkElement.)
	MinWidth	(Inherited from FrameworkElement.)
	Name	(Inherited from FrameworkElement.)
	Opacity	(Inherited from UIElement.)
	OpacityMask	(Inherited from UIElement.)
	Padding	(Inherited from Control.)
	Parent	(Inherited from FrameworkElement.)
	Projection	(Inherited from UIElement.)
	RenderSize	(Inherited from UIElement.)
	RenderTransform	(Inherited from UIElement.)
	RenderTransformOrigin	(Inherited from UIElement.)
	Resources	(Inherited from FrameworkElement.)
	SelectedIndex	Gets or sets the index of the selected (current) PivotItem.
	SelectedItem	Gets or sets the selected (current) PivotItem.
	Style	(Inherited from FrameworkElement.)
	TabIndex	(Inherited from Control.)
	TabNavigation	(Inherited from Control.)
	Tag	(Inherited from FrameworkElement.)
	Template	(Inherited from Control.)
	Title	Gets or sets the title to be optionally set above the headers.
	TitleTemplate	Gets or sets the title template used for displaying the title above the headers area.
	Triggers	(Inherited from FrameworkElement.)
	UseLayoutRounding	(Inherited from UIElement.)
	VerticalAlignment	(Inherited from FrameworkElement.)
	VerticalContentAlignment	(Inherited from Control.)
	Visibility	(Inherited from UIElement.)
	Width	(Inherited from FrameworkElement.)

Top

Methods

	Name	Description
	AddHandler	(Inherited from UIElement.)
	ApplyItemContainerStyle	Apply the ItemContainerStyle. (Inherited from TemplatedItemsControl<T>.)
	ApplyTemplate	(Inherited from Control.)
	Arrange	(Inherited from UIElement.)
	ArrangeOverride	Positions child elements and determines a size for a FrameworkElement derived class. (Overrides FrameworkElement.ArrangeOverride(Size).)
	CaptureMouse	(Inherited from UIElement.)
	CheckAccess	(Inherited from DependencyObject.)
	ClearContainerForItemOverride	When overridden in a derived class, undoes the effects of the PrepareContainerForItemOverride method. (Inherited from TemplatedItemsControl<T>.)
	ClearValue	(Inherited from DependencyObject.)
	Equals	(Inherited from Object.)
	Finalize	(Inherited from Object.)
	FindName	(Inherited from FrameworkElement.)
	Focus	(Inherited from Control.)
	GetAnimationBaseValue	(Inherited from DependencyObject.)
	GetBindingExpression	(Inherited from FrameworkElement.)
	GetContainer	Gets the container associated with the specified item. (Inherited from TemplatedItemsControl<T>.)
	GetContainerForItemOverride	Creates or identifies the element that is used to display the given item. (Inherited from TemplatedItemsControl<T>.)
	GetHashCode	(Inherited from Object.)
	GetItem	Gets the item associated with the specified container. (Inherited from TemplatedItemsControl<T>.)
	GetTemplateChild	(Inherited from Control.)
	GetType	(Inherited from Object.)
	GetValue	(Inherited from DependencyObject.)
	InvalidateArrange	(Inherited from UIElement.)
	InvalidateMeasure	(Inherited from UIElement.)
	IsItemItsOwnContainerOverride	Determines whether the specified item is (or is eligible to be) its own container. (Inherited from TemplatedItemsControl<T>.)
	Measure	(Inherited from UIElement.)
	MeasureOverride	Measures the size in layout required for child elements and determines a size for the FrameworkElement-derived class. (Overrides FrameworkElement.MeasureOverride(Size).)
	MemberwiseClone	(Inherited from Object.)
	OnApplyTemplate	Overrides the on apply template method to connect template parts. (Overrides FrameworkElement.OnApplyTemplate().)
	OnCreateAutomationPeer	(Inherited from UIElement.)
	OnDoubleTap	(Inherited from Control.)
	OnDragEnter	(Inherited from Control.)
	OnDragLeave	(Inherited from Control.)
	OnDragOver	(Inherited from Control.)
	OnDrop	(Inherited from Control.)
	OnGotFocus	(Inherited from Control.)
	OnHold	(Inherited from Control.)
	OnItemsChanged	Update the header items when there are changes in the pivot items collection. (Overrides ItemsControl.OnItemsChanged(NotifyCollectionChangedEventArgs).)
	OnKeyDown	(Inherited from Control.)
	OnKeyUp	(Inherited from Control.)
	OnLoadedPivotItem	Override for notifying that an item has loaded.
	OnLoadingPivotItem	Overrride for creating content for a given item.
	OnLostFocus	(Inherited from Control.)
	OnLostMouseCapture	(Inherited from Control.)
	OnManipulationCompleted	(Inherited from Control.)
	OnManipulationDelta	(Inherited from Control.)
	OnManipulationStarted	(Inherited from Control.)
	OnMouseEnter	(Inherited from Control.)
	OnMouseLeave	(Inherited from Control.)
	OnMouseLeftButtonDown	(Inherited from Control.)
	OnMouseLeftButtonUp	(Inherited from Control.)
	OnMouseMove	(Inherited from Control.)
	OnMouseRightButtonDown	(Inherited from Control.)
	OnMouseRightButtonUp	(Inherited from Control.)
	OnMouseWheel	(Inherited from Control.)
	OnSelectionChanged	Responds to a pivot selection change by raising a SelectionChanged event.
	OnTap	(Inherited from Control.)
	OnTextInput	(Inherited from Control.)
	OnTextInputStart	(Inherited from Control.)
	OnTextInputUpdate	(Inherited from Control.)
	OnUnloadedPivotItem	The unloaded event handler.
	OnUnloadingPivotItem	The unloading event handler.
	PrepareContainerForItemOverride	Prepares the container to display the specified item. (Overrides TemplatedItemsControl<T>.PrepareContainerForItemOverride(DependencyObject, Object).)
	ReadLocalValue	(Inherited from DependencyObject.)
	ReleaseMouseCapture	(Inherited from UIElement.)
	RemoveHandler	(Inherited from UIElement.)
	SetBinding	(Inherited from FrameworkElement.)
	SetValue	(Inherited from DependencyObject.)
	ToString	(Inherited from Object.)
	TransformToVisual	(Inherited from UIElement.)
	UpdateItemVisibility	Shows or hides an item.
	UpdateLayout	(Inherited from UIElement.)

Top

Events

	Name	Description
	BindingValidationError	(Inherited from FrameworkElement.)
	DoubleTap	(Inherited from UIElement.)
	GotFocus	(Inherited from UIElement.)
	Hold	(Inherited from UIElement.)
	IsEnabledChanged	(Inherited from Control.)
	KeyDown	(Inherited from UIElement.)
	KeyUp	(Inherited from UIElement.)
	LayoutUpdated	(Inherited from FrameworkElement.)
	Loaded	(Inherited from FrameworkElement.)
	LoadedPivotItem	Event for indicating that an item has fully loaded.
	LoadingPivotItem	Event for offering an opportunity to dynamically load or change the content of a pivot item before it is displayed.
	LostFocus	(Inherited from UIElement.)
	LostMouseCapture	(Inherited from UIElement.)
	ManipulationCompleted	(Inherited from UIElement.)
	ManipulationDelta	(Inherited from UIElement.)
	ManipulationStarted	(Inherited from UIElement.)
	MouseEnter	(Inherited from UIElement.)
	MouseLeave	(Inherited from UIElement.)
	MouseLeftButtonDown	(Inherited from UIElement.)
	MouseLeftButtonUp	(Inherited from UIElement.)
	MouseMove	(Inherited from UIElement.)
	MouseWheel	(Inherited from UIElement.)
	SelectionChanged	Occurs when the currently selected item changes.
	SizeChanged	(Inherited from FrameworkElement.)
	Tap	(Inherited from UIElement.)
	TextInput	(Inherited from UIElement.)
	TextInputStart	(Inherited from UIElement.)
	TextInputUpdate	(Inherited from UIElement.)
	Unloaded	(Inherited from FrameworkElement.)
	UnloadedPivotItem	Event for notifying that the pivot item has been completely unloaded from the visual pivot.
	UnloadingPivotItem	Event for offering an opportunity to dynamically load, change, or remove the content of a pivot item as it is removed.

Top

Fields

	Name	Description
	HeaderTemplateProperty	Identifies the HeaderTemplate dependency property.
	SelectedIndexProperty	Identifies the SelectedIndex dependency property.
	SelectedItemProperty	Identifies the SelectedItem dependency property.
	TitleProperty	Identifies the Title dependency property.
	TitleTemplateProperty	Identifies the TitleTemplate dependency property.

Top

Version Information

Windows Phone OS

Supported in: 7.1, 7.0

Platforms

Windows Phone

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

Microsoft.Phone.Controls Namespace

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)