Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Commands that are shipped by default also show up the default user input mask that may not suit well into the host applications surface. The CFxARESInstance allows to disable the predefined controls using the method SetUIConfiguration(). Once this is done it is necessary to create a custom input that cooperates with commands. Whenever a command requires an user action the custom input should request for corresponding values. This can be accomplished with the CFxUserInputDelegate.  The CFxUserInputDelegate informs the host application when an user interaction starts interactionStarted() or ends interactionEnded(). The DWG Expert controls a class UserInput.java that takes over the job of the delegate and the user interface. The class must be instantiated and registered as main CFxUserInputDelegate. Depending on the started interaction type the custom user input has to accept the command value or exit the command procedure. The DWG Expert relies on point input and demonstrates the use of acceptWithCoordinates() and cancel().


UIConfiguration
The default value is 7. Get the current value with GetUIConfiguration() from CFxARESInstance.

Flag

Value

Description

eCustomUserInput

0

This flag overrides and disables the default user input

eStandardUserInput

1

The standard user input for commands, all features enabled

eStandardUserInputHelpButton

2

This flag can be removed to hide the help button

eStandardUserInputPanButton

4

This flag can be removed to hide the Pan/Orbit button

The method interactionStarted( final String prompt, String[] keywords, int inputType ) basically provides the following kind of data:

...