char *cvxMsgPtr ( int idFile, /* I: message file id (see cvxMsgFileLoad()) */ int MessageNum /* I: message number within message file */ ) /* DESCRIPTION: Returns a pointer to a static memory area containing the text of the message identified by "idFile" and "MessageNum". */ ________________________________________________________________________________ evxColor cvxColorNear ( const svxColor* rgb /* I: RGB components of a color to match to a standard color or an index color*/ ) /* DESCRIPTION: This function returns the color defined by evxColor type that is the nearest match to the input RGB components. The return value is never VX_COLOR_NULL or VX_COLOR_RGB. See cvxColorRGB for a function that outputs RGB components when given a standard color's evxColor value. */ ________________________________________________________________________________ int cvxColorRGB ( evxColor color, /* I: one of the evxColor values for a standard color or an index color */ svxColor* rgb /* O: RGB components for the input color */ ) /* DESCRIPTION: Output the RGB components of a standard color or an index color. Returns 0 if the input is an unambiguous color, as defined by the evxColor type. Returns 1 if the input is not a valid evxColor value or is ambiguous (VX_COLOR_NULL or VX_COLOR_RGB). The output will be black if 1 is returned. See cvxColorNear for a function that finds the evxColor value of the nearest standard color when given a color's RGB components. */ ________________________________________________________________________________ void cvxColorToColorf ( const svxColor* rgb, /* I: input color (each component defined over 0 to 255) */ svxColorf* rgbf /* O: output color (each float component defined over 0.0 to 1.0) */ ) /* DESCRIPTION: This function copies the input svxColor structure, in which the color component values are defined over 0 to 255, to the output svxColorf structure, where the color components are floating point values defined over 0.0 to 1.0. See cvxColorfToColor to copy svxColorf to svxColor. */ ________________________________________________________________________________ void cvxColorfToColor ( const svxColorf* rgbf, /* I: input color (each float component defined over 0.0 to 1.0) */ svxColor* rgb /* O: output color (each component defined over 0 to 255) */ ) /* DESCRIPTION: This function copies the input svxColorf structure, in which the color components are floating point values defined over 0.0 to 1.0, to the output svxColor structure, where the color component values are defined over 0 to 255. See cvxColorToColorf to copy svxColor to svxColorf. */ ________________________________________________________________________________ void cvxCursorRestore(void) /* DESCRIPTION: Restores the cursor type that was active prior to the last call to cvxCursorSet. */ ________________________________________________________________________________ void cvxCursorSet ( evxCursorType Type /* I: cursor type */ ) /* DESCRIPTION: Changes the active mouse cursor to the specified type. A call to this function should always be paired with a subsequent callto cvxCursorRestore(). */ ________________________________________________________________________________ void cvxErrDisable (void) /* DESCRIPTION: Disable display of error messages in the ZW3D message area. The application that uses this function is ALWAYS responsible for re-enabling error message display using cvxErrEnable(). */ ________________________________________________________________________________ void cvxErrEnable (void) /* DESCRIPTION: Re-enable display of error messages in the ZW3D message area. */ ________________________________________________________________________________ int cvxEscCheck(void) /* DESCRIPTION: When escape checking has been enabled using cvxEscStart(), this function returns a non-zero value if the user has pressed thekey or other menu item that generates and "Escape" event with the intention of terminating execution of the active command. If no "Escape" event has been triggered by the user, this function returns 0. */ ________________________________________________________________________________ void cvxEscDisable ( int *EscapeState /* O: current escape checking state */ ) /* DESCRIPTION: Disables checking for "Escape" events overriding cvxEscStart(). This function MUST ALWAYS be paired with a subsequent call to cvxEscRestore(). The "integer" value output by this function (EscapeState) must be passed to the corresponding call to cvxEscRestore(). */ ________________________________________________________________________________ void cvxEscEnd(void) /* DESCRIPTION: This function is used to end "Escape" checking after it has been previously initialized with CdEscStart(). Calls to CdEscStart() MUST ALWAYS be paired with a call to CdEscEnd(). */ ________________________________________________________________________________ void cvxEscRestore ( int EscapeState /* I: original escape checking state */ ) /* DESCRIPTION: Re-enables checking for "Escape" events after cvxEscDisable() has been called. "EscapeState" should be the value output by a previous call to cvxEscDisable(). This function MUST ALWAYS be paired with a prior call to cvxEscDisable(). */ ________________________________________________________________________________ void cvxEscStart(void) /* DESCRIPTION: This function is used to start "Escape" checking, whereby execution of a command is aborted if the user presses the button or other menu item that generates an "Escape" event. This presumes that the currently executing code is calling cvxEscCheck() periodically to allow escape events to be processed. THE CALLING PROCEDURE MUST PAIR A CALL TO cvxEscStart() WITH A SUBSEQUENT CALL TO cvxEscEnd(). You should put escape checking in a callback function or other code that could take a long time to execute, but that you want to abort if the user tries to initiate a new input or action through the user interface. Put cvxEscStart() at the beginning of your function and cvxEscEnd() at the end. Add calls to cvxEscCheck() between cvxEscStart() and cvxEscEnd(). If a call to cvxEscCheck() returns a non-zero value, clean up whatever your function has started (including all dynamically allocated memory), call cvxEscEnd() and exit your function. */ ________________________________________________________________________________ int cvxGetAngle ( char *Prompt, /* I: text prompt */ double *Angle /* O: angle (deg) */ ) /* DESCRIPTION: Gets angle input from the user, using the specified prompt. Returns 1 if error or user-escape, else 0. */ ________________________________________________________________________________ int cvxGetDistance ( char *Prompt, /* I: text prompt */ double *Distance /* O: distance (mm) */ ) /* DESCRIPTION: Gets distance input from the user, using the specified prompt. Returns 1 if error or user-escape, else 0. */ ________________________________________________________________________________ int cvxGetEnt ( char *Prompt, /* I: text prompt */ evxEntInpOpt Opt, /* I: entity input option */ int EmptyOk, /* I: 1 if without input is okay; else 0 */ int *idEntity /* O: entity id (0 if undefined) */ ) /* DESCRIPTION: Displays the specified "Prompt" and waits for the user to pick an entity whose id is output via "idEntity". Returns 1 if error or user-escape. Otherwise, returns 0. */ ________________________________________________________________________________ int cvxGetEntPath ( char *Prompt, /* I: text prompt */ evxEntInpOpt Opt, /* I: entity input option */ int EmptyOk, /* I: 1 if without input is okay; else 0 */ svxEntPath *Path /* O: entity path */ ) /* DESCRIPTION: Displays the specified "Prompt" and waits for the user to pick an entity whose path is output via "Path". Returns 1 if error or user-escape. Otherwise, returns 0. */ ________________________________________________________________________________ int cvxGetEntPaths ( char *Prompt, /* I: text prompt */ evxEntInpOpt Opt, /* I: entity input option */ int EmptyOk, /* I: 1 if without input is okay; else 0 */ int *Count, /* O: number of entity picks */ svxEntPath **Paths /* O: list of entity path */ ) /* DESCRIPTION: Displays the specified "Prompt" and waits for the user to pick a list of entities, which is output via "Paths". The calling procedure is responsible for deallocating the entity path list. Returns 1 if error or user-escape. Otherwise, returns 0. */ ________________________________________________________________________________ int cvxGetEnts ( char *Prompt, /* I: text prompt */ evxEntInpOpt Opt, /* I: entity input option */ int EmptyOk, /* I: 1 if without input is okay; else 0 */ int *Count, /* O: number of entity picks */ int **idEnts /* O: list of entity id's */ ) /* DESCRIPTION: Displays the specified "Prompt" and waits for the user to pick a list of entities, which is output via "idEnts". The calling procedure is responsible for deallocating the entity list. Returns 1 if error or user-escape. Otherwise, returns 0. */ ________________________________________________________________________________ int cvxGetExternalPick ( const char *Prompt, /* I: text prompt */ evxPntInpOpt Opt, /* I: point input option */ int EmptyOk, /* I: 1 if without input is okay; else 0 */ svxPoint *Point, /* O: point defined in the local space of its parent entity */ svxEntPath *EntPath,/* O: entity pick-path (Entity->Count=0 if undefined) */ svxMatrix *Matrix /* O: transform that maps point from local space to space of active target */ ) /* DESCRIPTION: Displays the specified "prompt" and waits for the user to select a point based on the input option (evxPntInpOpt). This function is especially designed to manage the selection of points on entities that lie outside of the active target object, such as a point on a face of an assembly component. Your objective may be to get the coordinates of a point that lies external to the active object (e.g. part), the pick-path of an external entity (e.g. an assembly face), or both. The selected point's coordinates are output in the local space of the point's parent entity. "Matrix" may be used to transform the point (and entity) coordinates from their local space to the space of the target object that was active at the time the point was selected (see cvxPntTransform(), cvxCrvTransform()and cvxSrfTransform()). If the point was selected by snapping to an entity, the pick-path of the entity is output via "EntPath". A pick-path defines the sequence of object references (i.e. nested assembly components) that locate the entity relative to the active target object. A pick-path could lead to an entity that lies in a different file or object than the active file/object. API functions for querying entities generally require that an entity's parent file and object(i.e. part, sketch, plan, drawing) be active. If you want to query information about an entity, such as its geometry, use cvxEntPathActivate() to activate the entity's parent file and object, and to get the entity's id. Query the geometry and, if desired, transform it into the space of the original target object using "Matrix". When you are done querying the geometry, restore the original target file and object with cvxEntPathActivate(). This function returns 1 if there is an error or the user presses escape. Otherwise, it returns 0. */ ________________________________________________________________________________ void cvxGetFile ( int Open, /* I: 1 to open files, 0 to save files */ char *Prompt, /* I: null-terminated text prompt */ char *Default, /* I: default directory (null-terminated string) */ char *Filter, /* I: file filter (null-terminated string) */ char *Path /* O: user-selected file path */ ) /* DESCRIPTION: Displays the file browser with the specified "Prompt" and initialized to the "Default" folder. The browser will display the files specified by "Filter", which is a string like the following examples: Show all files: "All Files (*.*)|*.*|" Show DXF and DWG files: "DWG File (*.dwg)|*.dwg|DXF File (*.dxf)|*.dxf|" If "Open = 1", the file browser will come up in the configuration used to select a file to be opened. If "Open = 0", the file browser will come up in the configuration used to specify a file to be saved. If the file already exists, the user will be asked whether he wants to overwrite it. The path of the file selected by the user is output via the string variable "Path". If there is an error, or the user presses cancel, an empty string is output. It is assumed that "Path" references sufficient memory to hold the output path (max = 512 bytes). To initialize the file browser to both a default directory and file selection, input "Default" as the desired directory, followed by a comma, followed by the desired file name. See also the cvxGetFileActiveField function. */ ________________________________________________________________________________ void cvxGetFileActiveField ( int Open, /* I: 1 to open files, 0 to save files */ const char *Prompt, /* I: null-terminated text prompt */ const char *Default, /* I: default directory (null-terminated string) */ const char *Filter /* I: file filter (null-terminated string) */ ) /* DESCRIPTION: Similar to cvxGetFile, this function is intended for use when a form is open and a string field is active. The file browser is initialized using the parent folder of the file path from the active field. If the active field is empty, the file browser is initialized using the "Default" folder string. The specified "Prompt" is shown to the user when the file browser opens, and the browser displays the files specified by "Filter". Refer to cvxGetFile for more information about the syntax of the "Filter" string. When the user closes the file browser, the path to the file selected by the user is sent to the active field. If the user cancels the browser, or if an error occurs, the active field is not changed. If "Open = 1", the file browser will be configured to select a file to be opened. If "Open = 0", the file browser will be configured to select or name a file to be saved. If the file already exists, the user will be asked to confirm that the file is to be replaced. A default will be provided if the "Prompt", "Default" or "Filter" argument is NULL. When "Open" is 1, the default filter allows any file to be selected, but when "Open" is 0 the caller should always provide the filter, although this function will use a default in this case, too, if necessary guessing at the type of file to be saved. When saving ("Open" is 0), the file browser can be configured to show a default folder and also pre-select a specified file. Do this by assigning the path to the desired folder to "Default", followed by a comma, followed by the desired file name. Unlike the cvxGetFile function, this function does not allow multiple selections. Only a single file selection is sent to the active field when the user closes the file browser. This function is particularly helpful for implementing command functions that automatically display the file browser when the user activates a string input field. For example, a function that displays the file browser to open a text file might look like this: void TextFileCB(void) { cvxGetFileActiveField(1,"Select a text file",NULL, "Text Files|*.txt|All Files|*.*|"); } and after installing a symbol with the same name as the function, using the cvxCmdFunc function, it can be referenced in the string field's options property by preceding the symbol name with a tilde character: ~TextFileCb, See also the cvxGetFile function. */ ________________________________________________________________________________ void cvxGetFolder ( char *Prompt, /* I: prompt displayed on directory browser title bar */ char *Default, /* I: default folder (null-terminated string) */ char *Path /* O: path of selected folder (outputs NULL pointer if "Cancel" is selected) */ ) /* DESCRIPTION: Displays a dialogue for browsing and selecting a file folder. This function grabs all events and does not return until "OK" or "Cancel" is selected. The path of the folder selected by the user is output via the string variable "Path". If there is an error, or the user presses cancel, an empty string is output. It is assumed that "Path" references sufficient memory to hold the output path (max = 512 bytes). See also the cvxGetFolderActiveField function. */ ________________________________________________________________________________ void cvxGetFolderActiveField ( const char *Prompt, /* I: prompt displayed on folder browser title bar */ const char *Default /* I: default folder (null-terminated string) */ ) /* DESCRIPTION: Similar to cvxGetFolder, this function is intended for use when a form is open and a string field is active. The folder browser is initialized using the path found in the active field. If the active field is empty, the folder browser is initialized using the "Default" folder string. The specified "Prompt" is shown to the user when the folder browser opens. When the user closes the folder browser, the path to the folder selected by the user is sent to the active field. If the user cancels the browser, or if an error occurs, the active field is not changed. If the "Prompt" or "Default" argument is NULL, a default will be provided. This function is particularly helpful for implementing command functions that automatically display the folder browser when the user activates a string input field. For example, a function that displays the browser for selecting an output folder might look like this: void OutputDirCB(void) { cvxGetFolderActiveField("Select output folder",NULL); } and after installing a symbol with the same name as the function, using the cvxCmdFunc function, it can be referenced in the string field's options property by preceding the symbol name with a tilde character: ~OutputDirCb, See also the cvxGetFolder function. */ ________________________________________________________________________________ int cvxGetNumber ( char *Prompt, /* I: text prompt */ double *Number /* O: number (dimensionless) */ ) /* DESCRIPTION: Gets numeric input from the user, using the specified prompt. Returns 1 if error or user-escape, else 0. */ ________________________________________________________________________________ int cvxGetPoint ( const char *Prompt, /* I: text prompt */ evxPntInpOpt Opt, /* I: point input option */ int EmptyOk, /* I: 1 if without input is okay; else 0 */ svxPoint *Point, /* O: point input */ int *idEntity /* O: entity id (input NULL to ignore) */ ) /* DESCRIPTION: Displays the specified "prompt" and waits for the user to input a point, which is output via "Point". If the user used a "point-on-entity" option, the entity index is output via "idEntity". Returns 1 if error or user-escape. Otherwise, returns 0. */ ________________________________________________________________________________ int cvxGetPoints ( char *Prompt, /* I: text prompt */ evxPntInpOpt Opt, /* I: point input option */ int EmptyOk, /* I: 1 if without input is okay; else 0 */ int *Count, /* O: number of point picks */ svxPoint **Points /* O: list of points */ ) /* DESCRIPTION: Displays the specified "Prompt" and waits for the user to input a list of points, which is output via "Points". The calling procedure is responsible for deallocating the point list. Returns 1 if error or user-escape. Otherwise, returns 0. */ ________________________________________________________________________________ int cvxGetResponse ( int Option, /* I: see "DESCRIPTION" */ char *Message /* I: null-terminated text message */ ) /* DESCRIPTION: Displays the input message string in a GUI window and waits for a user response based on "Option". Occurrences of the "@" character in the message string will be replaced with a newline character. A numeric value indicating the user's response is returned. Valid options and corresponding return values are shown below: Option=1: Display "Continue". Return 1 when the user selects "Continue". Option=2: Display "Yes" and "No". Return 1 for "Yes", 0 for "No". Option=3: Display "Yes", "No" and "Cancel". Return 1 for "Yes", 0 for "No" and -1 for "Cancel". Option=4: Display "Yes", "Yes All", "No" and "Cancel". Return 1 for "Yes", 2 for "Yes All", 0 for "No" and -1 for "Cancel". */ ________________________________________________________________________________ int cvxGetString ( const char *Prompt, /* I: null-terminated text prompt */ const char *Default, /* I: default input string (or empty string) */ int NumBytes, /* I: no. bytes of storage referenced by "String" */ char *String /* O: user input text string */ ) /* DESCRIPTION: Gets string input from the user. The string input is placed in the memory referenced by "String". If necessary, the input string is truncated to fit the memory. Returns 0 if user pressed "Cancel" or did not input a string. Otherwise, returns 1. */ ________________________________________________________________________________ int cvxGetViewRect ( int includeFrame, /*I: 1=include window frame; 0=exclude window frame; */ int isGlobal, /*I: 1=get global coordinates; 0=get client coordinates; */ int* tlX, /*O: top left X */ int* tlY, /*O: top left Y */ int* brX, /*O: bottom right X */ int* brY /*O: bottom right Y */ ) /* DESCRIPTION: Get the global or client coordinates of active View. Returns 1 if function fails; 0 if it succeeds. */ ________________________________________________________________________________ void cvxMenuItemState ( vxName Menu, /* I: menu or toolbar name */ int Item, /* I: menu item (numbered from 1) */ int State /* I: 0=disabled, 1=enabled */ ) /* DESCRIPTION: Enable or disable the specified item (i.e. button or icon) of the specified ZW3D menu or toolbar. */ ________________________________________________________________________________ int cvxMessageBox ( int MsgType, /* I: Message box type */ int WndMode, /* I: 0 = modeless, 1 = full application modal */ const char* Title, /* I: Window title; set to NULL if not applicable */ const char* Message, /* I: Message string */ const char* Btn1Str, /* I: Button1 string; set to NULL if not applicable */ const char* Btn2Str, /* I: Button2 string; set to NULL if not applicable */ int* Action /* O: Action */ ) /* DESCRIPTION: Function to display message window. A message window is used for common interaction tasks, which include giving information, asking questions, and reporting errors. Valid MsgType is shown below: MsgType=1: An error window warns users of action consequences and gives them a choice of resolutions. MsgType=2: An information window gives the user information, such as the status of an action. MsgType=3: A message window is used for common interaction tasks. MsgType=4: A Question window is used to get the answer to a question from the user. MsgType=5: A warning window warns users of action consequences and gives them a choice of resolutions. MsgType=6: A working window informs users that there is atime-consuming operation in progress and allows them to cancel the operation. Returns 1 if error. Otherwise, returns 0. */ ________________________________________________________________________________ void cvxMsgAreaClose(void) /* DESCRIPTION: Closes the ZW3D message area. */ ________________________________________________________________________________ void cvxMsgAreaOpen(void) /* DESCRIPTION: Opens the ZW3D message area. */ ________________________________________________________________________________ void cvxMsgAreaState(int Disable) /* DESCRIPTION: Calling this function with "Disable=1" prevents the message window from automatically opening. Calling the function again with "Disable=0" re-enables the normal operation of the message window. This function MUST always be called in pairs -- the first call with "Disable=1" and the second call with "Disable=0". */ ________________________________________________________________________________ void cvxMsgDisable (void) /* DESCRIPTION: Disable display of general messages in the ZW3D message area. The application that uses this function is ALWAYS responsible for re-enabling general message display using cvxMsgEnable(). Use cvxErrDisable() to disable display of error messages. Use cvxPromptDisable() to disable display of command prompts. */ ________________________________________________________________________________ void cvxMsgDisp ( char *Text /* I: text string */ ) /* DESCRIPTION: Displays the specified text in the ZW3D message area. */ ________________________________________________________________________________ void cvxMsgDisp2 ( char *Text, /* I: text string */ int level /* I: message level (0-6) */ ) /* DESCRIPTION: Displays the specified text in the output area with specified level. level: 0-information 4-alert 1-note 5-error 2-debug 6-fatal 3-warning */ ________________________________________________________________________________ void cvxMsgEnable (void) /* DESCRIPTION: Re-enable display of general messages in the ZW3D message area. */ ________________________________________________________________________________ int cvxMsgFileLoad ( vxPath File, /* I: path to message file */ int *idFile /* O: loaded message file id */ ) /* DESCRIPTION: Load the messages in the specified file (File) in memory and return an id (idFile) that identifies the file. Returns 1 if function fails; 0 if it succeeds. */ ________________________________________________________________________________ void cvxProgress ( int iprogress /* i: percent progress (0-100) */ ) /* DESCRIPTION: Invoke GUI callback function to display percent progress or to clear the progress meter if "iprogress < 0". */ ________________________________________________________________________________ void cvxPromptDisable (void) /* DESCRIPTION: Disables the display of command prompts (when it is possible). */ ________________________________________________________________________________ void cvxPromptEnable (void) /* DESCRIPTION: Re-enables display of command prompts. */ ________________________________________________________________________________ void cvxTranStatusDisable (void) /* DESCRIPTION: Disables the translator status window. Always pair a call to this function with a subsequent call to cvxTranslatorStatusEnable(). */ ________________________________________________________________________________ void cvxTranStatusEnable (void) /* DESCRIPTION: Re-enables the translator status window. A call to cvxTranslatorStatusDisable() should always be paired with a subsequent call to this function. */ ________________________________________________________________________________ int cvxUiSettingsApply ( char* Name /* I: the name of the Settings */ ) /* DESCRIPTION: Apply the specified ui settings return 0 if success and 1 otherwise */ ________________________________________________________________________________ int cvxUiSettingsCount ( void ) /* DESCRIPTION: Get the count of ui settings */ ________________________________________________________________________________ int cvxUiSettingsCreate ( char* Name, /* I: the name of the Settings */ char* Base /* I: the name of the base Settings */ ) /* DESCRIPTION: Create a new ui settings based on the given settings return 0 if success and 1 otherwise */ ________________________________________________________________________________ int cvxUiSettingsExists ( char* Name /* I: the name of the settings */ ) /* DESCRIPTION: Test the existence of ui setting by the given name return 0 if true and 1 otherwise */ ________________________________________________________________________________ int cvxUiSettingsExport ( char* Name, /* I: the name of the settings to be exported */ char* Path /* I: the path of the settings file exported */ ) /* DESCRIPTION: Export the sepcified ui settings to a given path return 0 if success and 1 otherwise */ ________________________________________________________________________________ int cvxUiSettingsFetch ( int i, /* I: the index of the settings to be fetched */ char* Name /* O: the name of the settings to be fetched */ ) /* DESCRIPTION: Get the ui settings name by the given index if the settings exists, this function returns 0. */ ________________________________________________________________________________ int cvxUiSettingsImport ( char* Path /* I: the path of the settings file to be imported */ ) /* DESCRIPTION: Import the ui settings file return 0 if success and 1 otherwise */ ________________________________________________________________________________ int cvxUiSettingsRemove ( char* Name /* I: the name of the Settings to be removed */ ) /* DESCRIPTION: Remove the specified ui settings return 0 if success and 1 otherwise */ ________________________________________________________________________________ int cvxUiSettingsRename ( char* Name, /* I: the name of the Settings to be renamed */ char* Dest /* I: the new name of the Settings */ ) /* DESCRIPTION: Rename the sepcified ui settings to the given name return 0 if success and 1 otherwise */ ________________________________________________________________________________ int cvxUiSettingsReset ( char* Name /* I: the name of the settings */ ) /* DESCRIPTION: Set the specified ui settings to its original state return 0 if success and 1 otherwise */ ________________________________________________________________________________ void cvxUserActionStatusGet ( int *disableStatus /* O: current disable status*/ ) /* DESCRIPTION: Get the value of prompt dialog status. This function must be called before cvxUserActionStatusSet(). */ ________________________________________________________________________________ void cvxUserActionStatusSet ( int disable /* i: disable or enable the prompt dialog */ ) /* DESCRIPTION: Set the status of prompt dialog. disable: 0-enable 2-disable: the default action is "Yes" 3-disable: the default action is "Yes All", if the option does not have this, it is "Yes" -1-disable: the default action is "Cancel" ,if the option does not have this, it is "No" -2-disable: the default action is "No" If the option is "Continue", as long as disable is non-zero, it will choice the action "Continue". Make sure cvxUserActionStatusGet()has been called before you call this function. After your operation finished, please called this function again to restore the status. The "integer" value (disable) should be output by cvxUserActionStatusGet(). */ ________________________________________________________________________________ int cvxUserActionStatusSet2 ( evxDialogType type, /* I: prompt window type */ int value /* I: flag value to disable or enable the prompt dialog */ ) /* DESCRIPTION: Enhanced API for disable or enable the prompt dialog, as cvxUserActionStatusSet could only set yes / no. Type: When type is VX_DIALOG_SAVE_AS, parameter value controls the prompt dialog for "Save as the file": value == 0: Prompt dialog value == 3: The default action is select "Save as new and replace original one" then push ok button, not prompt dialog value == 4: The default action is select "Save as copy and close", then push ok button, not prompt dialog value == 5: The default action is select "Save as copy and open" then push ok button, not prompt dialog value == 6: The default action is "Cancel", not prompt dialog Other values for parameter type are reserved for future usage. Return: Return old value before set. */ ________________________________________________________________________________