Syntax

Example

Description/Remarks

GVID_SHOW title, button text, style, x location, y location, width, height

GVID_SHOW " CMM Gages", "Take Readings", 0, -1, -1, -1, -1

In this case we are showing the gage dialog with all the default values. The software will decide where to place the dialog and how big to make it. Once the button is hit, the button text changes to ‘close’ and the dialog remains until the close button is hit.

See Gage Visual Display for a sample template showing how the Gage Visual Display commands work together.

Returns a number, 1if successful, 0 if not.

This command displays the dialog of all initialized columns.

You can specify the text to display at the top of the window as well as the caption on the ‘OK’ button used to take the readings.

The style default is zero. Setting the style parameter to 1 causes the close button [x] in the upper right hand corner of the dialog to be ignored, so the dialog cannot be exited.

Setting the style parameter to 2 hides the ‘OK’ button and assumes the template will execute a GVID_CLOSE command later in the template.

Setting the style parameter to 4 normalizes the data based on the targets, as opposed to the default of being normalized on the specs. Normalizing on the target, fixes the target while the specs float. Using the default and normalizing on the specs, causes the specs to be fixed and the targets to float.

Setting the style parameter to 8 causes the dialog to wait 15 seconds or until the user hits the button again before going away. This allows the user to verify the values when the button was hit.

Setting the style parameter to 16, causes the dialog to go away immediately when the button is hit.

Setting the style parameter to 32 changes the background color to the "alternate color". The default "alternate color" is white.

The settings may be combined, e.g. set to 15 to change all defaults (1 + 2 + 4 + 8)

The settings 8 and 16 are exclusive and cannot be combined. 

The X and Y locations refer to the upper left hand corner of the dialog. If either is set to –1, we determine the values.

The width and height determine the size of the dialog. If either is set to –1, we determine the values. If either is set to 0, the dialog will be maximized.

This command may be called at any time after a column has been initialized, even if the dialog is already showing.

The Gage Visual Display window will automatically be minimized when the data entry session is minimized, when the user clicks the Notes button to enter a note, and when the real-time failure note or message is displayed.