# Příručka k aplikaci MateDialog

## Úvod

Aplikace MateDialog vám umožňuje vytvářet následující typy jednoduchých dialogových oken:

- Kalendář

- Výběr souboru

- Seznam

- Oznamovací ikona

- Zpráva

  - Chybové hlášení

  - Informační hlášení

  - Dotaz

  - Varovné hlášení

- Ukazatel průběhu

- Textový vstup

- Textová informace

## Použití

Pokud píšete skripty, můžete využít aplikaci MateDialog k vytváření jednoduchých dialogových oken, díky čemuž můžete graficky komunikovat s uživatelem. Využití je pro následující dva účely:

- Můžete vytvořit dialogové okno k získání informací od uživatele. Například se můžete uživatele dotázat na datum pomocí výběru z dialogového okna s kalendářem nebo na název souboru pomocí dialogového okna pro výběr souboru.

- Můžete vytvořit dialogové okno pro sdělení informace uživateli. Například můžete použít dialogové okno s ukazatelem průběhu k informování o stavu operace nebo dialogové okno s varovnou zprávou k upozornění uživatele.

Po té, co uživatel zavře dialog, vypíše aplikace MateDialog text vytvořený dialogem na standardní výstup.

Při zapisování příkazů MateDialog se ujistěte, že máte všechny argumenty uzavřené do uvozovek.

For example, use:

    matedialog --calendar --title="Holiday Planner"

Do not use:

    matedialog --calendar --title=Holiday Planner

Pokud uvozovky nepoužijete, můžete získat nepředvídatelné výsledky.

### Horké klávesy

Horké klávesy jsou klávesy, které vám umožňují provádět činnost z klávesnice místo abyste museli použít myš k výběru z nabídky nebo dialogového okna. Každá horká klávesa je symbolizovaná podtržením příslušného písmene v položce nabídky nebo dialogového okna.

Některá dialogová okna MateDialog podporují horké klávesy. Pokud chcete určit, že některý znak má fungovat jako horká klávesa, umístěte před něj podtržítko. Následující příklad ukazuje, jak určit jako horkou klávesu znak „Z“

    "_Choose a name".

### Návratové kódy

MateDialog vrací následující návratové kódy:

Návratový kód | Popis
`0` | Uživatel zmáčkl buď OK nebo Zavřít.
`1` | Uživatel buď zmáčkl Zrušit nebo použil ovládací prvky okna k zavření dialogu.
`-1` | Vyskytla se neznámá chyba.
`5` | Dialogové okno bylo zavřeno, protože vypršel časový limit.

### Všeobecné přepínače

Všechna dialogová okna MateDialog podporují následující všeobecné přepínače:

`--title`=`název`

- Určuje název dialogového okna.

`--window-icon`=`cesta_k_ikoně`

- Určuje ikonu, která se zobrazí v záhlaví dialogového okna. K dispozici jsou také 4 předdefinované ikony dostupné pomocí klíčových slov „info“ (informace), „warning“ (varování), „question“ (dotaz) a „error“ (chyba).

`--width`=`šířka`

- Určuje šířku dialogového okna.

`--height`=`výška`

- Určuje výšku dialogového okna.

`--timeout`=`časový_limit`

- Určuje časový limit v sekundách, po kterém se dialog zavře.

### Přepínače nápovědy

MateDialog poskytuje následující přepínače pro nápovědu:

`--help`

- Zobrazí zkrácenou nápovědu.

`--help-all`

- Zobrazí celou nápovědu pro všechny typy dialogových oken.

`--help-general`

- Zobrazí nápovědu pro všeobecné přepínače dialogových oken.

`--help-calendar`

- Zobrazí nápovědu pro přepínače dialogového okna s kalendářem.

`--help-entry`

- Zobrazí nápovědu pro přepínače dialogového okna na vkládání údajů.

`--help-error`

- Zobrazí nápovědu pro přepínače dialogového okna s chybovým hlášením.

`--help-info`

- Zobrazí nápovědu pro přepínače dialogového okna s informačním hlášením.

