PROIV Client and Open Client - PROIV Application Settings

This section compares the Session Properties settings between the PROIV Client and the Open Client section, and focuses on the equivalent PROIV Application Settings properties.

PROIV Client

Description

Open Client

ApplicationIconFile

Sets the icon which appears in the top left of the title bar of the main PROIV frame window. Graphics located in the directory containing Images field in the Appearance Settings option are available for selection. The selected graphic must be available on all clients.

The location can be either the complete path and name, or just the name if the icon is located in the same directory as the proiv.exe. (It must have an .ico extension.) For example:

c:\pro40itmaps\title.ico

Set in the application images (appImages) folder (proiv.ico). Click here to learn more about Open Client Customisation and Deployment.

ApplicationTitle

Sets the text which displays in the title bar of the main PROIV frame window and all pop-up child frames that may be created during the PROIV session.

Title can only be set in the PROIV Client.

AutoSenseURL

Determines whether URLs are automatically detected and when the text is clicked on a screen, the website appears in your browser.

Not Supported

ClientBackColor

Sets the background colour of the PROIV session if the following conditions are true:

  • If the DefaultWallpaper has not been defined.

  • If the DefaultWallpaper has not been loaded into the PROIV Client

Note: DefaultWallpaper loads as the PROIV Client's background. The ClientBackColor is restricted to the PROIV Client's parent frame or window (i.e. ClientBackColor is not applied to child windows, for example Global Screens.)

PROIV Open Client style sheet

CloseExternalReportViews

If enabled, any active external report viewer launched by the current session will exit when the current session is closed.

Not Supported

CommandStackSize

DEPRECATED. Used only in legacy Version 5 PIV files.

Not Supported

DDEServiceName

Sets the name of the Dynamic Data Exchange service name. The default setting is PRO-IV.

Not Supported

DefaultWallpaper

Sets the wallpaper that appears by the PROIV session. You can select .gif, .bmp or .jpg files.

PROIV Open Client style sheet

EnableRightClickMenus

Displays a menu when you right-click in a Paging Area. It is not configurable, it gives the modes: Cut, Copy, Paste, Window and Expand.

Note that it is not related to the Control Bar/Action Control right-click menus.

Always on

EvenColor

Sets the colour that is applied to the even-numbered records of a Paging Cycle.

PROIV Open Client style sheet

FontHeight

Sets the font height of text displayed in the PROIV session, including field labels, data and user messages.

PROIV Open Client style sheet

IconicMenus

Used to specify PROIV menus that are represented by an icon.
0 = Functions will be shown traditionally with push s.
1 = Type M functions which have been built with icon capability will be executed as iconic menus.

Recommended Setting

iconicmenus = 1

Not Supported

KernelWaitHourGlass

Turns the mouse pointer into an hourglass when the kernel is busy (i.e. when the lightning bolt is red).  

Not Supported

KernelWaitTimeOut

Setting affects the mouse cursor behaviour. If KernelWaitTimeOut is set to 1 and the KernelWaitHourGlass property is enabled, you can use the Application.busy property to set or unset the cursor (where True is on and False is off.) This will display an egg timer when the kernel is busy.

Not Supported

Locale

Sets the locale .dll file. The locale determines the set of parameters that defines the user's language and country.

Browser locale

NumberOfFunctions

Sets the number of recently used functions shown in the Kernel Prompt window which are saved to the PIV.

Not Supported

OddColor

Sets the colour that is applied to the odd-numbered records of a Paging Cycle.

PROIV Open Client style sheet

OldFormatSizing

Specifies that a font size (x and y) should take into account the underline and italic settings of the font. If set to 0, the calculated font size assumes that underline and italic are always on. This effectively gives you slightly larger widget sizes. The value is read from the registry rather than the PIV setting.

Not Supported

OldListBoxSelection

Enables PROIV to send a list box selected item to the kernel each time the value needs to be sent. If this setting is 0 then the value is only re-sent if it has changed since the last time it was sent. The value is read from the registry rather than the PIV setting.

Not Supported

PagingHorzLineStyle

Specifies the line style to use for horizontal lines in paging areas.

0 = PS_SOLID

1 = PS_DASH       /* ------- */

2 = PS_DOT         /* &.... */

3 = PS_DASHDOT              /* _._._._ */

4 = PS_DASHDOTDOT      /* _.._.._ */

5 = PS_NULL

PROIV Open Client style sheet

PagingVerLineStyle

Specifies the line style to use for vertical lines in paging areas.

0 = PS_SOLID

1 = PS_DASH       /* ------- */

2 = PS_DOT         /* &.... */

3 = PS_DASHDOT              /* _._._._ */

4 = PS_DASHDOTDOT      /* _.._.._ */

5 = PS_NULL

PROIV Open Client style sheet

