Button Class
Namespace: Stride.UI.ControlsAssembly: Stride.UI.dll
Represents a Windows button control, which reacts to the Click event.
[DataContract("Button")]
[DataContractMetadataType(typeof(Button.ButtonMetadata))]
public class Button : ButtonBase, IUIElementUpdate, IUIElementChildren, IIdentifiable
Name | Description | |
---|---|---|
Constructors | ||
Button() | ||
Properties | ||
ImageStretchDirection | Gets or sets a value that indicates how the button image is scaled. |
|
ImageStretchType | Gets or sets a value that describes how the button image should be stretched to fill the destination rectangle. |
|
IsPressed | Gets a value that indicates whether the button is currently down. |
|
MouseOverImage | Gets or sets the image displayed when the mouse hovers over the button. |
|
NotPressedImage | Gets or sets the image displayed when the button is not pressed. |
|
PressedImage | Gets or sets the image displayed when the button is pressed. |
|
SizeToContent | Gets or sets whether the size depends on the Content. The default is |
|
Methods | ||
ArrangeOverride(Vector3) | ||
MeasureOverride(Vector3) | ||
OnAspectImageInvalidated() | Function triggered when one of the PressedImage and NotPressedImage images are invalidated. This function can be overridden in inherited classes. |
Constructors
Button()
public Button()
Properties
ImageStretchDirection
Gets or sets a value that indicates how the button image is scaled.
[DataMember]
[Display(null, "Layout")]
public StretchDirection ImageStretchDirection { get; set; }
Property Value
Type | Description |
---|---|
StretchDirection |
Remarks
This property has no effect is SizeToContent is true
.
ImageStretchType
Gets or sets a value that describes how the button image should be stretched to fill the destination rectangle.
[DataMember]
[Display(null, "Layout")]
public StretchType ImageStretchType { get; set; }
Property Value
Type | Description |
---|---|
StretchType |
Remarks
This property has no effect is SizeToContent is true
.
IsPressed
Gets a value that indicates whether the button is currently down.
public override bool IsPressed { get; protected set; }
Property Value
Type | Description |
---|---|
System.Boolean |
Overrides
MouseOverImage
Gets or sets the image displayed when the mouse hovers over the button.
[DataMember]
[Display(null, "Appearance")]
public ISpriteProvider MouseOverImage { get; set; }
Property Value
Type | Description |
---|---|
ISpriteProvider |
NotPressedImage
Gets or sets the image displayed when the button is not pressed.
[DataMember]
[Display(null, "Appearance")]
public ISpriteProvider NotPressedImage { get; set; }
Property Value
Type | Description |
---|---|
ISpriteProvider |
PressedImage
Gets or sets the image displayed when the button is pressed.
[DataMember]
[Display(null, "Appearance")]
public ISpriteProvider PressedImage { get; set; }
Property Value
Type | Description |
---|---|
ISpriteProvider |
SizeToContent
Gets or sets whether the size depends on the Content. The default is true
.
[DataMember]
[Display(null, "Layout")]
public bool SizeToContent { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
Methods
ArrangeOverride(Vector3)
protected override Vector3 ArrangeOverride(Vector3 finalSizeWithoutMargins)
Parameters
Type | Name | Description |
---|---|---|
Vector3 | finalSizeWithoutMargins |
Returns
Type | Description |
---|---|
Vector3 |
Overrides
MeasureOverride(Vector3)
protected override Vector3 MeasureOverride(Vector3 availableSizeWithoutMargins)
Parameters
Type | Name | Description |
---|---|---|
Vector3 | availableSizeWithoutMargins |
Returns
Type | Description |
---|---|
Vector3 |
Overrides
OnAspectImageInvalidated()
Function triggered when one of the PressedImage and NotPressedImage images are invalidated. This function can be overridden in inherited classes.
protected virtual void OnAspectImageInvalidated()