Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Opracował: Piotr DejaVu Szawdyński
Biblioteki C/C++

GetNextDlgTabItem

[funkcja] Zwraca uchwyt do pierwszej kontrolki posiadającej styl WS_TABSTOP, która następuje po (lub przed) określoną kontrolką.

Składnia

C/C++
#include <windows.h>

HWND WINAPI GetNextDlgTabItem(
HWND hDlg,
HWND hCtl,
BOOL bPrevious
);

Argumenty

ArgumentOpis
HWND hDlgUchwyt do okna dialogowego, które ma być przeszukane.
HWND hCtlUchwyt do kontrolki, która ma zostać używa jako punkt startowy wyszukiwania. W przypadku gdy wartość tego argumentu będzie wynosiła NULL to wywołanie funkcji zakończy się niepowodzeniem.
BOOL bPreviousOkreśla sposób szukania kontrolki w dialogu. Jeżeli wartość argumentu wynosi TRUE to funkcja szuka poprzedniej kontrolki w oknie dialogowym. W przypadku gdy wartość argumentu wynosi FALSE to funkcja szuka następnej kontrolki w oknie dialogowym.

Zwracana wartość

Jeżeli wywołanie funkcji się powiedzie to zwracany jest uchwyt HWND do poprzedniej bądź następnej kontrolki, która posiada styl WS_TABSTOP.

Funkcja zwraca wartość NULL w przypadku niepowodzenia. Aby uzyskać rozszerzone informacje o błędzie wywołaj funkcję » WinAPIGetLastError.

Opis szczegółowy

Funkcja zwraca uchwyt do pierwszej kontrolki posiadającej styl WS_TABSTOP, która następuje po (lub przed) określoną kontrolką.

Funkcja wyszukuje kontrolkę w porządku (bądź odwrotnym porządku) w którym kontrolki były tworzone w oknie dialogowym. Funkcja zwraca pierwszą kontrolkę, która zostanie znaleziona i spełnia następujące warunki:
  • kontrolka jest widoczna;
  • kontrolka nie jest wyłączona (posiada status kontrolki: enabled);
  • posiada styl WS_TABSTOP.
W przypadku gdy taka kontrolka nie istnieje, funkcja zwraca uchwyt przekazany poprzez argument hCtrl.

Jeżeli szukana kontrolka posiada styl WS_TABSTOP i jest ona oknem, które posiada styl WS_EX_CONTROLPARENT to system rekursywnie przeszuka również okno potomne.

Linki zewnętrzne