Delen via

Schuifbalk

  • Artikel

Deze sectie bevat informatie over de programmeerelementen die worden gebruikt met schuifbalken. Een venster kan een gegevensobject, zoals een document of bitmap, weergeven dat groter is dan het clientgebied van het venster. Wanneer deze wordt geleverd met een schuifbalk, kan de gebruiker door een gegevensobject in het clientgebied schuiven om de gedeelten van het object te bekijken die buiten de randen van het venster liggen.

Overzichten

Onderwerp Inhoud
Over schuifbalken Een schuifbalk bestaat uit een gearceerde as met een pijlknop aan elk uiteinde en een schuifvak (ook wel een duim genoemd) tussen de pijlknoppen.
Schuifbalken gebruiken Wanneer u een overlappend, pop-upvenster of onderliggend venster maakt, kunt u standaard schuifbalken toevoegen met behulp van de functie CreateWindowEx en het opgeven van WS_HSCROLL, WS_VSCROLLof beide stijlen.

Functies

Onderwerp Inhoud
EnableScrollBar De functie EnableScrollBar schakelt een of beide schuifbalkpijlen in of uit.
GetScrollBarInfo- De functie GetScrollBarInfo haalt informatie over de opgegeven schuifbalk op.
GetScrollInfo- De functie GetScrollInfo haalt de parameters van een schuifbalk op, inclusief de minimale en maximale schuifposities, het paginaformaat en de positie van het schuifvak (duim).
GetScrollPos- De functie GetScrollPos haalt de huidige positie van het schuifvak (duim) op in de opgegeven schuifbalk. De huidige positie is een relatieve waarde die afhankelijk is van het huidige schuifbereik. Als het schuifbereik bijvoorbeeld 0 tot en met 100 is en het schuifvak zich midden in de balk bevindt, is de huidige positie 50. Opmerking: De functie GetScrollPos is beschikbaar voor achterwaartse compatibiliteit. Voor nieuwe toepassingen moet de functie GetScrollInfo worden gebruikt.
GetScrollRange De functie GetScrollRange haalt de huidige minimale en maximale schuifvakposities (duim) voor de opgegeven schuifbalk op. Opmerking: De functie GetScrollRange is alleen beschikbaar voor compatibiliteit. Voor nieuwe toepassingen moet de functie GetScrollInfo worden gebruikt.
ScrollDC- Met de functie ScrollDC schuift u een rechthoek met bits horizontaal en verticaal.
ScrollWindow- Met de functie ScrollWindow schuift u door de inhoud van het clientgebied van het opgegeven venster. Opmerking: De functie ScrollWindow is beschikbaar voor achterwaartse compatibiliteit. Nieuwe toepassingen moeten de functie ScrollWindowEx gebruiken.
ScrollWindowEx- De functie ScrollWindowEx schuift de inhoud van het clientgebied van het opgegeven venster.
SetScrollInfo De functie SetScrollInfo stelt de parameters van een schuifbalk in, inclusief de minimale en maximale schuifposities, het paginaformaat en de positie van het schuifvak (duim). De functie tekent ook de schuifbalk opnieuw, indien aangevraagd.
SetScrollPos Met de functie SetScrollPos stelt u de positie van het schuifvak (duim) in de opgegeven schuifbalk in en tekent u de schuifbalk opnieuw om de nieuwe positie van het schuifvak weer te geven. Opmerking: De functie SetScrollPos is beschikbaar voor achterwaartse compatibiliteit. Nieuwe toepassingen moeten gebruikmaken van de functie SetScrollInfo.
SetScrollRange De functie SetScrollRange stelt de minimale en maximale schuifvakposities voor de opgegeven schuifbalk in. Opmerking: De functie SetScrollRange is beschikbaar voor achterwaartse compatibiliteit. Nieuwe toepassingen moeten gebruikmaken van de functie SetScrollInfo.
ShowScrollBar De functie ShowScrollBar toont of verbergt de opgegeven schuifbalk.

Berichten

