Differences

This shows you the differences between two versions of the page.

--- action:Display_Text [2016/08/13 20:19] – add internal and forum links + cosmetic edits alain
+++ action:Display_Text [2020/12/14 02:56] (current) – peternlewis
@@ 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 ======
-Display options are:
+The //Display Text// Action provides two very different functions:
-  *Insert text by typing
+  - Display Text in a Popup Window
-  *Insert text by pasting
+  - Insert Text in a Text Document or Text Field
-  *Insert styled text by pasting
-  *Display text in a window
-  *Display text briefly
-  *Display text large
-The first 4 options display the text in a small window on screen. Dismiss the window with the //OK// button.
-Display text briefly displays the text in a notification which disappears after a few moments.
+===== Action Screenshot =====
-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.
+When you initially insert this _Action_, it looks like this:
-The action allows you to control what text processing happens in the gear menu (7.2+) :
+{{: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)
@@ Line 22: / Line 23: @@
 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 =====
-===== See Also =====
+  *Display text in a window
+  *Display text briefly
+  *Display text large
-----
+==== 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.  This uses the standard system Notification, so if you have disabled Notifications from displaying you may not see any results.
+**Note:** If you are mirroring screens, have turned on Do Not Disturb, or have disabled Notifications for any other reason, then these will not appear.
+==== 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.
+===== 2. Insert Text Choices =====
+  *Insert text by typing
+  *Insert text by pasting
+  *Insert styled text by pasting
+===== See Also =====
 === Actions ===
@@ Line 32: / Line 72: @@
 * [[action:Notification|Notification]]
 * [[:Actions|See all Actions]]
-----
 ==== Forum ====
@@ Line 41: / Line 79: @@
 - [[https://forum.keyboardmaestro.com/t/display-an-rtf-file/4609/4|Display an RTF file?]]
-- [[https://www.google.fr/search?q=site:forum.keyboardmaestro.com+Display+text|Keyboard Maestro Forum topics about Display text]]
+- [[https://forum.keyboardmaestro.com/search?q=Display%20text|Keyboard Maestro Forum topics about Display text]]