# MateDialog-ren eskuliburua

## Sarrera

MateDialog aplikazioak elkarrizketa-koadro sinple hauek sortzeko aukera ematen dizu:

- Egutegia

- Fitxategi-hautapena

- Zerrenda

- Jakinarazpenaren ikonoa

- Mezua

  - Errorea

  - Informazioa

  - Galdera

  - Abisua

- Progresio-Barra

- Testu-sarrera

- Testu-informazioa

## Erabilera

Script-ak idazterakoan, MateDialog erabil dezakezu erabiltzaileari grafikoki eragiten dioten elkarrizketa-koadro sinpleak sortzeko.

- Erabiltzaileagandik informazioa lortzeko, elkarrizketa-koadro bat sor dezakezu. Esaterako, erabiltzaileari eska diezaiokezu elkarrizketa-koadroko egutegitik data bat aukeratu dezan, edo elkarrizketa-koadroko fitxategi-hautapenetik fitxategi bat hauta dezan.

- Erabiltzaileari informazioa emateko, elkarrizketa-koadro bat sor dezakezu. Esaterako, eragiketa baten egoera adierazteko, elkarrizketa-koadroko progresio-barra erabil dezakezu, edo, erabiltzailea ohartarazteko, elkarrizketa-koadroko abisu bat.

When the user closes the dialog, MateDialog prints the text produced by the dialog to standard output.

MateDialogren komandoak idaztean, segurtatu argumentu bakoitza komatxo artean jartzen duzula.

For example, use:

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

Do not use:

    matedialog --calendar --title=Holiday Planner

Komatxo artean jartzen ez baduzu, ustekabeko emaitzak lortuko dituzu.

### Tekla bizkortzaileak

Teklatua erabiliz menu bateko edo elkarrizketa-koadro bateko komando bat sagua erabili gabe aukeratzeko modua eskaintzen dizu tekla bizkortzaileak. Menu edo elkarrizketa-koadroetako aukera bakoitzean azpimarratuta dagoen letra da bizkortzailea.

MateDialog elkarrizketa-koadroek tekla bizkortzaileen erabilera onartzen dute. Tekla bizkortzaile moduan erabiliko den karakterea zehazteko, jarri azpimarra karakterearen aurretik elkarrizketa-koadroko testuan. Adibide hauetan ikusten da nola zehaztu behar den 'C' letra tekla bizkortzaile gisa:

    "_Choose a name".

### Irteera-kodeak

MateDialog aplikazioak irteera-kode hauek itzultzen ditu:

Irteera-kodea | Azalpena
`0` | Erabiltzaileak Ados edo Itxi sakatu du.
`1` | Erabiltzaileak Utzi sakatu du edo leihoen funtzioak erabili ditu elkarrizketa-koadroa ixteko.
`-1` | Ustekabeko errorea gertatu da.
`5` | The dialog has been closed because the timeout has been reached.

### Aukera orokorrak

MateDialog aplikazioaren elkarrizketa-koadro guztiek aukera orokor hauek onartzen dituzte:

`--title`=`titulua`

- Elkarrizketa-koadroaren titulua zehazten du.

`--window-icon`=`ikonoaren bide-izena`

- Elkarrizketa-koadroaren leiho-markoetan bistaratu den ikonoa zehazten du. 4 ikono daude erabilgarri gako-hitz hauek sartuz gero - 'info', 'warning', 'question' eta 'error'.

`--width`=`zabalera`

- Elkarrizketa-koadroaren zabalera zehazten du.

`--height`=`altuera`

- Elkarrizketa-koadroaren altuera zehazten du.

`--timeout`=`timeout`

- Specifies the timeout in seconds after which the dialog is closed.

### Laguntza-aukerak

MateDialog aplikazioak laguntza-aukera hauek ematen ditu:

`--help`

- Laguntza-testu murriztua ematen du.

`--help-all`

- Elkarrizketa-koadro guztietarako laguntza-testu osoa bistaratzen du.

`--help-general`

- Elkarrizketa-koadroen aukera orokorretarako laguntza-testua bistaratzen du.

`--help-calendar`

- Egutegiaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-entry`

- Hasierako testuaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-error`

- Erroreen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-info`

- Informazioaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-file-selection`

- Fitxategi-hautapenaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-list`

- Zerrendaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-notification`

- Jakinarazpen-ikonoaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-progress`

- Progresio-barraren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-question`

- Galderen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-warning`

- Abisuen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-text-info`

- Testu-informazioaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.

`--help-misc`

- Aukera askotarako laguntza bistaratzen du.

`--help-gtk`

- GTK aukeretarako laguntza bistaratzen du.

### Askotariko aukerak

