Share via

XRPlacementMode (Compact 2013)

  • Article

3/28/2014

This enumeration specifies the preferred location for positioning a tooltip relative to a visual element.

Syntax

enum XRPlacementMode{
  XRPlacementMode_Bottom = 2,
  XRPlacementMode_Right  = 4,
  XRPlacementMode_Mouse  = 7,
  XRPlacementMode_Left   = 9,
  XRPlacementMode_Top    = 10,
  XRPlacementMode_None   = -1,
};

Members

  • XRPlacementMode_Bottom
    Not supported in XAML for Windows Embedded.
  • XRPlacementMode_Right
    Not supported in XAML for Windows Embedded.

  • XRPlacementMode_Mouse
    Indicates that the preferred location of the tooltip is at the mouse pointer location.

    This setting has the same effect as XRPlacementMode_Bottom, except that the bounding box (the box that normally bounds the control) is the bounding box of the mouse cursor. This has the effect of displaying the popup below the area occupied by the mouse cursor. Edge behaviors are the same as those defined by XRPlacementMode_Bottom. This is the default value for XAML for Windows Embedded.

  • XRPlacementMode_Left
    Not supported in XAML for Windows Embedded.
  • XRPlacementMode_Top
    Not supported in XAML for Windows Embedded.
  • XRPlacementMode_None
    Not supported in XAML for Windows Embedded.

Remarks

Use XRPlacementMode enumeration values to specify the position of a tooltip when you call the IXRToolTip::SetPlacement method. XRPlacementMode_Mouse is the only member that is supported in XAML for Windows Embedded.

If the tooltip does not fit within the bounds of the XAML for Windows Embedded plug-in at the specified placement, it is automatically moved to a location where it fits. The tooltip is first moved to the opposite location of the specified placement, and then to the other locations in a top-to-bottom, left-to-right order. If the tooltip does not fit completely at the top, bottom, left, or right of the target element, the tooltip is positioned at the right and is clipped.

If the tooltip exceeds the width of the browser, it is clipped.

If the tooltip is automatically moved, the Placement value for the IXRToolTip control is not changed.

.NET Framework Equivalent

System.Windows.Controls.Primitives.PlacementMode

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

XAML for Windows Embedded Enumerations
IXRToolTip::GetPlacement
IXRToolTip::GetPlacementTarget
IXRToolTip::SetPlacement
IXRToolTip::SetPlacementTarget