repo_zf1/documentation/manual/pl/module_specs/Zend_ProgressBar_Adapter_Console.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect3 id="zend.progressbar.adapter.console">
    <title>Zend_ProgressBar_Adapter_Console</title>

    <para>
        <classname>Zend_ProgressBar_Adapter_Console</classname> to adapter tekstowy przeznaczony
        do użytku z terminalem (konsolą, wierszem polecenia). Adapter potrafi automatycznie wykryć
        dostępną szerokość ale można również podać ją ręcznie. Oprócz tego można definiować
        elementy, jakie mają zostać pokazane oraz ich kolejność jak również sam styl wyświetlanego
        paska postępu.
    </para>

    <note>
        <title>Automatyczne rozpoznawanie szerokości konsoli</title>

        <para>
            W przypadku systemów *nix niezbędny dla tej funkcjonalności jest
            <code>shell_exec</code>. Na maszynach Windows szerokość terminala jest stała
            (wynosi 80 znaków) więc automatyczne rozpoznawanie szerokości nie jest potrzebne.
        </para>
    </note>

    <para>
        Opcje adaptera można ustawiać za pomocą metod <code>set*</code> albo przez podanie
        tablicy asocjacyjnej lub obiektu <classname>Zend_Config</classname> w pierwszym parametrze
        konstruktora. Dostępne opcje to:
    </para>

    <itemizedlist>
        <listitem>
            <para>
                <code>outputStream</code>: Strumień do którego będzie kierowany wynik.
                Domyślnie to STDOUT.
                Może być dowolnym strumieniem, np.: <code>php://stderr</code> lub ścieżką do pliku.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>width</code>: Liczba całkowita lub stała <constant>AUTO</constant>
                klasy <classname>Zend_Console_ProgressBar</classname>.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>elements</code>: Przyjmuje <constant>NULL</constant> dla domyślnej
                konfiguracji lub tablicę zawierającą co najmniej jedną z następujących wartości:
            </para>

            <itemizedlist>
                <listitem>
                    <para>
                        <constant>ELEMENT_PERCENT</constant>: Obecna wartość wyrażona procentowo
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>ELEMENT_BAR</constant>: Pasek pokazujący wartość procentową.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>ELEMENT_ETA</constant>: Automatycznie obliczany czas do
                        zakończenia operacji. Ten element jest pokazywany pierwszy raz z
                        opóźnieniem 5 sekund bo w krótszym czasie nie ma możliwości
                        obliczenia wiarygodnych wyników.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>ELEMENT_TEXT</constant>: Opcjonalna wiadomość stanu postępu
                        operacji.
                    </para>
                </listitem>
            </itemizedlist>
        </listitem>

        <listitem>
            <para>
                <code>textWidth</code>: Szerokość elementu <constant>ELEMENT_TEXT</constant>
                podana w znakach. Domyślnie to 20.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>charset</code>: Kodowanie elementu <constant>ELEMENT_TEXT</constant>.
                Domyślnie to utf-8.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>barLeftChar</code>: Łańcuch znaków używany jako lewa krawędź paska postępu.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>barRightChar</code>: Łańcuch znaków używany jako prawa krawędź paska postępu.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>barIndicatorChar</code>: Łańcuch znaków używany jako wskaźnik paska postępu.
                Może zostać pusty.
            </para>
        </listitem>
    </itemizedlist>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->