Button

  + Object
    + Display
      + UIComponent
        + Control
          + ActionControl
            + Button

The Button class implements behaviours specific to Button controls. A button is a basic control which simply raises a Click event when the user taps it with the stylus. This class is not instantiable, derivable or cloneable. The only instances available to the programmer are those automatically generated by HB++ when you place a control on a form.

The button's appearance is set during compilation using the Frame property. On the other hand, the text and font can be modified at runtime using the Font and Text properties inherited from the ActionControl class.

The button's behaviour can be modified by the value of the Repeating property. By default, this property is set to False and the button only raises one Click event once the user removes the stylus. If you set this property to True, the button raises Click events at regular intervals while the user keeps the stylus pressed down. This function is typically used for scrolling arrows for example.

Note: the PenMove event is not raised by this object but handled internally.

Members	Description

Repeating	Indicates if a button raises multiple Click events if it is held down.

Inherited from ActionControl	Description

Click	Raised when the user taps a control.
Font	Font used to display the control text.
Group	Group which the control belongs to.
HitControl	Simulates a tap on a control.
Text	Text displayed by the control.
Value	Control state.

Inherited from Control	Description

DrawFocusRing	Draws the focus ring.
GotFocus	Event raised when the control gains the focus.
Layer	Layer to which the control belongs.
LostFocus	Event raised when the control loses the focus.
NavFlags	Navigation flags for the control.
RemoveFocusRing	Erase the focus ring.
Tag	String associated with the control.
Visible	Indicates if a control is visible or not.

Inherited from UIComponent	Description

ComponentToScreen	Converts coordinates relative to a component into coordinates relative to the screen.
FiveWayNavigator	Event raised when the user presses one of the 5-way navigator keys.
Height	Element height.
Left	Distance between the left edge of the form and the left edge of the element.
Move	Moves or resizes an element.
PenDown	Event raised when the user touches an UI element with the stylus.
PenMove	Event raised when the user moves the stylus.
PenUp	Event raised when the user releases the stylus.
ScreenToComponent	Converts coordinates relative to the screen into coordinates relative a component.
Top	Distance between the top edge of the form and the top edge of the element.
UIRef	Internal reference to a control.
Width	Element width.

Inherited from Display	Description

Arc	Draws an arc.
BackColor	Background color.
BatchLimit	Size of the graphics instruction buffer.
CoordinateSystem	Coordinates system.
CopyArea	Efficiently copies part of a Display object to another.
DrawFont	Font used to draw the text.
Flush	Empties the graphics instruction buffer.
FontMetrics	Returns a FontMetrics object describing the physical charateristics of the currently active font.
ForeColor	Foreground color.
GetPixel	Queries the color of a given pixel.
hWin	Returns the window handle.
Line	Draws a line.
Oval	Draws a circle or ellipse.
Pattern	Defines the pattern used to fill drawings.
Polygon	Draws a polygon.
PutPixel	Sets the color of a pixel.
Rectangle	Draw a rectangle.
ResID	Identifier of the resource associated with the object.
ScaleFont	Enable or disable font scaling.
TextColor	Text color.
TextOut	Draw text.

Inherited from Object	Description

ClassID	Returns the type identifier corresponding to the actual class of the object.
Implements	Determines whether the object implements the features of a given class.
Iterate	Event raised to iterate over the elements of a container object.
Recipient	Recipient of events sent by the object.
Serialize	Event raised to serialize the object content into a stream.

System	Minimal version	Remarks

Palm OS	Palm OS 3.0	N/A