Class WaveLinkWidget

The public class WaveLinkWidget is supported on: Palm, CE

The Class WaveLinkWidget contains the methods necessary to build and manipulate all types of widget objects.

Deprecated.

Fields

ALLWIDGETTYPES

public static final int ALLWIDGETTYPES

Includes all widget types.

AUTOSIZE

public static final int AUTOSIZE

Widget Height or Width - Determine the widget extent by size of label text.

BYCELL

public static final int BYCELL

Coordinate Type - Position the widget using cell coordinates.

BYPERCENTAGE

public static final int BYPERCENTAGE

Coordinate Type - Position the widget using percentage coordinates.

BYPIXEL

public static final int BYPIXEL

Coordinate Type - Position the widget using pixel coordinates.

CENTERJUST

public static final int CENTERJUST

Label Formatting Flag - Center justify the widget label.

CHECKED

public static final int CHECKED

Checkbox State - This constant represents a checked checkbox state.

DOWNREPEATER

public static final int DOWNREPEATER

Repeater Button Type - This constant specifies a down arrow type repeater button.

INITDISABLED

public static final int INITDISABLED

Initial State - Initial state of the widget is disabled.

INITHIDDEN

public static final int INITHIDDEN

Initial State - Initial state of the widget is hidden.

INITSTANDARD

public static final int INITSTANDARD

Initial State - Initial state of the widget is standard (shown and enabled).

LEFTJUST

public static final int LEFTJUST

Label Formatting Flag - Left justify the widget label.

LEFTREPEATER

public static final int LEFTREPEATER

Repeater Button Type - This constant specifies a left arrow type repeater button.

PBFIXED

Public static final int PBFIXED

Initial State - Size each box of a push button widget equally.

PBHORIZONTAL

Public static final int PBHORIZONTAL

Initial State - Position a push button widget horizontally.

PBPROPORTIONAL

Public static final int PBPROPORTIONAL

Initial State - Size each box of a push button widget to the size of the text that it contains.

PBVERTICAL

Public static final int PBVERTICAL

Initial State - Position a push button widget vertically.

RIGHTJUST

public static final int RIGHTJUST

Label Formatting Flag - Right justify the widget label.

RIGHTREPEATER

public static final int RIGHTREPEATER

Repeater Button Type - This constant specifies a right arrow type repeater button.

UNCHECKED

public static final int UNCHECKED

Checkbox State - This constant represents an unchecked checkbox state.

UNDETERMINED

public static final int UNDETERMINED

Checkbox State - This constant represents an undetermined checkbox state.

UPREPEATER

public static final int UPREPEATER

Repeater Button Type - This constant specifies an up arrow type repeater button.

WAVELINKBITMAP

public static final int WAVELINKBITMAP

Widget Type - A bitmap image widget. This widget is based on a bitmap file.

WAVELINKBUTTON

public static final int WAVELINKBUTTON

Widget Type - A button widget. This widget is a standard labeled button that triggers a specific action when the user "clicks" it.

WAVELINKCHECKBOX

public static final int WAVELINKCHECKBOX

Widget Type - A checkbox widget. This widget stores an on/off state. The on/off state switches when the user taps it.

WAVELINKFIELD

public static final int WAVELINKFIELD

Widget Type - A field widget. This widget is an input box.

WAVELINKHOTSPOT

public static final int WAVELINKHOTSPOT

Widget Type - A hotspot widget. This widget is an invisible area that triggers a specific action when the user taps it.

WAVELINKLABEL

public static final int WAVELINKLABEL

Widget Type - A label widget. This widget consists of positioned text displayed in a proportionally spaced font.

WAVELINKMENUBAR

public static final int WAVELINKMENUBAR

Widget Type - A menubar widget. This widget is a menubar containing a set of menus. Each menu activates a pop-up list when the user taps it. The menus are based on WaveLinkMenu configurations.

WAVELINKPOPUP

public static final int WAVELINKPOPUP

Widget Type - A popup trigger widget. This widget displays a pop-up list when the user taps it. The currently selected item appears to the right of the trigger.

WAVELINKPUSHBUTTON

public static final int WAVELINKPUSHBUTTON

Widget Type - A push button widget. This widget consists of a set of buttons that store an on/off state. When the user selects a button, the selected button stores the "on" state, and all other buttons store the "off" state. Only one button can store the "on" state at any time.

WAVELINKREPEATER

public static final int WAVELINKREPEATER

Widget Type - A repeater button widget. This widget consists of a button that implies that something can be scrolled or incremented. The four available buttons are: left arrow, right arrow, up arrow, and down arrow.

WAVELINKSELECTOR

public static final int WAVELINKSELECTOR

Widget Type - A selector trigger widget. This widget triggers a dialog box when the user "clicks" it.

Constructors

public WaveLinkWidget()
public WaveLinkWidget(IWaveLinkSession currentSession)

Properties

CoordinateType Property

Stores and retrieves the coordinate type of the widget.

DisplayBackColor Property

Stores and retrieves the background color of the widget.

DisplayFlags Property

Stores and retrieves the label formatting flags of the widget.

DisplayFontName Property

Stores and retrieves the font name of the widget.

DisplayFontSize Property

Stores and retrieves the font size of the widget.

DisplayForeColor Property

Stores and retrieves the foreground color of the widget.

DisplayText Property

Stores and retrieves the label display text of the widget.

Height Property

Stores and retrieves the height of the widget.

InitialFlags Property

Stores and retrieves the initial state of the widget.

InitialValue Property

Stores and retrieves the initial value of the widget.

PlatformFlags Property

Stores and retrieves the platform-specific flags of the widget.

SpecialString Property

Stores and retrieves information specific to a widget based on its type.

WidgetID Property

Retrieves the unique identifier of the current widget.

WidgetType Property

Stores and retrieves the widget type.

Width Property

Stores and retrieves the width of the widget.

XCoord Property

Stores and retrieves the starting left coordinate of the widget.

YCoord Property

Stores and retrieves the starting top coordinate of the widget.

Methods

Enable Method

Enables or disables the widget.

Focus Method

Sets the input focus to the current widget.

SetCoordinates Method

Sets the type of positioning, the top left corner, the width, and the height of the widget.

SetDisplayInfo Method

Sets the formatting and text of the widget.

SetInitialInfo Method

Sets the initial value and state of the widget.

SetLabel Method

Changes the display text of the current widget.

SetReturnInfo Method

Sets the type and value of events returned by the widget.

SetSpecialInfo Method

Takes in a WaveLinkSpecialInfo object.

Show Method

Displays or hides the current widget.

Remarks

The WaveLinkWidget object is used primarily for manipulating widgets. Although you can also use the WaveLinkWidget object to create widgets, the WaveLinkFactory object effectively automates the widget creation process. For this reason, the WaveLinkFactory object is the recommended method for creating widgets.

Before widgets display on the device, you must use the StoreWidgets Method.

 


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other

Privacy and Legal