PIVCompare

Displays comparison information when a PIV is loaded. This option is not available if you are running PROIV after a clean installation.

Not Supported

PrintMarginLeft

Displays text in left print margin.

 

Not Supported

RegionalSettings

Sets the language and code pages that PROIV uses to display characters. The resource dll selected on the Regional Settings option determines the default Regional Setting. This can be changed if required.

Browser locale

ReportEditor

Sets the application to be used as the destination for report generation. Enter the full path to the editor, for example: C:\Program Files\Microsoft Office\Office\Winword.exe.

Not Supported

ReportFileType

Sets the file extension the client uses when creating a temporary file during report generation for example: .doc.

Not Supported

ShowFrameBorder

If enabled, the window frame border appears. If disabled, the window frame border is hidden.

Not Supported

ShowMenu

If enabled, the menu bar appears. If disabled, the menu is hidden.

Not Supported

ShowScrollBars

If enabled, the scroll bars are displayed. If disabled, the scroll bars are hidden.

Not Supported

ShowStatusBar

If enabled, the status bar appears. If disabled, the status bar is hidden.

PROIV Open Client object definitions

ShowTitle

If enabled, the title bar appears. If disabled, the title is hidden. You can alter the text in the title bar, see the ApplicationTitle setting for more information.

Not Supported

ShowToolbar

If enabled, the toolbar appears. If disabled, the toolbar is hidden.

Not Supported

SkipUserConfirmation

If enabled, the PIV file is automatically saved and the application is closed on session exit. If disabled, the PIV file is not automatically saved.

Not Supported

SLWinAddLines

DEPRECATED Forced pop-up windows to be 2 rows longer. This was introduced for Superlayer purposes and therefore is now deprecated.

Not Supported

SqlWaitTimer

Sets the length of time the client waits for the kernel to read a database record (in seconds). The value is read from the registry rather than the PIV setting.

Not Supported

SSHPortOverride

Enables the override of the secure shell port from the default value of 22.

Not Supported

SystemWaitMsg (Unix kernel only)

Y = the following message displays when a system command has been completed:

'System Command completed
Returning to PROIV.'

N = Suppress the message.

Not Supported

TypeAhead

If set to TRUE, you can continue typing regardless of the current PROIV operation, if PROIV is busy at the time, it handles the entry when it is free to do so.

Always on

Auto Complete Settings

The Auto Complete section gives the user a limited amount of control over the operation of the .AutoCompleteEntry property for edit boxes and combo boxes.  The developer can specify that certain edit boxes and combo boxes can have augmented data entry properties through the .AutoCompleteEntry property. These edit boxes and combo boxes can then remember the last n (default being 50) unique data items entered into each control. PROIV then prompts the user with items that match the data entered so far into the control.

Not Supported

Disabled

Auto Complete functionality in edit and combo boxes is disabled regardless of any settings made in PROIV logic.

Not Supported

Always Complete

Puts the best previous match into the field until you stop typing. If there is only one entry in the list, it is automatically entered into the edit or combo box.

Overrides the .AutoCompleteEntry settings for all controls that have .AutoCompleteEntry turned on.

Not Supported

Always Suggest

Displays a drop-down list based on the characters you type. For example, if the previous values entered in a field are Fred, Fish, Frank and John, typing F would populate a list with Fred, Fish and Frank. Typing "Fr" populates the list with Frank and Fred. Typing "Fre" limits the list to Fred.  

Overrides the .AutoCompleteEntry settings for all controls that have .AutoCompleteEntry turned on.

Not Supported

Set by PROIV

Enables the developer to configure the Auto Complete settings on a field by field basis. The Auto Complete setting is on the Data tab on the Editbox or Combobox Properties windows for both Dynamics and Statics.

Not Supported

Maximum entries per field

This field allows the user (not the PROIV developer) to specify for the current PIV, how many items per object Tag Name are to be remembered, and can also discard all remembered entries. If the count of items remembered is reduced, excess entries are deleted.

In other words, it is the maximum number of items which are available to draw suitable subsets from your recent text entries. These subsets are based on the first few letters that are typed into the edit and combo boxes.

Not Supported

List Settings

The developer can store the state of the column sort order, column width, and column order of a particular list box after the current function exits by setting the .RememberSettings property for the list box object to TRUE. If this property setting is used, the information is stored in the Windows Registry on the Client’s machine under a per-Windows user, per-PIV, per Tag Name key. Those settings are subsequently retrieved and used to initialise the list box environment when it is next displayed.

The List Settings section gives the PROIV user some control over the storage of these settings and allows them to be imported and exported across different machines

Settings are saved to the DOM local storage area. Please note that this is restricted to recent browsers that support DOM local storage functionality.

 

Comment on this topic

Topic ID: 800032