[RBASE-L] - Tip of the Day - Customizing Load Window in Compiled Applications

[A. Razzak Memon]

Thursday, April 21, 2011

Tip of the Day - Customizing Load Window in Compiled Applications
Product: R:Compiler 9.1 (32/64)
Update.: 3
Build..: 9.1.3.10414 or higher http://www.rupdates.com
Section: Customizing Load Window

When compiling your application, you have the option (check box)
to "Show Loading Window" which permits the ability to display a 
progress window while the program is loading. The available field 
is used to enter a custom message for the progress dialog window. 

With this feature available to the compiled program, there are 
three additional PROPERTY command parameters which you can use
to display customized load window:

PROPERTY LOADWINDOW TITLE 'Your Message Here'
PROPERTY LOADWINDOW PROGRESS nnn (0-100)
PROPERTY LOADWINDOW CLOSE 'TRUE'
PROPERTY LOADWINDOW CAPTION 'Your Caption'

Did you know that you can use the new LOADWINDOW SHOWINDICATOR 
option to display moving circle (indicator) along with your 
custom message?

Here's how:

01. While customizing your project using R:Compiler 9.1 (32/64),
    make sure to enable the option for "Show Loading Windows"

    Example: 
    http://www.razzak.com/tips/RCompiler91_ShowLoadWindow_01.png

02. Customize the application DAT file to include the following
    PROPERTY command:

    PROPERTY LOADWINDOW SHOWINDICATOR 'TRUE'
    RETURN

03. Compile your application.

    Example:
    http://www.razzak.com/tips/RCompiler91_ShowLoadWindow_02.png

04. Once the application is compiled successfully, run the .exe 
    file and notice the Load Window with moving circle (Indicator).

    Example:
    http://www.razzak.com/tips/RCompiler91_ShowIndicator_03.png

05. Finally, use the following PROPERTY command as "On After Start" 
    EEP for your main application form to close the loading window.

    -- On After Start Custom EEP
    SET VARIABLE vCompiled TEXT = NULL
    GETPROPERTY APPLICATION IsCompiled vCompiled
    IF vCompiled = 'YES' THEN
       PROPERTY LOADWINDOW CLOSE 'TRUE'
    ENDIF
    CLEAR VARIABLE vCompiled
    RETURN

    Example:
    http://www.razzak.com/tips/Application_Main_Menu.png

Have fun implementing new features & enhancements of R:Compiler 9.1!

Very Best R:egards,

Razzak.