• 1. Introduction
  • 1.1. What is HwGUI
  • 1.2. History of HwGUI
• 2. Installation of HwGUI
  • 2.1. HwGUI package
  • 2.2. How to build HwGUI library
  • 2.3. How to build HwGUI samples
• 3. How to use HwGUI
  • 3.1. First HwGUI application
• 4. Commands
  • 4.1. Commands for windows and dialogs handling
  • 4.2. Menu commands
  • 4.3. Commands for controls handling
  • 4.4. Get system commands
  • 4.5. Print commands
• 5. Functions
  • 5.1. Common dialogs
  • 5.2. MessageBoxes and HwGUI dialogs
  • 5.3. Drawing functions.
• 6. Classes
  • 6.1. Class hierarchy
• 7. QHTM integration
  • 7.1. Overview
  • 7.2. Commands
  • 7.3. Functions
• 8. Utilities
  • 8.1. Designer
• 9. License
• 10. About the author

HwGUI is an add-on library for Harbour and xHarbour, intended for creating GUI applications on Win32 platform. HwGUI is based on direct calls of Win32 API, so it cannot be used with other operating systems. While developing HwGUI I tried to hide from the end user - Harbour programmer technical details of API calls and to build a set of commands and functions, which could allow easily create and manage GUI objects.

I began to work on HwGUI in August 2001 and the first version was released on August 21. My initial intention was to create a small and fast GUI lib mainly for my own needs. And already in October I had wrote the first small application with HwGUI for my firm, it reads the databases, created and managed with the accounting system, generates some documents and sends them by fax.

Firstly, from the initial release and til the 1.3 HwGUI didn't use the OOP paradigm - and I even had declared this as one of HwGUI features. My main motivations was speed and stability. Harbour's implementation of classes at that time had some bugs and I didn't want to add problems to myself. And, of course, access to object's variables is more slow than access to the array items. OOP is an additional level and using of it reduces application's performance.

But later I have arrived at a decision to make HwGUI OOP based - to simplify user interface and make it better structured and more convenient. So since release 2.0 HwGUI uses classes.

HwGUI is distributed as a zip package. Currently it doesn't use any setup utility, you need simply unzip it to any place you want. The zip package includes following files and directories:

Before building the library you need to set the HB_PATH environment variable, it should point to the directory where your copy of Harbour is. Then run one of command files depending of the C compiler you use ( make_b32.bat for Borland C, make_pc.bat for Pelles C, make_vc.bat for MSVC, make_w32.bat for Open Watcom C, makemngw.bat for Mingw ) - this will build four libraries - hwgui.lib, procmisc.lib, hwg_qhtm.lib and hbxml.lib. That's all !

   Function Main
   Local oMainWnd, oFont
   Local aCombo := {"First","Second" }

   PREPARE FONT oFont NAME "MS Sans Serif" WIDTH 0 HEIGHT -13
   INIT WINDOW oMainWnd TITLE "Example" ;
           FONT oFont ;
           ON EXIT {||MsgYesNo("Really want to quit ?")}

   @ 20,10 EDITBOX "Hello, World!" ;
           SIZE 200,30 ;

   @ 270,10 COMBOBOX aCombo ;
           SIZE 100, 150 TOOLTIP "Combobox"

   @ 120,60 BUTTON "Close" ;
           SIZE 150,30 ;
           ON CLICK {||EndWindow()}

   MENU OF oMainWnd
           MENUITEM "About" ACTION MsgInfo("First HwGUI Application")
   ENDMENU

   ACTIVATE WINDOW oMainWnd

   Return

First thing you will want to do, I think, is to create the main window. The best way to do this is the command INIT WINDOW. In this command you can define initial position and the size of the window, it's style, icon, background color. You can set also event handlers - codeblocks, which are evaluated for different events ( INIT, EXIT, PAINT, SIZE changing, GETFOCUS, LOSTFOCUS and others ).

Then you need to define controls for that window and the main menu ( MENU ... ENDMENU commands), and, at least, activate the window, ( ACTIVATE WINDOW ) show it on the screen. Let analyse the above sample.

   PREPARE FONT oFont NAME "MS Sans Serif" WIDTH 0 HEIGHT -13

   INIT WINDOW oMainWnd MAIN TITLE "Example" ;
           FONT oFont ;
           ON EXIT {||MsgYesNo("Really want to quit ?")}

   @ 20,10 EDITBOX "Hello, World!" ;
           SIZE 200,30 ;
   @ 270,10 COMBOBOX aCombo ;
           SIZE 100, 150 TOOLTIP "Combobox"
   @ 120,60 BUTTON "Close" ;
           SIZE 150,30 ;
           ON CLICK {||EndWindow()}

   MENU OF oMainWnd
           MENUITEM "About" ACTION MsgInfo("First HwGUI Application")
   ENDMENU

   ACTIVATE WINDOW oMainWnd

• 4.1.1. INIT WINDOW
• 4.1.2. INIT DIALOG
• 4.1.3. ACTIVATE WINDOW
• 4.1.4. ACTIVATE DIALOG
• 4.1.5. DIALOG ACTIONS OF

This command creates the window - main, MDI or MDI CHILD. To force this window show up on the screen you need to activate it later. You can do this with ACTIVATE WINDOW command or with Activate() method of that window object.

INIT WINDOW <oWnd>

[ MAIN ]
[ MDI ]
[ MDICHILD ]
[ APPNAME <appname> ]
[ TITLE <cTitle> ]
[ AT <x>, <y> ]
[ SIZE <width>, <height> ]
[ ICON <ico> ]
[ COLOR <clr> ]
[ BACKGROUND BITMAP <oBmp>> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ MENU <cMenu> ]
[ MENUPOS <nPos> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ ON GETFOCUS <bGfocus> ]
[ ON LOSTFOCUS <bLfocus> ]
[ ON OTHER MESSAGES <bOther> ]
[ ON EXIT <bExit>]
[ MAXIMIZE]
[ HELP <cHelp> ]
[ HELPID <nHelpId> ]

This command creates the dialog box. To force the dialog show up on the screen you need to activate it later. You can do this with ACTIVATE DIALOG command or with Activate() method of that window object.

INIT DIALOG <oWnd>

