'OPTION' |
On-the-Fly Setting |
Behaviour
'OPTION' (keyword$,value[$])
keyword$ |
Named property. Case insensitive string expression (characteristic, icon, font, colour index) described below. |
value[$] |
Value assigned to keyword$. String or numeric expression. (The numeric option was added in PxPlus v11.) |
The 'OPTION' mnemonic allows specific PxPlus environment properties (typically set via INI entries) to be set at run time (on the fly) within a session.
Item Colors | |||||||||||||||||||||||||||||||||||
BtnFaceClr |
Button face color. | ||||||||||||||||||||||||||||||||||
BtnFocusHilight |
Focus highlight. | ||||||||||||||||||||||||||||||||||
BtnFrameClr |
Button/Check Box/Radio Button frame color. | ||||||||||||||||||||||||||||||||||
BtnHoverHilight |
Mouse Over highlight. | ||||||||||||||||||||||||||||||||||
CbxMarkClr |
Check mark or 'X' in a Check Box. | ||||||||||||||||||||||||||||||||||
Sets the background and text colors used to display currently selected items from a List Box or Drop Box and display the background and text in a Multi-Line when it has focus. If setting focus on the Multi-Line, selects all of the text. If selecting a portion of the inputted text for Copy, Cut, Delete or Paste functions, then the color of the selected text will be displayed in the standard Windows color for selected text. (added in PxPlus 2017) | |||||||||||||||||||||||||||||||||||
Background for any 'SB' data. (Default: Light Gray button face color) (added in PxPlus 2022 Update 1) | |||||||||||||||||||||||||||||||||||
Background for any 'SF' data. (Default: White) (added in PxPlus 2022 Update 1) | |||||||||||||||||||||||||||||||||||
Text (Default: Black) (added in PxPlus 2022 Update 1) | |||||||||||||||||||||||||||||||||||
ClrToolBar |
Background color for the tool bar. (added in PxPlus v9) | ||||||||||||||||||||||||||||||||||
Background color of the Drop Box button. (added in PxPlus 2024) | |||||||||||||||||||||||||||||||||||
Background color of the Drop Box button when the Drop Box is disabled. (added in PxPlus 2024) | |||||||||||||||||||||||||||||||||||
Background color of the Drop Box button while hovering over it. Defaults to the Windows hover color if no drop button colors are set; otherwise, it defaults to the drop button background color but is 25% lighter. (added in PxPlus 2024) | |||||||||||||||||||||||||||||||||||
Color of the down arrow/tick on the Drop Box button while hovering over it. Defaults to the Windows tick color if no drop button colors are set; otherwise, it defaults to the drop button tick color but is 25% lighter. (added in PxPlus 2024) | |||||||||||||||||||||||||||||||||||
Color of the down arrow/tick on the Drop Box button. (added in PxPlus 2024) | |||||||||||||||||||||||||||||||||||
Color of shadow line drawn by 'FRAME' mnemonic. (Default: Dark Gray) (added in PxPlus v11) | |||||||||||||||||||||||||||||||||||
Color of highlight line drawn by 'FRAME' mnemonic. (Default: Light Gray) (added in PxPlus v11) | |||||||||||||||||||||||||||||||||||
Color of text header used by the 'FRAME' mnemonic. (added in PxPlus v11) | |||||||||||||||||||||||||||||||||||
RbtMarkClr |
Ball within a Radio Button. | ||||||||||||||||||||||||||||||||||
Sets the background colors used to display currently selected items from a List Box or Drop Box and display the background color in a Multi-Line when the control has focus. (added in PxPlus 2018) | |||||||||||||||||||||||||||||||||||
Sets the text colors used to display currently selected items from a List Box or Drop Box and display the text in a Multi-Line when the control has focus. (added in PxPlus 2018) | |||||||||||||||||||||||||||||||||||
Sets the standard/default line color for all subsequent grids. (Default is RGB: 220,220,220.) (added in PxPlus 2020) | |||||||||||||||||||||||||||||||||||
(Report View Only) Used to define the default hotlink column color for List Views. (added in PxPlus 2018) | |||||||||||||||||||||||||||||||||||
(Report View Only) Used to specify a system-wide background hover color for all List Views. (added in PxPlus 2018) | |||||||||||||||||||||||||||||||||||
(Report View Only) Used to define the text color when the mouse is over a row in a List View. (added in PxPlus 2018) | |||||||||||||||||||||||||||||||||||
(Report View Only) Sets the standard/default line color for all subsequent report style List Views. (Default is RGB: 220,220,220.) (added in PxPlus 2020) | |||||||||||||||||||||||||||||||||||
Color to be used as the background of alternate rows in a List Box or Grid. (added in PxPlus v11) | |||||||||||||||||||||||||||||||||||
Color to be used as the second background of alternate rows in a List Box or Grid. (added in PxPlus v11) | |||||||||||||||||||||||||||||||||||
TipArrowColor |
Used by HTML tips to define the color of the tip arrowhead and the underline below the tip title. (Default: Dark Red) For information on HTML tips, see Defining an Info Tip. (added in PxPlus 2016) | ||||||||||||||||||||||||||||||||||
Used to define the color for non-HTML tips. Valid formats for defining a color include predefined system color names (e.g. LightRed), RGB values, HSL values, Hex color codes, color blending, and dynamic color lightening. For information on these formats, see Color Properties. Setting this option sets the 'TC' system parameter to -3. If 'TC' is set to -3 but the TipColor (or TipColour) setting is not defined, the default Windows color will be used. (added in PxPlus 2021) | |||||||||||||||||||||||||||||||||||
The value$ may be assigned as color names.
| |||||||||||||||||||||||||||||||||||
Item Shading | |||||||||||||||||||||||||||||||||||
BtnDownBtmClr |
Colour for blend at the bottom of pushed button. | ||||||||||||||||||||||||||||||||||
BtnDownBtmPct |
Lightness applied to face at the bottom of pushed button. | ||||||||||||||||||||||||||||||||||
BtnDownMidClr |
Colour for blend at in middle of pushed button. | ||||||||||||||||||||||||||||||||||
BtnDownMiddle |
Mid-point percentage from the top of pushed button. | ||||||||||||||||||||||||||||||||||
BtnDownMidPct |
Lightness applied to face in middle of pushed button. | ||||||||||||||||||||||||||||||||||
BtnDownTopClr |
Colour for blend at the top of pushed button. | ||||||||||||||||||||||||||||||||||
BtnDownTopPct |
Lightness applied to face at the top of pushed button. | ||||||||||||||||||||||||||||||||||
BtnNormBtmClr |
Colour for blend at the bottom of normal button. | ||||||||||||||||||||||||||||||||||
BtnNormBtmPct |
Lightness applied to face at the bottom of normal button. | ||||||||||||||||||||||||||||||||||
BtnNormMidClr |
Colour for blend at in middle of normal button. | ||||||||||||||||||||||||||||||||||
BtnNormMiddle |
Mid-point percentage from the top of normal button. | ||||||||||||||||||||||||||||||||||
BtnNormMidPct |
Lightness applied to face in middle of normal button. | ||||||||||||||||||||||||||||||||||
BtnNormTopClr |
Colour for blend at the top of normal button. | ||||||||||||||||||||||||||||||||||
BtnNormTopPct |
Lightness applied to face at the top of normal button. | ||||||||||||||||||||||||||||||||||
Background colour to be used for text in auto complete List Boxes. (added in PxPlus v9.00, build 9200) | |||||||||||||||||||||||||||||||||||
Text colour to be used for text in auto complete List Boxes. (added in PxPlus v9.00, build 9200) | |||||||||||||||||||||||||||||||||||
Background colour to be used for text in disabled List Boxes, Multi-Lines, Radio Button text and Check Boxes. (added in PxPlus v9.00, build 9200) | |||||||||||||||||||||||||||||||||||
Text colour to be used for text in disabled List Boxes, Multi-Lines, Radio Button text and Check Boxes. (added in PxPlus v9.00, build 9200) | |||||||||||||||||||||||||||||||||||
CtlFrameClr |
Colour of lines in a frame. | ||||||||||||||||||||||||||||||||||
The value$ must be defined as a numeric string, either from 0 to 100 (for colour indexes) or -100 to 100 (for percentages) depending on the associated item.
| |||||||||||||||||||||||||||||||||||
Icons | |||||||||||||||||||||||||||||||||||
Icon |
Set the icon for current and subsequent windows. | ||||||||||||||||||||||||||||||||||
WdwIcon |
Set the icon for the current window only. | ||||||||||||||||||||||||||||||||||
The value$ assigned may be the path and name of the image .icofile or a full icon specification. If it is null " ", the icon is removed from the current window. If it is an * (asterisk), the default icon is displayed for the window. Example:
| |||||||||||||||||||||||||||||||||||
Fonts | |||||||||||||||||||||||||||||||||||
Controls the font to use for Radio Button and Check Box text. Setting to "1" causes the system to display text using fixed text plane font. Default is to use the graphical font ("0"). | |||||||||||||||||||||||||||||||||||
Font |
Sets the current window's text plane font. | ||||||||||||||||||||||||||||||||||
GraphicFont |
Sets the current window's default graphic font. | ||||||||||||||||||||||||||||||||||
StdFont |
Sets the session's default text plane font. | ||||||||||||||||||||||||||||||||||
StdGraphicFont |
Sets the session's default graphic font. If set, this must be prior to drawing any graphical user interface controls. | ||||||||||||||||||||||||||||||||||
The value$ indicates the current font specification. See 'FONT' mnemonic for specification. If the numeric font size specified in value$ is negative, then it provides the logical font height, not the point size. | |||||||||||||||||||||||||||||||||||
Colour Index | |||||||||||||||||||||||||||||||||||
Colornnn |
Sets color number nnn. | ||||||||||||||||||||||||||||||||||
While the colour index allows numbers 0 - 254, the first 16 are predefined by the system (0 - 15). The remaining colours must be assigned in order without skipping (i.e. Colour16 then Colour17 then Colour18, etc.). The value$ assigned may be any RGB code (RGB: n n n where n = 0 - 255); e.g. A null " ", either removes the assigned number from the table or resets it to the default colour (as predefined by PxPlus). Example:
Note: | |||||||||||||||||||||||||||||||||||
General Windows/System-Wide Options | |||||||||||||||||||||||||||||||||||
4D_ML_Adjust ¹ |
Setting this option to a non-zero numeric value overrides the standard Multi-Line height adjustment to the value specified (in pixels). Setting the value to "0" restores the standard adjustment. | ||||||||||||||||||||||||||||||||||
AlwaysOnTop ¹ |
This option is used to control locking the current window on top of all other windows. If value$ is set to "1", then the window is locked on top; else if "0", then the window is released from being locked on top. Note: | ||||||||||||||||||||||||||||||||||
Animate ¹ |
Allows the application to animate the window generally during the transition from visible to hidden or vice-versa. Possible values are:
Note:
| ||||||||||||||||||||||||||||||||||
AutoCompleteLimit ¹ |
Sets the AutoComplete limit. Issuing PRINT 'OPTION'("AutoCompleteLimit", "nnn") or SETDEV (0) SET "AutoCompleteLimit" TO "nnn" can be used to set the AutoComplete limit. | ||||||||||||||||||||||||||||||||||
Setting this option to "1" (or "Y") in conjunction with setting the 'U8' system parameter will internally convert UTF-8 data to its corresponding single byte character based on the current text plane character set to allow for its display. This conversion will be done on any standard PRINT to the text plane and on all user input of extended characters (e.g. accented characters, high-order ASCII, etc.). Where there is no corresponding single byte character for a UTF-8 code, a ? (question mark) will be output. If the 'U8' system parameter is not set, this option is ignored. (added in PxPlus 2014) | |||||||||||||||||||||||||||||||||||
This option is used to set automatic spell checking for Multi-Line controls. Possible values are:
(added in PxPlus 2019) | |||||||||||||||||||||||||||||||||||
Controls the rate at which data will blink on a graphical device. The value provided defines the rate at which the data appears or disappears in terms of milliseconds (i.e. "500" indicated 500ms or 1/2 a second). A rate of "0" terminates blinking. Default rate is "500" milliseconds. (added in PxPlus v8.11, build 9182) | |||||||||||||||||||||||||||||||||||
Setting this option to "1", "Y" or "y" causes the browser developer console to display in a popup window for any subsequently created *BROWSER controls. The browser developer console makes it possible to examine the code and properties of the Web page loaded by the *BROWSER control and debug any errors. (added in PxPlus 2021) | |||||||||||||||||||||||||||||||||||
Defines the language code that controls the embedded Chromium browser language. See Language Codes for a list of supported languages and codes. The value of BrowserLang is only read the first time per process that an embedded Chromium browser is created. This will override the BrowserLang INI setting. Defaults to user OS language unless BrowserLang was set in the INI file. See INI Contents. (added in PxPlus 2019) | |||||||||||||||||||||||||||||||||||
Controls the SAVE CONTROL output. If set to "1", only the client area (interior) of a window/control will be saved; otherwise, the border and caption for the window/control will be included in the output. Default setting is Off ("0"). (added in PxPlus v11.50) | |||||||||||||||||||||||||||||||||||
(Windows Only) Defines the pathname to the image used to create Check Boxes on the screen. See Customizing Radio Buttons and Check Boxes. (added in PxPlus 2017) | |||||||||||||||||||||||||||||||||||
(Windows Only) If not set, the default size of the Check Box image is based on the height of one line. If set, the size of the Check Box image will be based on the value of CbxMarkSize (in pixels) or the height of the Check Box control, whichever is smaller. Example: See Customizing Radio Buttons and Check Boxes. (added in PxPlus 2017) | |||||||||||||||||||||||||||||||||||
CenterWdw ¹ |
Center the current window (DIALOGUE) on screen. This mnemonic takes into account multiple monitors and places the window in the center of the nearest monitor currently displaying the window. | ||||||||||||||||||||||||||||||||||
Setting this option controls the colors that are used for displaying a selected line in a list box/list view. | |||||||||||||||||||||||||||||||||||
This option controls the system built-in text Copy functionality. When set to "1" or "YES" and the text being copied consists of only one line, no trailing line feed will be appended to the text. In all cases, copying multiple lines of text will append a trailing line feed. (added in PxPlus 2021 Update 1) | |||||||||||||||||||||||||||||||||||
DeleteOnClose |
Setting this option to "1" will cause the system to attempt to delete the associated file when closed. (added in PxPlus 2014) | ||||||||||||||||||||||||||||||||||
Controls the double buffering of screen updates on Windows. If set to "1", screen updates are first done off-screen then copied on-screen in a single update thereby reducing flickering. Default setting is Off (0). Affects current window only. Set this option after a window is created for each window on which you want double buffering to apply. (added in PxPlus v10) | |||||||||||||||||||||||||||||||||||
Flash ¹ |
Controls flashing of the frame for the current window and the task bar.
(added in PxPlus v8.11, build 9182) | ||||||||||||||||||||||||||||||||||
Frame ¹ |
This option is used to control the type of frame/border for the current window. Possible values are:
(added in PxPlus v7.00, build 9163.1) | ||||||||||||||||||||||||||||||||||
This option is used to control the display of images on disabled buttons. If set to Off ("0" or "N"), the images on disabled buttons will display only as shadows. This means that only the shadow left by the outline of the image will be seen. If set to On ("1" or "Y"), the images on disabled buttons will be converted to gray scale. Default setting is "0" or "N" (image displays as a shadow). Example:
(added in PxPlus 2017) | |||||||||||||||||||||||||||||||||||
Note:
| |||||||||||||||||||||||||||||||||||
This option is used to set the behavior of the Enter key and the Up/Down arrow keys when editing a Grid cell with lines of Multi-Line text. When set to "1" (Default), pressing Enter or Ctrl - Enter creates a new line, and the Up/Down arrow keys are used to move up/down between the lines of text in the cell. If set to "0", pressing Ctrl - Enter creates a new line, the Enter key enters/exits the cell, and the Up/Down arrow keys are used to move to other cells. (added in PxPlus 2019) | |||||||||||||||||||||||||||||||||||
HideTips ¹ |
This option is used to control the display of Floating tips in the system. When set to "1", tips will not be displayed. Setting it to a null value or "0" (Default) enables tips. | ||||||||||||||||||||||||||||||||||
HoverCtl ¹ |
This option is used to define a CTL value that the system will generate when the mouse hovers over the text plane in the current windows. Passing a null value or "0" disables this option. | ||||||||||||||||||||||||||||||||||
Invalid_Bmp ¹ |
This option is used to set the name of a Bitmap/Image file to be used whenever the selected Bitmap is not available for display. Use this option to avoid missing images from your application. (added in PxPlus v7.00, build 9163.1) | ||||||||||||||||||||||||||||||||||
Keyboard ¹ |
This option can be sent to channel 0 on a Windows (or WindX) session to change the current keyboard language. (added in PxPlus v8.11, build 9182) | ||||||||||||||||||||||||||||||||||
Setting this option will change the file creation, modified, and last access time based on the value provided in the following format: YYYY-MM-DD hh:mm:ss The date/time returned has be converted to local time on the system thus for files on a shared server the value may differ based on the current time zone. (added in PxPlus v10.10) | |||||||||||||||||||||||||||||||||||
When this option is set ("1" or "Y"), Multi_Line input fields that are both locked and disabled will display as locked (as opposed to disabled). (added in PxPlus 2023 Update 1) | |||||||||||||||||||||||||||||||||||
This option is used to set the system log file and can be used to override the setting in the INI file. The pathname can include %Y, %M and/or %D, which will each be replaced by the current year, month and day respectively (2 digits). When defining the log file, you can specify the maximum file size (in megabytes) that you want the log file to grow. See PxPlus Log File. (added in PxPlus v10) | |||||||||||||||||||||||||||||||||||
Sets the colour to be considered completely transparent within the current window. Note that clicking the mouse on a fully transparent section of the window passes the mouse click to the window below. Setting this value along with removing the window frame is used to create windows of different shapes. (added in PxPlus v7.00, build 9163.1) | |||||||||||||||||||||||||||||||||||
This option is used to set the height (in pixels expressed as a string) for the message/status bar at the bottom of the window. | |||||||||||||||||||||||||||||||||||
Setting this option to "1" (Default) enables an automatic adjustment of the size/position of overlapping Multi-Line controls. When enabled, the system will adjust Multi-Lines so that neither the field nor its border overlaps any adjacent Multi-Line. | |||||||||||||||||||||||||||||||||||
MouseWheel ¹ |
This option is used to adjust the MouseWheel increment value. This is the count of logical Up/Down arrow keys that the system will emulate when the wheel is used. | ||||||||||||||||||||||||||||||||||
Msg_Is_Tip ¹ |
This option tells the system that when the mouse hovers over a control, the MSG= value should be used as a TIP when no TIP is assigned. This avoids having to set both the TIP and MSG properties for all the controls. (added in PxPlus v7.00, build 9163.1) | ||||||||||||||||||||||||||||||||||
PasteFilter |
This option sets the PasteFilter property for Multi-Line controls. Possible values are:
Defaults to "YES" except for Multi-Lines that are >1 line high and accept multiple lines of input, which default to "NO". (added in PxPlus 2020 Update 1) | ||||||||||||||||||||||||||||||||||
(Windows Only) Defines the pathname to the image used to create Radio Buttons on the screen. See Customizing Radio Buttons and Check Boxes. (added in PxPlus 2017) | |||||||||||||||||||||||||||||||||||
(Windows Only) If not set, the default size of the Radio Button image is based on the height of one line. If set, the size of the Radio Button image will be based on the value of RbtMarkSize (in pixels) or the height of the Radio Button control, whichever is smaller. Example: See Customizing Radio Buttons and Check Boxes. (added in PxPlus 2017) | |||||||||||||||||||||||||||||||||||
Sets or changes the current resource library/libraries. As of PxPlus V11, the resource library value may contain multiple semi-colon (or comma) separated file names up to a maximum of 10. | |||||||||||||||||||||||||||||||||||
This option enables right mouse click Copy/Paste functionality whenever focus is on the window and not on a control. It is primarily used when running older Text mode applications and provides the ability to copy/paste text from the screen much like a terminal emulator. The value can be set "1" to enable the option or "0" (Default) to disable it. Its setting will be automatically cascaded to subsequent windows. (added in PxPlus v8.11, build 9182) | |||||||||||||||||||||||||||||||||||
Save_Msg_Bfr ¹ |
This option is used to control the return of error messages generated by a SAVE command. If initially set to non-blank (by the SETDEV directive or 'OPTION' mnemonic) and a SAVE command is issued, this value will return a list of errors that occurred during the SAVE function. | ||||||||||||||||||||||||||||||||||
Setting this option causes a specified CTL value to be generated when the caption on the current window is changed. Any numeric value may be used as the CTL value, but -1109 is reserved by NOMADS. The setting applies only to the current window. Setting the item to null will turn this option off. (added in PxPlus 2017) | |||||||||||||||||||||||||||||||||||
SortImageList |
This option controls the sorting of all 'IMAGE' graphics groups by name. This sort order is used by the NOMADS Panel Designer to determine the order in which the graphics are drawn on a window. When set to "1", the 'IMAGE' groups are sorted and drawn in alphabetical order by name on the current window. When a new 'IMAGE' group is created, it is inserted into the list of 'IMAGE' groups alphabetically. When set to "0" (Default), the 'IMAGE' groups are drawn in the order they are created with the default group first followed by all subsequent groups in the order they were created. (added in PxPlus 2014.01 Update 0005) | ||||||||||||||||||||||||||||||||||
Sets the default 'HideButtons property for all subsequent grids. (added in PxPlus 2020) | |||||||||||||||||||||||||||||||||||
This option defines the image to use in the query/lookup buttons of a grid. The value of the setting is an image pathname or internal image (!xxxxxx). An invalid value will result in the original ellipsis (...) being used. This value is only referenced when a grid is first created; therefore, changing the value will not affect any grid already in existence. (added in PxPlus 2021) | |||||||||||||||||||||||||||||||||||
StdSortOrder ¹ |
The value provided defines the default column sort settings used by the List_Box (Report View) and Grid. Possible values are:
(added in PxPlus v11.00 and upgraded to a string value in PxPlus v11.50) | ||||||||||||||||||||||||||||||||||
Sets the file 'FF' suppression settings to one of the following values:
Note:
| |||||||||||||||||||||||||||||||||||
SysMenu# |
This option can be used to add a menu item to the system drop-down menu, which displays when clicking the icon in the upper left corner of the PxPlus launch window or when using Alt + Spacebar. The contents of value$ would be "SysMenu#" where # can be a range between 1 to 10, followed by "Menu Text=###" for displaying the text for the menu item. The "Menu Text" can contain an & (ampersand) preceding any character to be used as a "hot key" to select the menu item when the menu is displayed. When the menu item is selected, the CTL value specified by ### will be generated. To set a Menu #2, you would issue: To remove an item from the menu, set the item to null: PRINT 'OPTION'("SysMenu2","") Examples: If no number is specified (i.e. "SysMenu"), the system will set the first unused slot in the system menu. To retrieve the value, use the FIN( ) function. (added in PxPlus 2016) | ||||||||||||||||||||||||||||||||||
Setting this option n channel 0 changes the current font attributes of the tip window. | |||||||||||||||||||||||||||||||||||
Defines the length of time (in tenths of a second) that a tip will be displayed. (added in PxPlus v8.30) | |||||||||||||||||||||||||||||||||||
ToolBar ¹ |
This option is used to set the height (in pixels expressed as a string) for the toolbar. | ||||||||||||||||||||||||||||||||||
Percentage transparent for the current window. A value of "0" indicates non-transparent, "100" would be completely transparent. Can only be applied to TOP level windows. | |||||||||||||||||||||||||||||||||||
UTC_MTime |
Setting this option will change the file creation, modified, and last access time based on the value in the value provided consisting of UTC in seconds since Jan 1,1970. (added in PxPlus v10.10) | ||||||||||||||||||||||||||||||||||
Utility ¹ |
This option is used to add lines to the 'Utility' command mode menu option. The contents of value$ should contain a CTL code in the range of between 3900 and 3999 followed by an = (equals sign) and then the text to display in the menu. When the menu item is selected, the CTL value specified will be sent to the system command processor (actual value will be negated). | ||||||||||||||||||||||||||||||||||
Window_NoAuto_Focus |
Setting this option to "1" will avoid window frame repaints when changing focus between concurrent windows. (added in PxPlus 2014) | ||||||||||||||||||||||||||||||||||
XYPos ¹ |
This option is used to change the position of the current window. The contents of value$ would be two comma separated numbers containing the absolute pixel address (top, left) to which to move the current window. These numbers are relative to the desktop of the workstation or the current window's parent window. The XYPos and XYPos_NoChk options are identical with the exception that XYPos validates the location (on screen and is visible), while XYPos_NoChk changes the position of the window without validating the location. Note:
| ||||||||||||||||||||||||||||||||||
XYWdw ¹ |
This option is used to change the position of the current window. The contents of value$ would be four comma separated numbers containing the absolute pixel address (top, left, bottom, and right in pixels) to move/resize the current window to. This is slightly different to XYPOS in that the information pertains to the Child windows as opposed to the outer/dialog window. (added in PxPlus v8.11, build 9182) | ||||||||||||||||||||||||||||||||||
If value$ is "1", the current window will be brought to the top of the Z-Order when input focus switches to the window. "0" indicates that the Z-Order of the window will not be changed when focus switches to the window. (added in PxPlus v8.11, build 9182) | |||||||||||||||||||||||||||||||||||
Miscellaneous Options | |||||||||||||||||||||||||||||||||||
This option allows you to change/set the Date format to be used on the specified channel open to an ODB, MySql, OCI, DB2 or ADO database connection. If DateFmt is set to null, the system will use the format specific to the type of database being used (generally YYYY-MM-DD hh:mm:ss.hhh). Example: PRINT (channel), 'OPTION'("DATEFMT","YYYYMMDD") If used with a native file, this will result in Error #32: Invalid or redundant Input/Output option. (added in PxPlus 2023) |
¹ Indicates this option can only be used with channel 0 under Windows (or WindX)
*WINPRT* Options | |||||||||||
Orientation |
This option is used to control the orientation of the next page to be printed. The orientation of the current page cannot be changed. Possible values are "LANDSCAPE" or "PORTRAIT" (only the first letter is checked). | ||||||||||
Source |
This option controls the paper source for the next page to be printed. It will take effect on the next 'FF' mnemonic. The parameter specified must be the numeric value associated with the various paper trays for the printer. Use the FIN(nnn, "SOURCELIST") function to get a list of possible values. | ||||||||||
Secure |
Sets the current connection on TCP/IP from unsecure to secure. The option, if specified, can contain the pathname to the security certificate to use. Once a connection is set to SECURE, it cannot be set unsecured. | ||||||||||
TLS |
This option is used to force the current secure connection on TCP/IP to only use a specific TLS protocol version (if the OS supported it) as opposed to the default mode of supporting SSL v2, v3, TLS1, 1.1, 1.2 and 1.3 (negotiated with the other end). Possible values are:
Example: PRINT (chan)'OPTION'("TLS","1.2") This example would make an existing secure TCP connection force the use of TLS 1.2 protocol. (added TLS 1.3 support in PxPlus 2020) | ||||||||||
PDF Options | |||||||||||
Bookmark |
Set bookmark location, text and hierarchy. For information on bookmarks, see *PDF* - PDF Print Interface. | ||||||||||
Special Processing PDF Options | |||||||||||
This option defines a multiplication factor to be used in computing the extra vertical space (height) to be allocated to PDF fonts. Increasing this value will result in wider spacing between lines when using the font size for line spacing. This applies only to PDF files using the Haru library. (Default is 1.2.) (added in PxPlus v9.00, build 9200) | |||||||||||
(Linux Only) This option can be used to change the location of the font directory when creating PDF files using true type fonts. Important Note:
| |||||||||||
This option controls the number of thousandths of an inch to use for setting the default PDF printer margins. These will be assigned on all edges of the printed document. Default is 250 (1/4 of an inch). (added in PxPlus v9.00, build 9200) |
Debugging functionality includes the ability to add watch values, set dynamic breakpoints, initiate program tracing, as well as the ability to transfer the contents of the debug window to the Clipboard.
This can be set on the fly using the keyword$ "DebugWindow", which determines the specific functionality based on the associated value$ settings.
Example:
print 'option'("DebugWindow","Trace")
print 'option'("DebugWindow","Host Command Open")
print 'option'("DebugWindow","Watch Add x$")
print 'option'("DebugWindow","Host Break Add Program=C:\Work51\email\send_email.pvx,Statement=10,Change=SMTPSERVER$")
The available DebugWindow value$ settings for enhanced debugging functionality are described by category in the table below.
The Windows version of PxPlus also includes a debugging environment that can be accessed via the PxPlus icon drop-down menu by selecting Debugging Environment. See Windows Debugging Environment.
Break Window Specific |
Break Window is used to assign logical break points for halting execution in an application. Can be used in combination with other settings. See Multi-Use Commands. |
"Break" |
Activate Break window. |
Command Window Specific |
Command Window is used to handle all console commands without disrupting your standard screen display. Can be used in combination with other settings. See Multi-Use Commands. |
"Command" |
Activate Command mode window. |
"Halt" |
Simulate a Command window halt (stop program). |
"Step" |
Simulate a Command mode window step. |
Trace Window Specific |
Trace Window is used to trace the execution of an application. Can be used in combination with other settings. See Multi-Use Commands. |
"DebugPlus [with] [Backtrace] [Enable|Disable]" |
Enable/disable DebugPlus Backtrace option. |
"File [IO] [Operation] [Trace] [Enable|Disable]" |
Enable/disable file IO operation trace option. |
"File Opens [Enable|Disable]" |
Enable/disable trace file opens option. |
"File Opens [Failures] [Enable|Disable]" |
Enable/disable trace file open failures option. |
"[Host] Log [All] [Errors] [Enable|Disable]" |
Enable logging of errors on the host or local machine. |
"Host Trace Programs [Enable|Disable]" |
Enable/disable host trace programs option. |
"Show [Property] [GET] [Enable|Disable]" |
Enable/disable show property GET option. |
"Show [Property] [SET] [Enable|Disable]" |
Enable/disable show property SET option. |
"Size=1k" |
Set 1K program trace size. |
"Size=2k" |
Set 2K program trace size. |
"Size=8k" |
Set 8K program trace size. |
"Size=16k" |
Set 16K program trace size. |
"Size=32k" |
Set 32K program trace size. |
"Suppress [Program [Trace [Enable|Disable]]]" |
Enable/disable suppress program trace option. |
"Trace" |
Activate Trace window. |
Watch Window Specific |
Watch Window allows you to constantly monitor variables and/or expressions during program execution. Can be used in combination with other settings. See Multi-Use Commands. |
"Size=0" |
Select the no-data-break option. |
"Size=50" |
Select the 50-byte-data-break option. |
"Size=100" |
Select the 100-byte-data-break option. |
"Size=no" |
Select the No-data-break option. |
"Watch" |
Activate Watch Window. |
| |
"Host [Break|Trace|Watch] [Enable|Disable]" |
Enable/disable host trace option. |
"[Host] [Break|Watch] Add "String to Add" |
Add a (pre-formatted) item to the Break|Watch window. |
When using the following commands, if the Debug window type is not specified, then the last window used will be utilized: | |
"[Host] [Break|Command|Trace|Watch] Close" |
Close window option. |
"[Host] [Break|Command|Trace|Watch] Disable" |
Disable window without closing. |
"[Host] [Break|Trace|Watch] Clear" |
Clear window contents. |
"[Host] [Break|Trace|Watch] Copy" |
Copy window contents to the Clipboard. |
Miscellaneous Debug Options |
|
PRINT 'OPTION'("Logfile", filename$) |
(Windows Only) Allows setting the Log File name on the fly. |
PRINT 'OPTION'("TraceWdwToLogfile", "0"|"1") |
Copies all information written to the Trace window to the filename$ specified by the "Logfile" setting. "1" enables the functionality and "0" disables it. |