Over besturingselementen voor de trackbar

Een schuifbalk is een venster met een schuifregelaar (ook wel een duimgreep genoemd) in een kanaal en optionele streepmarkeringen. Wanneer de gebruiker de schuifregelaar verplaatst met behulp van de muis of de richtingstoetsen, verzendt de trackbar meldingsberichten om de wijziging aan te geven.

• Selectie Bereik
• berichten van de trackbar
• Trackbar Kennisgevingsberichten
• Standaard schuifbalk berichtverwerking
• Tooltips voor schuifbalk

Trackbars zijn handig als u wilt dat de gebruiker een discrete niet-ondertekende geheel getalwaarde of een reeks opeenvolgende niet-ondertekende gehele getallen in een bereik selecteert. U kunt bijvoorbeeld een schuifbalk gebruiken om de gebruiker de herhalingsfrequentie van het toetsenbord in te laten stellen door de schuifregelaar naar een bepaald maatstreepje te verplaatsen. In de volgende afbeelding ziet u een typische trackbar.

De schuifregelaar in een trackbar wordt verplaatst in stappen die u opgeeft wanneer u deze maakt. De waarden in dit bereik worden logische eenheden genoemd. Als u bijvoorbeeld opgeeft dat de trackbar logische eenheden moet hebben die variëren van 0 tot 5, kan de schuifregelaar slechts zes posities innemen: een positie aan de linkerkant van de trackbar en één positie voor elke stap in het bereik. Normaal gesproken wordt elk van deze posities geïdentificeerd met een maatstreepje; Het aantal maatstreepjes is echter willekeurig en kan kleiner zijn dan het aantal logische posities.

U maakt een trackbar met behulp van de functie CreateWindowEx, waarbij u de TRACKBAR_CLASS-vensterklasse opgeeft. Nadat u een trackbar hebt gemaakt, kunt u trackbar-berichten gebruiken om veel eigenschappen in te stellen en op te halen. Wijzigingen die u kunt aanbrengen, zijn onder andere het instellen van de minimum- en maximumpositie voor de schuifregelaar, het tekenen van maatstreepjes, het instellen van een selectiebereik en het verplaatsen van de schuifregelaar.

Selectiebereik

Als u een trackbar maakt met de stijl TBS_ENABLESELRANGE, kunt u een selectiebereik opgeven. De trackbar markeert het selectiebereik en toont driehoekige maatstreepjes aan het begin en einde, zoals te zien is in de volgende afbeelding.

Het selectiebereik van de trackbar heeft geen invloed op de functionaliteit ervan. Het is aan de toepassing om het bereik te implementeren. U kunt dit op een van de volgende manieren doen:

• Gebruik een selectiebereik om de gebruiker in staat te stellen maximum- en minimumwaarden in te stellen voor een bepaalde parameter. De gebruiker kan bijvoorbeeld de schuifregelaar naar een positie verplaatsen en vervolgens op een knop met het label Max klikken. De toepassing stelt vervolgens het selectiebereik in om de waarden weer te geven die door de gebruiker zijn gekozen.
• Beperk de verplaatsing van de schuifregelaar tot een vooraf bepaald subbereik binnen het besturingselement door de melding WM_HSCROLL of WM_VSCROLL te verwerken en de verplaatsing buiten het selectiebereik ongedaan te maken. U kunt dit bijvoorbeeld doen als het bereik van waarden dat beschikbaar is voor de gebruiker kan veranderen vanwege andere keuzes die de gebruiker heeft gemaakt of op basis van beschikbare resources.

Trackbar-berichten

De logische eenheden van een trackbar zijn de set aaneengesloten waarden die de trackbar kan vertegenwoordigen. Ze worden meestal gedefinieerd door het bereik van mogelijke waarden op te geven met een TBM_SETRANGE bericht zodra de trackbar is gemaakt. Toepassingen kunnen het bereik dynamisch wijzigen met behulp van TBM_SETRANGE, TBM_SETRANGEMAXof TBM_SETRANGEMIN.

Gebruik het TBM_GETPOS bericht om de positie van de schuifregelaar op te halen (dat wil gezegd de waarde die de gebruiker heeft gekozen). Als u de positie van de schuifregelaar wilt instellen, gebruikt u het TBM_SETPOS bericht.

In een trackbar worden automatisch markeringen aan het begin en einde weergegeven, tenzij u de stijl TBS_NOTICKS opgeeft. (In de Microsoft Visual Studio resource-editor betekent dit dat de eigenschap Maatstreepjes wordt ingesteld op False.) U kunt de stijl TBS_AUTOTICKS gebruiken om automatisch extra maatstreepjes op regelmatige afstanden op de schuifbalk weer te geven. Standaard geeft een TBS_AUTOTICKS trackbar een markering weer op elke stap binnen het bereik van de trackbar. Als u een ander interval wilt instellen voor de automatische maatstreepjes, stuurt u het bericht TBM_SETTICFREQ naar de trackbar. U kunt dit bericht bijvoorbeeld gebruiken om slechts 10 markeringen weer te geven in een bereik van 1 tot en met 100.

