GetNextDlgGroupItem

Funksjonen GetNextDlgGroupItem henter håndtaket på den første kontrollen i en gruppe med kontroller som kommer før (eller følger) den angitte kontrollen i en dialogboks.

() HWND GetNextDlgGroupItem HWND  hDlg, / / håndtere i dialogboksenHWNDhCtl, / / håndtere av kontrollBOOLbPrevious / / flag retning);
 

Parametere

hDlg
Identifiserer dialogboksen søkes.
hCtl
Identifiserer kontrollen som skal brukes som utgangspunkt for søket. Hvis denne parameteren er NULL, bruker funksjonen den siste (eller første) kontrollen i dialogboksen som utgangspunkt for søket.
bPrevious
Angir hvordan funksjonen skal søke gruppen med kontroller i dialogboksen. Hvis denne parameteren er sann, vil funksjonen søker etter den forrige kontrollen i gruppen. Hvis den er FALSE, søker funksjonen etter neste kontroll i gruppen.

Returverdier

Hvis GetNextDlgGroupItem er vellykket, er returverdien håndtaket på den forrige (eller neste) kontrollen i gruppen med kontroller.

Hvis funksjonen mislykkes, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Den GetNextDlgGroupItem -funksjonen søker etter kontroller i rekkefølge (eller omvendt rekkefølge) de ble opprettet i dialogboksen boksen malen. Den første kontrollen i gruppen må ha WS_GROUP-stil; alle andre kontroller i gruppen må være etter hverandre opprettet, og må ikke ha WS_GROUP-stil.

Når du søker etter den forrige kontrollen, returnerer funksjonen den første kontrollen den finner som er synlige og ikke deaktivert. Hvis kontrollen gitt av hCtl har stilen WS_GROUP, funksjonen midlertidig reverserer søk til å finne den første kontrollen har WS_GROUP-stil, deretter fortsetter søket i den opprinnelige retningen, går tilbake til den første kontrollen den finner det vil si synlig og ikke deaktivert eller retur hwndCtrl Hvis ingen slik kontroll er funnet.

Når du søker etter neste kontroll, funksjonen returnerer den første kontrollen den finner som vises, ikke er deaktivert, og gjør ikke har stilen WS_GROUP. Hvis det oppstår en kontroll som har stilen WS_GROUP, funksjonen reverserer søket, finner den første kontrollen har WS_GROUP-stil, og returnerer denne kontrollen hvis det er synlig og ikke deaktivert. Ellers funksjonen fortsetter søket i den opprinnelige retningen og returnerer den første kontrollen den finner som er synlige og ikke er deaktivert, eller returnerer hCtl Hvis ingen slik kontroll er funnet.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Oversikt over dialogboksen-boksene, dialogboksen fungerer, GetNextDlgTabItem

Index