Skip to end of metadata
Go to start of metadata

UXCallOut is an interactive popup control in a form of CallOut which can be used to represent the content inside the callout as well as the content of the control itself.

On this page:

Headered Content Control

UXCallOut derives from ISHeaderedContentControl, which means that it is using headered content presentation model. To learn more about headered content model, see Content Model Overview.

Understanding Header and Content in UXCallOut

The Content in UXCallOut represents the object inside the callout itself., while the Header represents the element attached to the callout.

The following example shows the difference between the Content and Header in UXCallOut.

UXCallOut

Configuring UXCallOut Animation

UXCallOut uses UXPopup control to display content which stays on the top of other elements along with comprehensive hide and display animation. Consequently, they share a number of settings that control the animation behaviors such as listed below.

To learn more about configuring the animation behaviors, see Popup Overview.

Configuring UXCallOut Positioning

You can position the UXCallOut to one of the supported mode through the PreferredPosition property. It is best practice to use either Top, Left, Right or Bottom position to take advantage of the callout pointer feature. Otherwise, the callout pointer will not be enabled.

Configuring Mouse Actions

Beside animation and positioning, you also can control when the callout should be displayed or collapsed based on mouse interaction, which is listed below.

By default, the MouseEnterAction property is set to ShowPopup, while the other properties are set to None. This setting shows the UXCallOut when your mouse cursor is over the element.

The following list describes the some configurations used in common UI scenarios: