docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    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()
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)