[ FROM RESOURCE ]
[ TITLE <cTitle> ]
[ AT <x>, <y> ]
[ SIZE <width>, <height> ]
[ ICON <ico> ]
[ BACKGROUND BITMAP <oBmp> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ CLIPPER ]
[ NOEXIT ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ ON GETFOCUS <bGfocus> ]
[ ON LOSTFOCUS <bLfocus> ]
[ ON OTHER MESSAGES <bOther> ]
[ ON EXIT <bExit> ]
[ HELPID <nHelpId>> ]

All clauses has the same meaning as in INIT WINDOW command, there is only three specific clause:
FROM RESOURCE - it is used if you create the dialog box from resource file;
CLIPPER - to force the Clipper like behavior - the Enter key is used for moving between GET's;
NOEXIT - the Enter key doesn't cause closing of a dialog box.

ACTIVATE WINDOW <oWnd>

This command is equal to 'oWnd:Activate()' call. It shows the previously created window and starts messages processing for it.

ACTIVATE DIALOG <oDlg> [ NOMODAL ]

This command is equal to 'oDlg:Activate()' call. It shows the previously defined dialog and starts messages processing for it. By default, it creates modal dialog. You can create modeless dialog, specifying NOMODAL clause in this command.

DIALOG ACTIONS OF <oWnd>

ON <id1>,<id2> ACTION <b1>
[ ON <idn1>,<idn2> ACTION <bn> ]

This is a compatibility command and therefore not recommended. The window gets WM_COMMAND message when the user selects a command item from a menu, when a control sends a notification message to its parent window, or when an accelerator keystroke is translated.
You can specify in this command the event, the source of the event and the appropriate action. id1 ...idn1 is the event code, id1 ... idn2 - is the identificator of the control, b1 ... bn - the codeblock.
Take a look at the samples to see how this command may be used.

• 4.2.1. MENU
• 4.2.2. ENDMENU
• 4.2.3. MENUITEM
• 4.2.4. SEPARATOR
• 4.2.5. MENU FROM RESOURCE OF
• 4.2.6. CONTEXT MENU
• 4.2.7. ACCELERATOR

MENU [ OF <oWnd> ] [ ID <nId> ] [ TITLE <cTitle> ]

ENDMENU

MENUITEM <item> [ ID <nId> ]

ACTION <act>
[ BITMAP <bmp> ]
[ ACCELERATOR <flag>, <key> ]
[ <lDisabled: DISABLED> ]

SEPARATOR

MENU FROM RESOURCE OF <oWnd>

ON <id1> ACTION <b1>
[ ON <idn> ACTION <bn> ]

This command is used if you specify menu in resource file, it defines actions for each menu item.

CONTEXT MENU <oMenu>

ACCELERATOR <flag>, <key>
[ ID <nId> ]
ACTION <act>

• 4.3.1. ADD STATUS TO
• 4.3.2. @ <x>,<y> SAY
• 4.3.3. @ <x>,<y> EDITBOX
• 4.3.4. REDEFINE EDITBOX
• 4.3.5. @ <x>,<y> BUTTON
• 4.3.6. REDEFINE BUTTON
• 4.3.7. @ <x>,<y> CHECKBOX
• 4.3.8. REDEFINE CHECKBOX
• 4.3.9. @ <x>,<y> COMBOBOX
• 4.3.10. REDEFINE COMBOBOX
• 4.3.11. @ <x>,<y> RADIOBUTTON
• 4.3.12. REDEFINE RADIOBUTTON
• 4.3.13. RADIOGROUP
• 4.3.14. END RADIOGROUP
• 4.3.15. @ <x>,<y> PANEL
• 4.3.16. REDEFINE PANEL
• 4.3.17. @ <x>,<y> BROWSE
• 4.3.18. REDEFINE BROWSE
• 4.3.19. ADD COLUMN
• 4.3.20. @ <x>,<y> OWNERBUTTON
• 4.3.21. REDEFINE OWNERBUTTON
• 4.3.22. @ <x>,<y> GROUPBOX
• 4.3.23. @ <x>,<y> DATEPICKER
• 4.3.24. @ <x>,<y> UPDOWN
• 4.3.25. @ <x>,<y> TAB
• 4.3.26. BEGIN PAGE
• 4.3.27. END PAGE
• 4.3.28. @ <x>,<y> TREE
• 4.3.29. INSERT NODE
• 4.3.30. SET TIMER
• 4.3.31. @ <x>,<y> BITMAP
• 4.3.32. REDEFINE BITMAP
• 4.3.33. @ <x>,<y> ICON
• 4.3.34. REDEFINE ICON
• 4.3.35. @ <x>,<y> IMAGE
• 4.3.36. REDEFINE IMAGE
• 4.3.37. @ <x>,<y> LINE
• 4.3.38. @ <x>,<y> RICHEDIT
• 4.3.39. @ <x>,<y> SPLITTER
• 4.3.40. @ <x>,<y> GRAPH
• 4.3.41. @ <x>,<y> PROGRESSBAR
• 4.3.42. @ <x>,<y> MONTHCALENDAR
• 4.3.43. @ <x>,<y> LISTBOX
• 4.3.44. REDEFINE LISTBOX
• 4.3.45. SPLASH
• 4.3.46. @ <x>,<y> TRACKBAR
• 4.3.47. @ <x>,<y> ANIMATION

All the following commands creates the instances of classes, they are preprocessed into the New() or Redefine() method of appropriate class.

ADD STATUS [ TO <oWnd> ]

[ ID <nId> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ PARTS <aparts,...> ]

@ <x>,<y> SAY [ <oSay> CAPTION ] <caption>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ TRANSPARENT ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> EDITBOX [ <oEdit> CAPTION ] <caption>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON GETFOCUS <bGfocus> ]
[ ON LOSTFOCUS <bLfocus> ]
[ STYLE <nStyle> ]
[ NOBORDER ]
[ PASSWORD ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

REDEFINE EDITBOX <oEdit>

[ OF <oWnd> ]
ID <nId>
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON GETFOCUS <bGfocus> ]
[ ON LOSTFOCUS <bLfocus> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> BUTTON [ <oButton> CAPTION ] <caption>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

REDEFINE BUTTON <oButton>

[ OF <oWnd> ]
ID <nId>
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> CHECKBOX [ <oCheck> CAPTION ] <caption>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ INIT <lInit> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

REDEFINE CHECKBOX <oCheck>

[ OF <oWnd> ]
ID <nId>
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ INIT <lInit> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> COMBOBOX [ <oCombo> ITEMS ] <aItems>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ INIT <nInit> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CHANGE <bChange> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]
[ EDIT ]
[ TEXT ]

