Chapter 2: System Object Properties, Events, and Functions

Oval control

An oval is a filled or outlined round or elliptical drawing object that you typically use for design effects (for example, you can put a CommandButton or a picture in an oval). The grouping does not affect the behavior of the controls in the oval.

Properties

Oval property	Datatype	Description
ClassDefinition	PowerObject	An object of type PowerObject containing information about the class definition of the object or control.
FillColor	Long	Specifies the numeric value of the color used to fill the control: -2 to 16,777,215. For more information about color, see the RGB function in the PowerScript Reference.
FillPattern	FillPattern (enumerated)	Specifies the hatch pattern used to fill the control. Values are: BDiagonal! Diamond! FDiagonal! Horizontal! Solid! Square! Vertical! FDiagonal! is lines going from the lower left to the upper right. BDiagonal! is lines going from the upper left to the lower right.
Height	Integer	Specifies the height of the control, in PowerBuilder units.
LineColor	Long	Specifies the numeric value of the line color: -2 to 16,777,215. For more information about color, see the RGB function in the PowerScript Reference.
LineStyle	LineStyle (enumerated)	Specifies the style of the line used to draw the control. Values are: Continuous! Dash! DashDot! DashDotDot! Dot! Transparent!
LineThickness	Integer	Specifies the thickness of the line used to draw the control, in PowerBuilder units. If LineThickness is greater than one pixel (about four PowerBuilder units), the LineStyle is Continuous!.
Tag	String	Specifies the tag value assigned to the control.
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.
X	Integer	Specifies the X position (the distance from the left edge of the window), in PowerBuilder units.
Y	Integer	Specifies the Y position (the distance from the top of the window), in PowerBuilder units.

Events

Oval event	Occurs
Constructor	When the control is created.
Destructor	When the control is destroyed.

Functions

Oval function	Datatype returned	Description
ClassName	String	Returns the name assigned to the control.
GetContextService	Integer	Creates a reference to a context-specific instance of the specified service.
GetParent	PowerObject	Returns a reference to the name of the parent object.
Hide	Integer	Makes the control invisible.
Move	Integer	Moves the control to a specified location.
PostEvent	Boolean	Adds an event to the end of the message queue for the control.
Resize	Integer	Changes the size of the control.
Show	Integer	Makes the control visible.
TriggerEvent	Integer	Triggers a specified event in the control and executes the script for the event.
TypeOf	Object	Returns the type of the control.

View this book as PDF