## **Overview**
**Related Modules:**
[Graphic](Graphic.md)
**Description:**
Represents a button.
This component responds to the press and release events.
**Since:**
1.0
**Version:**
1.0
## **Summary**
## Public Types
ButtonImageSrc : uint8_t | Enumerates the images for different button states. |
ButtonState : uint8_t | Enumerates the states of this button. |
## Public Member Functions
UIButton () | A constructor used to create a UIButton instance. |
UIButton (const char *id) | A constructor used to create a UIButton instance based on the button ID. |
~UIButton () | A destructor used to delete the UIButton instance. |
GetViewType () const override | |
OnPreDraw (const Rect &invalidatedArea) override | Do something before draw, this function will be invoked mainly to check if this view need to cover invalidate area so render manager can decide which layer to draw firstly. |
OnDraw (const Rect &invalidatedArea) override | |
OnPressEvent (const PressEvent &event) override | Executes the press event action. |
OnReleaseEvent (const ReleaseEvent &event) override | Executes the press release event action. |
OnCancelEvent (const CancelEvent &event) override | Executes the cancel event action. |
SetImageSrc (const char *defaultImgSrc, const char *triggeredImgSrc) | Sets the image for this button. |
SetImageSrc (const ImageInfo *defaultImgSrc, const ImageInfo *triggeredImgSrc) | Sets the image for this button. |
SetImagePosition (const int16_t x, const int16_t y) | Sets the position for this image. |
GetImageX () const | Obtains the x-coordinate of this image. |
GetImageY () const | Obtains the y-coordinate of this image. |
GetCurImageSrc () const | const Image * Obtains the image for the current button state. |
GetWidth () override | Obtains the width of this image. |
GetHeight () override | Obtains the height of this image. |
SetWidth (int16_t width) override | Sets the width for this image. |
SetHeight (int16_t height) override | Sets the height for this image. |
GetContentRect () override | virtual Rect Obtains a rectangular area that contains coordinate information. |
GetStyle (uint8_t key) const override | |
SetStyle (uint8_t key, int64_t value) override | |
GetStyleForState (uint8_t key, ButtonState state) const | Obtains the style of a button in a specific state. |
SetStyleForState (uint8_t key, int64_t value, ButtonState state) | Sets the style for a button in a specific state. |
Disable () | |
Enable () | |
SetStateForStyle (ButtonState state) | Sets the state for a button. After the setting, calling SetStyle will change the style of this button, but not its state. |
UIView () | A default constructor used to create an UIView instance. |
UIView (const char *id) | A constructor used to create an UIView instance. |
~UIView () | A destructor used to delete the UIView instance. |
OnPostDraw (const Rect &invalidatedArea) | |
ReMeasure () | |
Invalidate () | Refreshes the invalidated area of the view. |
InvalidateRect (const Rect &invalidatedArea) | Refreshes a view in a specified invalidated area. |
OnLongPressEvent (const LongPressEvent &event) | Called when the view is long pressed. |
OnDragStartEvent (const DragEvent &event) | Called when the view starts to drag. |
OnDragEvent (const DragEvent &event) | Called when the view is being dragged. |
OnDragEndEvent (const DragEvent &event) | Called when the view stops dragging. |
OnClickEvent (const ClickEvent &event) | Called when the view is clicked. |
SetOnDragListener (OnDragListener *onDragListener) | Sets a drag event listener for the view. |
Obtains the drag event listener for the view. | |
SetOnClickListener (OnClickListener *onClickListener) | Sets a click event listener for the view. |
Obtains the click event listener for the view. | |
SetOnLongPressListener (OnLongPressListener *onLongPressListener) | Sets a long-press event listener for the view. |
Obtains the long-press event listener for the view. | |
SetOnTouchListener (OnTouchListener *onTouchListener) | Sets a touch event listener for the view. |
Obtains the touch event listener for the view. | |
GetTargetView (const Point &point, UIView **last) | Obtains the top-level view based on specified coordinates. |
Sets the parent view for the view. | |
GetParent () const | UIView * Obtains the parent view of the view. |
SetNextSibling (UIView *sibling) | Sets the next sibling view for the view. |
GetNextSibling () const | UIView * Obtains the next sibling view of the view. |
SetVisible (bool visible) | Sets whether the view is visible. |
IsVisible () const | Checks whether the view is visible. |
SetTouchable (bool touch) | Sets whether the view is touchable. |
IsTouchable () const | Checks whether the view is touchable. |
SetDraggable (bool draggable) | Sets whether the view is draggable. |
IsDraggable () const | Checks whether the view is draggable. |
SetDragParentInstead (bool dragParentInstead) | Sets whether to transfer the drag event to the parent view for processing when the view is being dragged. |
IsDragParentInstead () const | Obtains whether the view transfers a drag event to the parent view for processing. |
GetRect () const | Obtains the absolute rectangle area of the view. When the view has deformation such as rotation, the rectangle area is the intersection set of the absolute rectangle area and deformation matrix. |
GetVisibleRect () const | Obtains the visible absolute rectangle area of the view. |
GetMaskedRect () const | Obtains the valid absolute rectangle area of the view. The valid area refers to the area where the view can be displayed. Generally, the valid area is the same as the visible view area, but they may be different in the grid layout. |
GetOrigRect () const | Obtains the absolute rectangle area of the view. |
GetRelativeRect () const | Obtains the rectangular area of the view relative to the parent view, that is, the rectangular area relative to the coordinates of the parent view. |
ResizeVisibleArea (int16_t x, int16_t y, int16_t width, int16_t height) | Adjusts the size of the visible area. This operation may affect the final display size. |
Resize (int16_t width, int16_t height) | |
SetX (int16_t x) | Sets the x-coordinate for the view. |
GetX () const | Obtains the x-coordinate for the view. |
SetY (int16_t y) | Sets the y-coordinate for the view. |
GetY () const | Obtains the y-coordinate for the view. |
SetPosition (int16_t x, int16_t y) | Sets the position for the view. |
SetPosition (int16_t x, int16_t y, int16_t width, int16_t height) | Adjusts the position and size of the view. |
IsViewGroup () const | Checks whether the view is a container view. |
SetIntercept (bool isIntercept) | Sets whether to intercept the drag event. If intercepted, the view does not transfer the drag event to the parent view after local processing. |
SetTransformMap (const TransformMap &transMap) | Sets the affine transformation matrix. |
Obtains an affine transformation matrix. | |
GetChildById (const char *id) const | virtual UIView * Obtains the child view of a specified ID. |
SetViewId (const char *id) | |
GetViewId () const | |
SetViewIndex (int16_t index) | |
GetViewIndex () const | |
LayoutChildren (bool neeInvalidate=false) | Lays out all child views according to the preset arrangement mode. |
LayoutCenterOfParent (int16_t xOffSet=0, int16_t yOffset=0) | Lays out the view in the center of the parent view. |
LayoutLeftOfParent (int16_t offset=0) | Lays out the view on the left of the parent view. |
LayoutRightOfParent (int16_t offset=0) | Lays out the view on the right of the parent view. |
LayoutTopOfParent (int16_t offset=0) | Lays out the view on the top of the parent view. |
LayoutBottomOfParent (int16_t offset=0) | Lays out the view on the bottom of the parent view. |
AlignLeftToSibling (const char *id, int16_t offset=0) | Aligns the view with the left of a sibling view. |
AlignRightToSibling (const char *id, int16_t offset=0) | Aligns the view with the right of a sibling view. |
AlignTopToSibling (const char *id, int16_t offset=0) | Aligns the view with the top of a sibling view. |
AlignBottomToSibling (const char *id, int16_t offset=0) | Aligns the view with the bottom of a sibling view. |
AlignHorCenterToSibling (const char *id, int16_t offset=0) | Aligns the view with the center of a sibling view in the x-axis. |
AlignVerCenterToSibling (const char *id, int16_t offset=0) | Aligns the view with the center of a sibling view in the y-axis. |
LayoutLeftToSibling (const char *id, int16_t offset=0) | Lays out the view on the left of a sibling view. |
LayoutRightToSibling (const char *id, int16_t offset=0) | Lays out the view on the right of a sibling view. |
LayoutTopToSibling (const char *id, int16_t offset=0) | Lays out the view on the above of a sibling view. |
LayoutBottomToSibling (const char *id, int16_t offset=0) | Lays out the view on the below of a sibling view. |
GetStyleConst () const | const Style & Obtains the view style. This function applies to scenarios where the style does not need to be modified, which saves memory. |
operator new (size_t size) | |
operator delete (void *p) | Overrides the delete function. |