| Command group | Flag affected | Reversible | Execute on client | Platform(s) |
|---|---|---|---|---|
| Text | NO | NO | YES | All |
Begin text block ([Keep current contents][,Carriage return][,Linefeed])
| Keep current contents | If specified, the command keeps the current contents of the text block rather than setting it to empty |
| Carriage return | If specified, Omnis appends a carriage return after it appends the text from a Line: command in the block. If the Carriage return and Linefeed options are both omitted then Omnis appends a platform newline after each Line: command |
| Linefeed | If specified, Omnis appends a line feed after it appends the text from a Line: command in the block. If the Carriage return and Linefeed options are both omitted then Omnis appends a platform newline after each Line: command |
This command defines the start of a block of text to be stored in the text buffer for the current method stack. The Begin text block command clears the text buffer by default, and adds the text in subsequent Line: and Text: commands to the text buffer. However, you can keep the current contents of the buffer by checking the Keep current contents option, in which case text is appended to current text in the buffer. You build the text block using the Line: and Text: commands, which support leading and trailing spaces and can contain square bracket notation. The Carriage return and Linefeed options specify the line delimiter added after each Line: command; if you omit both of these options, Omnis adds the platform specific newline character sequence after each Line: command. The End text block command defines the end of the text block, and you can return the contents of the text buffer using the Get text block command.
Begin text block
Text: Thought for the day: (Carriage return)
Text: If a train station is where the train
Text: stops, what is a work station?
End text block
Get text block lTextString
OK message {[lTextString]}