This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | Next revision Both sides next revision | ||
action:Display_Text [2016/08/13 16:19] alain add internal and forum links + cosmetic edits |
action:Display_Text [2016/12/03 17:43] JMichaelTX Major rewrite -- ADD screenshots, sections, examples |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | The //Display Text// action displays text on the screen in one of several ways. Text may also include [[:Tokens|text tokens]]. Select text tokens using the Insert Token arrow at the right-hand end of the text area. | + | ====== Display Text Action ====== |
+ | |||
+ | The //Display Text// Action provides two very different functions: | ||
+ | - Display Text in a Popup Window | ||
+ | - Insert Text in a Text Document or Text Field | ||
+ | |||
+ | |||
+ | ===== Action Screenshot ===== | ||
+ | When you initially insert this _Action_, it looks like this: | ||
+ | |||
+ | {{:action:km-7.3-display-text-action.png?nolink|}} | ||
+ | |||
+ | Text may also include [[:Tokens|text tokens]]. Select text tokens using the Insert Token arrow at the right-hand end of the text area. | ||
+ | |||
+ | ===== Action Options (Gear Menu) ===== | ||
+ | |||
+ | You can control what text processing happens by selecting one of these options from the Gear Menu (7.2+) : | ||
+ | |||
+ | * Process Text Normally (process text tokens and backslash characters) | ||
+ | * Process Text Tokens Only (process text tokens but not backslash characters) | ||
+ | * Process Nothing (process neither text tokens nor backslash characters) | ||
+ | |||
+ | Most other [[:Text Fields|Text Fields]] in Keyboard Maestro process both [[:Tokens|text tokens]] and (except for regular expression fields) backslash characters. | ||
+ | |||
+ | ===== 1. Display Text Choices ===== | ||
- | Display options are: | ||
- | *Insert text by typing | ||
- | *Insert text by pasting | ||
- | *Insert styled text by pasting | ||
*Display text in a window | *Display text in a window | ||
*Display text briefly | *Display text briefly | ||
*Display text large | *Display text large | ||
- | The first 4 options display the text in a small window on screen. Dismiss the window with the //OK// button. | + | ==== 1.1 Display Text In a Window ==== |
+ | |||
+ | * The _Display Text In a Window_ displays plain text, rich text, and/or images in a popup window with only a "OK" button. | ||
+ | * It remains visible until the user clicks on the button, or presses RETURN twice. | ||
+ | * It is still available even if you switch to other apps that hide it. | ||
+ | * Rich Text and Images | ||
+ | * You can enter the rich text in the _Action_ setup by either pasting from the Clipboard, or by selecting text already in the _Action_, and applying a style to it, using the Keyboard Maestro Editor _Edit > Format_ menu: | ||
+ | * {{:action:km-7.3-format-menu.png?nolink|}} | ||
+ | |||
+ | |||
+ | **Example Created by Pasting Rich Text and Image, then Formatting** | ||
+ | |||
+ | {{:action:km-7.3-display-text-win-example.png?nolink|}} | ||
+ | |||
+ | |||
+ | ==== 1.2 Display Text Briefly ==== | ||
Display text briefly displays the text in a notification which disappears after a few moments. | Display text briefly displays the text in a notification which disappears after a few moments. | ||
+ | |||
+ | ==== 1.3 Display Text Large ==== | ||
Display text large displays text in white across a transparent gray background in the centre of the screen. The more text there is the smaller the text size so that it fits on a single line. That means it’s a good idea to keep the text short. The text disappears after a few moments. | Display text large displays text in white across a transparent gray background in the centre of the screen. The more text there is the smaller the text size so that it fits on a single line. That means it’s a good idea to keep the text short. The text disappears after a few moments. | ||
- | The action allows you to control what text processing happens in the gear menu (7.2+) : | + | ===== 2. Insert Text Choices ===== |
+ | |||
+ | *Insert text by typing | ||
+ | *Insert text by pasting | ||
+ | *Insert styled text by pasting | ||
+ | |||
+ | |||
- | * Process Text Normally (process text tokens and backslash characters) | ||
- | * Process Text Tokens Only (process text tokens but not backslash characters) | ||
- | * Process Nothing (process neither text tokens nor backslash characters) | ||
- | Most other [[:Text Fields|Text Fields]] in Keyboard Maestro process both [[:Tokens|text tokens]] and (except for regular expression fields) backslash characters. | ||
===== See Also ===== | ===== See Also ===== |