`--help-file-selection`

- Zobrazí nápovědu pro přepínače dialogového okna na výběr souboru.

`--help-list`

- Zobrazí nápovědu pro přepínače dialogového okna se seznamem.

`--help-notification`

- Zobrazí nápovědu pro přepínače oznamovací ikony.

`--help-progress`

- Zobrazí nápovědu pro přepínače dialogového okna s ukazatele průběhu.

`--help-question`

- Zobrazí nápovědu pro přepínače dialogového okna s dotazem.

`--help-warning`

- Zobrazí nápovědu pro přepínače dialogového okna s varovným hlášením.

`--help-text-info`

- Zobrazí nápovědu pro přepínače dialogového okna s informačním textem.

`--help-misc`

- Zobrazí nápovědu pro různé přepínače.

`--help-gtk`

- Zobrazí nápovědu pro přepínače GTK+.

### Různé přepínače

MateDialog také poskytuje následující různorodé přepínače:

`--about`

- Zobrazí dialogové okno O aplikaci MateDialog, které obsahuje informace o verzi MateDialog, informace o autorských právech a informace o vývojářích.

`--version`

- Zobrazí číslo verze aplikace MateDialog.

### Přepínače GTK+

Aplikace MateDialog podporuje standardní přepínače GTK+. Více informací o přepínačích GTK+ získáte spuštěním příkazu `matedialog -?`.

### Proměnné prostředí

Normálně MateDialog detekuje terminálové okno, ze kterého byla spuštěná a drží se nad tímto oknem. Toto chování lze zakázat zrušením nastavení proměnné prostředí `WINDOWID`.

## Dialogové okno s kalendářem

K vytvoření dialogového okna s kalendářem použijte přepínač `--calendar`. Aplikace MateDialog vrátí vybrané datum na standardní výstup. Pokud neurčíte v příkazovém řádku žádné datum, použije se aktuální.

Dialogové okno s kalendářem podporuje následující přepínače:

`--text`=`text`

- Určuje text, který se v dialogovém okně s kalendářem zobrazí.

`--day`=`den`

- Určuje den, který bude v kalendáři vybraný. `den` musí být číslo v rozmezí 1 až 31 včetně.

`--month`=`měsíc`

- Určuje měsíc, který bude v kalendáři vybraný. `měsíc` musí být číslo v rozmezí 1 až 12 včetně.

`--year`=`rok`

- Určuje rok, který bude v kalendáři vybraný.

`--date-format`=`formát`

- Určuje formát, v jakém má dialogové okno s kalendářem vrátit vybrané datum. Výchozí formát je daný vaším národním prostředím. `formát` musí být formát, který akceptuje funkce `strftime`, např. `%A %d/%m/%y`.

The following example script shows how to create a calendar dialog:

            #!/bin/sh

            if matedialog --calendar \
            --title="Select a Date" \
            --text="Click on a date to select that date." \
            --day=10 --month=8 --year=2004
              then echo $?
              else echo "No date selected"
            fi

### Příklad dialogového okna s kalendářem

MateDialog calendar dialog example

## Dialogové okno s výběrem souboru

K vytvoření dialogového okna s výběrem souboru použijte přepínač `--file-selection`. Aplikace MateDialog vrátí vybrané soubory nebo složky na standardní výstup. Výchozí režim dialogového okna s výběrem souboru je open (otevřít).

Dialogové okno s výběrem souboru podporuje následující přepínače:

`--filename`=`název_souboru`

- Určuje soubor nebo složku, kteří budou vybraní po prvním spuštění dialogového okna.

`--multiple`

- Umožní v dialogovém okně vybrat více souborů naráz.

`--directory`

- Umožní v dialogovém okně pouze výběr složek.

`--save`

- Přepne dialogové okno s výběrem souboru do režimu save (uložit).

`--separator`=`oddělovač`

- Určuje řetězec, který se použije k oddělení jednotlivých názvů souborů ve vráceném seznamu.