Onderwerp Inhoud
SBM_ENABLE_ARROWS Een toepassing verzendt het SBM_ENABLE_ARROWS bericht om een of beide pijlen van een schuifbalk besturingselement in of uit te schakelen.
SBM_GETPOS Het SBM_GETPOS bericht wordt verzonden om de huidige positie van het schuifvak van een schuifbalk op te halen. De huidige positie is een relatieve waarde die afhankelijk is van het huidige schuifbereik. Als het schuifbereik bijvoorbeeld 0 tot en met 100 is en het schuifvak zich midden in de balk bevindt, is de huidige positie 50.
Toepassingen mogen dit bericht niet rechtstreeks verzenden. In plaats daarvan moeten ze de functie GetScrollPos gebruiken. Een venster ontvangt dit bericht via de functie WindowProc. Toepassingen die een aangepast besturingselement voor de schuifbalk implementeren, moeten reageren op deze berichten voor de functie GetScrollPos om goed te kunnen functioneren.
SBM_GETRANGE Het SBM_GETRANGE bericht wordt verzonden om de minimum- en maximumpositiewaarden voor het besturingselement voor de schuifbalk op te halen.
Toepassingen mogen dit bericht niet rechtstreeks verzenden. In plaats daarvan moeten ze de functie GetScrollRange gebruiken. Een venster ontvangt dit bericht via de functie WindowProc. Toepassingen die een aangepast besturingselement voor de schuifbalk implementeren, moeten reageren op deze berichten zodat de functie GetScrollRange goed werkt.
SBM_GETSCROLLBARINFO Verzonden door een toepassing om informatie over de opgegeven schuifbalk op te halen.
SBM_GETSCROLLINFO Het SBM_GETSCROLLINFO bericht wordt verzonden om de parameters van een schuifbalk op te halen.
Toepassingen mogen dit bericht niet rechtstreeks verzenden. In plaats daarvan moeten ze de functie GetScrollInfo gebruiken. Een venster ontvangt dit bericht via de functie WindowProc. Toepassingen die een aangepast besturingselement voor de schuifbalk implementeren, moeten reageren op deze berichten voor de GetScrollInfo--functie om goed te kunnen werken.
SBM_SETPOS Het SBM_SETPOS bericht wordt verzonden om de positie van het schuifvak (duim) in te stellen en, indien gewenst, de schuifbalk opnieuw te tekenen om de nieuwe positie van het schuifvak weer te geven.
Toepassingen mogen dit bericht niet rechtstreeks verzenden. In plaats daarvan moeten ze de functie SetScrollPos gebruiken. Een venster ontvangt dit bericht via de functie WindowProc. Toepassingen die een aangepast besturingselement voor een schuifbalk implementeren, moeten reageren op deze berichten voor de SetScrollPos--functie om goed te kunnen werken.
SBM_SETRANGE Het SBM_SETRANGE bericht wordt verzonden om de minimum- en maximumpositiewaarden voor het besturingselement voor de schuifbalk in te stellen.
Toepassingen mogen dit bericht niet rechtstreeks verzenden. In plaats daarvan moeten ze de functie SetScrollRange gebruiken. Een venster ontvangt dit bericht via de functie WindowProc. Toepassingen die een aangepast besturingselement voor een schuifbalk implementeren, moeten reageren op deze berichten zodat de functie SetScrollRange goed werkt.
SBM_SETRANGEREDRAW Een toepassing verzendt het SBM_SETRANGEREDRAW bericht naar een schuifbalk besturingselement om de minimum- en maximumpositiewaarden in te stellen en het besturingselement opnieuw te tekenen.
SBM_SETSCROLLINFO Het SBM_SETSCROLLINFO bericht wordt verzonden om de parameters van een schuifbalk in te stellen.
Toepassingen mogen dit bericht niet rechtstreeks verzenden. In plaats daarvan moeten ze de functie SetScrollInfo gebruiken. Een venster ontvangt dit bericht via de functie WindowProc. Toepassingen die een aangepast besturingselement voor de schuifbalk implementeren, moeten reageren op deze berichten voor de SetScrollInfo- functie om goed te functioneren.

Meldingen

Onderwerp Inhoud
WM_CTLCOLORSCROLLBAR Het WM_CTLCOLORSCROLLBAR bericht wordt naar het bovenliggende venster van een schuifbalk besturingselement verzonden wanneer het besturingselement op het punt staat te worden getekend. Als u op dit bericht reageert, kan het bovenliggende venster de weergavecontextgreep gebruiken om de achtergrondkleur van het besturingselement voor de schuifbalk in te stellen.
Een venster ontvangt dit bericht via de functie WindowProc.
WM_HSCROLL Het WM_HSCROLL bericht wordt verzonden naar een venster wanneer er een scroll-gebeurtenis optreedt in de standaard horizontale schuifbalk van het venster. Dit bericht wordt ook verzonden naar de eigenaar van een horizontaal schuifbalk besturingselement wanneer er een scroll-gebeurtenis plaatsvindt in het besturingselement.
Een venster ontvangt dit bericht via de functie WindowProc.
WM_VSCROLL Het WM_VSCROLL bericht wordt verzonden naar een venster wanneer een scroll-gebeurtenis plaatsvindt in de standaard verticale schuifbalk van het venster. Dit bericht wordt ook verzonden naar de eigenaar van een verticaal schuifbalk besturingselement wanneer er een scroll-gebeurtenis plaatsvindt in het besturingselement.
Een venster ontvangt dit bericht via de functie WindowProc.

Structuren

Onderwerp Inhoud
SCROLLBARINFO De SCROLLBARINFO structuur bevat informatie over de schuifbalk.
SCROLLINFO- De SCROLLINFO structuur bevat schuifbalkparameters die moeten worden ingesteld door de functie SetScrollInfo (of SBM_SETSCROLLINFO bericht) of opgehaald door de functie GetScrollInfo (of SBM_GETSCROLLINFO bericht).

Constanten

Onderwerp Inhoud
schuifbalk Als u een schuifbalk besturingselement wilt maken met behulp van de functie CreateWindow of CreateWindowEx, geeft u de klasse SCROLLBAR, de juiste vensterstijlconstanten en een combinatie van de volgende schuifbalkbesturingsstijlen op. Sommige stijlen maken een schuifbalk besturingselement dat gebruikmaakt van een standaardbreedte of -hoogte. U moet echter altijd de x- en y-coördinaten en de andere dimensies van de schuifbalk opgeven wanneer u CreateWindow- of CreateWindowEx-aanroept.