Stel de positie van één enkel maatstreepje in door het TBM_SETTIC bericht te verzenden. Een trackbar onderhoudt een matrix met DWORD-waarden waarmee de positie van elk maatstreepje wordt opgeslagen. De array bevat niet de eerste en laatste markeringen, die automatisch door de trackbar worden gemaakt. U kunt een index in deze matrix opgeven wanneer u het TBM_GETTIC bericht verzendt om de positie van het bijbehorende maatstreepje op te halen. U kunt ook het TBM_GETPTICS bericht verzenden om een aanwijzer naar de matrix op te halen. Het aantal elementen in de matrix is gelijk aan twee minder dan het aantal tikken dat wordt geretourneerd door het TBM_GETNUMTICS bericht. Dit komt doordat het aantal dat wordt geretourneerd door TBM_GETNUMTICS de eerste en laatste verdelingsstreepjes bevat, die niet zijn opgenomen in de array. Als u de fysieke positie van een maatstreepje wilt ophalen, verzendt u het TBM_GETTICPOS bericht in clientcoördinaten van het venster van de trackbar. Het TBM_CLEARTICS bericht verwijdert alle markeringen op de schuifbalk behalve de eerste en de laatste.

De lijngrootte van een trackbar bepaalt hoe ver de schuifregelaar wordt verplaatst als reactie op de invoer van de pijltoetsen op het toetsenbord, zoals de RECHTSPIJL- of OMLAAG-PIJL-toets. Als u de lijngrootte wilt ophalen of instellen, verzendt u de TBM_GETLINESIZE en TBM_SETLINESIZE berichten. De trackbar verzendt ook de TB_LINEUP en TB_LINEDOWN meldingscodes naar het bovenliggende venster wanneer de gebruiker op de pijltoetsen drukt.

Het paginaformaat van een trackbar bepaalt hoe ver de schuifregelaar wordt verplaatst als reactie op toetsenbordinvoer, zoals de toets PAGE UP of PAGE DOWN, of muisinvoer, zoals klikken in het trackbar-kanaal. Als u het paginaformaat wilt ophalen of instellen, verzendt u de TBM_GETPAGESIZE en TBM_SETPAGESIZE berichten. De trackbar verzendt ook de TB_PAGEUP- en TB_PAGEDOWN meldingscodes naar het bovenliggende venster wanneer er toetsenbord- of muisinvoer wordt ontvangen die door de pagina schuift. Zie Trackbar Notification Messagesvoor meer informatie.

Een toepassing kan berichten verzenden om de afmetingen van een trackbar op te halen. Het TBM_GETTHUMBRECT bericht haalt de begrenzingsrechthoek voor de schuifbalk op. Het TBM_GETTHUMBLENGTH bericht haalt de lengte van de schuifregelaar op. Het TBM_GETCHANNELRECT bericht haalt de omgrenzingsrechthoek voor het kanaal van de trackbar op, wat het gebied is waarover de schuifregelaar beweegt. Het bevat de highlight wanneer een bereik is geselecteerd. Als een trackbar de stijl TBS_FIXEDLENGTH heeft, kunt u het TBM_SETTHUMBLENGTH bericht verzenden om de lengte van de schuifregelaar te wijzigen.

U kunt het selectiebereik ophalen of instellen door berichten naar de trackbar te verzenden. Gebruik het TBM_SETSEL bericht om de begin- en eindposities van een selectie in te stellen. Als u alleen de beginpositie of alleen de eindpositie van een selectie wilt instellen, verzendt u een TBM_SETSELSTART of TBM_SETSELEND bericht. Als u de begin- of eindposities van een selectiebereik wilt ophalen, verzendt u een TBM_GETSELSTART of TBM_GETSELEND bericht. Als u een selectiebereik wilt wissen en de trackbar wilt herstellen naar het oorspronkelijke bereik, verzendt u het TBM_CLEARSEL bericht.

Meldingsberichten van de trackbar

Een trackbar informeert het bovenliggende venster over gebruikersacties door een WM_HSCROLL of WM_VSCROLL bericht te verzenden. Met een trackbar met de stijl TBS_HORZ worden WM_HSCROLL berichten verzonden. Met een trackbar met de stijl TBS_VERT worden WM_VSCROLL berichten verzonden. Het woord in lage volgorde van de wParam parameter van WM_HSCROLL of WM_VSCROLL bevat de meldingscode. Voor de TB_THUMBPOSITION- en TB_THUMBTRACK meldingscodes geeft het woord in hoge volgorde van de parameter wParam de positie van de schuifregelaar op. Voor alle andere meldingscodes is het woord in hoge volgorde nul; verzend het TBM_GETPOS bericht om de schuifregelaarpositie te bepalen. De parameter lParam is de ingang voor de trackbar.

Het systeem verzendt de TB_BOTTOM, TB_LINEDOWN, TB_LINEUP en TB_TOP meldingscodes alleen wanneer de gebruiker met een trackbar communiceert met behulp van het toetsenbord. De TB_THUMBPOSITION- en TB_THUMBTRACK meldingscodes worden alleen verzonden wanneer de gebruiker de muis gebruikt. De TB_ENDTRACK, TB_PAGEDOWN en TB_PAGEUP meldingscodes worden in beide gevallen verzonden. De volgende tabel bevat de trackbar-meldingscodes en de gebeurtenissen (virtuele-sleutelcodes of muis-gebeurtenissen) die ervoor zorgen dat de Virtual-Key Codesmeldingen worden verzonden.

Standaardverwerking van trackbar-berichten

In deze sectie wordt de verwerking van vensterberichten beschreven die door een trackbar worden uitgevoerd.

Knopinfo bijhouden

Een trackbar die is gemaakt met de stijl TBS_TOOLTIPS heeft een standaard tooltipelement. De tooltip blijft zichtbaar en geeft de huidige waarde weer terwijl de gebruiker de schuifregelaar sleept met de muis.

U kunt een nieuwe knoptekstcontrole toewijzen aan een trackbar door het TBM_SETTOOLTIPS bericht te verzenden. Als u het handvat wilt ophalen naar een toegewezen tooltipcontrole, gebruikt u het TBM_GETTOOLTIPS bericht.