GetDlgCtrlID

Funkcja GetDlgCtrlID zwraca identyfikator określonego formantu.

int GetDlgCtrlID ( HWND  hwndCtl / / obsługi sterowania);
 

Parametry

hwndCtl
Identyfikuje formant.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest identyfikatorem formantu.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Nieprawidłowa wartość dla parametru hwndCtl spowoduje na przykład funkcję nie powiedzie się. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

GetDlgCtrlID akceptuje uchwyty okien podrzędnych, a także obsługuje formanty w oknach dialogowych. Aplikacja ustawia identyfikator okna podrzędnego, gdy tworzy okno przez przypisanie wartości identyfikatora do parametru hmenu podczas wywoływania funkcji CreateWindow lub funkcji CreateWindowEx.

Chociaż GetDlgCtrlID mogą zwrócić wartość, jeśli hwndCtl identyfikuje okno najwyższego poziomu, okien najwyższego poziomu nie może mieć identyfikatory i takie zwracany wartość nigdy nie jest prawidłowy.

Systemu Windows CE: Identyfikatory są prawidłowe dla okien podrzędnych tylko.

Identyfikator można ustawić przez przekazanie go jako parametr hMenu do funkcji funkcji CreateWindowEx . Go można również ustawić i pobierane przez wywołanie funkcji GetWindowLong i SetWindowLong z parametrem nIndex ustawiona na GWL_ID.

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, właściwości, funkcji CreateWindowEx, GetDlgItem

Index