Export (0) Print
Expand All

ToolTip.CustomPopupPlacementCallback Property

Gets or sets the delegate handler method to use to position the ToolTip.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

[BindableAttribute(false)]
public CustomPopupPlacementCallback CustomPopupPlacementCallback { get; set; }

Property Value

Type: System.Windows.Controls.Primitives.CustomPopupPlacementCallback
The CustomPopupPlacementCallback delegate method that provides placement information for the ToolTip. The default is null.

Identifier field

CustomPopupPlacementCallbackProperty

Metadata properties set to true

None

The Placement property must be set to Custom for the callback delegate to be used.

The CustomPopupPlacementCallback delegate returns an array of possible points that are defined with respect to the PlacementTarget. When the ToolTip is displayed, a point is chosen that maximizes the amount of the ToolTip window that is visible.

The following example shows how to set the CustomPopupPlacementCallback property and create the corresponding delegate. The same technique is used to by the Popup, which is demonstrated in the Popup Placement Sample.

aToolTip.Placement = PlacementMode.Custom;
aToolTip.CustomPopupPlacementCallback =
    new CustomPopupPlacementCallback(placeToolTip);
        public CustomPopupPlacement[] placeToolTip(Size popupSize,
	                                               Size targetSize,
	                                               Point offset)
        {
            CustomPopupPlacement placement1 =
               new CustomPopupPlacement(new Point(-50, 100), PopupPrimaryAxis.Vertical);

            CustomPopupPlacement placement2 =
                new CustomPopupPlacement(new Point(10, 20), PopupPrimaryAxis.Horizontal);

            CustomPopupPlacement[] ttplaces =
                    new CustomPopupPlacement[] { placement1, placement2 };
            return ttplaces;
        }

More Code

How to: Specify a Custom Popup PositionThis example shows how to specify a custom position for a Popup control when the Placement property is set to Custom.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft