Popup.VerticalOffset Property

Reference

Definition

Namespace:: System.Windows.Controls.Primitives

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the vertical distance between the target origin and the popup alignment point.

public:
 property double VerticalOffset { double get(); void set(double value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
public double VerticalOffset { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
member this.VerticalOffset : double with get, set

Public Property VerticalOffset As Double

Property Value

Double

The vertical distance between the target origin and the popup alignment point. For information about the target origin and popup alignment point, see Popup Placement Behavior. The default is 0.

Attributes: BindableAttribute TypeConverterAttribute

Examples

The following example creates a Popup and sets the HorizontalOffset and VerticalOffset properties to 20. The Placement property is set to Bottom (which is the default), so the target origin is the bottom left corner of the target area, and the popup alignment point is the top left corner of the Popup.

<Canvas Width="200" Height="200" Background="Yellow" Margin="20">
  <Popup IsOpen="True" Placement="Bottom"
         HorizontalOffset="20" VerticalOffset="20">
    <TextBlock FontSize="14" Background="#42F3FD">
      This is a popup.
    </TextBlock>
  </Popup>
</Canvas>

Remarks

You can position a popup by setting the PlacementTarget, PlacementRectangle, Placement, HorizontalOffset, and VerticalOffset properties. For more information, see Popup Placement Behavior.

XAML Attribute Usage

<object VerticalOffset="double"/>
- or -
<object VerticalOffset="qualifiedDouble"/>

XAML Values

double Double

A string representation of a Double value. This is interpreted as a device-independent unit (1/96th inch) measurement. Strings do not have to explicitly include decimal points. For example, a value of 1 is acceptable.

The same Double range restrictions apply as those that are mentioned in the Property Value section of this topic.

qualifiedDouble A double value as described earlier in this table, followed by one of the following unit declaration strings: px, in, cm, or pt.

px (default) is device-independent units (1/96th inch per unit)

in is inches; 1in=96px

cm is centimeters; 1cm=(96/2.54) px

pt is points; 1pt=(96/72) px

Dependency Property Information

Item	Value
Identifier field	VerticalOffsetProperty
Metadata properties set to `true`	None

Applies to

Condividi tramite