Rullningslist

Det här avsnittet innehåller information om de programmeringselement som används med rullningslister. Ett fönster kan visa ett dataobjekt, till exempel ett dokument eller en bitmapp, som är större än fönstrets klientområde. När det finns en rullningslistkan användaren rulla ett dataobjekt i klientområdet för att visa de delar av objektet som sträcker sig utanför fönstrets kantlinjer.

Översikter

Ämne	Innehåll
om rullningslister	En rullningslist består av en skuggad axel med en pilknapp i varje ände och en rullningsruta (kallas ibland tumme) mellan pilknapparna.
använda rullningslister	När du skapar ett överlappande fönster, popup-fönster eller underordnat fönster kan du lägga till standardrullningslister med hjälp av funktionen CreateWindowEx och ange WS_HSCROLL, WS_VSCROLLeller båda formatmallarna.

Funktioner

Ämne	Innehåll
EnableScrollBar	Funktionen EnableScrollBar aktiverar eller inaktiverar en eller båda rullningslistpilarna.
GetScrollBarInfo	Funktionen GetScrollBarInfo hämtar information om den angivna rullningslisten.
GetScrollInfo	Funktionen GetScrollInfo hämtar parametrarna för en rullningslist, inklusive de lägsta och högsta rullningspositionerna, sidstorleken och rullningsrutans position (tumme).
GetScrollPos	Funktionen GetScrollPos hämtar den aktuella positionen för rullningsrutan (tumme) i den angivna rullningslisten. Den aktuella positionen är ett relativt värde som är beroende av det aktuella rullningsintervallet. Om rullningsintervallet till exempel är 0 till 100 och rullningsrutan är mitt i fältet är den aktuella positionen 50. Obs! Funktionen GetScrollPos tillhandahålls för bakåtkompatibilitet. Nya program bör använda funktionen GetScrollInfo.
GetScrollRange	Funktionen GetScrollRange hämtar de aktuella positionerna för minsta och högsta rullningsruta (tumme) för den angivna rullningslisten. Obs! Funktionen GetScrollRange tillhandahålls endast för kompatibilitet. Nya program bör använda funktionen GetScrollInfo.
ScrollDC-	Funktionen ScrollDC rullar en rektangel med bitar vågrätt och lodrätt.
ScrollWindow	Funktionen ScrollWindow rullar innehållet i det angivna fönstrets klientområde. Obs! Funktionen ScrollWindow tillhandahålls för bakåtkompatibilitet. Nya program bör använda funktionen ScrollWindowEx.
ScrollWindowEx	Funktionen ScrollWindowEx rullar innehållet i det angivna fönstrets klientområde.
SetScrollInfo	Funktionen SetScrollInfo anger parametrarna för en rullningslist, inklusive de lägsta och högsta rullningspositionerna, sidstorleken och rullningsrutans position (tumme). Funktionen ritar också om rullningslisten om det begärs.
SetScrollPos	Funktionen SetScrollPos anger rullningsrutans position (tumme) i den angivna rullningslisten och ritar om rullningslisten så att den återspeglar rullningsrutans nya position. Obs! funktionen SetScrollPos tillhandahålls för bakåtkompatibilitet. Nya program bör använda funktionen SetScrollInfo.
SetScrollRange	Funktionen SetScrollRange anger de lägsta och högsta rullningslistpositionerna för den angivna rullningslisten. Obs! funktionen SetScrollRange tillhandahålls för bakåtkompatibilitet. Nya program bör använda funktionen SetScrollInfo.
ShowScrollBar	Funktionen ShowScrollBar visar eller döljer den angivna rullningslisten.

Meddelanden