The following example script shows how to create a file selection dialog:

            #!/bin/sh

            FILE=`matedialog --file-selection --title="Select a File"`

            case $? in
                     0)
                            echo "\"$FILE\" selected.";;
                     1)
                            echo "No file selected.";;
                    -1)
                            echo "No file selected.";;
            esac

### Příklad dialogového okna na výběr souboru

MateDialog file selection dialog example

## Oznamovací ikona

`--text`=`text`

- Určuje text, který se zobrazí v oznamovací oblasti.

The following example script shows how to create a notification icon:

            #!/bin/sh

            matedialog --notification\
              --window-icon="info" \
              --text="There are system updates necessary!"

### Příklad oznamovací ikony

MateDialog notification icon example

## Dialogové okno se seznamem

K vytvoření dialogového okna se seznamem použijte přepínač `--list`. Aplikace MateDialog vrátí položky z prvního sloupce vybraných řádků na standardní výstup.

Data pro dialogové okno se musí zadat sloupec po sloupci, řádek po řádku. Data lze dialogovému oknu předat i přes standardní vstup. Každá položka musí být oddělená znakem nového řádku.

Pokud použijete přepínače `--checklist` nebo `--radiolist`, musí každý řádek začínat buď hodnotou „TRUE“ (bude zaškrtnuté) nebo „FALSE“ (nebude zaškrtnuté).

Dialogové okno se seznamem podporuje následující přepínače:

`--column`=`sloupec`

- Určuje záhlaví sloupců zobrazených v seznamu. Přepínač `--column` musíte zadat opakovaně zvlášť pro každý ze sloupců, které chcete v seznamu zobrazit.

`--checklist`

- Určuje, že první sloupec v seznamu bude obsahovat zaškrtávací pole.

`--radiolist`

- Určuje, že první sloupec v seznamu bude obsahovat skupinový přepínač.

`--editable`

- Povolit v zobrazených položkách provádění úprav.

`--separator`=`oddělovač`

- Určuje řetězec použitý jako oddělovač vybraných položek seznamu, které dialogové okno vrátí.

`--print-column`=`sloupec`

- Určuje sloupec, který se má z vybraného řádku vracet. Výchozí hodnota je „1“. Pokud chcete vrátit všechny sloupce seznamu, můžete použít hodnotu „ALL“.

The following example script shows how to create a list dialog:

            #!/bin/sh

            matedialog --list \
              --title="Choose the Bugs You Wish to View" \
              --column="Bug Number" --column="Severity" --column="Description" \
                992383 Normal "GtkTreeView crashes on multiple selections" \
                293823 High "MATE Dictionary does not handle proxy" \
                393823 Critical "Menu editing does not work in MATE 2.0"

### Příklad dialogového okna se seznamem

MateDialog list dialog example

## Dialogové okno s hlášením

Aplikace MateDialog umí vytvářet čtyři typy dialogových oken s hlášením:

- Chybové hlášení

- Informační hlášení

- Dotaz

- Varovné hlášení

U každého z typů použijte přepínač `--text` k zadání textu, který se má v dialogovém okně zobrazit.

### Dialogové okno s chybovým hlášením

K vytvoření dialogového okna s chybovým hlášením použijte přepínač `--error`.

The following example script shows how to create an error dialog:

              #!/bin/bash

              matedialog --error \
              --text="Could not find /var/log/syslog."

#### Příklad dialogového okna s chybovým hlášením

MateDialog error dialog example

### Dialogové okno s informačním hlášením

K vytvoření dialogového okna s informačním hlášením použijte přepínač `--info`.

The following example script shows how to create an information dialog:

              #!/bin/bash

              matedialog --info \
              --text="Merge complete. Updated 3 of 10 files."

#### Příklad dialogového okna s informačním hlášením

MateDialog information dialog example

### Dialogové okno s dotazem

K vytvoření dialogového okna s dotazem použijte přepínač `--question`.

The following example script shows how to create a question dialog:

              #!/bin/bash

              matedialog --question \
              --text="Are you sure you wish to proceed?"

