SoDialogEditText Class Reference
[Dialog]

VSG extension Dialog EditText node. More...

#include <DialogViz/dialog/SoDialogEditText.h>

Inheritance diagram for SoDialogEditText:
SoDialogComponent SoTopComponent SoDialogViz SoDragger SoInteractionKit SoBaseKit SoNode SoGetView SoFieldContainer SoBase SoRefCounter SoTypedObject

List of all members.

Public Member Functions

 SoDialogEditText ()
void addAuditor (SoDialogEditTextAuditor *auditor)
void removeAuditor (SoDialogEditTextAuditor *auditor)

Public Attributes

SoSFString editText
SoSFBool editable
SoSFBool multiLine
SoSFBool wrapLine
SoSFBool trigOnEnter
SoSFBool isNumeric

Detailed Description

VSG extension Dialog EditText node.

This node defines a multi-line editing zone for the dialog.

DialogEditText.jpg

The editText field represents the text of the editing zone. This field supports the newline (\n) character and the tabulation character (\t). The editable field specifies if the user can write new text in the edit zone or not. The multiLine field allows to edit a multiLine text. In this case, a vertical scroll bar appears at the left side of the component. On windows system, mouse scroll wheel is supported in the edit area. The trigOnEnter field specifies how the associated auditor is triggered. If its value is TRUE, the event happened only when the <ENTER> key is pressed. Otherwise, the auditor is called each time the edit text changes. It's possible to filter text to be numeric or not by using the isNumeric field.

Note : On UNIX systems, the auditor call is depending on the multiLine field value. If the edit control is multiLine, only the num pad <ENTER> key will process the auditor, else, in case multiLine is FALSE, the two <ENTER> key will do it.

To add or remove an SoDialogEditTextAuditor, use the addAuditor() and removeAuditor() methods.

You can change the parts in any instance of this editText component using setPart(). The default part geometries are defined as resources for this SoDialogEditText class. They are detailed below in the Catalog Parts section of the online reference page for this class. You can make your program use different default resources for the parts by copying the file $OIVHOME/data/DialogViz/Skins/default/DialogEditText.iv into your own directory, editing the file, and then setting the environment variable DIALOGVIZ_SKINS_DIR to be a path to that directory, or by using the setSkinDirectory() method in your application.

FILE FORMAT/DEFAULT

SEE ALSO

SoDialogCheckBox, SoDialogCheckBoxLauncher, SoDialogComboBox, SoDialogRadioButtons, SoDialogCustom, SoColumnDialog, SoRowDialog, SoTabDialog, SoDialogLabel, SoDialogPushButton, SoDialogPushButtonLauncher, SoDialogSeparator, SoDialogIntegerSlider, SoDialogRealSlider

See related examples:

ShowAll, Simple, SetSkin, Simple3DMenu


Constructor & Destructor Documentation

SoDialogEditText::SoDialogEditText (  ) 

Constructor.


Member Function Documentation

void SoDialogEditText::addAuditor ( SoDialogEditTextAuditor auditor  ) 

Adds a dialogEditTextAuditor to the current editText component.

void SoDialogEditText::removeAuditor ( SoDialogEditTextAuditor auditor  ) 

Removes the specified editTextAuditor from the auditor list.


Member Data Documentation

Allows writing in the edit zone.

Default is TRUE.

String of the edit zone.

Default value is an empty string.

Specifies if typed text is numeric only.

Sets multi-line mode.

Default is FALSE.

When trigOnEnter is TRUE, the associated auditor is called only when the <ENTER> key is pressed.

Otherwise, the auditor is called at any edit text changes. Default is TRUE.

Sets wraping line mode.

Default is TRUE.


The documentation for this class was generated from the following file:

Open Inventor Toolkit reference manual, generated on 12 Feb 2024
Copyright © Thermo Fisher Scientific All rights reserved.
http://www.openinventor.com/