Standardowy element sterujący Liczba dziesiętna

Ten standardowy element sterujący tworzy pole, w którym użytkownik może wyświetlić lub wprowadzić liczbę zawierającą wartości dziesiętne.

Po dodaniu standardowego elementu sterującego Liczba dziesiętna do formatki lub widoku formatki ma on wartości domyślne i wygląda podobnie jak na następującym zrzucie ekranu w układzie.
Decimal stock control

Aby standardowy element sterujący Liczba dziesiętna zawierał wartość walutową, należy ustawić właściwość konfiguracyjną Waluta na tę walutę lub podać dla tej waluty kod ISO 4217 w polu Inna waluta. Domyślnie pole Waluta jest ustawione na wartość Inna, a pole Inna waluta jest puste, co oznacza, że standardowy element sterujący Liczba dziesiętna nie zawiera wartości walutowej.

Restrykcje i ograniczenia

Ograniczenia
Ostrzeżenie: Jeśli użytkownik wpisze treść, która nie jest poprawną liczbą, powiązany element danych ma wartość null, gdy użytkownik wyzwoli zdarzenie graniczne, takie jak kliknięcie przycisku. Gdy przepływ powróci do formatki, element sterujący będzie pusty. Wszystkie inne elementy sterujące powiązane z tym samym elementem danych również będą puste.
Biblioteka narzędziowa Formatki używa wersji pakietu Dojo, która nie obsługuje liczb arabskich lub hinduskich. Dlatego też w przypadku używania biblioteki narzędziowej Formatki nie można wprowadzać takich liczb w elemencie sterującym Liczba dziesiętna. Więcej informacji na ten temat zawiera rozdział dokumentacji pakietu Dojo Cultural conventions: Date, Number and Currency (Zwyczaje kulturowe: daty, liczby i waluty).

Powiązanie danych

Powiązanie danych elementu sterującego należy ustawić na karcie właściwości Ogólne.
Tabela 1. Powiązanie danych standardowego elementu sterującego Liczba dziesiętna
Opis powiązania Typ danych
Zawiera liczbę wyświetlaną przez ten standardowy element sterujący. Powiązane dane mogą być puste. Element sterujący Liczba dziesiętna zapisze liczbę wprowadzoną przez użytkownika. Liczba dziesiętna

Właściwości konfiguracyjne

Konfigurację elementu sterującego można ustawić lub zmodyfikować na karcie właściwości Konfiguracja.

Właściwości konfiguracji, które zawierają ikonę ikona wielkości ekranu, mogą 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ą. Jeśli używany jest edytor lokalny komponentu Process Designer, ustawiana jest wartość dużej wielkości ekranu. Inne wielkości ekranu dziedziczą tę wartość.

Tabela 2. Właściwości konfiguracyjne standardowego elementu sterującego Liczba dziesiętna
Właściwość konfiguracyjna Opis Typ danych
Currency Jeśli pole jest używane na potrzeby wartości walutowej, należy wybrać walutę ISO 4217. Dzięki ustawieniu waluty element sterujący Liczba dziesiętna używa odpowiedniego symbolu i formatowania dla danej waluty. Wartość domyślna to Inna. Łańcuch
Inna waluta Jeśli w polu Waluta zostanie ustawiona wartość Inna, należy pozostawić to pole puste na potrzeby wartości innych niż walutowa lub określić trzyliterowy kod ISO 4217 waluty, aby ustawić formatowanie i symbol.  
Symbol waluty Pozwala nadpisać symbol waluty ustawiony przy użyciu właściwości Waluta lub Inna waluta określonym symbolem. Wartością domyślną jest brak nadpisywania symbolu.

To pole jest przeznaczone do obsługi zmian symboli walut wprowadzanych przez kraje. Na przykład w 2010 roku Indie zmieniły znak swojej waluty rupii. Aby wyświetlić znak HTML dla rupii indyjskiej, w polu Symbol waluty należy wpisać wartość ₹.

 
Ukryj separatory tysięcy Tę opcję należy wybrać, aby ukryć znaki separatora używane do rozdzielania tysięcy. Pozwala ona na przykład wyświetlać wartość dziesięć tysięcy jako 10000 zamiast 10 000 lub 10,000. Wartością domyślną jest wyświetlanie separatorów. Wartość boolowska
Miejsca dziesiętneikona wielkości ekranu Ustawia maksymalną liczbę miejsc po znaku przecinka. Wartość domyślna to 2 miejsca (0,00). Wartość 0 oznacza brak miejsc po przecinku. Wartość ujemna oznacza brak restrykcji dotyczącej liczby miejsc po przecinku.
Ograniczenie: informacje na temat maksymalnej liczby miejsc dziesiętnych można znaleźć w opisie standardu IEEE 754.
Liczba całkowita
Wartość minimalna Ustawia wartość minimalną, jaką może zawierać element sterujący Liczba dziesiętna. Domyślnie nie ma ustawionej restrykcji dotyczącej wartości minimalnej. Liczba dziesiętna
Wartość maksymalna Ustawia wartość maksymalną, jaką może zawierać element sterujący Liczba dziesiętna. Domyślnie nie ma ustawionej restrykcji dotyczącej wartości maksymalnej. Liczba dziesiętna
Wielkość kroku Określa liczbę, o jaką wartość jest zwiększana lub zmniejszana po naciśnięciu przez użytkownika klawiszy strzałek w górę lub w dół albo po kliknięciu elementu sterującego przewijania. Element sterujący uzyska możliwość sterowania przewijaniem po określeniu wielkości kroku. Liczba dziesiętna

Przykład: dodanie waluty nie znajdującej się na liście

Opcja Waluta zawiera statyczną listę walut standardu ISO 4217. Lista pozwala na ustawienie większości walut, ale jest listą statyczną, podczas gdy lista walut standardu ISO 4217 jest dynamiczna. Na przykład na liście standardu ISO 4217 nie ma waluty bitcoin. Jeśli waluta bitcoin zostanie dodana do standardu ISO 4217, lista opcji Waluta nie zostanie automatyczne zaktualizowana. Aby obsłużyć sytuację, w której pożądana waluta nie znajduje się na liście opcji Waluta:
  1. Dodaj element sterujący Liczba dziesiętna do układu formatki lub widoku formatki.
  2. Otwórz stronę właściwości konfiguracyjnych. Domyślnie opcja Waluta jest ustawiona na wartość Inna. Ponieważ waluty bitcoin nie ma na liście walut zawartych w opcji Waluta, należy ustawić wartość Inna.
  3. W opcji Inna waluta wpisz kod standardu ISO 4217 dla waluty bitcoin. Określenie kodu waluty w opcji Waluta lub opcji Inna waluta spowoduje, że element sterujący Liczba dziesiętna nie będzie wyświetlać liczb, tylko wartość walutową.
  4. Jeśli używany jest symbol alternatywny do symbolu określonego przez standard ISO 4217 dla waluty bitcoin, wpisz ten symbol w polu Symbol waluty.