ActionControl

  + Object
    + Display
      + UIComponent
        + Control
          + ActionControl

The ActionControl class implements the common behaviors of control that only react to a user tap. Its subclasses are Button, CheckBox, PushButton and Selector. Like all derived classes of the UIComponent, this class is not instantiable, cloneable or derivable. The only instances available to the programmer are those automatically generated by HB++ when you place a control on a form.

The Font and Text properties sets the text displayed on the control as well as the font to use. Controls derived from the ActionControl class cannot display several lines of text or use several fonts: if you place a carriage return character (ANSI code 13) in the text of this control, it is ignored.

The Click event handles user taps on a control while the HitControl method raises this event.

The Group property defines the group that contains the control. When several controls are part of the same group, only one can be checked at the same time. A null value means that the control does not belong to a group. This property is available for checkboxes and pushbuttons and it has no effect on other types of control.

The Value property returns or sets the control state. If it is checked, its value is True otherwise it is False. This property is available for checkboxes and pushbuttons. It has no effect on other types of control.

Note: The PenMove event is never raised by objects derived from this class, but intercepted internally.

Members	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