Share

acedCommandS Function

C++

int acedCommandS(
    int rtype, 
    ...
);

File

acedCmdNF.h

Description

Syntax-compatible replacement of acedCommand, use for "full commands", not partial ones. This command essentially begins with its own private command line processor, initialized at the "Command:" prompt. The commands are executed in the same manner as with acedCommand, except that when the supplied input has all been executed, the private command line processor is deleted and the previous command line processor is unchanged from when the call is made. Modality and transparent "builtin" commands may not be nested.

Parameters

Parameters Description
rtype First argument in the pair, representing the type of the data in the second argument; one of the result type codes defined in adscodes.h /*variable_arg_list*/ : Second argument in the pair, containing the data to pass to the command or zero or RTNONE to indicate the end of the argument pairs

Notes

In the acedCommandS ‘Subroutine’ the first input token is fed to the Command: prompt, so should initiate a command, the last input token completes a command. A ‘token’ is a segment of a command. In a call like this:

acedCommand(RTSTR, _T("_Line"), RTSTR, _T("0,0"), RTSTR, _T("111,111"), , RTSTR, _T("") , RTNONE);

RTSTR, _T("_Line") is the first command token, and RTSTR, _T(””) is the last, which finishes the LINE command.

If your acedCommand call follows this contract, then use acedCommandS. Migrating the above code to acedCommandS is as simple as typing the extra ‘S’, like this:

acedCommandS(RTSTR, _T("Line"), RTSTR, _T("0,0"), RTSTR, _T("111,111"), RTSTR, _T(""), RTNONE);

See Also

acedCommand Migration in the ObjectARX Release Notes.

Was this information helpful?