GetNextDlgTabItem

Składnia

Argumenty

Argument	Opis
HWND hDlg	Uchwyt do okna dialogowego, które ma być przeszukane.
HWND hCtl	Uchwyt 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 bPrevious	Okreś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ę _{» WinAPI ♦} GetLastError.

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

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms645495(v=vs.85).aspx