GetDlgItemInt

Funkcja GetDlgItemInt tłumaczy teksty kontroli określonej w oknie dialogowym wartość całkowitą.

(UINT GetDlgItemInt HWND  hDlg, / / dojście do okna dialogowegointnIDDlgItem, / / kontroli identyfikatorBOOL* lpTranslated,  / / wskazuje zmienna otrzymywać sukces/awarii / / wskaźnikBOOLbSigned / / określa, czy wartość jest podpisany lub niepodpisanych);
 

Parametry

hDlg

Dojście do okna dialogowego, który zawiera formant odsetek.

nIDDlgItem

Identyfikator elementu okna dialogowego, który określa formant, którego tekst jest przetłumaczona.

lpTranslated

Wskaźnik do zmiennej typu Boolean, która odbiera wartość sukces/Niepowodzenie funkcji. Wartość TRUE wskazuje sukcesu, FALSE wskazuje awarii.

Parametr ten jest opcjonalny: może mieć wartość NULL. W takim przypadku funkcja zwraca żadnych informacji o sukcesie lub niepowodzeniu.

bSigned

Określa, czy funkcja powinna zbadać tekst znak minus na początku i zwracają wartość całkowita, jeżeli zostanie znaleziony. TRUE określa, że powinny to być gotowe, FALSE, nie powinien.

Zwraca wartości

Jeśli funkcja, zmienna wskazywanego przez lpTranslated jest ustawiona na wartość TRUE, a wartość zwracana jest wartość przetłumaczonego tekstu formantu.

Jeśli funkcja zawiedzie, zmienna wskazywanego przez lpTranslated jest ustawiona na wartość FALSE, a wartość zwracany jest równa zero. Należy zauważyć, że od zera jest możliwe wartości przetłumaczony, wartość zwracany zero nie przez siebie wskazują awarii.

Jeśli lpTranslated ma wartość NULL, funkcja zwraca żadnych informacji o sukcesie lub niepowodzeniu.

Jeżeli parametr bSigned ma wartość TRUE, określając, że wartość, która ma być pobierana jest wartość całkowita oddać wartość zwracany do typu int . Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja GetDlgItemInt odczytuje tekst danego formantu, wysyłając kontroli komunikat WM_GETTEXT. Funkcja tłumaczy pobrane tekst oddzielania wszelkie dodatkowe spacje na początku tekstu, a następnie przekonwertować cyfr dziesiętnych. Funkcja zatrzymuje, tłumaczenie po osiągnięciu końca tekstu lub napotka znaki nienumeryczne.

Jeżeli parametr bSigned ma wartość PRAWDA, funkcja GetDlgItemInt szuka znak minus (-) na początku tekstu i tłumaczy tekst na wartość Liczba całkowita ze znakiem. W przeciwnym wypadku funkcja tworzy wartość Liczba całkowita bez znaku.

Funkcja GetDlgItemInt zwraca wartość zero, jeśli przetłumaczonych wartość jest większa niż INT_MAX (dla podpisanych numery) lub UINT_MAX (dla liczb bez znaku).

Systemu Windows CE: Ciągi tekstowe z więcej niż 48 znaków nie może być przetłumaczona.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie pola dialogowego, okno dialogowe pole funkcji, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Index