MateDialog aplikazioak askotariko laguntza-aukera hauek ere eskaintzen ditu:

`--about`

- MateDialog-ri buruz elkarrizketa-koadroa bistaratzen da eta hau aurkitu dezakezu: MateDialog bertsioari buruzko informazioa, copyrightaren informazioa eta garatzaileen informazioa.

`--version`

- MateDialogren bertsioaren zenbakia bistaratzen du.

### GTK+ aukerak

MateDialog aplikazioak GTKren aukera estandarrak onartzen ditu. GTKren aukerei buruzko informazio gehiago nahi izanez gero, exekutatu `matedialog -?` komandoa.

### Environment Variables

Normally, MateDialog detects the terminal window from which it was launched and keeps itself above that window. This behavior can be disabled by unsetting the `WINDOWID` environment variable.

## Egutegiaren elkarrizketa-koadroa

Use the `--calendar` option to create a calendar dialog. MateDialog returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date.

Egutegiaren elkarrizketa-koadroak aukera hauek onartzen ditu:

`--text`=`testua`

- Egutegiaren elkarrizketa-koadroan bistaratu den testua zehazten du.

`--day`=`eguna`

- Egutegiaren elkarrizketa-koadroan hautatu den eguna zehazten du. `eguna`k 1 eta 31 arteko zenbaki bat izan behar du (bi horiek barne).

`--month`=`hilabetea`

- Egutegiaren elkarrizketa-koadroan hautatu den hilabetea zehazten du. `hilabetea`k 1 eta 12 arteko zenbaki bat izan behar du (bi horiek barne).

`--year`=`urtea`

- Egutegiaren elkarrizketa-koadroan hautatu den urtea zehazten du.

`--date-format`=`formatua`

- Data hautatu ondoren egutegiaren elkarrizketa-koadroak itzuli duen formatua zehazten du. Formatu lehenetsia ezarpen lokalen araberakoa da. `strftime` funtzioak `formatua` onartu behar du, `%A %d/%m/%y` esate baterako.

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

### Egutegiaren elkarrizketa-koadroaren adibidea

MateDialog calendar dialog example

## Fitxategi-hautapenaren elkarrizketa-koadroa

Use the `--file-selection` option to create a file selection dialog. MateDialog returns the selected files or directories to standard output. The default mode of the file selection dialog is open.

Fitxategi-hautapenaren elkarrizketa-koadroak aukera hauek onartzen ditu:

`--filename`=`fitxategi-izena`

- Elkarrizketa-koadroa lehenengoz erakusten denean, fitxategi-hautapenaren elkarrizketa-koadroan hautatutako fitxategia edo direktorioa zehazten du.

`--multiple`

- Fitxategi-hautapenaren elkarrizketa-koadroan era askotako fitxategi-izenak hautatzeko aukera ematen du.

`--directory`

- Fitxategi-hautapenaren elkarrizketa-koadroan dauden direktorioak hautatzea soilik baimentzen du.

`--save`

- Fitxategi-hautapenaren elkarrizketa-koadroa gorde moduan jartzen du.

`--separator`=`bereizlea`

- Itzulitako fitxategi-izenen zerrenda zatitzeko erabiltzen den katea zehazten du.

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

### Fitxategi-hautapenaren elkarrizketa-koadroaren adibidea

MateDialog file selection dialog example

## Jakinarazpen-ikonoa

`--text`=`testua`

- Jakinarazpen-arean bistaratu den testua zehazten du.

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

            #!/bin/sh

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

### Jakinarazpen-ikonoaren adibidea

MateDialog notification icon example

## Zerrendaren elkarrizketa-koadroa

Use the `--list` option to create a list dialog. MateDialog returns the entries in the first column of text of selected rows to standard output.

Elkarrizketa-koadroaren datuak zutabez zutabe eta errenkadaz errenkada zehaztu behar dira. Elkarrizketa-koadroak sarrera estandarraren bidez jaso ditzake datuak. Sarrera bakoitza lerro berriko karaktere batekin bereizi behar da.

`--checklist` edo `--radiolist` aukerak erabiltzen badituzu, errenkada bakoitza 'TRUE' edo 'FALSE'-rekin hasi beharko da.

Zerrendaren elkarrizketa-koadroak aukera hauek onartzen ditu:

`--column`=`zutabea`

- Elkarrizketa-koadroan bistaratzen diren zutabe-goiburuak zehazten ditu. `--column` aukera zehaztu behar duzu elkarrizketa-koadroan bistaratzea nahi duzun zutabe bakoitzarentzat.

`--checklist`

- Zerrendaren elkarrizketa-koadroko lehen zutabeak kontrol-laukiak dituela adierazten du.