#### Příklad dialogového okna s dotazem

MateDialog question dialog example

### Dialogové okno s varovným hlášením

K vytvoření dialogového okna s varovným hlášením použijte přepínač `--warning`.

The following example script shows how to create a warning dialog:

              #!/bin/bash

              matedialog --warning \
              --text="Disconnect the power cable to avoid electrical shock."

#### Příklad dialogového okna s varovným hlášením

MateDialog warning dialog example

## Dialogové okno s ukazatelem průběhu

K vytvoření dialogového okna s ukazatelem průběhu použijte přepínač `--progress`.

Aplikace MateDialog čte data ze standardního vstupu řádek po řádku. Když řádek začíná znakem #, provede se aktualizace textu pomocí textu na zbytku tohoto řádku. Když řádek obsahuje pouze číslo, aktualizují se procenta ukazatele.

Dialogové okno s ukazatelem průběhu podporuje následující přepínače:

`--text`=`text`

- Určuje text, který se má v dialogovém okně zobrazit.

`--percentage`=`procenta`

- Určuje počáteční stav procent, na které se má ukazatel průběhu nastavit.

`--auto-close`

- Zavřít dialogové okno po dosažení 100%.

`--pulsate`

- Určuje, že ukazatel průběhu bude pulzovat, dokud se ze standardního vstupu nenačte znak EOF (konce souboru).

The following example script shows how to create a progress dialog:

            #!/bin/sh
            (
            echo "10" ; sleep 1
            echo "# Updating mail logs" ; sleep 1
            echo "20" ; sleep 1
            echo "# Resetting cron jobs" ; sleep 1
            echo "50" ; sleep 1
            echo "This line will just be ignored" ; sleep 1
            echo "75" ; sleep 1
            echo "# Rebooting system" ; sleep 1
            echo "100" ; sleep 1
            ) |
            matedialog --progress \
              --title="Update System Logs" \
              --text="Scanning mail logs..." \
              --percentage=0

            if [ "$?" = -1 ] ; then
                    matedialog --error \
                      --text="Update canceled."
            fi

### Příklad dialogového okna s ukazatelem průběhu

MateDialog progress dialog example

## Dialogové okno s vkládáním údajů

K vytvoření dialogového okna s textovým vstupem použijte přepínač `--entry`. Aplikace MateDialog vrátí zadaný text na standardní výstup.

Dialogové okno s vkládáním údajů podporuje následující přepínače:

`--text`=`text`

- Určuje text, který se má v dialogovém okně zobrazit.

`--entry-text`=`text`

- Určujte text, který se má zobrazit ve vstupním poli dialogového okna.

`--hide-text`

- Skrýt text ve vstupním poli dialogového okna.

The following example script shows how to create a text entry dialog:

            #!/bin/sh

            if matedialog --entry \
            --title="Add an Entry" \
            --text="Enter your _password:" \
            --entry-text "password" \
            --hide-text
              then echo $?
              else echo "No password entered"
            fi

### Příklad dialogového okna na vkládání údajů

MateDialog text entry dialog example

## Dialogové okno s informačním textem

K vytvoření dialogového okna s informačním textem použijte přepínač `--text-info`.

Dialogové okno s informačním textem podporuje následující přepínače:

`--filename`=`název_souboru`

- Určuje soubor, ze kterého se má do dialogového okna načíst text.

`--editable`

- Povolit provádění úprav zobrazeného textu. Upravený text bude po zavření dialogového okna vrácen na standardní výstup.

The following example script shows how to create a text information dialog:

            #!/bin/sh

            FILE=`matedialog --file-selection \
              --title="Select a File"`

            case $? in
                     0)
                            matedialog --text-info \
                              --title=$FILE \
                              --filename=$FILE \
                              --editable 2>/tmp/tmp.txt;;
                     1)
                            echo "No file selected.";;
                    -1)
                            echo "No file selected.";;
            esac

### Příklad dialogového okna s informačním textem

MateDialog text information dialog example