REDEFINE COMBOBOX [ <oCombo> ITEMS ] <aItems>

[ OF <oWnd> ]
ID <nId>
[ INIT <nInit> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CHANGE <bChange> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> RADIOBUTTON [ <oRadio> CAPTION ] <caption>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

REDEFINE RADIOBUTTON <oRadio>

[ OF <oWnd> ]
ID <nId>
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

   RADIOGROUP

   END RADIOGROUP [ SELECTED <nSel> ]

@ <x>,<y> PANEL <oPanel>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ STYLE <nStyle> ]

REDEFINE PANEL <oCheck>

[ OF <oWnd> ]
ID <nId>
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]

@ <x>,<y> BROWSE <oBrowse>

[ ARRAY ]
[ DATABASE ]
[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ ON GETFOCUS <bGetFocus> ]
[ ON LOSTFOCUS <bLostFocus> ]
[ STYLE <nStyle> ]
[ <lNoVScr: NO VSCROLL> ]
[ <lNoBord: NO BORDER> ]
[ FONT <oFont> ]
[ APPEND ]
[ AUTOEDIT ]
[ ON UPDATE <bUpdate> ]
[ ON KEYDOWN <bKeyDown> ]
[ ON POSCHANGE <bPosChg> ]

REDEFINE BROWSE <oBrowse>

[ ARRAY ]
[ DATABASE ]
[ OF <oWnd> ]
ID <nId>
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ ON GETFOCUS <bGetFocus> ]
[ ON LOSTFOCUS <bLostFocus> ]
[ FONT <oFont> ]

TO <oBrowse>
[ HEADER <cTitle> ]
[ TYPE <type> ]
[ LENGTH <length> ]
[ DEC <dec> ]
[ <lEdit: EDITABLE> ]
[ JUSTIFY HEAD <nJusHead> ]
[ JUSTIFY LINE <nJusLine> ]
[ PICTURE <cPict> ]
[ VALID <bValid> ]
[ WHEN <bWhen> ]
[ ITEMS <aItem> ]
[ BITMAP >oBmp> ]

@ <x>,<y> OWNERBUTTON <oOwnBtn>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ STYLE <nStyle> ]
[ FLAT ]
[ TEXT <cText>
           [ COLOR <color> ] [ FONT <font> ]
           [ COORDINATES <xt>, <yt>, <widthtt>, <heightt> ]
]
[ BITMAP <bmp> [ FROM RESOURCE ] [ TRANSPARENT ]
           [ COORDINATES <xb>, <yb>, <widthtb>, <heightb> ]
]

REDEFINE OWNERBUTTON <oOwnBtn>

[ OF <oWnd> ]
ID <nId>
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CLICK <bClick> ]
[ STYLE <nStyle> ]
[ FLAT ]
[ TEXT <cText>
           [ COLOR <color> ] [ FONT <font> ]
           [ COORDINATES <xt>, <yt>, <widthtt>, <heightt> ]
]
[ BITMAP <bmp> [ FROM RESOURCE ] [ TRANSPARENT ]
           [ COORDINATES <xb>, <yb>, <widthtb>, <heightb> ]
]

@ <x>,<y> GROUPBOX [ <oGroup> CAPTION ] <caption>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]

@ <x>,<y> DATEPICKER [ <oPicker> CAPTION ] <caption>