`--radiolist`

- Zerrendaren elkarrizketa-koadroko lehen zutabeak aukera-laukiak dituela zehazten du.

`--editable`

- Bistaratutako elementuak editatzeko aukera ematen du.

`--separator`=`bereizlea`

- Zerrendaren elkarrizketa-koadroak hautatutako sarrerak itzultzen dituenean zer kate erabiltzen den zehazten da.

`--print-column`=`zutabea`

- Zer zutabe inprimatu behar den zehazten du, hautapenaren arabera. Zutabe lehenetsia '1' da. Zerrendako zutabe guztiak inprimatzeko 'ALL' erabil daiteke.

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"

### Zerrendaren elkarrizketa-koadroaren adibidea

MateDialog list dialog example

## Mezuaren elkarrizketa-koadroak

MateDialog aplikazioak mezuaren lau elkarrizketa-koadro mota sor ditzake.

- Errorea

- Informazioa

- Galdera

- Abisua

Mota bakoitzean, erabili `--text` aukera, elkarrizketa-koadroan bistaratutako testua zehazteko.

### Erroreen elkarrizketa-koadroa

Erabili `--error` aukera, erroreen elkarrizketa-koadroa sortzeko.

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

              #!/bin/bash

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

#### Erroreen elkarrizketa-koadroaren adibidea

MateDialog error dialog example

### Informazioaren elkarrizketa-koadroa

Erabili `--info` aukera, informazioaren elkarrizketa-koadroa sortzeko.

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

              #!/bin/bash

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

#### Informazioaren elkarrizketa-koadroaren adibidea

MateDialog information dialog example

### Galderen elkarrizketa-koadroa

Erabili `--galdera` aukera, galderen elkarrizketa-koadroa sortzeko.

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

              #!/bin/bash

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

#### Galderen elkarrizketa-koadroaren adibidea

MateDialog question dialog example

### Abisuen elkarrizketa-koadroa

Erabili `--warning` aukera, abisuen elkarrizketa-koadroa sortzeko.

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

              #!/bin/bash

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

#### Abisuen elkarrizketa-koadroa

MateDialog warning dialog example

## Progresioaren elkarrizketa-koadroa

Erabili `--progress` aukera, progresioaren elkarrizketa-koadroa sortzeko.

MateDialog aplikazioak errenkadaz errenkada irakurtzen ditu sarrera estandarreko datuak. Errenkada bat aurrez #rekin finkatzen bada, testua errenkada horretako testuarekin eguneratzen da. Errenkada batek zenbaki bakar bat soilik badu, ehunekoa zenbaki horrekin eguneratzen da.

Progresioaren elkarrizketa-koadroak aukera hauek onartzen ditu:

`--text`=`testua`

- Progresioaren elkarrizketa-koadroan bistaratu den testua zehazten du.

`--percentage`=`ehunekoa`

- Progresioaren elkarrizketa-koadroan finkatu den hasierako ehunekoa zehazten du.

`--auto-close`

- % 100a lortu denean, progresioaren elkarrizketa-koadroa ixten du.

`--pulsate`

- Progresio-barra pultsuka luzatzen da sarrera estandarrean EOF karaktere bat irakurri arte.

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

### Progresioaren elkarrizketa-koadroaren adibidea

MateDialog progress dialog example

## Testu-sarreraren elkarrizketa-koadroa

Use the `--entry` option to create a text entry dialog. MateDialog returns the contents of the text entry to standard output.

Testu-sarreraren elkarrizketa-koadroak aukera hauek onartzen ditu:

`--text`=`testua`

- Testu-sarreraren elkarrizketa-koadroan bistaratu den testua zehazten du.

`--entry-text`=`testua`

- Testu-sarreraren elkarrizketa-koadroko sarrera-eremuan bistaratu den testua zehazten du.

`--hide-text`

- Testu-sarreraren elkarrizketa-koadroko sarrera-eremuan dagoen testua ezkutatzen du

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

### Testu-sarreraren elkarrizketa-koadroaren adibidea

MateDialog text entry dialog example

## Testu-informazioaren elkarrizketa-koadroa

Erabili `--text-info` aukera, testu-informazioaren elkarrizketa-koadroa sortzeko.

Testu-informazioaren elkarrizketa-koadroak aukera hauek onartzen ditu:

`--filename`=`fitxategi-izena`

- Testu-informazioaren elkarrizketa-koadroan kargaturiko fitxategia zehazten du.

`--editable`

- Allows the displayed text to be edited. The edited text is returned to standard output when the dialog is closed.

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

### Testu-informazioaren elkarrizketa-koadroaren adibidea

MateDialog text information dialog example