Ämne	Innehåll
SBM_ENABLE_ARROWS	Ett program skickar meddelandet SBM_ENABLE_ARROWS för att aktivera eller inaktivera en eller båda pilarna i en rullningslistkontroll.
SBM_GETPOS	Meddelandet SBM_GETPOS skickas för att hämta den aktuella positionen för rullningsrutan i en rullningslistkontroll. Den aktuella positionen är ett relativt värde som är beroende av det aktuella rullningsintervallet. Om rullningsintervallet till exempel är 0 till 100 och rullningsrutan är mitt i fältet är den aktuella positionen 50. Program bör inte skicka det här meddelandet direkt. I stället bör de använda funktionen GetScrollPos. Ett fönster tar emot det här meddelandet via funktionen WindowProc. Program som implementerar en anpassad rullningslistkontroll måste svara på dessa meddelanden för att funktionen GetScrollPos ska fungera korrekt.
SBM_GETRANGE	Meddelandet SBM_GETRANGE skickas för att hämta lägsta och högsta position för rullningslistkontrollen. Program bör inte skicka det här meddelandet direkt. I stället bör de använda funktionen GetScrollRange. Ett fönster tar emot det här meddelandet via funktionen WindowProc. Program som implementerar en anpassad rullningslistkontroll måste svara på dessa meddelanden för att funktionen GetScrollRange ska fungera korrekt.
SBM_GETSCROLLBARINFO	Skickas av ett program för att hämta information om den angivna rullningslisten.
SBM_GETSCROLLINFO	Meddelandet SBM_GETSCROLLINFO skickas för att hämta parametrarna för en rullningslist. Program bör inte skicka det här meddelandet direkt. I stället bör de använda funktionen GetScrollInfo. Ett fönster tar emot det här meddelandet via funktionen WindowProc. Program som implementerar en anpassad rullningslistkontroll måste svara på dessa meddelanden för att funktionen GetScrollInfo ska fungera korrekt.
SBM_SETPOS	Meddelandet SBM_SETPOS skickas för att ange rullningsrutans position (tumme) och, om så önskas, rita om rullningslisten för att återspegla den nya positionen för rullningsrutan. Program bör inte skicka det här meddelandet direkt. I stället bör de använda funktionen SetScrollPos. Ett fönster tar emot det här meddelandet via funktionen WindowProc. Program som implementerar en anpassad rullningslistkontroll måste svara på dessa meddelanden för att funktionen SetScrollPos ska fungera korrekt.
SBM_SETRANGE	Meddelandet SBM_SETRANGE skickas för att ange lägsta och högsta position för rullningslistkontrollen. Program bör inte skicka det här meddelandet direkt. I stället bör de använda funktionen SetScrollRange. Ett fönster tar emot det här meddelandet via funktionen WindowProc. Program som implementerar en anpassad rullningslistkontroll måste svara på dessa meddelanden för att funktionen SetScrollRange ska fungera korrekt.
SBM_SETRANGEREDRAW	Ett program skickar meddelandet SBM_SETRANGEREDRAW till en rullningslistkontroll för att ange lägsta och högsta position och för att rita om kontrollen.
SBM_SETSCROLLINFO	Meddelandet SBM_SETSCROLLINFO skickas för att ange parametrarna för en rullningslist. Program bör inte skicka det här meddelandet direkt. I stället bör de använda funktionen SetScrollInfo. Ett fönster tar emot det här meddelandet via funktionen WindowProc. Program som implementerar en anpassad rullningslistkontroll måste svara på dessa meddelanden för att funktionen SetScrollInfo ska fungera korrekt.

Meddelanden

Ämne	Innehåll
WM_CTLCOLORSCROLLBAR	Meddelandet WM_CTLCOLORSCROLLBAR skickas till det överordnade fönstret i en rullningslistkontroll när kontrollen är på väg att ritas. Genom att svara på det här meddelandet kan det överordnade fönstret använda visningskontexthandtaget för att ange bakgrundsfärgen för rullningslistkontrollen. Ett fönster tar emot det här meddelandet via funktionen WindowProc.
WM_HSCROLL	Meddelandet WM_HSCROLL skickas till ett fönster när en rullningshändelse inträffar i fönstrets standardräta rullningslist. Det här meddelandet skickas också till ägaren av en vågrät rullningslistkontroll när en rullningshändelse inträffar i kontrollen. Ett fönster tar emot det här meddelandet via funktionen WindowProc.
WM_VSCROLL	Meddelandet WM_VSCROLL skickas till ett fönster när en rullningshändelse inträffar i fönstrets lodräta standardrullningslist. Det här meddelandet skickas också till ägaren av en lodrät rullningslistkontroll när en rullningshändelse inträffar i kontrollen. Ett fönster tar emot det här meddelandet via funktionen WindowProc.

Strukturer

Ämne	Innehåll
SCROLLBARINFO	Strukturen SCROLLBARINFO innehåller information om rullningslister.
SCROLLINFO	Strukturen SCROLLINFO innehåller rullningslistparametrar som ska anges av funktionen SetScrollInfo (eller SBM_SETSCROLLINFO meddelande) eller hämtas av funktionen GetScrollInfo (eller SBM_GETSCROLLINFO meddelande).

Konstanter

Ämne

Innehåll

kontrollformat för rullningslister

Om du vill skapa en rullningslistkontroll med hjälp av funktionen CreateWindow eller CreateWindowEx anger du klassen SCROLLBAR, lämpliga konstanter i fönsterformat och en kombination av följande rullningslistkontrollformat. Vissa formatmallar skapar en rullningslistkontroll som använder en standardbredd eller standardhöjd. Du måste dock alltid ange x- och y-koordinaterna och de andra dimensionerna i rullningslisten när du anropar CreateWindow eller CreateWindowEx.