[ OF <oWnd> ]
ID <nId>
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ INIT <value> ]
[ ON INIT <bInit> ]
[ ON GETFOCUS <bGetFocus> ]
[ ON LOSTFOCUS <bLostFocus> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> UPDOWN [ <oUpDown> INIT ] <nInit>

RANGE <nLower>, <nUpper>
[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ WIDTH <nUpdWidth> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON GETFOCUS <bGfocus> ]
[ ON LOSTFOCUS <bLfocus> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bDraw> ]
[ ON CHANGE <bChange> ]
[ BITMAP <aBmp> [ FROM RESOURCE] [ BITCOUNT <nBC> ] ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ FONT <oFont> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ STYLE <nStyle> ]
[ EDITABLE ]
[ BITMAP <aBmp> [ FROM RESOURCE ] ]

TO <oTree>
[ AFTER <oPrev> ]
[ BEFORE <oNext> ]
[ BITMAP <aBmp> ]
[ ON CLICK <bClick> ]

[ OF <oWnd> ]
[ ID <id> ]
VALUE <value>
ACTION <bAction>

[<res: FROM RESOURCE> ]
[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ TOOLTIP <ctoolt> ]

[<res: FROM RESOURCE> ]
[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
ID <nId>
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
ID <nId>
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ TOOLTIP <ctoolt> ]

[ LENGTH <length> ]
[ OF <oWnd> ]
[ ID <nId> ]
[ VERTICAL]
[ ON SIZE <bSize> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ ON GETFOCUS <bGfocus> ]
[ ON LOSTFOCUS <bLfocus> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ DIVIDE <aLeft> FROM <aRight> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON SIZE <bSize> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ BARWIDTH <maxpos> ]
[ QUANTITY <nRange> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ INIT <dInit> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON CHANGE <bChange> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]
[ NOTODAY ]
[ NOTODAYCIRCLE ]
[ WEEKNUMBERS ]

[ OF <oWnd> ]
[ ID <nId> ]
[ INIT <dInit> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ ON CHANGE <bChange> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

[ OF <oWnd> ]
ID <nId>
[ INIT <dInit> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ ON CHANGE <bChange> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

[ FROM RESOURCE ]
[ TIME <otime> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ RANGE <nLow>, <nHigh> ]
[ INIT <dInit> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ ON CHANGE <bChange> ]
[ ON DRAG <bDrag> ]
[ STYLE <nStyle> ]
[ TOOLTIP <ctoolt> ]
[ VERTICAL ]
[ AUTOTICKS ]
[ NOTICKS ]
[ BOTH ]
[ TOP ]
[ LEFT ]

[ OF <oWnd> ]
[ ID <nId> ]
[ STYLE <nStyle> ]
[ SIZE <width>, <height> ]
[ FILE <cFile> ]
[ AUTOPLAY ]
[ CENTER ]
[ TRANSPARENT ]

• 4.4.1. @ <x>,<y> GET
• 4.4.2. REDEFINE GET
• 4.4.3. @ <x>,<y> GET CHECKBOX
• 4.4.4. REDEFINE GET CHECKBOX
• 4.4.5. @ <x>,<y> GET COMBOBOX
• 4.4.6. REDEFINE GET COMBOBOX
• 4.4.7. GET RADIOGROUP
• 4.4.8. @ <x>,<y> GET DATEPICKER
• 4.4.9. @ <x>,<y> GET UPDOWN
• 4.4.10. SET KEY

Get system doesn't use a special class, something like HGet. It uses the same control classes ( HEdit, HCheckButton, etc. ), as usual control creating commands, only add there some new behavour.

@ <x>,<y> GET [ <oEdit> VAR ] <vari>

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ PICTURE <cPicture> ]
[ WHEN <bWhen> ]
[ VALID <bValid> ]
[ NOBORDER ]
[ PASSWORD ]
[ MAXLENGTH <lMaxLength> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

REDEFINE GET [ <oEdit> VAR ] <vari>

[ OF <oWnd> ]
ID <nId>
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ WHEN <bWhen> ]
[ VALID <bValid> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> GET CHECKBOX [ <oEdit> VAR ] <vari>

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ VALID,ON CLICK <bValid> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

REDEFINE GET CHECKBOX [ <oEdit> VAR ] <vari>

[ OF <oWnd>]
ID <nId>
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ VALID,ON CLICK <bValid> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> GET COMBOBOX [ <oCombo> VAR ] <vari>

ITEMS ] <aItems>
[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON CHANGE <bChange> ]
[ WHEN <bWhen> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ EDIT ]
[ TEXT ]
[ TOOLTIP <ctoolt> ]

REDEFINE GET COMBOBOX [ <oCombo> VAR ] <vari>

ITEMS ] <aItems>
[ OF <oWnd> ]
ID <nId>
[ ON CHANGE <bChange> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

   GET RADIOGROUP [ <ogr> VAR ] <vari>

@ <x>,<y> GET DATEPICKER [ <oPick> VAR ] <vari>

[ OF <oWnd>]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ WHEN <bWhen> ]
[ VALID <bValid> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

@ <x>,<y> GET UPDOWN[ <oUpDown> VAR ] <vari>

RANGE <nLower>, <nUpper>
[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ WIDTH <nUpdWidth> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ PICTURE <cPicture> ]
[ WHEN <bWhen> ]
[ VALID <bValid> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

SET KEY <nctrl>, <nkey> [ OF <oDlg> ] [ TO <func> ]

• 4.5.1. INIT PRINTER
• 4.5.2. INIT DEFAULT PRINTER

INIT PRINTER <oPrinter>

[ NAME <cPrinter> ]
[ PIXEL ]

INIT DEFAULT PRINTER <oPrinter>

[ PIXEL ]

• 5.1.1. SelectFont( oFont )
• 5.1.2. SelectFile( cDescript,cMask,cInitDir,cTitle )
• 5.1.3. SaveFile( cPrompt,cDescript,cMask,cInitDir,cTitle )
• 5.1.4. PrintSetup()
• 5.1.5. hwg_ChooseColor( nColorCurrent )

• oFont - optional parameter, the current font object ( HFont instance ).
• Return value - the array with selected font characteristics ( nHandle, fontName, nWidth, nHeight ,fnWeight, fdwCharSet, fdwItalic, fdwUnderline, fdwStrikeOut ) or Nil, if the font wasn't selected.

• cDescript - this string appears in the dialog as a description of a file type.
• cMask - string type parameter, describing the file mask.
• cInitDir - optional string parameter, the initial directory for file selecting.
• cTitle - optional string parameter, the title of a dialog box.
• Return value - a string with a selected file name, or an empty string, if a file wasn't selected.

• cPrompt - this string appears as a prompt of a file name.
• cDescript - this string appears in the dialog as a description of a file type.
• cMask - string type parameter, describing the file mask.
• cInitDir - optional string parameter, the initial directory for file selecting.
• cTitle - optional string parameter, the title of a dialog box.
• Return value - a string with a selected file name, or an empty string, if a file wasn't selected.

• Return value ( numeric ) - handle to device context ( hDC ) of selected printer, 0 - if printer wasn't selected.
• Writes to the cPrinterName parameter the name of a selected printer.

• nColorCurrent - a numeric parameter, initial value of a color,
• Return value ( numeric ) - selected color.

• 5.2.1. MsgInfo( cMessage,cTitle )
• 5.2.2. MsgStop( cMessage,cTitle )
• 5.2.3. MsgOkCancel( cMessage,cTitle )
• 5.2.4. MsgYesNo( cMessage,cTitle )
• 5.2.5. MsgBeep( nSound )
• 5.2.6. MsgGet( cTitle, cText, nStyle, x, y, nDlgStyle )
• 5.2.7. WChoice( arr, cTitle, nLeft, nTop, oFont, clrT, clrB, clrTSel, clrBSel )

The following schema illustrates the hierarchy of classes, currently implemented in HwGUI.

• HObject
  • HCustomWindow
    • HWindow
      • HMainWindow
      • HMDIChildWindow
      • HChildWindow
    • HDialog
    • HControl
      • HBrowse
      • HPanel
      • HOwnerButton
      • HSplitter
      • HStatus
      • HStatic
      • HButton
      • HEdit
      • HChecBox
      • HRadioButton
      • HCombobox
      • HGroup
      • HLine
      • HSayImage
        • HSayBmp
        • HSayIcon
        • HSayFImage
      • HDatePicker
      • HUpDown
      • HTab
      • HTree
      • HMonthCalendar
      • HListbox
      • HTrackBar
      • HAnimation
  • HColumn
  • HRadioGroup
  • HFont
  • HPen
  • HBrush
  • HBitmap
  • HIcon
  • HPrinter
  • HTreeNode
  • HTimer
  • HFreeImage
  • HSplash

It is a base class for all HwGUI classes.

Do not create instances of HCustomWindow. It serves as a base class for windows, dialogs and controls classes. Variables and methods of HCustomWindow provide basic behavior that descendant classes inherit as well as behavior that components can override to customize their behavior.

DATA

CLASS VAR oDefaultParent SHARED
handle
oParent
title
type
nTop, nLeft, nWidth, nHeight
tcolor, bcolor, brush
style
extstyle
lHide
oFont
aEvents, aNotify
aControls
bInit
bDestroy
bSize
bPaint
bGetFocus
bLostFocus
bOther
cargo
HelpId
nHolder

METHODS

AddControl( oCtrl )
DelControl( oCtrl )
AddEvent( nEvent,nId,bAction )
FindControl( nId )
Hide()
Show()
Move( x1,y1,width,height )
onEvent( msg, wParam, lParam )
End()

DATA

CLASS VAR aWindows
CLASS VAR szAppName
menu, oPopup, hAccel
oIcon, oBmp
lUpdated
lClipper
GetList
KeyList
nLastKey
aOffset
lMaximize

METHODS

New( oIcon,clr,nStyle,x,y,width,height,cTitle,cMenu,nPos,oFont,
           bInit,bExit,bSize,bPaint,bGfocus,bLfocus,bOther,cAppName,oBmp,lMaximize,cHelp,nHelpId )
AddItem( oWnd )
DelItem( oWnd )
FindWindow( hWnd )
GetMain()
Center()
Restore()
Maximize()
Minimize()
Close()

DATA

CLASS VAR aMessages
nMenuPos
oNotifyIcon, bNotify, oNotifyMenu
lTray

METHODS

New( lType,oIcon,clr,nStyle,x,y,width,height,cTitle,cMenu,nPos,
           oFont,bInit,bExit,bSize,bPaint,bGfocus,bLfocus,bOther,
           cAppName,oBmp,lMaximize,cHelp,nHelpId )
Activate( lShow )
onEvent( msg, wParam, lParam )
InitTray( oNotifyIcon, bNotify, oNotifyMenu )
GetMdiActive()

DATA

CLASS VAR aMessages

METHODS

Activate( lShow )
onEvent( msg, wParam, lParam )

METHODS

New( oIcon,clr,nStyle,x,y,width,height,cTitle,cMenu,oFont,
           bInit,bExit,bSize,bPaint,bGfocus,bLfocus,bOther,
           cAppName,oBmp,lMaximize,cHelp,nHelpId )
Activate( lShow )
onEvent( msg, wParam, lParam )

DATA

CLASS VAR aDialogs
CLASS VAR aModalDialogs
menu
oPopup
lResult
lUpdated // TRUE, if any GET is changed
lClipper // Set it to TRUE for moving between GETs with ENTER key
GetList
KeyList
nLastKey
oIcon, oBmp
lExitOnEnter
bActivate
lActivated
xResourceID

METHODS

New( lType,nStyle,x,y,width,height,cTitle,bInit,bExit,bSize,
           bPaint,bGfocus,bLfocus,bOther,lClipper,oBmp,oIcon,lExitOnEnter,nHelpId,xResourceID )
Activate(lNoModal)
onEvent( msg, wParam, lParam )
AddItem( oWnd,lModal )
DelItem( oWnd,lModal )
FindDialog( hWnd )
GetActive()
Center()
Restore()
Maximize()
Minimize()
Close()

DATA

id
tooltip
lInit

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,oFont,bInit,
           bSize,bPaint,ctoolt,tcolor,bcolor )
Init()
SetColor( tcolor,bcolor,lRepaint )
NewId()
Disable()
Enable()
IsEnabled()
SetFocus()
GetText()
SetText( c )
End()

DATA

winclass
active
lChanged
lDispHead	Should I display headers ?
lDispSep	Should I display separators ?
aColumns	HColumn's array
rowCount	Number of visible data rows
rowPos	Current row position
rowCurrCount	Current number of rows
colPos	Current column position
nColumns	Number of visible data columns
nLeftCol	Leftmost column
xpos
freeze	Number of columns to freeze
kolz	Number of records in browse
tekzp,msrec
recCurr
headColor	Header text color
sepColor	Separators color
lSep3d
varbuf
tcolorSel,bcolorSel,brushSel
bSkip,bGoTo,bGoTop,bGoBot,bEof,bBof
bRcou,bRecno
bPosChanged, bLineOut, bScrollPos
bEnter, bKeyDown, bUpdate
internal
alias	Alias name of browsed database
x1,y1,x2,y2,width,height
minHeight
lEditable
lAppable
lAppMode
lAutoEdit
lUpdated
lAppended
lAdjRight	Adjust last column to right
nHeadRows	Rows in header
nFootRows	Rows in footer

METHODS

New( lType,oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,oFont ;
           bInit,bSize,bPaint,bEnter,bGfocus,bLfocus,lNoVScroll,lNoBorder,
           lAppend,lAutoedit,bUpdate,bKeyDown,bPosChg ) InitBrw( nType )
Rebuild()
Activate()
onEvent( msg, wParam, lParam )
Redefine( lType,oWnd,nId,bInit,bSize,bDraw,bEnter,bGfocus,bLfocus )
FindBrowse( nId )
AddColumn( oColumn )
InsColumn( oColumn,nPos )
DelColumn( nPos )
Paint()
LineOut()
HeaderOut( hDC )
FooterOut( hDC )
SetColumn( nCol )
DoHScroll( wParam )
DoVScroll( wParam )
LineDown()
LineUp()
PageUp()
PageDown()
Bottom()
Top()
ButtonDown( lParam )
ButtonUp( lParam )
ButtonDbl( lParam )
MouseMove( wParam, lParam )
MouseWheel( nKeys, nDelta, nXPos, nYPos )
Edit( wParam,lParam )
Append()
RefreshLine()
Refresh()
ShowSizes()
End()

DATA

winclass

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,
           bInit,bSize,bPaint,lDocked )
Activate()
onEvent( msg, wParam, lParam )
Redefine( oWnd,nId,nHeight,bInit,bSize,bPaint )
Paint()
End()

DATA

winclass
lFlat
state
bClick
lPress
text,tfont,xt,yt,widtht,heightt
bitmap,xb,yb,widthb,heightb,lTransp,oBitmap
lEnabled

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,
           bInit,bSize,bPaint,bClick,lflat,
           cText,color,font,xt,yt,widtht,heightt,
           bmp,lResour,xb,yb,widthb,heightb,lTr,
           cTooltip,lEnabled )
