HwGUI reference manual for version 2.10

Alexander S.Kresin
September 2003

• 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.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
  • 4.2 Menu commands
    • 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.3 Commands for controls handling
    • 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.4 Get system commands
    • 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
• 5 Functions
  • 5.1 Common dialogs
    • 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 )
  • 5.2 MessageBoxes and HwGUI dialogs
    • 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 )
  • 5.3 Drawing functions.
• 5 Classes
  • 6.1 Class hierarchy
  • 6.2 HObject
  • 6.3 HCustomWindow
    • 6.3.1 HWindow
    • 6.3.2 HDialog
    • 6.3.3 HControl
      • 6.3.3.1 HBrowse
      • 6.3.3.2 HPanel
      • 6.3.3.3 HOwnerButton
      • 6.3.3.4 HSplitter
      • 6.3.3.5 HStatus
      • 6.3.3.6 HStatic
      • 6.3.3.7 HButton
      • 6.3.3.8 HEdit
      • 6.3.3.9 HChecBox
      • 6.3.3.10 HRadioButton
      • 6.3.3.11 HCombobox
      • 6.3.3.12 HGroup
      • 6.3.3.13 HLine
      • 6.3.3.14 HSayImage
        • 6.3.3.14.1 HSayBmp
        • 6.3.3.14.2 HSayIcon
        • 6.3.3.14.3 HSayFImage
      • 6.3.3.15 HDatePicker
      • 6.3.3.16 HUpDown
      • 6.3.3.17 HTab
      • 6.3.3.18 HTree
  • 6.5 HColumn
  • 6.6 HRadioGroup
  • 6.7 HFont
  • 6.8 HPen
  • 6.9 HBrush
  • 6.10 HBitmap
  • 6.11 HIcon
  • 6.12 HPrinter
  • 6.13 HTreeNode
  • 6.14 HTimer
  • 6.15 HFreeImage
• 7 QHTM integration
  • 7.1 Overview
  • 7.2 Commands
  • 7.3 Functions
• 8 License
• 9 About the author

1 Introduction

1.1 What is HwGUI

HwGUI is an add-on library for Harbour, 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.

1.2 History of HwGUI

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.

2 Installation of HwGUI

2.1 HwGUI package

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:

2.2 How to build HwGUI library

Before building the library you need to check the value of HRB_DIR environment variable in the HWGUI/makefile.bc file. It should point to the directory where your copy of Harbour is. Then run make_b32.bat - and this will build two libraries - hwgui.lib and procmisc.lib. That's all !

2.3 How to build HwGUI samples

3 How to use HwGUI

3.1 First HwGUI application

   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 ;
           STYLE WS_DLGFRAME+ES_LEFT

   @ 270,10 COMBOBOX aCombo ;
           STYLE WS_TABSTOP ;
           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 ;
           STYLE WS_DLGFRAME+ES_LEFT
   @ 270,10 COMBOBOX aCombo ;
           STYLE WS_TABSTOP ;
           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 Commands

4.1 Commands for windows and dialogs handling

4.1.1 INIT WINDOW

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> ]

MAIN,MDI,MDICHILD clauses specifies the type of the window, only one of this clauses may be used in the command.
cTitle - title of the window;
x,y,width,height - left and top coordinates of the window, it's width and height;
ico - the name of the Icon in the resource file;
clr - the background color of the window;
nStyle - style of the window;
oFont - previously created HFont object;
cMenu - the name of menu declaration in the resource file ( if you specify menu in resources );
nPos - identifies the window menu used for controlling MDI child windows. As child windows are created, the application adds their titles to the Window menu as menu items. The user can then activate a child window by choosing its title from the window menu.
bSize - codeblock, which is evaluated while resizing window;
bPaint - codeblock, which is evaluated while window drawing;
bGFocus - codeblock, which is evaluated when window gets focus;
bLFocus - codeblock, which is evaluated when window losts focus;
bExit - codeblock, which is evaluated when window is closed;
bOther - codeblock, which is evaluated for all other messages - you can write your own procedure for messages handling;

4.1.2 INIT DIALOG

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 ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ ON PAINT <bPaint> ]
[ ON GETFOCUS <bGfocus> ]
[ ON LOSTFOCUS <bLfocus> ]
[ ON OTHER MESSAGES <bOther> ]
[ ON EXIT <bExit> ]

All clauses has the same meaning as in INIT WINDOW command, there is only one specific clause - FROM RESOURCE - it is used if you create the dialog box from resource file.

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 command is for those users, who are familiar with Win32 API. 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 Menu commands

4.2.1 MENU

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

