Class Popup

Definition

Namespace:

ElmSharp

Assembly:

ElmSharp.dll

The Popup is a widget that is an enhancement of notify. In addition to content area, there are two optional sections, namely title area and action area.

public class Popup : Layout, IAccessibleObject

Inheritance

object

EvasObject

AccessibleObject

Widget

Container

Layout

Popup

Implements

IAccessibleObject

Constructors

Popup(EvasObject)

Creates and initializes a new instance of the Popup class.

Declaration

public Popup(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	The EvasObject to which the new popup will be attached as a child.

Properties

AlignmentX

Sets or gets the AlignmentX in which the popup will appear in its parent.

Declaration

public override double AlignmentX { get; set; }

Property Value

Type	Description
double

Overrides

EvasObject.AlignmentX

AlignmentY

Sets or gets the AlignmentY in which the popup will appear in its parent.

Declaration

public override double AlignmentY { get; set; }

Property Value

Type	Description
double

Overrides

EvasObject.AlignmentY

AllowEvents

Sets or gets whether events should be passed to the event blocked area by a click outside.

Declaration

public bool AllowEvents { get; set; }

Property Value

Type	Description
bool

Remarks

The visible region of the popup is surrounded by a translucent region called the Blocked event area.

ContentTextWrapType

Sets or gets the wrapping type of content text packed in the content area of Popup widget.

Declaration

public WrapType ContentTextWrapType { get; set; }

Property Value

Type	Description
WrapType

Remarks

Popup need to wrap the content text, so not allowing WrapType.None.

Opacity

Gets the opacity value of the popup.

Declaration

public override int Opacity { get; set; }

Property Value

Type	Description
int

Overrides

Widget.Opacity

Orientation

Sets or gets the position in which the popup will appear in its parent.

Declaration

public PopupOrientation Orientation { get; set; }

Property Value

Type	Description
PopupOrientation

Timeout

Sets or gets the timeout value set to the popup (in seconds).

Declaration

public double Timeout { get; set; }

Property Value

Type	Description
double

Remarks

Since calling Show() on a popup restarts the timer controlling when it is hidden, setting this before the popup is shown, will in effect mean starting the timer when the popup is shown. TimedOut is called afterwards, which can be handled, if needed. Set a value <= 0.0 to disable a running timer. If the value is > 0.0 and the popup is previously visible, the timer will be started with this value, canceling any running timer.

Methods

Append(string, EvasObject)

Adds the Label and icon to a Popup widget.

Declaration

public PopupItem Append(string label, EvasObject icon)

Parameters

Type	Name	Description
string	label	The Label, which will be added into a new PopupItem.
EvasObject	icon	The icon, which will be added into a new PopupItem.

Returns

Type	Description
PopupItem	The new PopupItem, which contains the label and icon.

Append(string)

Adds the label to a Popup widget.

Declaration

public PopupItem Append(string label)

Parameters

Type	Name	Description
string	label

Returns

Type	Description
PopupItem	The new PopupItem which contains a label.

CreateHandle(EvasObject)

Creates a widget handle.

Declaration

protected override IntPtr CreateHandle(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	Parent EvasObject.

Returns

Type	Description
System.IntPtr	Handle IntPtr.

Overrides

Layout.CreateHandle(EvasObject)

Dismiss()

Uses this function to dismiss the popup in hide effect. When the Popup is dismissed, the "dismissed" signal will be emitted.

Declaration

public void Dismiss()

Events

Dismissed

Dismissed will be triggered when the popup has been dismissed.

Declaration

public event EventHandler Dismissed

Event Type

Type	Description
System.EventHandler

OutsideClicked

OutsideClicked will be triggered when users taps on the outside of Popup.

Declaration

public event EventHandler OutsideClicked

Event Type

Type	Description
System.EventHandler

ShowAnimationFinished

OutsideClicked will be triggered when the popup transition has finished in showing.

Declaration

public event EventHandler ShowAnimationFinished

Event Type

Type	Description
System.EventHandler

TimedOut

OutsideClicked will be triggered when the popup is closed as a result of timeout.

Declaration

public event EventHandler TimedOut

Event Type

Type	Description
System.EventHandler

Implements

IAccessibleObject

Extension Methods

RotaryEventExtensions.Activate(EvasObject)

RotaryEventExtensions.AddRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.Deactivate(EvasObject)

RotaryEventExtensions.RemoveRotaryEventHandler(EvasObject, RotaryEventHandler)