Activate()
onEvent( msg, wParam, lParam )
Init()
Redefine( oWndParent,nId,bInit,bSize,bPaint,bClick,lflat,
           cText,color,font,xt,yt,widtht,heightt,
           bmp,lResour,xb,yb,widthb,heightb,lTr,
           cTooltip,lEnabled ) Paint()
MouseMove( wParam, lParam )
MDown()
MUp()
Press()
Release()
End()

DATA

winclass
aLeft
aRight
lVertical
hCursor
lCaptured, lMoved
bEndDrag

METHODS

New( oWndParent,nId,nLeft,nTop,nWidth,nHeight,
           bSize,bPaint,color,bcolor,aLeft,aRight )
Activate()
onEvent( msg, wParam, lParam )
Init()
Paint( lpdis )
Drag( lParam )
DragAll()

DATA

CLASS VAR winclass
aParts

METHODS

New( oWndParent,nId,nStyle,aParts,bInit,bSize,bPaint )
Activate()
Init()

DATA

CLASS VAR winclass

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,cCaption,oFont,bInit,bSize,bPaint,ctoolt,tcolor,bcolor,lTransp )
Activate()
Redefine( oWndParent,nId,oFont,bInit, ;
           bSize,bPaint,ctoolt,tcolor,bcolor,lTransp )