ENDMENU

MENUITEM <item> [ ID <nId> ]

ACTION <act>
[ 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>

4.3 Commands for controls handling

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> ]
[ 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> ]
[<lnoborder: NOBORDER> ]
[ 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> ]
[ 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> ]
[ FONT <oFont> ]
[ TOOLTIP <ctoolt> ]

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

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

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> ]
[ 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> ]
[ 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> ]

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> ]
[ LEN <length> ]
[ DEC <dec> ]
[ <lEdit: EDITABLE> ]

@ <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> ]

[ OF <oWnd> ]
[ ID <nId> ]
[ SIZE <width>, <height> ]
[ FONT <oFont> ]
[ COLOR <tcolor> ]
[ BACKCOLOR <bcolor> ]
[ ON INIT <bInit> ]
[ ON SIZE <bSize> ]
[ STYLE <nStyle> ]
[<lEdit: EDITABLE> ]
[ BITMAP <aBmp> [<res: 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> ]
[<lVert: 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> ]

4.4 Get system commands

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> ]
[ 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: 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: 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> ]
[ STYLE <nStyle> ]
[ FONT <oFont> ]
[ 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> ]

5 Functions

5.1 Common dialogs

5.1.1 SelectFont( [ oFont ] )

• 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.

5.1.2 SelectFile( cDescript,cMask,[ cInitDir ], [ cTitle ] )

• 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.

5.1.3 SaveFile( cPrompt,cDescript,cMask,cInitDir,cTitle )

• 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.

5.1.4 PrintSetup()

• Return value ( numeric ) - handle to device context ( hDC ) of selected printer, 0 - if printer wasn't selected.

5.1.5 hwg_ChooseColor( nColorCurrent )

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

5.2 MessageBoxes and HwGUI dialogs

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 )

5.3 Drawing functions.

6 Classes

6.1 Class hierarchy

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

6.2 HObject

It is a base class for all HwGUI classes.

6.3 HCustomWindow

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

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

METHODS

AddControl( oCtrl )
DelControl( oCtrl )
AddEvent( nEvent,nId,bAction )
FindControl( nId )
Hide()
Show()

6.3.1 HWindow

DATA

CLASS VAR aWindows
CLASS VAR szAppName
menu, nMenuPos, oPopup, hAccel
oIcon, oBmp
oNotifyIcon, bNotify, oNotifyMenu
lClipper
lTray

METHODS

New( lType,oIcon,clr,nStyle,x,y,width,height,cTitle,cMenu,nPos,oFont,
           bInit,bExit,bSize,bPaint,bGfocus,bLfocus,bOther,cAppName,oBmp )
Activate( lShow )
InitTray( oNotifyIcon, bNotify, oNotifyMenu )
AddItem( oWnd )
DelItem( oWnd )
FindWindow( hWnd )
GetMain()
GetMdiActive()

6.3.2 HDialog

DATA

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

METHODS

New( lType,nStyle,x,y,width,height,cTitle,bInit,bExit,bSize,
           bPaint,bGfocus,bLfocus,bOther,lClipper,oBmp,oIcon ) Activate(lNoModal)
AddItem( oWnd,lModal )
DelItem( oWnd,lModal )
FindDialog( hWnd )

6.3.3 HControl

DATA

id
tooltip
lInit

METHODS

Init()
SetColor( tcolor,bcolor,lRepaint )
NewId()
Move( x1,y1,width,height )

6.3.3.1 HBrowse

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
tcolorSel,bcolorSel,brushSel
bSkip,bGoTo,bGoTop,bGoBot,bEof,bBof
bRcou,bRecno
bPosChanged, bLineOut
bEnter, bKeyDown
internal
alias	Alias name of browsed database
x1,y1,x2,y2,width,height
minHeight
lEditable
lAppable
lAppMode
lAutoEdit
lUpdated
lAppended

METHODS

New( lType,oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,oFont ;
           bInit,bSize,bPaint,bEnter,bGfocus,bLfocus,lNoVScroll,lNoBorder )
InitBrw( nType )
Rebuild()
Activate()
Redefine( lType,oWnd,nId,bInit,bSize,bDraw,bEnter,bGfocus,bLfocus )
FindBrowse( nId )
AddColumn( oColumn )
InsColumn( oColumn,nPos )
DelColumn( nPos )
Paint()
LineOut()
HeaderOut( hDC )
DoHScroll( wParam )
DoVScroll( wParam )
LineDown()
LineUp()
PageUp()
PageDown()
Bottom()
Top()
ButtonDown( lParam )
ButtonUp( lParam )
ButtonDbl( lParam )
MouseMove( wParam, lParam )
Edit( wParam,lParam )
Append()
RefreshLine()
Refresh()
ShowSizes()
End()

