InkPic.property

Description

Properties that control the behavior of ink in an InkPicture control.

Applies to

InkPicture controls

Syntax

PowerBuilder dot notation:

dw_control.Object.inkpicname.InkPic.property

Describe and Modify argument:

"inkpicname.InkPic.property { = value }"

Parameter	Description
inkpicname	The name of an InkPicture control.
property	A property for the InkPicture control. Properties and their settings are listed in the table below.
value	The value to be assigned to the property.

Property for InkPic	Value
AutoErase	Specifies whether the auto erase feature available on some styluses is turned on. Values are: true – AutoErase is turned on. false – AutoErase is turned off (default). Painter: AutoErase option.
BackColor	Specifies the numeric value of the background color: –2 to 16,777,215. For more information about color, see the RGB function. Painter: BackColor option.
CollectionMode	Specifies whether ink only, gestures only, or ink and gestures are collected. Values are: InkOnly (0) – Only ink is collected (default). GestureOnly (1) – Only gestures are collected. InkAndGesture (2) – Ink and gestures are collected. Painter: CollectionMode option.
DynamicRendering	Specifies whether the ink is rendered (displayed in the control) as it is drawn. The default is true. Painter: DynamicRendering option.
EditMode	Specifies whether the editing mode of the control is set for drawing, deleting, or selecting ink. Values are: InkMode (0) – Ink is drawn (default). DeleteMode (1) – Ink is deleted. SelectMode (2) – Ink is selected. Painter: EditMode option.
EraserMode	Specifies whether ink is removed by stroke or point. Values are: StrokeErase (0) – The entire ink stroke under the stylus is removed (default). PointErase (1) – Only the ink under the stylus is removed. Painter: EraserMode option.
EraserWidth	Specifies the width of the eraser pen tip in HIMETRIC units (1 HIMETRIC unit = .01mm). The default is 212. This property applies when EditMode is set to DeleteMode and EraserMode is set to PointErase. Painter: EraserWidth option.
HighContrastInk	Specifies whether ink is rendered in a single color when the system is in high contrast mode and draws the selection rectangle and handles in high contrast. Values are: true – Ink is rendered in a single color in high contrast mode (default). false – Ink is not rendered in a single color in high contrast mode. Painter: HighContrastInk option.
InkEnabled	Specifies whether the InkPicture control collects pen input. Values are: true – The control collects pen input (default). false – The control does not collect pen input and no pen-related events fire. Painter: InkEnabled option.
MarginX	Specifies the x-axis margin around the control in PowerBuilder units. The default value is 0. Painter: MarginX option.
MarginY	Specifies the y-axis margin around the control in PowerBuilder units. The default value is 0. Painter: MarginY option.
PictureSizeMode	Specifies how the picture is displayed in the control. Values are: Center Image (1) – The picture is centered in the control. Normal (2) – The picture is displayed in the upper-left corner of the control and any part of the picture that does not fit in the control is clipped (default). Stretch (3) – The picture is stretched to fill the control. Painter: PictureSizeMode option.

Usage

In the painter

Select the control and set values in the Properties view, InkPicture tab.

Examples

Example 1

dw1.Object.inkpic1.InkPic.InkEnabled = true

li_color = dw1.Describe("inkpic1.InkPic.BackColor")