SetValue(value)
Init()

DATA

CLASS VAR winclass

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,cCaption,oFont,
           bInit,bSize,bPaint,bClick,ctoolt,tcolor,bcolor )
Activate()
Redefine( oWnd,nId,oFont,bInit,bSize,bDraw,bClick,ctoolt,tcolor,bcolor )
Init()

DATA

CLASS VAR winclass
lMultiLine
cType
bSetGet
bValid
cPicFunc, cPicMask
lPicComplex
lFirst
lChanged
lMaxLength

METHODS

New( oWndParent,nId,vari,bSetGet,nStyle,nLeft,nTop,nWidth,nHeight,oFont,
           bInit,bSize,bPaint,bGfocus,bLfocus,ctoolt,tcolor,bcolor,cPicture,lNoBorder,lMaxLength )
Activate()
onEvent( msg, wParam, lParam )
Redefine( oWnd,nId,vari,bSetGet,oFont,bInit,bSize,bDraw,bGfocus,bLfocus,ctoolt,tcolor,bcolor,cPicture )
Init()
SetGet(value) INLINE Eval( ::bSetGet,value )
Refresh()
SetText(c)

DATA

CLASS VAR winclass
bSetGet
value

METHODS

New( oWndParent,nId,vari,bSetGet,nStyle,nLeft,nTop,nWidth,nHeight,cCaption,oFont,
           bInit,bSize,bPaint,bClick,ctoolt,tcolor,bcolor,bGFocus )
Activate()
Redefine( oWnd,nId,vari,bSetGet,oFont,bInit,bSize,bDraw,bClick,ctoolt,tcolor,bcolor,bGFocus )
Init()
Refresh()
Disable()
Enable()

DATA

CLASS VAR winclass
CLASS VAR oGroup

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,cCaption,oFont,
           bInit,bSize,bPaint,bClick,ctoolt,tcolor,bcolor )
Activate()
Redefine( oWnd,nId,oFont,bInit,bSize,bDraw,bClick,ctoolt,tcolor,bcolor )

DATA

CLASS VAR winclass
aItems
bSetGet
value
bChangeSel
lText
lEdit

METHODS

New( oWndParent,nId,vari,bSetGet,nStyle,nLeft,nTop,nWidth,nHeight,aItems,
           bInit,bSize,bPaint,bChange,cTooltip,lEdit,lText,bGFocus,tcolor,bcolor )
Activate()
Redefine( oWnd,nId,vari,bSetGet,aItems,bInit,bSize,bPaint,bChange,cTooltip,bGFocus )
Init( aCombo, nCurrent )
Refresh()
Setitem( nPos )

DATA

CLASS VAR winclass

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,cCaption,oFont,
           bInit,bSize,bPaint,tcolor,bcolor )
Activate()

DATA

CLASS VAR winclass
lVert
oPenLight, oPenGray

METHODS

New( oWndParent,nId,lVert,nLeft,nTop,nLength,bSize )
Activate()
Paint()

DATA

CLASS VAR winclass
oImage

METHODS

New( oWndParent,nId,nLeft,nTop,nWidth,nHeight,bInit,
           bSize,ctoolt )
Activate() Redefine( oWndParent,nId,bInit,bSize,ctoolt )
End()

METHODS

New( oWndParent,nId,nLeft,nTop,nWidth,nHeight,Image,lRes,bInit,
           bSize,ctoolt )
Redefine( oWndParent,nId,Image,lRes,bInit,bSize,ctoolt )
Init()
ReplaceBitmap( Image, lRes )

METHODS

New( oWndParent,nId,nLeft,nTop,nWidth,nHeight,Image,lRes,bInit,
           bSize,ctoolt )
Redefine( oWndParent,nId,Image,lRes,bInit,bSize,ctoolt )
Init()

METHODS

New( oWndParent,nId,nLeft,nTop,nWidth,nHeight,Image,lRes,bInit,
           bSize,ctoolt )
Redefine( oWndParent,nId,Image,lRes,bInit,bSize,ctoolt )
Paint()

DATA

CLASS VAR winclass
bSetGet
value
bChange

METHODS

New( oWndParent,nId,vari,bSetGet,nStyle,nLeft,nTop,nWidth,nHeight, ;
           oFont,bInit,bGfocus,bLfocus,ctoolt,tcolor,bcolor )
Activate()
Init()
Refresh()

DATA

CLASS VAR winclass
bSetGet
value
hUpDown, idUpDown, styleUpDown
nLower
nUpper
nUpDownWidth
lChanged

METHODS

New( oWndParent,nId,vari,bSetGet,nStyle,nLeft,nTop,nWidth,nHeight, ;
           oFont,bInit,bSize,bPaint,bGfocus,bLfocus,ctoolt,tcolor,bcolor,nUpDWidth,nLower,nUpper )
Activate()
Init()
Refresh()

DATA

CLASS VAR winclass
aTabs
aPages
bChange,bChange2
hIml, aImages, Image1, Image2
oTemp
bAction

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight, ;
           oFont,bInit,bSize,bPaint,aTabs,bChange,,aImages,lResour,nBC,bClick, bGetFocus, bLostFocus )
Activate()
Init()
SetTab( n )
StartPage( cname )
EndPage()
ChangePage( nPage )
HidePage( nPage )
ShowPage( nPage )
GetActivePage( nFirst,nEnd )

DATA

CLASS VAR winclass
aItems
oSelected
himl,aImages,Image1,Image2
bItemChange, bExpand, bRClick, bAction
lEmpty

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,oFont,
           bInit,bSize,color,bcolor,aImages,lResour,lEditLabels,bAction,nBC )
Activate()
Init()
AddNode( cTitle, oPrev, oNext, bAction, aImages )
FindChild( handle )
GetSelected()
EditLabel( oNode )
Expand( oNode )
Select( oNode )
Clean()
End()

DATA

CLASS VAR winclass
value
bChange

