Class Button

Definition

Namespace:

Tizen.NUI.Components

Assembly:

Tizen.NUI.Components.dll

API Level:

6

Button is one kind of common component, a button clearly describes what action will occur when the user selects it. Button may contain text or an icon.

public class Button : Control, INotifyPropertyChanged, IDynamicResourceHandler, IElement, INameScope, IElementController, IDisposable, IResourcesProvider

Inheritance

Object

Tizen.NUI.Binding.BindableObject

Tizen.NUI.Binding.Element

BaseHandle

Animatable

Container

View

ViewWrapper

CustomView

VisualView

Tizen.NUI.Components.Control

Button

Derived

Switch

Switch

Implements

INotifyPropertyChanged

IDisposable

Constructors

Button()

Creates a new instance of a Button.

Declaration

public Button()

API Level: 6

Button(String)

Creates a new instance of a Button with style.

Declaration

public Button(string style)

Parameters

Type	Name	Description
String	style	Create Button by special style defined in UX.

API Level: 8

Button(ButtonStyle)

Creates a new instance of a Button with style.

Declaration

public Button(ButtonStyle buttonStyle)

Parameters

Type	Name	Description
ButtonStyle	buttonStyle	Create Button by style customized by user.

API Level: 8

Properties

FontFamily

Text font family in Button.

Declaration

public string FontFamily { get; set; }

Property Value

Type	Description
String

API Level: 6

Icon

Button's icon part.

Declaration

public ImageView Icon { get; }

Property Value

Type	Description
ImageView

API Level: 8

IconPadding

Icon padding in Button, work only when show icon and text.

Declaration

public Extents IconPadding { get; set; }

Property Value

Type	Description
Extents

API Level: 6

IconRelativeOrientation

Icon relative orientation in Button, work only when show icon and text.

Declaration

public Button.IconOrientation? IconRelativeOrientation { get; set; }

Property Value

Type	Description
Nullable<Button.IconOrientation>

API Level: 8

IconURL

Icon image's resource url in Button.

Declaration

public string IconURL { get; set; }

Property Value

Type	Description
String

API Level: 6

IconURLSelector

Icon image's resource url selector in Button. Getter returns copied selector value if exist, null otherwise.

Declaration

public StringSelector IconURLSelector { get; set; }

Property Value

Type	Description
Tizen.NUI.Components.StringSelector

Exceptions

Type	Condition
NullReferenceException	Thrown when setting null value.

API Level: 6

IsEnabled

Flag to decide enable or disable in Button.

Declaration

public bool IsEnabled { get; set; }

Property Value

Type	Description
Boolean

API Level: 6

IsSelectable

Flag to decide Button can be selected or not.

Declaration

public bool IsSelectable { get; set; }

Property Value

Type	Description
Boolean

API Level: 6

IsSelected

Flag to decide selected state in Button.

Declaration

public bool IsSelected { get; set; }

Property Value

Type	Description
Boolean

API Level: 6

OverlayImage

Button's overlay image part.

Declaration

public ImageView OverlayImage { get; }

Property Value

Type	Description
ImageView

API Level: 8

PointSize

Text point size in Button.

Declaration

public float PointSize { get; set; }

Property Value

Type	Description
Single

API Level: 6

PointSizeSelector

Text font size selector in Button. Getter returns copied selector value if exist, null otherwise.

Declaration

public FloatSelector PointSizeSelector { get; set; }

Property Value

Type	Description
Tizen.NUI.Components.FloatSelector

Exceptions

Type	Condition
NullReferenceException	Thrown when setting null value.

API Level: 6

Style

Return a copied Style instance of Button

Declaration

public ButtonStyle Style { get; }

Property Value

Type	Description
ButtonStyle

Remarks

It returns copied Style instance and changing it does not effect to the Button. Style setting is possible by using constructor or the function of ApplyStyle(ViewStyle viewStyle)

API Level: 8

Text

The text of Button.

Declaration

public string Text { get; set; }

Property Value

Type	Description
String

API Level: 6

TextAlignment

Text horizontal alignment in Button.

Declaration

public HorizontalAlignment TextAlignment { get; set; }

Property Value

Type	Description
HorizontalAlignment

API Level: 6

TextColor

Text color in Button.

Declaration

public Color TextColor { get; set; }

Property Value

Type	Description
Color

API Level: 6

TextColorSelector

Text color selector in Button. Getter returns copied selector value if exist, null otherwise.

Declaration

public ColorSelector TextColorSelector { get; set; }

Property Value

Type	Description
Tizen.NUI.Components.ColorSelector

Exceptions

Type	Condition
NullReferenceException	Thrown when setting null value.

API Level: 6

TextLabel

Button's text part.

Declaration

public TextLabel TextLabel { get; }

Property Value

Type	Description
TextLabel

API Level: 8

TextPadding