6.3.3.2 HPanel

DATA

winclass

METHODS

New( oWndParent,nId,nStyle,nLeft,nTop,nWidth,nHeight,
           bInit,bSize,bPaint )
Activate()
Redefine( oWnd,nId,nHeight,bInit,bSize,bPaint )
Paint()
End()

6.3.3.3 HOwnerButton

DATA

CLASSDATA oSelected
winclass
lFlat
state
bClick
text,tfont,xt,yt,widtht,heightt
bitmap,xb,yb,widthb,heightb,lTransp

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 )
Activate()
Redefine( oWndParent,nId,bInit,bSize,bPaint,bClick,lflat,
           cText,color,font,xt,yt,widtht,heightt,
           bmp,lResour,xb,yb,widthb,heightb,lTr,
           cTooltip ) Paint()
MouseMove( wParam, lParam )
MDown()
MUp()
Press()
Release()
End()

6.3.3.4 HSplitter

DATA

winclass
aLeft
aRight
lVertical
hCursor
lCaptured, lMoved

METHODS

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

6.3.3.5 HStatus

DATA

aParts

METHODS

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

6.3.3.6 HStatic

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)

6.3.3.7 HButton

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 )

6.3.3.8 HEdit

DATA

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

METHODS

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

6.3.3.9. HChecButton

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 )
Activate()
Redefine( oWnd,nId,vari,bSetGet,oFont,bInit,bSize,bDraw,bClick,ctoolt,tcolor,bcolor )
Init()

6.3.3.10 HRadioButton

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 )

6.3.3.11 HCombobox

DATA

CLASS VAR winclass
aItems
value
bChangeSel

METHODS

New( oWndParent,nId,vari,bSetGet,nStyle,nLeft,nTop,nWidth,nHeight,aItems,
           bInit,bSize,bPaint,bChange,cTooltip )
Activate()
Redefine( oWnd,nId,vari,bSetGet,aItems,bInit,bSize,bPaint,bChange,cTooltip )
Init( aCombo, nCurrent )

6.3.3.12 HGroup

DATA

CLASS VAR winclass

METHODS

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

6.3.3.13 HLine

DATA

CLASS VAR winclass
lVert
oPenLight, oPenGray

METHODS

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

6.3.3.14 HSayImage

DATA

CLASS VAR winclass
oImage

METHODS

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

6.3.3.14.1 HSayBmp

METHODS

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

6.3.3.14.2 HSayIcon

METHODS

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

6.3.3.14.3 HSayFImage

METHODS

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

6.3.3.15 HDatePicker

DATA

CLASS VAR winclass
bSetGet
value

METHODS

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

6.3.3.16 HUpDown

DATA

CLASS VAR winclass
bSetGet
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()

6.3.3.17 HTab

DATA

CLASS VAR winclass
aTabs
aPages
bChange,bChange2
oTemp

METHODS

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

6.3.3.18 HTree

DATA

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

METHODS

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

6.5 HColumn

DATA

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

METHODS

New( cHeading,block,type,length,dec,lEditable,nJusHead,nJusLin )

6.6 HRadioGroup

DATA

CLASS VAR oGroupCurrent
aButtons
value
bSetGet

METHODS

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

6.7 HFont

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()

6.8 HPen

DATA

CLASS VAR aPens
handle
style, width, color
nCounter

METHODS

Add( style, width, color )
Release()

6.9 HBrush

DATA

CLASS VAR aBrushes
handle
color
nHatch
nCounter

METHODS

Add( color,nHatch )
Release()

6.10 HBitmap

DATA

CLASS VAR aBitmaps
handle
name
nWidth, nHeight
nCounter

METHODS

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

6.11 HIcon

DATA

CLASS VAR aIcons
handle
name
nCounter

METHODS

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

6.12 HPrinter

DATA

hDCPrn
hDC
aMeta
lPreview
cMetaName

METHODS

New( cPrinter )	Opening a printer. If 'cPrinter' is omitted, Printer Setup dialog appears; if 'cPrinter' is an empty string, default printer is used.
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 )	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 )

6.13 HTreeNode

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()

6.14 HTimer

DATA

CLASS VAR aTimers
id
value
oParent
bAction

METHODS

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

6.15 HFreeImage

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

7 Qhtm integration

7.1 Overview

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 !

7.2 Commands

@ <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.

7.3 Functions

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 )

8 License

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

9 About the author