METHODS

New( oWndParent, nId, vari, nStyle, nLeft, nTop, nWidth, nHeight,
           oFont, bInit, bChange, cTooltip, lNoToday, lNoTodayCircle, lWeekNumbers )
Activate()
Init()
SetValue( dValue )
GetValue()

DATA

CLASS VAR winclass
aItems
bSetGet
value
bChangeSel

METHODS

New( oWndParent,nId,vari,bSetGet,nStyle,nLeft,nTop,nWidth,nHeight,aItems,oFont,
           bInit,bSize,bPaint,bChange,cTooltip )
Activate()
Redefine( oWnd,nId,vari,bSetGet,aItems,oFont,bInit,bSize,bDraw,bChange,cTooltip )
Init( aListbox, nCurrent )
Refresh()
Setitem( nPos )

DATA

CLASS VAR winclass
value
bChange
bThumbDrag
nLow
nHigh
hCursor

METHODS

New( oWndParent,nId,vari,nStyle,nLeft,nTop,nWidth,nHeight,
           bInit,bSize,bPaint,cTooltip,bChange,bDrag,nLow,nHigh,lVertical,TickStyle,TickMarks )
Activate()
onEvent( msg, wParam, lParam )
Init()
SetValue( nValue )
GetValue()

DATA

CLASS VAR winclass
cFileName

METHODS

New( oWndParent, nId, nStyle, nLeft, nTop, nWidth, nHeight,
           cFilename, lAutoPlay, lCenter, lTransparent )
Activate()
Init()
Open( cFileName )
Play( nFrom, nTo, nRep )
Seek( nFrame )
Stop()
Close()
Destroy()

DATA

block,heading,width,type,length,dec,cargo
nJusHead, nJusLin
tcolor,bcolor,brush
lEditable
aList
aBitmaps
bValid,bWhen
bEdit
cGrid
lSpandHead
lSpandFoot
Picture

METHODS

New( cHeading,block,type,length,dec,lEditable,nJusHead,nJusLin,,cPict,bValid,bWhen,aItem,oBmp )

DATA

CLASS VAR oGroupCurrent
aButtons
value
bSetGet

METHODS

New( vari,bSetGet )
EndGroup( nSelected )
SetValue( nValue )
Refresh()

DATA

CLASS VAR aFonts
handle
name, width, height ,weight
charset, italic, Underline, StrikeOut
nCounter

METHODS

Add( fontName, nWidth, nHeight ,fnWeight, fdwCharSet, ;
           fdwItalic, fdwUnderline, fdwStrikeOut, nHandle )
Select()
Release()

DATA

CLASS VAR aPens
handle
style, width, color
nCounter

METHODS

Add( style, width, color )
Release()

DATA

CLASS VAR aBrushes
handle
color
nHatch
nCounter

METHODS

Add( color,nHatch )
Release()

DATA

CLASS VAR aBitmaps
handle
name
nWidth, nHeight
nCounter

METHODS

AddResource( name )
AddFile( name,hDC )
AddWindow( oWnd,lFull )
Release()

DATA

CLASS VAR aIcons
handle
name
nCounter

METHODS

AddResource( name )
AddFile( name,hDC )
Release()

DATA

hDCPrn
hDC
cPrinterName
hPrinter
aMeta
lPreview
cMetaName
nWidth, nHeight
nPWidth, nPHeight
nHRes, nVRes
lmm
nCurrPage, oTrackV, oTrackH
nZoom, xOffset, yOffset, x1, y1, x2, y2

METHODS

New( cPrinter,lmm )	Opening a printer. If 'cPrinter' is omitted, Printer Setup dialog appears; if 'cPrinter' is an empty string, default printer is used.
SetMode( nOrientation )
AddFont( fontName, nHeight ,lBold, lItalic, lUnderline )
SetFont( oFont )
StartDoc( lPreview,cMetaName )	Starts printing of a document. lPreview should be TRUE, if you want to preview the printing result.
EndDoc()	End of a document printing.
StartPage()
EndPage()
ReleaseMeta()
PlayMeta( nPage, oWnd, x1, y1, x2, y2 )
PrintMeta( nPage )
Preview( cTitle,aBitmaps,aTooltips,aBtnUser )	Opening of a preview window, this should be used after EndDoc() call.
End()	Releasing the printer.
Box( x1,y1,x2,y2,oPen )
Line( x1,y1,x2,y2,oPen )
Say( cString,x1,y1,x2,y2,nOpt,oFont )
Bitmap( x1,y1,x2,y2,nOpt,hBitmap )

DATA

CLASS VAR winclass
aItems
handle
oTree, oParent
bAction
cargo

METHODS

New( oTree, oParent, oPrev, oNext, cTitle, bAction,aImages )
AddNode( cTitle, oPrev, oNext, bAction, aImages )
Delete()
FindChild( handle )
GetText()
SetText(cText)

DATA

CLASS VAR aTimers
id
value
oParent
bAction

METHODS

New( oParent,id,value,bAction )
End()

This class is similar to HBitmap, HIcon classes, it allows to load, save and draw an image in BMP, JPEG, PNG and some other formats. It uses FreeImage library (http://freeimage.sourceforge.net>) - so, if you include it in your application, you need to have FreeImage.dll.

DATA

CLASS VAR aImages
handle
hBitmap
name
nWidth, nHeight
nCounter

METHODS

AddFile( name )	Load the image from a file
FromBitmap( oBitmap )	Create an image from a bitmap
Draw( hDC,nLeft,nTop,nWidth,nHeight )	Draw the image on specified device contect
Release()	Unload the image

METHODS

Create( cFile,oTime,oResource )

QHTM is a C++ library, which allows to display and print HTML content in your application - on any window, device context, on a report, on a button or in a tooltip. For more details look at http://www.gipsysoft.com.
HwGUI provides an interface for this library. To use it, you need to download QHTM from the http://www.gipsysoft.com/qhtm/freedownload.shtml and copy qhtm.dll to the same directory, where your application is.
Attention !!! QHTM is released under other license than Harbour and HwGUI, so don't forget to read it before using !

@ <x>,<y> QHTM [ <oQhtm> ]

[ CAPTION <caption> ]
[ FILE <fname> ]
[ RESOURCE <resname> ]
[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON CLICK <bLink> ]
[ ON SUBMIT <bSubmit> ]
[ STYLE <nStyle> ]

This command creates QHTM control. Html content may be assigned in three ways:

• You can write it after CAPTION clause.
• It may be in external html file, which name is designated after FILE clause.
• Resource file. In this case appropriate resource name is signed after RESOURCE clause.

REDEFINE QHTM [ <oQhtm> ]

[ CAPTION <caption> ]
[ FILE <fname> ]
[ RESOURCE <resname> ]
[ OF <oWnd> ];
ID <nId>
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON CLICK <bLink> ]
[ ON SUBMIT <bSubmit> ]

