Text-Reference Dialog
Applicability: Cranium, Synapse

The Text-Reference Dialog is used by many fields to display and edit values, references and comments. For example, clicking the left mouse button on the Formula Field, found in a knowledge base document's Chemicals Chapter, will activate the dialog.

The dialog contains several controls:

Datum Control: displays and enables editing of the physical property's value. Typically, because the physical property value is a string, very little if any verification is done of the entered value.
Reference Edit Control: displays and enables editing of the value's reference. Athough any value may be entered, typically one enters the identifier of a reference present in the References chapter.
List References Button: activates the Choose Reference dialog.

When you select one of the listed references, the reference's identifier is copied into the Reference Edit Control. (See here for additional documentation.)

Comments Edit Control: displays and enables editing of the comment's associated with this value.
Date Button: inserts the current date and time into the Comments Control. These values are inserted at the cursor's current position.
Phrase Button: inserts the current user's 'Personal Phrase' into the Comments Control. The phrase is inserted at the cursor's current position.
Set Phrase Button: activates the 'Set Comment Phrase' dialog. This phrase is stored within the Windows system and is accessible throughout all application documents.
Show Ref Button: displays the document assoicated with the cited reference. The cited document must be the identifier of a Reference contained within the current document's Reference Chapter. The document's location is retrieved from the entry in the Document Location Section.
Save Button: stores the entered values into the current document.
Typical Usage

Clicking on many text-based physical property values will activate the Text-Reference dialog.

You would then enter a value for the Datum and optionally, but highly recommended, values for the reference and comments. The List button and the reference control's dropdown menu is typically used to select reference identifiers. The Date and Phrase buttons are typically used to add details to the Comments.

Once all values have been entered, you would press the dialog's Save button to store the values into the current document.

Text Edit Control Menu

Clicking the right mouse button within a text edit control (the value, reference and comments control in this dialog) will display the edit control menu.

Documentation on each of the menu commands can be found here.

Related Documentation