In This Article

ZapPanel Class

Represents a panel that positions child elements in sequential order, either horizontally or vertically.

public class ZapPanel : PanelBase, ILogicalParent, IVisualParent
Inheritance:
object Visual UIElement FrameworkElement Panel PanelBase object
Implements:
ILogicalParent IVisualParent

Constructors

ZapPanel()

Initializes a new instance of the ZapPanel class.

public ZapPanel()

Properties

AreChildrenWrapped

Gets or sets a value indicating whether the child items are wrapped around the item currently centered. This is a dependency property.

public bool AreChildrenWrapped { get; set; }

Property Value

bool:

true if the child items are wrapped around the item currently centered; otherwise, false. The default value is false.

CanHorizontallyScroll

Gets or sets a value that indicates whether scrolling on the horizontal axis is possible.

public bool CanHorizontallyScroll { get; set; }

Property Value

bool

CanVerticallyScroll

Gets or sets a value that indicates whether scrolling on the vertical axis is possible.

public bool CanVerticallyScroll { get; set; }

Property Value

bool

ExtentHeight

Gets the vertical size of the extent.

public double ExtentHeight { get; }

Property Value

double:

A double that represents, in device independent pixels, the vertical size of the extent. This property has no default value.

ExtentWidth

Gets the horizontal size of the extent.

public double ExtentWidth { get; }

Property Value

double:

A double that represents, in device independent pixels, the horizontal size of the extent. This property has no default value.

FocalIndex

Gets or sets the index of the focal child, which should be centered in the panel. This is a dependency property.

public int FocalIndex { get; set; }

Property Value

int:

The index of the focal child, which should be centered in the panel. If set to -1 then no focal item will be used. The default value is -1.

HasLogicalOrientation

Gets a value that indicates whether this Panel arranges its descendants in a single dimension.

protected override bool HasLogicalOrientation { get; }

Property Value

bool:

true if the orientation of the Panel is in one dimension; otherwise, false.

HorizontalOffset

Gets the horizontal offset of the scrolled content.

public double HorizontalOffset { get; }

Property Value

double:

A double that represents, in device independent pixels, the horizontal offset. This property has no default value.

IsFocalIndexAutoBound

Gets or sets a value indicating whether the FocalIndex property is automatically bound to the associated Selector.SelectedIndex property when used as an items host. This is a dependency property.

public bool IsFocalIndexAutoBound { get; set; }

Property Value

bool:

true if the FocalIndex property is automatically bound; otherwise, false. The default value is true.

LogicalOrientation

The Orientation of the panel, if the panel supports layout in only a single dimension.

protected override Orientation LogicalOrientation { get; }

Property Value

Orientation:

The Orientation of the panel. This property has no default value.

Orientation

Gets or sets the orientation that the child elements are arranged. This is a dependency property.

public Orientation Orientation { get; set; }

Property Value

Orientation:

The orientation that the child elements are arranged. The default value is Orientation.Vertical.

ScrollOwner

Gets or sets a ScrollViewer element that controls scrolling behavior.

public ScrollViewer ScrollOwner { get; set; }

Property Value

ScrollViewer:

A ScrollViewer element that controls scrolling behavior. This property has no default value.

VerticalOffset

Gets the vertical offset of the scrolled content.

public double VerticalOffset { get; }

Property Value

double:

A double that represents, in device independent pixels, the vertical offset of the scrolled content. Valid values are between zero and the ExtentHeight minus the ViewportHeight. This property has no default value.

ViewportHeight

Gets the vertical size of the viewport for this content.

public double ViewportHeight { get; }

Property Value

double:

A double that represents, in device independent pixels, the vertical size of the viewport for this content. This property has no default value.

ViewportWidth

Gets the horizontal size of the viewport for this content.

public double ViewportWidth { get; }

Property Value

double:

A double that represents, in device independent pixels, the horizontal size of the viewport for this content. This property has no default value.

Methods

ArrangeElements(IList<UIElement>, Size)

Positions the specified elements and determines a size for a FrameworkElement-derived class.

public override Size ArrangeElements(IList<UIElement> elements, Size finalSize)
Parameter Type Description
elements IList<UIElement>

The elements to be arranged.

finalSize Size

The final area within the parent that this element should use to arrange itself and the specified elements.

Returns

Size:

The actual size used.

LineDown()

Scrolls down within content by one logical unit.

public void LineDown()

LineLeft()

Scrolls left within content by one logical unit.

public void LineLeft()

LineRight()

Scrolls right within content by one logical unit.

public void LineRight()

LineUp()

Scrolls up within content by one logical unit.

public void LineUp()

MakeVisible(Visual, Rect)

Forces content to scroll until the coordinate space of a Visual object is visible.

public Rect MakeVisible(Visual visual, Rect rectangle)
Parameter Type Description
visual Visual

A Visual that becomes visible.

rectangle Rect

A bounding rectangle that identifies the coordinate space to make visible.

Returns

Rect:

A System.Windows.Rect that is visible.

MeasureElements(IList<UIElement>, Size)

Measures the size in layout required for the specified elements and determines a size for the FrameworkElement-derived class.

public override Size MeasureElements(IList<UIElement> elements, Size availableSize)
Parameter Type Description
elements IList<UIElement>

The elements to be measured.

availableSize Size

The available size that this element can give to the specified elements. Infinity can be specified as a value to indicate that the element will size to whatever content is available.

Returns

Size:

The size that this element determines it needs during layout, based on its calculations of the specified elements.

MouseWheelDown()

Scrolls down within content after a user clicks the wheel button on a mouse.

public void MouseWheelDown()

MouseWheelLeft()

Scrolls left within content after a user clicks the wheel button on a mouse.

public void MouseWheelLeft()

MouseWheelRight()

Scrolls right within content after a user clicks the wheel button on a mouse.

public void MouseWheelRight()

MouseWheelUp()

Scrolls up within content after a user clicks the wheel button on a mouse.

public void MouseWheelUp()

PageDown()

Scrolls down within content by one page.

public void PageDown()

PageLeft()

Scrolls left within content by one page.

public void PageLeft()

PageRight()

Scrolls right within content by one page.

public void PageRight()

PageUp()

Scrolls up within content by one page.

public void PageUp()

SetHorizontalOffset(double)

Sets the amount of horizontal offset.

public void SetHorizontalOffset(double offset)
Parameter Type Description
offset double

The degree to which content is horizontally offset from the containing viewport.

SetVerticalOffset(double)

Sets the amount of vertical offset.

public void SetVerticalOffset(double offset)
Parameter Type Description
offset double

The degree to which content is vertically offset from the containing viewport.

Fields

AreChildrenWrappedProperty

Identifies the AreChildrenWrapped dependency property. This field is read-only.

public static readonly DependencyProperty AreChildrenWrappedProperty

FocalIndexProperty

Identifies the FocalIndex dependency property. This field is read-only.

public static readonly DependencyProperty FocalIndexProperty

IsFocalIndexAutoBoundProperty

Identifies the IsFocalIndexAutoBound dependency property. This field is read-only.

public static readonly DependencyProperty IsFocalIndexAutoBoundProperty

OrientationProperty

Identifies the Orientation dependency property. This field is read-only.

public static readonly DependencyProperty OrientationProperty

Inherited Members