Export (0) Print
Expand All
Expand Minimize

Repeater Element

Repeats a markup based on a given dataset.

Syntax

<Repeater
    Alpha="float"
    AnimationsEnabled="{true | false}"
    CenterPointOffset="Vector3"
    CenterPointPercent="Vector3"
    ColorFilter="Color"
    ContentName="string"
    ContentSelectors="IList"
    DebugOutline="Color"
    DefaultFocusIndex="int"
    DiscardOffscreenVisuals="{true | false}"
    DividerName="string"
    FocusOrder="int"
    Layout="{Anchor | Center | Dock | Fill | Form | Grid | HorizontalFlow | Rotate | Scale | VerticalFlow}"
    LayoutInput="LayoutInput"
    Margins="Inset"
    MaximumSize="Size"
    MinimumSize="Size"
    MouseInteractive="{true | false}"
    Name="string"
    Navigation="NavigationPolicies enumeration"
    Padding="Inset"
    Rotation="Rotation"
    Scale="Vector3"
    Source="IList"
    TouchInteractive="{true | false}"
    Visible="{true | false}"
>
    <Animations />
    <Children />
    <Content />
    <Divider />
    <Layout />
    <LayoutInput />
</Repeater>

Attributes

Alpha

Specifies the opacity value for the view item. This value must be between 0.0 and 1.0.

AnimationsEnabled

Specifies whether animations are enabled for the view item and child elements.

Animations

Contains a list of elements that describe an animation. Possible elements are:

Animation

MergeAnimation

SwitchAnimation

TransformAnimation

TransformByAttributeAnimation

CenterPointOffset

Specifies a center point adjustment based on a pixel-offset value when applying a scale or rotation to the view item. This value is applied after the CenterPointPercent value has been applied if both are provided. Use the inline construction for the Vector3 structure.

CenterPointPercent

Specifies a center point adjustment based on a percentage value when applying a scale or rotation to the view item. This value must be between 0 and 1, where a value of 1 equals 100%. Use the inline construction for the Vector3 structure.

Children

Specifies the child elements for a view item. Possible child elements are:

Clip

ColorFill

Graphic

Host

Panel

Repeater

Scroller

Text

Video

ColorFilter

Indicates the Color of the filter to apply on top of the color of the view item.

Content

A property that specifies the visual content to repeat, which can be one of the following elements (only one direct child of a Content element is allowed):

Clip

ColorFill

Graphic

Host

NowPlaying

Panel

Repeater

Scroller

Text

Video

ContentName

Contains the visual content to repeat (non-inline form). Content comes from a named Content element elsewhere in the UI.

ContentSelectors

List of content selectors for non-homogeneous repeating. The list is read-only (although you can modify the contents of the list).

DebugOutline

Enables and sets the Color of the debugging outline of the view item.

DefaultFocusIndex

Specifies the item that should be given a preferential focus order when repeated. Setting this property does not force the specified item to be repeated.

DiscardOffscreenVisuals

Specifies to remove visuals that go offscreen.

Divider

The visual content to insert between repeated items. Divider is the root of a tree of visual primitives:

Clip

ColorFill

Graphic

Host

Panel

Scroller

Text

DividerName

Contains the visual content to insert between repeated items (non-inline form). Divider comes from a named Content element.

FocusOrder

Specifies relative priorities to sibling view items within the container for determining which item has default focus when entering a UI. Values can range from 0 (the highest priority) to Int32.MaxValue (the lowest priority and the default).

Layout

Specifies the current layout associated with this view item. You can use the inline construction, or expanded syntax with the following child elements that define a layout:

AnchorLayout

DockLayout

FlowLayout

GridLayout

RotateLayout

ScaleLayout

LayoutInput

Specifies the layout input for use by parent layouts. You can use the inline construction to specify a reference to a layout element, or use expanded syntax with the following child elements that define input:

AnchorLayoutInput

DockLayoutInput

FormLayoutInput

Margins

An Inset structure that specifies extra spacing outside the boundaries of the view item.

MaximumSize

Specifies the maximum Size, in pixels. If a maximum size is not specified or the maximum size is set to zero, the size will not be restricted.

MinimumSize

Specifies the minimum Size, in pixels. If a maximum size is not specified or the maximum size is set to zero, the size will not be restricted.

MouseInteractive

Determines whether the view item can receive and react to mouse input.

Name

Identifies this element.

Navigation

Specifies how the view item should behave during directional navigation. This value must be a member of the NavigationPolicies enumeration.

Padding

An Inset structure that specifies the extra spacing, in pixels, between the view item and its child elements.

Rotation

Applies a Rotation to the view item. Use the inline construction for this element.

Scale

A Vector3 structure that applies a scaling factor to the view item. Use the inline construction for this element.

Source

Specifies the data to repeat.

TouchInteractive

Determines whether the view item can receive and react to touch input.

Visible

Specifies whether the view item is visible.

Public Instance Methods

MethodDescription
AttachAnimationDynamically adds an animation.
DetachAnimationDynamically removes an animation from the view item.
ForceContentChangeManually forces a content change for animations.
NavigateIntoRequests navigation into the view item to send focus to the view item or one of its children.
NavigateIntoIndexSends keyboard focus to the child with the specified virtual index. This method attempts to create the item if it hasn't already been repeated.

Requirements

Platform: Windows Vista Ultimate, Windows Vista Home Premium, and later

See Also

Show:
© 2015 Microsoft