## Diese Warnung ist Bestandteil jedes Howtos und darf nicht entfernt werden!!! {{{#!vorlage Warnung Die Verwendung dieses Howto geschieht auf eigene Gefahr. Bei Problemen mit der Anleitung melde dies bitte in der dazugehörigen Diskussion und wende dich zusätzlich an den Verfasser des Howtos. }}} ## Bitte die Angaben zu dem letzten erfolgreichen Test dieser Anleitung eintragen: {{{#!vorlage Hinweis Diese Howto-Anleitung wurde zuletzt von [user:HattoriHanzo12:] im Januar 2020 unter '''Ubuntu 19.10''' erfolgreich getestet. }}} [[Inhaltsverzeichnis(3)]] [:Dialog:] bietet eine große Anzahl an Optionen, die hier genauer vorgestellt werden. = Box-Optionen = || '''Option''' || '''Parameter''' || '''Aktion''' || '''Bildbeispiele''' || || `--buildlist` || `TEXT HÖHE BREITE WERT1 ELEMENT1 STATUS1` || Buildlist|| [[Bild(Dialog/beispielbild_buildlist)]] || || `--calendar` || `TEXT HÖHE BREITE TAG MONAT JAHR` || Kalender || [[Bild(Dialog/beispielbild_calendar)]] || || `--checklist` || `TEXT HÖHE BREITE LISTEN-HÖHE ELEMENT1 ELEMENT2 STATUS1` || Checkliste || [[Bild(Dialog/beispielbild_checklist)]] || || `--dselect` || `ORDNER HÖHE BREITE` || Ordnerauswahl || [[Bild(Dialog/beispielbild_dselect)]] || || `--editbox` || `DATEI HÖHE BREITE` || Texteditor für Dialog || [[Bild(Dialog/beispielbild_editbox)]] || || `--fselect` || `DATEIPFAD HÖHE BREITE` || Ordner-/Datei-Anzeige || [[Bild(Dialog/beispielbild_fselect)]] || || `--gauge` || `TEXT HÖHE BREITE [PROZENT]` || Progressbar || [[Bild(Dialog/beispielbild_gauge)]] || || `--infobox` || `TEXT HÖHE BREITE` || Infobox || [[Bild(Dialog/beispielbild_infobox)]] || || `--inputbox` || `TEXT HÖHE BREITE [INIT]` || Eingabefeld für Zahlen und Buchstaben || [[Bild(Dialog/beispielbild_inputbox)]] || || `--inputmenu` || `TEXT HÖHE BREITE MENÜ-HÖHE ELEMENT1 WERT1 [ELEMENT2] [WERT2]...` || Eingabebox || [[Bild(Dialog/beispielbild_inputmenu)]] || || `--menu` || `TEXT HÖHE BREITE MENÜ-HÖHE ELEMENT1 WERT1 [ELEMENT2] [WERT2]...` || Menü || [[Bild(Dialog/beispielbild_menu)]] || || `--mixedgauge` || `TEXT HÖHE BREITE PROZENT ELEMENT1 WERT1 ...` || Progressbar mit zusätzlichen Feldern || [[Bild(Dialog/beispielbild_mixedgauge)]] || || `--msgbox` || `TEXT HÖHE BREITE` || Infobox mit ''"OK"''-Button* || [[Bild(Dialog/beispielbild_msgbox)]] || || `--passwordbox` || `TEXT HÖHE BREITE [INIT]` || Passwortfeld || [[Bild(Dialog/beispielbild_passwordbox)]] || || `--pause` || `TEXT HÖHE BREITE SEKUNDEN`|| Pause in Sekunden || [[Bild(Dialog/beispielbild_pause)]] || || `--prgbox` || `TEXT BEFEHL HÖHE BREITE` || Ausgabebox || [[Bild(Dialog/beispielbild_prgbox)]] || || `--radiolist` || `TEXT HÖHE BREITE LISTEN-HÖHE ELEMENT1 WERT1 STATUS1 ELEMENT2...` || Radiolist || [[Bild(Dialog/beispielbild_radiolist)]] || || `--rangebox` || `TEXT HÖHE BREITE MIN_WERT MAX_WERT STANDARDWERT` || Rangebox || [[Bild(Dialog/beispielbild_rangebox)]] || = Optionale Option = Im Gegensatz zu den Box-Optionen können von den optionalen Optionen beliebig viele zu einem Befehl eingegeben werden, allerdings funktionieren nicht alle Optionen für alle Box-Optionen. Ein Beispiel dazu: {{{#!vorlage Befehl dialog --ascii-lines --extra-button --colors --extra-label 'Extra umbenannt' --inputbox '\Z2Hier steht grüner Text' 0 0 }}} [[Bild(Dialog/beispiel_ascii+colors)]] || '''Optionen''' || '''Parameter''' || '''Aktion''' || '''Beispiele''' || ||<-2> `[--ascii-lines]` || Erstellt Ascii-Linien im Fenster als Rahmen. || [[Bild(Dialog/beispiel_ascii)]] || || `[--aspect]` || `SEITENVERHÄLTNIS` || änder das Seitenverhältnis vom Objekt. || [[Bild(Dialog/beispiel_aspect)]] || || `[--backtitle]` || `TEXT` || Setzt eine Überschrift über das Objekt || [[Bild(Dialog/beispiel_backtitle)]] || ||<-2> `[--beep-after]` ||<-2> Gibt ein Systemton mit aus || || `[--begin]` || `Y Z` || Positioniert das Objekt. || [[Bild(Dialog/beispiel_begin)]] || || `[--cancel-label]` || `TEXT` || Benennt den ''"cancel"''-Button um. || [[Bild(Dialog/beispiel_cancel_label)]] || || `[--colors]` || `\Z...`*** || Ändert die Textfarbe und die Hintergrundfarbe des Textes. Kann auch '''Fett''' und __Unterstreichen__.* || [[Bild(Dialog/beispiel_colors)]] || || `[--cr-wrap]` || || *Erklärung unten* || || `[--default-item]` || `ELEMENT` || Setzt das ausgewählte Element auf Standard. || [[Bild(Dialog/beispiel_default-item)]] || || `[--defaultno]` || || Setzt ''"Cancel"'', ''"No"'', ''"Nein"'', ''"Abbrechen"'' als standardmäßig ausgewählten Button || [[Bild(Dialog/beispiel_defaultno)]] || || `[--extra-button]` || || Setzt ein zusätzlichen Button mit der Beschriftung ''"Extra"'' || [[Bild(Dialog/beispiel_extra-button)]] || || `[--extra-label]` || `UMBENENNUNG` || Benennt den ''"Extra"''-Button um. || [[Bild(Dialog/beispiel_extra-label)]] || || `[--help-button]` || || Setzt ein zusätzlichen Button mit der Beschriftung ''"Help/Hilfe"'' || [[Bild(Dialog/beispiel_help-button)]] || || `[--help-label]` || `UMBENENNUNG` || Benennt einen ''"Help/Hilfe"''-Button um. || [[Bild(Dialog/beispiel_help-label)]] || || `[--help-status] `|| ||<-2> Setzt bei Drücken des Help-Buttons ''"HELP"'' vor das zurückgegebene Element. || || `[--ignore]` || || Ignoriert Optionen, die Dialog nicht kennt. || || || `[--insecure]` || || Zeigt Sterne in einer Passwordbox an, damit zu sehen ist, wie viele Zeichen schon eingegeben wurden. || [[Bild(Dialog/beispiel_insecure)]] || || `[--max-input]` || `WERT` || Begrenzt die Anzahl der einzugebenden Zeichen. || || || `[--no-lines]` || || Lässt alle Layoutgrenzen im Fenster verschwinden. || [[Bild(Dialog/beispiel_no-lines)]] || || `[--no-mouse]` || || Lässt keine Eingabe über Maus zu. || || || `[--no-cancel]` || || Lässt den ''"Cancel"''- (Abbrechen) und ''"No"''-Button verschwinden. || [[Bild(Dialog/beispiel_no-cancel)]] || || `[--no-ok]` || || Lässt den ''"Ok"''-Button verschwinden. || [[Bild(Dialog/beispiel_no-ok)]] || || `[--no-shadow]` || || Lässt den Schatten verschwinden. || [[Bild(Dialog/beispiel_no-shadow)]] || || `[--nook]` || || Siehe `--no-ok` || || || `[--ok-label]` || `UMBENENNUNG` || Benennt den ''"Ok"''-Button um. || [[Bild(Dialog/beispiel_ok-label)]] || || `[--sleep]` || `SEKUNDEN` || Wartet die angegebenen Sekunden, bis das Skript fortgesetzt wird. || || || `[--stderr]` || || Schreibt das Ergebnis in den stderr-Kanal. || || || `[--stdout]` || || Schreibt das Ergebnis in den stdout-Kanal. || || || `[--tab-correct] `|| || Ändert den Tabulatorabstand in ein Leerzeichen. Nur für `--textbox` || || || `[--tab-len]` || `WERT` || Ändert die Zeichenanzahl, den die Tabulator-Taste vorspringen lässt. || || || `[--trace]` || `DATEI` || Zeichnet Tastatureingaben auf und schreibt sie in die angegebene Datei. || || || `[--trim]` || || Entfernt Leerzeichen am Anfang und am Ende einer Eingabe. || || || `[--yes-label]` || `UMBENNEUNG` || Benennt den ''"Yes"''-Button um. || Informationen zu einigen Optionen: == --colors == Bei `--colors` muss vor dem zu formatierenden Text immer `\Z` stehen. Je nach dem was hinter `\Z` steht, verändert sich die Schriftfarbe, Hintergrund oder Formatierung. === Zu den Farben === Um die Farbe vom Text zu ändern, muss nach dem `\Z` ein Ziffer stehen, beginnend bei der 0 bis zur 7. * `0` = Schwarz * `1` = Rot * `2` = Grün * `3` = Gelb * `4` = Blau * `5` = Magenta * `6` = Cyan * `7` = Schwarz markiert Hier ein Beispiel: {{{#!vorlage Befehl dialog --colors --infobox '\Z1Hier steht roter Text. \Z2Und hier steht grüner Text. \Z4Und hier blauer Text. \Z5Oder Zw\Z6ei Farben.' 0 0 }}} [[Bild(Dialog/beispiel_bunter-text)]] === Zu den Formatierungen === * `\Zb` = Fettschrift `\ZB` = Deaktiviert es wieder * `\Tr` = Tauscht Vorder und Hintergrund `\ZR` = Deaktiviert es wieder * `\Zu` = Unterstreicht den Text `\ZU` = Deaktiviert es wieder * `\Zn` = Setzt alle Veränderung wieder zurück == --cr-wrap == `[--cr-wrap]` wird im Skript verwendet, um Zeilen in Dialog umzubrechen. {{{ #!/bin/bash dialog --cr-wrap --infobox 'Hier steht der Text in mehreren Zeilen' 0 0 }}} Dies ist natürlich nur ein Teil dessen, was Dialog kann. Genaueres im Terminal per {{{#!vorlage Befehl dialog --help }}} oder in der [:man:Manpage] zu Dialog. #tag: Howto