%object%.ReadText function

From ADRIFT 5 Manual Wiki
Jump to: navigation, search

This function returns the contents of the "...and description when read" property of an object.

This is a text box, so the returned text can span multiple lines.

Requirements

If the object does not have a "...and description when read" property containing text, then this function will do nothing.

This function does NOT default to the object description or print the "there is nothing worth reading" message like the "read %object%" command. Those outputs are produced by restriction messages and alternate descriptions in the standard library.

Properties

The "Object is Readable" property must be selected before the "...and description when read" property becomes available.

If the "...and description when read" property is also selected, then you can enter a description that is to be printed whenever the player enters the "read %object%" command.

PropertyReadText.jpg

How to use

This function simply returns the contents of the "...and description when read" text box as one or more lines of text. No further functions can be appended to this function.

If the text box has Alternate Descriptions then the text that is printed will be effected by the restrictions and composition setting of each alternate description.

Examples

  • %object%.ReadText
Prints the contents of the read-text text box for an object referenced in a task.
  • Object12.ReadText
Prints the contents of the read-text text box for the object with the key "Object12"


<<< WornByWhoObject FunctionsDescription >>>