Signature control

BackColor

Long

Specifies the numeric value of the background color, with valid values from -2 to 16,777,215.

Border

Boolean

Specifies whether the control has a border. Values are:

• TRUE – Control has a border

• FALSE – Control does not have a border

BorderStyle

BorderStyle (enumeration)

Specifies the style of the border of the control. Values are:

• StyleBox!

• StyleLowered!

• StyleRaised!

BringToTop

Boolean

Specifies whether PocketBuilder moves the control to the front of the window.

Enabled

Boolean

Specifies whether the control is visible or grayed. Values are:

• TRUE – Control is visible

• FALSE – Control is grayed

Height

Integer

Specifies the height of the control, in PowerBuilder units.

PageStyle

SigPageStyle (enumeration)

Specifies the style of the control, which can be one of the following values:

• SIGPageStyleNone!

• SIGPageStyleDottedLines!

• SIGPageStyleGridLines!

• SIGPageStyleLeftMargin!

• SIGPageStyleRuledLines! (default)

• SIGPageStyleTopMargin!

• SIGPageStyleTopLeftMargin!

• SIGPageStyleYellowBackground!

PenMode

SigPenMode (enumeration)

Specifies the drawing mode. Values are:

• SIGPenModePen! – User can write or draw (default)

• SIGPenModeSelect! – User can select text

• SIGPenModeSpace! – User can collapse and expand white space

Tag

String

Specifies the tag value assigned to the control.

Tap_And_Hold_Indicator

Boolean

Specifies whether red or blue dots in a circular animation display to confirm that the user has performed a tap and hold action with the stylus on the control. This action on a Pocket PC simulates a right mouse-click. The property is enabled by default to conform with typical Pocket PC behavior.

ViewStyle

SigViewStyle (enumeration)

Specifies the type of user input expected. Values are:

• SIGViewStyleWriting! – Words in user input are converted to text

• SIGViewStyleTyping! – User inputs data using the SIP

• SIGViewStyleDrawing! – No attempt is made to convert user input into text and the SIP is disabled

Visible

Boolean

Specifies whether the control is visible. Values are:

• TRUE – Control is visible

• FALSE – Control is not visible

Width

Integer

Specifies the width of the control, in PowerBuilder units.

WrapMode

SigWrapMode (enumeration)

Specifies whether text is wrapped to the window or page. Values are:

• SigWrapModePage! – Wraps text to page

• SigWrapModeWindow! – Wraps text to window (default)

X

Integer

Specifies the X position (the distance from the left edge of the parent window), in PowerBuilder units.

Y

Integer

Specifies the Y position (the distance from the top of the parent window), in PowerBuilder units.

ZoomPercent

Integer

Specifies the zoom percent for the control. The default value is 100.

Clicked

Immediately after the control is tapped or clicked

Constructor

Immediately before the Open event occurs in the window

Destructor

Immediately after the Close event occurs in the window

GetFocus

Just before the control receives focus (before it is selected and becomes active)

LoseFocus

When the control loses focus (becomes inactive)

RButtonDown

When the user performs a tap and hold action on the control

Clear

Integer

Clears the contents of the control.

GetDataAsBitmap

Integer

Retrieves the data in the control as a standard Windows bitmap that is compatible with the Picture control and Windows desktop applications.

GetDataAsInk

Integer

Retrieves the data in the control in Pocket Word Ink (PWI) format. This format is compatible with Pocket Word.

GetDataAsRTF

Integer

Retrieves the text data in the control as an RTF ANSI text block in a blob or Unicode string. This function does not return graphic signature data.

GetDataAsText

Integer

Retrieves the text data in the control as a string. This function does not return graphic signature data.

SetDataAsInk

Integer

Sets data in Pocket Word Ink (PWI) format in the control. This format is compatible with Pocket Word.

SetDataAsRTF

Integer

Sets text data in the control as an RTF ANSI text block in a blob or Unicode string. This function does not set graphic signature data.

SetDataAsText

Integer

Sets the text data in the control as a string. This function does not return graphic signature data.

SetFocus

Integer

Sets focus to the control.