Pasek postępu

Udostępnia prezentację graficzną informacji o postępie wykonywania konkretnej operacji.

Prezentacja graficzna widoku Pasek postępu natychmiast udostępnia użytkownikowi informacje o tym, ile zostało wypełnionych tabel, stron i pól wejściowych. Zwykle jest on używany jako nagłówek w formularzach WWW i kartach.

Właściwości konfiguracyjne

W obszarze Konfiguracja można ustawić lub zmodyfikować właściwości wyglądu i zachowania widoku. W obszarze Zdarzenia można ustawić właściwości konfiguracyjne formuły.

Wielkość ekranu: Właściwość konfiguracyjna, na której znajduje się ikona Rozmiarów ekranu obok nazwy właściwości, może mieć różne wartości dla każdej wielkości ekranu. Jeśli nie zostanie ustawiona wartość, wielkość ekranu dziedziczy wartość następnej większej wielkości ekranu jako swoją wartość domyślną.

Definicje kompozycji: Definicje kompozycji służą do podawania kolorów i stylów widoku oraz do określania jego wyglądu. W edytorze kompozycji można wyświetlić podgląd wyglądu i zachowania widoku. Patrz Kompozycje.

Właściwości konfiguracyjne wyglądu widoku Pasek postępu znajdują się w poniższej tabeli:

Tabela 1. Właściwości konfiguracyjne wyglądu elementu Pasek postępu
Właściwość konfiguracyjna wyglądu	Opis	Typ danych
Styl koloru	Służy do podawania stylu koloru wypełnienia paska postępu. Kolory odpowiadają zmiennym w podanej kompozycji. Domyślnym stylem koloru jest Domyślny (szary).	`TooltipColorStyle`
Pasiasty	Jeśli jest wybrana ta opcja, do paska postępu zostaną dodane paski.	`Boolean`
Aktywne	Jeśli jest wybrana ta opcja i opcja Pasiasty, paski na pasku postępu będą się poruszać.	`Boolean`
Promień	Służy do podawania promienia krzywizny narożników paska postępu, który jest wyrażany w pikselach (px) lub w firetach (em). Na przykład: `15px` lub `1em`. Jeśli liczba zostanie podana bez jednostki, będzie interpretowana jako liczba pikseli. Domyślnie promień zaokrąglenia krawędzi nie jest podawany.	`String`
Szerokość	Służy do podawania szerokości paska postępu, która jest wyrażana w pikselach (px), jako wartość procentowa (%) lub w firetach (em). Na przykład: `800px`, `80%` lub `50em`. Jeśli liczba zostanie podana bez jednostki, będzie interpretowana jako liczba pikseli.	`String`
Wysokość	Służy do podawania wysokości źródła, która jest wyrażana w pikselach (px) lub w firetach (em). Na przykład: `15px` lub `1em`. Jeśli liczba zostanie podana bez jednostki, będzie interpretowana jako liczba pikseli. Domyślnie wysokość nie jest podawana.	`String`

Właściwości konfiguracyjne zachowania widoku Pasek postępu znajdują się w poniższej tabeli:

Tabela 2. Właściwości konfiguracyjne zachowania elementu Pasek postępu
Właściwość konfiguracyjna zachowania	Opis	Typ danych
Wartość maksymalna	Służy do podawania maksymalnej liczby określającej postęp wykonywania operacji (nie należy jej mylić z właściwością Szerokość). Na przykład: `100`.	`Integer`

Przykład

W tym przykładzie widok Pasek postępu ma ustawione następujące właściwości konfiguracyjne:

Właściwości konfiguracyjne zachowania:
- Wartość maksymalna jest ustawiona na wartość 100.
Właściwości konfiguracyjne wyglądu:
- Opcja Styl kolorów jest ustawiona na wartość Info.
- Wybrana jest opcja Strypowane .
- Wybrano opcję Aktywne .
- Opcja Promień jest ustawiona na wartość 1.
- Opcja Szerokość jest ustawiona na wartość 25%.
Właściwości konfiguracyjne zdarzeń:
- W przypadku zdarzenia Przy ładowaniu metoda setProgress służy do ustawiania paska postępu na wartość 50 (me.setProgress(50);).

Te właściwości i ich wartości spowodują wyświetlenie jasnoniebieskiego paska postępu (pasiastego i animowanego), który jest do połowy wypełniony, ma zaokrąglone narożniki i zajmuje 25% szerokości strony.

Zdarzenia

We właściwościach Zdarzenia można ustawiać i modyfikować właściwości konfiguracyjne formuły i procedury obsługi zdarzeń widoku. Zdarzenia mogą być uruchamiane w sposób programowy lub w wyniku interakcji użytkownika z widokiem. Informacje na temat definiowania zdarzeń i kodu zdarzeń zawiera sekcja Zdarzenia zdefiniowane przez użytkownika.

Właściwości konfiguracyjne formuły widoku Pasek postępu znajdują się w poniższej tabeli:

Tabela 3. Właściwości konfiguracyjne formuły elementu Pasek postępu
Właściwość konfiguracyjna formuły	Opis	Typ danych
Formuła	Wyrażenie używane do wyznaczania postępu. Więcej informacji na temat formuł zawiera sekcja Formuły.	`String`

Widok Pasek postępu ma następujące typy procedur obsługi zdarzeń:

On load: aktywowano podczas ładowania strony.
On click: Aktywacja po kliknięciu paska postępu.

metody

W przypadku tego widoku są dostępne następujące metody:

setWidth(): ustawia szerokość paska postępu.
getWidth(): pobiera skonfigurowaną wielkość dla szerokości paska postępu (łącznie z jednostką).
setHeight(): ustawia wysokość paska postępu.
getHeight(): pobiera skonfigurowaną wielkość dla wysokości paska postępu (wraz z jednostką).
setColorStyle(): służy do ustawiania stylu kolorów paska postępu.
setRadius(): ustawia promień (roundness) paska postępu.
setProgress(): ustawia status postępu.
getProgress(): Pobiera status postępu.
setMaximum(): ustawia maksymalną wartość paska postępu.

Więcej informacji na temat korzystania z tych metod zawiera sekcja Interfejs API języka JavaScript w pasku postępu.

Zasoby dodatkowe

Więcej informacji na temat sposobu tworzenia formatki lub strony zawiera sekcja Budowanie formatek.
Informacje na temat standardowych właściwości (Ogólne, Konfiguracja, Pozycjonowanie, Widocznośći Atrybuty HTML) można znaleźć w sekcji Właściwości widoku.