Class AnchorPopup<T>

Base class for Popup that can be anchored to another UI Element.

Inheritance

object

Popup

Popup<T>

AnchorPopup<T>

MenuBuilder

Popover

Tooltip

Inherited Members

Popup<T>.m_LastFocusedElement

Popup<T>.shown

Popup<T>.dismissed

Popup<T>.SetKeyboardDismiss(bool)

Popup<T>.SetLastFocusedElement(Focusable)

Popup<T>.InvokeShownEventHandlers()

Popup.k_NextFrameDurationMs

Popup.k_PopupShow

Popup.k_PopupDismiss

Popup.handler

Popup.keyboardDismissEnabled

Popup.view

Popup.targetParent

Popup.contentView

Popup.Dismiss()

Popup.Dismiss(DismissType)

Popup.Show()

Popup.GetFocusableElement()

Popup.ShouldAnimate()

Popup.OnViewKeyDown(KeyDownEvent)

Popup.FindSuitableParent(VisualElement)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Unity.AppUI.UI

Assembly: Unity.AppUI.dll

Syntax

public abstract class AnchorPopup<T> : Popup<T> where T : AnchorPopup<T>

Type Parameters

Name	Description
T	The sealed anchor popup class type.

Constructors

AnchorPopup(VisualElement, VisualElement, VisualElement)

Default constructor.

Declaration

protected AnchorPopup(VisualElement parentView, VisualElement view, VisualElement contentView = null)

Parameters

Type	Name	Description
VisualElement	parentView	The popup container.
VisualElement	view	The popup visual element itself.
VisualElement	contentView	The content that will appear inside this popup.

Properties

anchor

The popup's anchor.

Declaration

public VisualElement anchor { get; }

Property Value

Type	Description
VisualElement

arrowVisible

True if the small arrow used next to the anchor should be visible, False otherwise.

Declaration

public bool arrowVisible { get; }

Property Value

Type	Description
bool

containerPadding

The padding in pixels, inside the popup panel's container.

Declaration

public int containerPadding { get; }

Property Value

Type	Description
int

crossOffset

The offset in pixels, in the direction of the secondary placement vector.

Declaration

public int crossOffset { get; }

Property Value

Type	Description
int

currentPlacement

The current placement. The current placement can be different from the placement set with SetPlacement(PopoverPlacement), based on the current position of the anchor on the screen and the ability to flip placement.

Declaration

public PopoverPlacement currentPlacement { get; }

Property Value

Type	Description
PopoverPlacement

offset

The offset in pixels, in the direction of the primary placement vector.

Declaration

public int offset { get; }

Property Value

Type	Description
int

outsideClickDismissEnabled

True if the the popup can be dismissed by clicking outside of it, False otherwise.

Declaration

public bool outsideClickDismissEnabled { get; protected set; }

Property Value

Type	Description
bool

outsideClickStrategy

The strategy used to determine if the click is outside of the popup.

Declaration

public OutsideClickStrategy outsideClickStrategy { get; protected set; }

Property Value

Type	Description
OutsideClickStrategy

outsideScrollEnabled

True if the the popup let the user to be able to scroll outside of it, False otherwise.

Declaration

public bool outsideScrollEnabled { get; protected set; }

Property Value

Type	Description
bool

placement

The desired placement. You can set the desired placement using SetPlacement(PopoverPlacement).

Declaration

public PopoverPlacement placement { get; }

Property Value

Type	Description
PopoverPlacement

shouldFlip

True if the popup will be displayed at the opposite position if there's not enough place using the preferred placement, False otherwise.

Declaration

public bool shouldFlip { get; }

Property Value

Type	Description
bool

Methods

AnimateViewIn()

Start the animation for this popup.

Declaration

protected override void AnimateViewIn()

Overrides

Popup.AnimateViewIn()

AnimateViewOut(DismissType)

Start the hide animation for this popup.

Declaration

protected override void AnimateViewOut(DismissType reason)

Parameters

Type	Name	Description
DismissType	reason

Overrides

Popup.AnimateViewOut(DismissType)

GetMovableElement()

Method which must return the visual element that needs to be moved, based on the anchor position and size.

Declaration

protected virtual VisualElement GetMovableElement()

Returns

Type	Description
VisualElement	The visual element which will be moved. The default value is view.

