int prompt_qgroup ( char *message, int e_type )

char *message;     // prompt message string

int   e_type;      // entity type mask

Synopsis

#include "silver.h"

The prompt_qgroup function allows the user to select entities to define a q-group, based on the e_type filter. The prompt specified by message is at the bottom of the screen. This function uses either pick mode or scan mode to select an entity, depending on the current pick/scan setting.

Parameters

message is a null-terminated string containing a prompt message. e_type is an integer value specifying which entity type is to be considered for picking. e_type may be one of (as defined in silver.h):

Return Value

prompt_qgroup returns 1 if the user successfully completes selection operation. Otherwise, the function returns 0.

Comments

The paths to the q-group entities may be accessed by get_group_item . The entities in the q-group may also be referenced in a command by the [q-group] keyword.

See Also

fence_qgroup

Example

The following example draws the selected text entities in a light-blue color.