Rapid-Q Documentation by William Yu (c)1999, Appended by John Kelly Appendix A: APPLICATION

APPLICATION Component

This object is global, and need not be created. This is extended in RAPIDQ2.INC

Application Properties
FieldTypeR/WDefaultSupport





ExeNameSTRINGRWXG
The executable name of the application, path name is excluded (use COMMAND$(0) for full path information).
HandleINTEGERRW
hInstance of the application.
HelpFileSTRINGRWW
HelpFile specifies the name of the file the application uses to display help.
HintColorINTEGERRWclInfoBkW
HintColor determines the color of the hint boxes for the Help Hints.
HintHidePauseINTEGERRW2500W
HintHidePause specifies the time interval to wait before hiding the Help Hint if the mouse has not moved from the control or menu item.
HintPauseINTEGERRW500W
HintPause specifies the time interval that passes before the control's Help Hint appears when the user places the mouse pointer on a control or menu item.
HintShortPauseINTEGERRW50W
HideShortPause specifies the pause to wait before bringing up a hint if a hint has already been shown.
IconSTRINGRWW
Specify an icon filename to appear as the default icon of your application.
IcoHandleRESOURCEWW
Specify an icon resource to appear as the default icon of your application.
Example:
$RESOURCE game_ICO AS "game.ico"
Application.IcoHandle = game_ICO
ShowHintINTEGERRWTrueW
TitleSTRINGRWW


Application Methods
MethodTypeDescriptionParamsSupport





HelpCommandSUB (Command AS WORD, Data AS LONG)Accesses the Help commands in the WinHelp API2W
HelpContextSUB (Context AS LONG)Bring up the Application's HelpFile at specifed Context ID1W
HelpJumpSUB (JumpID AS STRING)Brings up the HelpFile and displays the screen in the Help file that has the JumpID1W
MinimizeSUBMinimize Application0W
TerminateSUBTerminates Application0WXG

Application Methods
with RAPIDQ2.INC  (also see QProcess for threads)
GetPriorityVOID

Get the current Application Process Priority Windows Priority of the application, typically will be NORMAL_PRIORITY_CLASS

0W
SetPriorityFUNCTION (Priority AS LONG)

Sets the Application Process priority, in case you want more or less CPU power to your program.
Possible values are:
IDLE_PRIORITY_CLASS                                     Reduce RapidQ time allocation--, for occasional running
BELOW_NORMAL_PRIORITY_CLASS             Win2000, NT, XP+ only, less power to your App
NORMAL_PRIORITY_CLASS                              Default 
ABOVE_NORMAL_PRIORITY_CLASS              Win2000, NT, XP+ only more CPU to your App
HIGH_PRIORITY_CLASS                                     Other programs suffer, but yours gets most CPU
REALTIME_PRIORITY_CLASS                            CAUTION!!! 
    (REALTIME mouse,no keyboard, no disk, you own the CPU! You must do all hardware IO)
1W
PathSTRINGReturns the path of the application0W


Application Examples

  Application.HintColor = &H00FF00

  CREATE Form AS QFORM
      CREATE Button AS QBUTTON
          Hint = "Button Hint"
          ShowHint = 1
      END CREATE
      ShowModal
  END CREATE  

Application Example #2
$INCLUDE "RAPIDQ2.INC"
ShowMessage "My application resides in folder " + Application.Path


Prev Component Up Contents Next Component