HideView(DismissType)

Called when the popup's Handler has received a k_PopupDismiss message.

Declaration

protected override void HideView(DismissType reason)

Parameters

Type	Name	Description
DismissType	reason	The reason why the popup should be dismissed.

Overrides

Popup.HideView(DismissType)

InvokeDismissedEventHandlers(DismissType)

Called when the popup has been dismissed. This method will invoke any handlers attached to the dismissed event.

Declaration

protected override void InvokeDismissedEventHandlers(DismissType reason)

Parameters

Type	Name	Description
DismissType	reason	The reason for the dismissal.

Overrides

Popup<T>.InvokeDismissedEventHandlers(DismissType)

RefreshPosition()

Recompute the position of the popup based on the anchor's position and size, but also others properties such as the offset, crossOffset, shouldFlip and placement.

Declaration

protected void RefreshPosition()

SetAnchor(VisualElement)

Set a new value for the anchor property. This will trigger a refresh of the current popup position automatically.

Declaration

public T SetAnchor(VisualElement value)

Parameters

Type	Name	Description
VisualElement	value	The new value.

Returns

Type	Description
T	The popup.

SetArrowVisible(bool)

Set a new value for the arrowVisible property. This will trigger a refresh of the current popup position automatically.

Declaration

public T SetArrowVisible(bool visible)

Parameters

Type	Name	Description
bool	visible	The new value.

Returns

Type	Description
T	The popup.

SetContainerPadding(int)

Set a new value for the containerPadding property. This will trigger a refresh of the current popup position automatically.

Declaration

public T SetContainerPadding(int value)

Parameters

Type	Name	Description
int	value	The new value.

Returns

Type	Description
T	The popup.

SetCrossOffset(int)

Set a new value for the crossOffset property.

Declaration

public T SetCrossOffset(int value)

Parameters

Type	Name	Description
int	value	The new value.

Returns

Type	Description
T	The popup.

SetOffset(int)

Set a new value for the offset property.

Declaration

public T SetOffset(int value)

Parameters

Type	Name	Description
int	value	The new value.

Returns

Type	Description
T	The popup.

SetOutsideClickDismiss(bool)

Activate the possibility to dismiss the popup by clicking outside of it.

Declaration

public T SetOutsideClickDismiss(bool dismissEnabled)

Parameters

Type	Name	Description
bool	dismissEnabled	True to activate the feature, False otherwise.

Returns

Type	Description
T	The popup of type T.

SetOutsideClickStrategy(OutsideClickStrategy)

Set the strategy used to determine if the click is outside of the popup.

Declaration

public T SetOutsideClickStrategy(OutsideClickStrategy strategy)

Parameters

Type	Name	Description
OutsideClickStrategy	strategy	The strategy to use.

Returns

Type	Description
T	The popup of type T.

SetOutsideScrollEnabled(bool)

Activate the possibility to scroll outside of the popup.

Declaration

public T SetOutsideScrollEnabled(bool scrollEnabled)

Parameters

Type	Name	Description
bool	scrollEnabled	True to activate the feature, False otherwise.

Returns

Type	Description
T	The popup of type T.

SetPlacement(PopoverPlacement)

Set the preferred placement value. This will trigger a refresh of the current popup position automatically.

Declaration

public T SetPlacement(PopoverPlacement popoverPlacement)

Parameters

Type	Name	Description
PopoverPlacement	popoverPlacement	The new value.

Returns

Type	Description
T	The popup.

SetShouldFlip(bool)

Set a new value for the shouldFlip property. This will trigger a refresh of the current popup position automatically.

Declaration

public T SetShouldFlip(bool value)

Parameters

Type	Name	Description
bool	value	The new value.

Returns

Type	Description
T	The popup.

ShouldDismiss(DismissType)

Returns True if the popup should be dismissed, False otherwise.

Declaration

protected override bool ShouldDismiss(DismissType reason)

Parameters

Type	Name	Description
DismissType	reason	The reason for the dismissal.

Returns

Type	Description
bool	True if the popup should be dismissed, False otherwise.

Overrides

Popup.ShouldDismiss(DismissType)

ShowView()

Called when the popup's Handler has received a k_PopupShow message. In this method the view should become visible at some point (directly or via an animation).

Declaration

protected override void ShowView()

Overrides

Popup.ShowView()