• Graphics4VO - Graphics Library for Visual-Objects
•  Brief Description of the Current Version
•  Development Tool Description
•  Specification Class graphics{}
•  Specification Class gDataWindow{}
•  Screenshots
•  Download of a linkable Graphics4VO DLL
•  Download of a runnable Graphics4VO Demo
•  Prices Graphics4VO
•  Order Graphics4VO

Description or the class gDataWindow{}

To explain the possibilities of the graphics library Graphics4VO, the documentation of the class gDataWindow{} contained in it is shown. Further classes are described in the original documentation.

CLASS gDataWindow INHERIT dataWindow

Creates a data window capable of interfacing with a data server that can 
display graphic elements.


Inherits from: dataWindow
A detailed description of this class and derived classes is available in 
CAVO online help. All methods and instance variables of this class can be 
used in a regular way.


Methods:
init()            Creates an instance of the class
paint()           Calls methods necessary to display graphic elements 
paintNew()        Draws graphic elements
setTransparent()  Displays static controls transparent or with background
                  color
setTimer()        Sets timer for the window
timerEvent()      Method called by the timer


Variables that provide access to methods of the class:
_oGraphics        Graphic object used to call class methods.


Bemarks:
Data window should be owned by the window of the class ShellWindow. Window 
editor can be used to place controls if the 'Inherit from class' property 
is changed to "gDataWindow".

Transparency represented FixedText controls update their background 
automatically, when a new text is written. With other classes inherited by 
the class TextControl the text is overwritten.

All methods for initializing and display of graphic elements are accessible
through the class instance variable _oGraphics. Class methods should be 
called from within the class method paint() only.


Example:
CLASS winGraphData INHERIT gDataWindow

METHOD paint() CLASS winGraphData
LOCAL nWinW,nWinH AS WORD
SELF:_oGraphics:setBackgroundColor(G_COLORLIGHTCYAN)
SELF:_oGraphics:paintGradientCanvas(10,G_DIRECTIONDOWN)
nWinW := SELF:_oGraphics:getDeviceWidth()
nWinH := SELF:_oGraphics:getDeviceHeight()
SELF:_oGraphics:setWorldOrigin(nWinW / 2, nWinH / 2)
SELF:_oGraphics:setStringFont(G_FONTTYPEROMAN,40,120,G_FONTBOLD,;
  G_FONTDIMFLEX,0.0)
SELF:_oGraphics:setStringColor(G_COLORWHITE)
SELF:_oGraphics:setStringShadow(6,G_COLORBLACK,G_DIRECTIONRIGHTDOWN)
SELF:_oGraphics:paintStringShadow(0,nWinH * 0.2,"Graphics4VO",G_ORIGINCENTER)
RETURN




METHOD init(oOwner,oRessourceID,nRessourcenID) CLASS gDataWindow

Creates an instance of the class gDataWindow.


Arguments:
oOwner:           The owner window
oRessourceID      The Id of the resource that defines the layout of the 
                  window
nRessourcenID     The resource ID that specifies the location and size of 
                  the sub-data window




METHOD paint() CLASS gDataWindow

Contains method calls necessary for graphics construction.


Arguments:
None


Remarks:
Derived classes will have their own paint() methods overriding those of 
the super class. Graphic elements are constructed within paint() by 
methods of the "graphics" classes.

Important! This is a callback method; it should not be called by the 
application code. The class calls this method automatically and executes 
the code within it.




METHOD paintNew() CLASS gDataWindow

Draws graphic elements.


Arguments:
None


Remarks:
This method calls paint() method of the derived class.

Graphics are automatically rebuilt after initialization, window resizing
or uncovering. Under those circumstances this method should not be called
directly. However, it is necessary to call this method when the graphics
content is changed.




METHOD setTransparent(lTransparent) CLASS gDataWindow

Displays static controls with a transparent background or with their
background color.


Arguments:
lTransparent      Flag for transparent static controls
                  TRUE:  transparent background
                  FALSE: with background color


Remarks:
Displaying static controls with a transparent background is the default.




METHOD setTimer(nMilliSec) CLASS gDataWindow


Creates a timer with a specified time-out rate.


Arguments:
nMilliSec         The time-out rate in milliseconds (1/1000 second)


Remarks:
Method timerEvent() is called when the time-out interval elapses. Derived 
classes have their own timerEvent() methods overriding those of the 
super class.




METHOD timerEvent(nMilliSec) CLASS gDataWindow

Executes the timer event.


Arguments:
nMilliSec         The time-out rate in milliseconds (1/1000 second)


Remarks:
This method is overridden in derived classes. It contains the code
executed for the timer event.

Important! This is a callback method. It should not be called in the
application code. The class calls and executes this method automatically.