Overview | Statement List | Example 1 | Example 2

选择对象

Synopsis

IDENT/'message'[,SCOPE,{WORK|ASSY|REF}],obj list[,CNT,count][,CURSOR,x-coord,y-coord,z-coord][,MEMBER,{ON|OFF}],response

Description

This statement allows objects chosen by the user interactively to be placed in an object list.

IDENT works with the Back, OK, and Cancel options of Unigraphics. If Back is chosen during program execution while the IDENT statement is pending, causes the value of 1 to be assigned to the response variable. Cancel causes 2 to be assigned. OK causes 3 to be assigned.

CAUTION: We do not recommend using the asterisk character (*) in menu prompts or menu options.

Below is a list of response values assigned to the response variable:

Response

Assignment

Back

1

Cancel

2

OK

3

The IDENT statement causes the system to display Class Selection Subfunction dialog box. Also the 'message' is displayed in the cue line. For more information on the Class Selection Subfunction see theGateway Online Help.

NOTE: If the object list is a simple object variable or a single object of an object array (OBJ(1) of OBJ(10)), the class selection menu does not appear, but the crosshairs are displayed and only a single object selection is allowed.

Parameters

Parameter

Description

message

A string which represents the title of the menu you want to display. The string can contain up to 40 characters.

SCOPE

Minor word which specifies the scope of object selection. ASSY is the default.

WORK

Allows you to select only objects which belong to the work part. This includes immediate components of the work part. If you select an object occurrence, the prototype is returned.

ASSY

Allows you to select any object or object occurrence in the assembly. No scope restrictions are applied.

REF

Allows you to select objects which belong to the work part or its subassembly. If you select an object occurrence, the prototype is returned.

obj list

An object list or array which is assigned the selected objects.

NOTE: If a group is selected, the object list or array must be large enough to contain the group plus the objects in the group. For example, an object list or array of four would be necessary to hold a group consisting of three objects.

CNT

Minor word that indicates that a count of objects selected is desired.

count

A variable which is assigned the number of objects selected.

CURSOR

Minor word that indicates that the coordinates of the screen position used for the selection of an object are to be retained.

x-coord,y-coord,z-coord

Three variables which are assigned the coordinates of the screen position used for the selection of an object. The assigned value of these variables may be unpredictable if a technique other than cursor is used.

MEMBER

Minor word that indicates that the parameter in the following field controls the status of member selection. This option is most important when the user is not prompted with the Class Selection Subfunction (where the member selection status could be changed). This option has an effect when single selection is used.

If the member parameter is not specified, the default is on unless selection of either groups or components is enabled. If it is enabled, member selection is automatically off.

ON

Minor word that indicates that member selection is on. This allows you to select members of groups or components without selecting the group or component.

OFF

Minor word that indicates that member selection is off. When you select a member of a group or component, the entire group or component is selected.

response

A variable which is assigned a numerical value based on the user response.

Parameter	Description
message	A string which represents the title of the menu you want to display. The string can contain up to 40 characters.
SCOPE	Minor word which specifies the scope of object selection. ASSY is the default.
WORK	Allows you to select only objects which belong to the work part. This includes immediate components of the work part. If you select an object occurrence, the prototype is returned.
ASSY	Allows you to select any object or object occurrence in the assembly. No scope restrictions are applied.
REF	Allows you to select objects which belong to the work part or its subassembly. If you select an object occurrence, the prototype is returned.
obj list	An object list or array which is assigned the selected objects. NOTE: If a group is selected, the object list or array must be large enough to contain the group plus the objects in the group. For example, an object list or array of four would be necessary to hold a group consisting of three objects.
CNT	Minor word that indicates that a count of objects selected is desired.
count	A variable which is assigned the number of objects selected.
CURSOR	Minor word that indicates that the coordinates of the screen position used for the selection of an object are to be retained.
x-coord,y-coord,z-coord	Three variables which are assigned the coordinates of the screen position used for the selection of an object. The assigned value of these variables may be unpredictable if a technique other than cursor is used.
MEMBER	Minor word that indicates that the parameter in the following field controls the status of member selection. This option is most important when the user is not prompted with the Class Selection Subfunction (where the member selection status could be changed). This option has an effect when single selection is used. If the member parameter is not specified, the default is on unless selection of either groups or components is enabled. If it is enabled, member selection is automatically off.
ON	Minor word that indicates that member selection is on. This allows you to select members of groups or components without selecting the group or component.
OFF	Minor word that indicates that member selection is off. When you select a member of a group or component, the entire group or component is selected.
response	A variable which is assigned a numerical value based on the user response.