Edit

Share via

Popup.HorizontalOffset Property

  • Reference

Definition

Namespace:
System.Windows.Controls.Primitives
Assembly:
PresentationFramework.dll

Get or sets the horizontal distance between the target origin and the popup alignment point.

public:
 property double HorizontalOffset { double get(); void set(double value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
public double HorizontalOffset { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
member this.HorizontalOffset : double with get, set
Public Property HorizontalOffset As Double

Property Value

Double

The horizontal 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.

Dependency Property Information
Identifier field HorizontalOffsetProperty
Metadata properties set to true None

XAML Attribute Usage

<object HorizontalOffset="double"/>
- or -
<object HorizontalOffset="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

Applies to

See also