This command redefines QHTM control from resources. Html content may be assigned in three ways the same three ways as in @ ... QHTM command.

@ <x>,<y> QHTMBUTTON [ <oButton> CAPTION ] <caption>

[ OF <oWnd> ];
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON CLICK <bClick> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

This command works exactly as @ ... BUTTON, but <caption> may include html content.

REDEFINE QHTMBUTTON <oButton>

[ OF <oWnd> ]
ID <nId>
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON CLICK <bClick> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

This command works exactly as REDEFINE BUTTON, but <caption> may include html content.

QHTM_Init( [ cDllName ] )

QHTM_Message( cMessage [,cTitle ] [,nFlags ] )

QHTM_LoadFile( handle, cFileName )

QHTM_LoadRes( handle, cResourceName )

QHTM_AddHtml( handle, cText )

QHTM_GetTitle( handle )

QHTM_GetSize( handle )

QHTM_EnableCooltips()

QHTM_PrintCreateContext() --> hContext

QHTM_PrintSetText( hContext,cHtmlText )

QHTM_PrintSetTextFile( hContext,cFileName )

QHTM_PrintSetTextResource( hContext,cResourceName )

QHTM_PrintLayOut( hDC,hContext ) --> nNumberOfPages

QHTM_PrintPage( hDC,hContext,nPage )

QHTM_PrintDestroyContext( hContext )

The Designer is intended to create/modify input screen forms and reports. It's main features are:

• The controls set is fully configurable. The list of controls ( widgets ) is placed in a special configuration XML file. The name of that file is specified in Designer's ini file "Designer.iml", currently it is resource/widgets.xml. To add a new control or even a controls set, or add new properties/methods for a control is easy now - just edit the widgets.xml. This allows to use the Designer not only for HwGUI based, but for any other applications - you can create a fully new controls set for your purposes. Report items, for example, has been added with an additional resource file - resource/repwidg.xml.
• The Designer can be built not only as standalone program, but can be a part of other application where it is needed to edit forms and/or reports at runtime. There is a bat file bldlib.bat, which builds the designer.lib to link it in your application. To invoke the designer, you just need to call the function Designer():
  
        Designer() - call Designer to open/create/edit any form ;
        Designer( "-r" ) - call Designer to open/create/edit any report ;
        Designer( "-s" ) - call Designer to create a new form ( doesn't allow to open any other ) ;
        Designer( "-s",cForm ) - call Designer to edit a form 'cForm' ( doesn't allow to open any other ), the 'cForm' may be a file name or a string, containing the form ;
        Designer( "-r","-s" ) - call Designer to create a new report ( doesn't allow to open any other ) ;
        Designer( "-r","-s",cReport ) - call Designer to edit a report 'cReport' ( doesn't allow to open any other ), the 'cReport' may be a file name or a string, containing the report ;
  
  
• The output formats are configurable via the external scripts. The native HwGUI format support is included in Designer's code, all others are included as plugins.
  Currently there are three plugins - for reading old .frm files ( resource/f_text.prg ), for reading old .rpt files ( resource/r_text.prg ) and for writing the prgs - f_hwgprg.prg ( not fully functional yet ).
• Designer allows to set not only properties, but methods, too, - for every control / report item, so the resulting form description is a complete dialog procedure, and the resulting report description is a complete report program, which opens/navigates/closes databases, calculates summs, etc.
• HwGUI includes special classes to load / execute a form or report, created with the Designer - HFormTmpl, HRepTmpl.
  
        oForm := HFormTmpl():Read( cForm ) - loads a form, 'cForm' may be a file name or a string, containing the form ;
        oForm:Show() - executes the loaded form, shows it on the screen ;
        oReport := HRepTmpl():Read( cReport ) - loads a report, 'cReport' may be a file name or a string, containing the report ;
        oReport:Print( cPrinterName,lPreview ) - prints the report.
  
  

Few notes for HwGUI applications about using of some properties and methods:

• There is a method 'common' in a form methods list, it is intended for functions, which are needed for the form and which can be called from any other event handler of the form.
  Each function must be ended with the 'ENDFUNC' statement. The 'Return' isn't obligatory, but may be used if the function must return some value.
• The form has a property 'Variables' - it is an array of variables, which will be declared as 'Private' in the beginning of HFormTmpl():Show() and may be used in any event handler of the form.
• Each widget has a property 'Name' - this is a object name, which also will be declared as 'Private' in the beginning of HFormTmpl():Show().
• The widgets, which have corresponding 'GET' items, has a property 'Varname' - the name of the correspondibg variable, which also will be declared as 'Private' in the beginning of HFormTmpl():Show().

Few notes about the reports builder.
For a few years there was another report designer in HwGUI - HwReport. Now the Designer becomes the main report builder utility. It has more modern and advanced engine than Hwreport and, what is important, it is more easy to support one engine than two different :). The important point is that now the report builder may be integrated into the application and it is convenient, IMO, that the same code, the same module, linked into the application, implements two tasks - works with input forms and with reports.
The compatibility with the *.rpt files, created with Hwreport, is implemented via the plugin ( resource/r_text.prg ) - you may open rpt files, choosing the 'plain text format' and then save them in a new format, which is exactly the same as for input forms.
The new report engine uses a bit different approach than the old one. There are no 'markers' - the widget 'area' is used instead. You can convert any rpt file into the new format and you will see how these 'areas' are used. The 'area' has two main properties:

• AreaType - it may be Table, DocHeader, DocFooter, PageHeader, PageFooter. The Table is the same as the space between 'Start line' and 'End line' markers in the old engine.
• VarOffset - False/True, it determines, if the area position on the paper is fixed ( False ), or it depends on the size of previous area ( True ).

• onRepInit, which is executed when the report starts ;
• onRepExit.

• onBegin - it is executed before the item is being printed ;
• Condition - it must return a logical value ( with the 'Return' statement ), which determines, should this item be printed or no ;
• onExit - it is executed after the item is being printed.

HwGUI is released under the same license, as Harbour itself.