Text padding in Button, work only when show icon and text.

Declaration

public Extents TextPadding { get; set; }

Property Value

Type	Description
Extents

API Level: 6

TextSelector

Text string selector in Button. Getter returns copied selector value if exist, null otherwise. NullReferenceException

Declaration

public StringSelector TextSelector { get; set; }

Property Value

Type	Description
Tizen.NUI.Components.StringSelector

API Level: 6

TranslatableText

Translate text string in Button.

Declaration

public string TranslatableText { get; set; }

Property Value

Type	Description
String

API Level: 6

TranslatableTextSelector

Translateable text string selector in Button. Getter returns copied selector value if exist, null otherwise.

Declaration

public StringSelector TranslatableTextSelector { get; set; }

Property Value

Type	Description
Tizen.NUI.Components.StringSelector

Exceptions

Type	Condition
NullReferenceException	Thrown when setting null value.

API Level: 6

Methods

ApplyStyle(ViewStyle)

Apply style to button.

Declaration

public override void ApplyStyle(ViewStyle viewStyle)

Parameters

Type	Name	Description
Tizen.NUI.BaseComponents.ViewStyle	viewStyle	The style to apply.

Overrides

Tizen.NUI.BaseComponents.View.ApplyStyle(Tizen.NUI.BaseComponents.ViewStyle)

API Level: 6

CreateViewStyle()

Get Button style.

Declaration

protected override ViewStyle CreateViewStyle()

Returns

Type	Description
Tizen.NUI.BaseComponents.ViewStyle	The default button style.

Overrides

Tizen.NUI.Components.Control.CreateViewStyle()

API Level: 8

Dispose(DisposeTypes)

Dispose Button and all children on it.

Declaration

protected override void Dispose(DisposeTypes type)

Parameters

Type	Name	Description
DisposeTypes	type	Dispose type.

Overrides

Tizen.NUI.Components.Control.Dispose(Tizen.NUI.DisposeTypes)

API Level: 6

OnFocusGained()

Called when the control gain key input focus. Should be overridden by derived classes if they need to customize what happens when the focus is gained.

Declaration

public override void OnFocusGained()

Overrides

Tizen.NUI.Components.Control.OnFocusGained()

API Level: 8

OnFocusLost()

Called when the control loses key input focus. Should be overridden by derived classes if they need to customize what happens when the focus is lost.

Declaration

public override void OnFocusLost()

Overrides

Tizen.NUI.Components.Control.OnFocusLost()

API Level: 8

OnKey(Key)

Called after a key event is received by the view that has had its focus set.

Declaration

public override bool OnKey(Key key)

Parameters

Type	Name	Description
Key	key	The key event.

Returns

Type	Description
Boolean	True if the key event should be consumed.

Overrides

Tizen.NUI.Components.Control.OnKey(Tizen.NUI.Key)

API Level: 6

OnTouch(Touch)

Deprecated in API8; Will be removed in API10. Please use OnClicked instead.

Called after a touch event is received by the owning view.
CustomViewBehaviour.REQUIRES_TOUCH_EVENTS must be enabled during construction. See CustomView(ViewWrapperImpl.CustomViewBehaviour behaviour).

Declaration

[Obsolete("Deprecated in API8; Will be removed in API10. Please use OnClicked instead.")]
public override bool OnTouch(Touch touch)

Parameters

Type	Name	Description
Touch	touch	The touch event.

Returns

Type	Description
Boolean	True if the event should be consumed.

Overrides

CustomView.OnTouch(Touch)

API Level: 8

Events

Clicked

An event for the button clicked signal which can be used to subscribe or unsubscribe the event handler provided by the user.

Declaration

public event EventHandler<ClickedEventArgs> Clicked

Event Type

Type	Description
EventHandler<ClickedEventArgs>

API Level: 8

ClickEvent

Deprecated in API8; Will be removed in API10. Please use Clicked event instead.

An event for the button clicked signal which can be used to subscribe or unsubscribe the event handler provided by the user.

Declaration

[Obsolete("Deprecated in API8; Will be removed in API10. Please use Clicked event instead.")]
public event EventHandler<Button.ClickEventArgs> ClickEvent

Event Type

Type	Description
EventHandler<Button.ClickEventArgs>

API Level: 6

StateChangedEvent

Deprecated in API8; Will be removed in API10. Please use View.ControlStateChangedEvent

An event for the button state changed signal which can be used to subscribe or unsubscribe the event handler provided by the user.

Declaration

[Obsolete("Deprecated in API8; Will be removed in API10. Please use View.ControlStateChangedEvent")]
public event EventHandler<Button.StateChangedEventArgs> StateChangedEvent

Event Type

Type	Description
EventHandler<Button.StateChangedEventArgs>

API Level: 6

Implements

System.ComponentModel.INotifyPropertyChanged

System.IDisposable