PopupBase
Represents the abstract base class for popup controls that display content in an overlay above other UI elements. Provides functionality for positioning, animation, and content management for popup-style controls.
Definition
Namespace:Telerik.Maui.Controls
Assembly:Telerik.Maui.Controls.dll
Syntax:
public abstract class PopupBase : BindableObject
Inheritance: objectPopupBase
Derived Classes:
Constructors
Initializes a new instance of the PopupBase class. Sets up the internal animation system and registers the instance for memory tracking.
public PopupBase()
Fields
AnimationDurationProperty
BindableProperty
Identifies the AnimationDuration bindable property.
public static readonly BindableProperty AnimationDurationProperty
AnimationEasingProperty
BindableProperty
Identifies the AnimationEasing bindable property.
public static readonly BindableProperty AnimationEasingProperty
AnimationTypeProperty
BindableProperty
Identifies the AnimationType bindable property.
public static readonly BindableProperty AnimationTypeProperty
ContentProperty
BindableProperty
Identifies the Content bindable property.
public static readonly BindableProperty ContentProperty
ContentTemplateProperty
BindableProperty
Identifies the ContentTemplate bindable property.
public static readonly BindableProperty ContentTemplateProperty
HorizontalOffsetProperty
BindableProperty
Identifies the HorizontalOffset bindable property.
public static readonly BindableProperty HorizontalOffsetProperty
IsModalProperty
BindableProperty
Identifies the IsModal bindable property.
public static readonly BindableProperty IsModalProperty
IsOpenProperty
BindableProperty
Identifies the IsOpen bindable property.
public static readonly BindableProperty IsOpenProperty
OutsideBackgroundColorProperty
BindableProperty
Identifies the OutsideBackgroundColor bindable property.
public static readonly BindableProperty OutsideBackgroundColorProperty
PlacementProperty
BindableProperty
Identifies the Placement bindable property.
public static readonly BindableProperty PlacementProperty
PlacementTargetProperty
BindableProperty
Identifies the PlacementTarget bindable property.
public static readonly BindableProperty PlacementTargetProperty
VerticalOffsetProperty
BindableProperty
Identifies the VerticalOffset bindable property.
public static readonly BindableProperty VerticalOffsetProperty
Properties
Gets or sets the duration in milliseconds for the popup open and close animations. This value is used for both opening and closing animations when AnimationType is not None.
public int AnimationDuration { get; set; }
The animation duration in milliseconds. The default value is 300.
AnimationEasing
Easing
Gets or sets the easing function used for popup opening and closing animations. This determines the acceleration curve for the animation when AnimationType is not None.
[TypeConverter(typeof(EasingTypeConverter))]
public Easing AnimationEasing { get; set; }
The Easing function for animations. The default value is .
Gets or sets the type of animation used when opening and closing the popup. Different animation types provide various visual effects for showing and hiding the popup.
public PopupAnimationType AnimationType { get; set; }
A PopupAnimationType value that specifies the animation type. The default value is Fade.
Content
View
Gets or sets the content to be displayed within the popup. When both Content and ContentTemplate are set, the ContentTemplate takes precedence.
public View Content { get; set; }
The View representing the popup's content, or null if no content is set.
ContentTemplate
DataTemplate
Gets or sets the data template used to generate the popup content dynamically. When set, this template will be used to create the content instead of the Content property.
public DataTemplate ContentTemplate { get; set; }
The DataTemplate used to create the popup content, or null if no template is set.
Gets or sets the horizontal offset of the popup from its calculated position based on the placement mode. Positive values move the popup to the right, negative values move it to the left.
public double HorizontalOffset { get; set; }
The horizontal offset value in device-independent units. The default value is 0.
Gets or sets a value indicating whether the popup is modal and prevents interaction with the underlying content. When modal, the popup displays an overlay background and captures all input until closed.
public bool IsModal { get; set; }
true if the popup is modal and blocks interaction with underlying content; otherwise, false. The default value is false.
Gets or sets a value indicating whether the popup is currently open and visible.
public bool IsOpen { get; set; }
true if the popup is open and visible; otherwise, false. The default value is false.
Gets or sets the background color of the overlay area outside the popup content when the popup is modal.
This color is applied to the area that covers the underlying content when IsModal is true.
public Color OutsideBackgroundColor { get; set; }
The Color of the modal overlay background. The default value is .
Gets or sets the placement mode that determines how the popup is positioned relative to its placement target. The popup may be repositioned automatically to ensure it remains visible within screen bounds.
public PlacementMode Placement { get; set; }
A PlacementMode value that specifies the popup placement. The default value is Bottom.
PlacementTarget
VisualElement
Gets or sets the visual element that the popup is positioned relative to. If not set, the popup will be positioned relative to the application's main page.
public VisualElement PlacementTarget { get; set; }
The VisualElement used as the placement target, or null to use the default placement target.
Gets or sets the vertical offset of the popup from its calculated position based on the placement mode. Positive values move the popup down, negative values move it up.
public double VerticalOffset { get; set; }
The vertical offset value in device-independent units. The default value is 0.