Megosztás a következőn keresztül:

Görgetősáv

  • Cikk

Ez a szakasz a görgetősávokkal használt programozási elemekről tartalmaz információkat. Az ablakok megjeleníthetnek egy olyan adatobjektumot, például egy dokumentumot vagy egy bitképet, amely nagyobb, mint az ablak ügyfélterülete. Ha görgetősáv, a felhasználó görgethet egy adatobjektumot az ügyfélterületen, hogy megtekinthesse az objektum azon részeit, amelyek az ablak határain túlnyúlnak.

Áttekintés

Téma Tartalomjegyzék
A görgetősávok A görgetősáv egy árnyékolt tengelyből áll, amelynek mindkét végén nyílgomb látható, és egy görgetőmező (más néven hüvelykujj) a nyílgombok között.
Görgetősávok használata Átfedésben lévő, előugró vagy gyermekablak létrehozásakor normál görgetősávokat adhat hozzá a CreateWindowEx függvénnyel, és megadhatja a WS_HSCROLL, WS_VSCROLLvagy mindkét stílust.

Funkciók

Téma Tartalomjegyzék
EnableScrollBar Az EnableScrollBar függvény engedélyezi vagy letilt egy vagy mindkét görgetősávnyilat.
GetScrollBarInfo A GetScrollBarInfo függvény lekéri a megadott görgetősáv adatait.
GetScrollInfo A GetScrollInfo függvény lekéri a görgetősáv paramétereit, beleértve a minimális és maximális görgetési pozíciót, az oldalméretet és a görgetődoboz pozícióját (hüvelykujj).
GetScrollPos A GetScrollPos függvény lekéri a görgetődoboz aktuális pozícióját (hüvelykujját) a megadott görgetősávon. Az aktuális pozíció egy relatív érték, amely az aktuális görgetési tartománytól függ. Ha például a görgetési tartomány 0 és 100 között van, és a görgetőmező a sáv közepén van, az aktuális pozíció 50. Megjegyzés: A GetScrollPos függvény visszamenőleges kompatibilitást biztosít. Az új alkalmazásoknak a GetScrollInfo függvényt kell használniuk.
GetScrollRange A GetScrollRange függvény lekéri a megadott görgetősáv aktuális minimális és maximális görgetőmező -pozícióit. Megjegyzés: A GetScrollRange függvény csak a kompatibilitás érdekében érhető el. Az új alkalmazásoknak a GetScrollInfo függvényt kell használniuk.
ScrollDC A ScrollDC függvény vízszintesen és függőlegesen görget egy bitből álló téglalapot.
ScrollWindow A ScrollWindow függvény görgeti a megadott ablak ügyfélterületének tartalmát. Megjegyzés: A ScrollWindow függvény a visszamenőleges kompatibilitás érdekében érhető el. Az új alkalmazásoknak a ScrollWindowEx függvényt kell használniuk.
ScrollWindowEx A ScrollWindowEx függvény görgeti a megadott ablak ügyfélterületének tartalmát.
SetScrollInfo A SetScrollInfo függvény beállítja a görgetősáv paramétereit, beleértve a minimális és maximális görgetési pozíciót, az oldalméretet és a görgetődoboz (hüvelykujj) pozícióját. A függvény szükség esetén újrarajzozza a görgetősávot is.
SetScrollPos A SetScrollPos függvény beállítja a görgetődoboz (hüvelykujj) pozícióját a megadott görgetősávban, és szükség esetén újrarajzolva a görgetősávot, hogy tükrözze a görgetődoboz új pozícióját. Megjegyzés: A SetScrollPos függvény a visszamenőleges kompatibilitás érdekében van megadva. Az új alkalmazásoknak a SetScrollInfo függvényt kell használniuk.
SetScrollRange A SetScrollRange függvény a megadott görgetősáv minimális és maximális görgetőmezőpozícióját állítja be. Megjegyzés: A SetScrollRange függvény a visszamenőleges kompatibilitás érdekében van megadva. Az új alkalmazásoknak a SetScrollInfo függvényt kell használniuk.
ShowScrollBar A ShowScrollBar függvény megjeleníti vagy elrejti a megadott görgetősávot.

Üzenetek

Téma Tartalomjegyzék
SBM_ENABLE_ARROWS Az alkalmazás elküldi a SBM_ENABLE_ARROWS üzenetet a görgetősáv-vezérlő egyik vagy mindkét nyílának engedélyezéséhez vagy letiltásához.
SBM_GETPOS A SBM_GETPOS üzenet a görgetősáv vezérlőelem görgetőmezőjének aktuális pozícióját kéri le. Az aktuális pozíció egy relatív érték, amely az aktuális görgetési tartománytól függ. Ha például a görgetési tartomány 0 és 100 között van, és a görgetőmező a sáv közepén van, az aktuális pozíció 50.
Az alkalmazások nem küldhetik közvetlenül ezt az üzenetet. Ehelyett a GetScrollPos függvényt kell használniuk. Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet. Az egyéni görgetősáv-vezérlőt implementáló alkalmazásoknak válaszolniuk kell ezekre az üzenetekre a GetScrollPos függvény megfelelő működéséhez.
SBM_GETRANGE A SBM_GETRANGE üzenet a görgetősáv vezérlőelem minimális és maximális pozícióértékeinek lekéréséhez lesz elküldve.
Az alkalmazások nem küldhetik közvetlenül ezt az üzenetet. Ehelyett a GetScrollRange függvényt kell használniuk. Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet. Az egyéni görgetősáv-vezérlőt implementáló alkalmazásoknak válaszolniuk kell ezekre az üzenetekre a GetScrollRange függvény megfelelő működéséhez.
SBM_GETSCROLLBARINFO Egy alkalmazás küldte a megadott görgetősávra vonatkozó információk lekéréséhez.
SBM_GETSCROLLINFO A rendszer elküldi a SBM_GETSCROLLINFO üzenetet a görgetősáv paramétereinek lekéréséhez.
Az alkalmazások nem küldhetik közvetlenül ezt az üzenetet. Ehelyett a GetScrollInfo függvényt kell használniuk. Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet. Az egyéni görgetősáv-vezérlőt implementáló alkalmazásoknak válaszolniuk kell ezekre az üzenetekre a GetScrollInfo függvény megfelelő működéséhez.
SBM_SETPOS A SBM_SETPOS üzenet a görgetődoboz (hüvelykujj) pozíciójának beállításához, illetve igény esetén a görgetősáv újraírásával tükrözi a görgetődoboz új pozícióját.
Az alkalmazások nem küldhetik közvetlenül ezt az üzenetet. Ehelyett a SetScrollPos függvényt kell használniuk. Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet. Az egyéni görgetősáv-vezérlőt implementáló alkalmazásoknak válaszolniuk kell ezekre az üzenetekre a SetScrollPos függvény megfelelő működéséhez.
SBM_SETRANGE A SBM_SETRANGE üzenet a görgetősáv vezérlőelem minimális és maximális pozícióértékének beállításához lesz elküldve.
Az alkalmazások nem küldhetik közvetlenül ezt az üzenetet. Ehelyett a SetScrollRange függvényt kell használniuk. Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet. Az egyéni görgetősáv-vezérlőt implementáló alkalmazásoknak válaszolniuk kell ezekre az üzenetekre a SetScrollRange függvény megfelelő működéséhez.
SBM_SETRANGEREDRAW Az alkalmazás elküldi a SBM_SETRANGEREDRAW üzenetet egy görgetősáv vezérlőelemnek a minimális és maximális pozícióértékek beállításához és a vezérlő újraírásához.
SBM_SETSCROLLINFO A rendszer elküldi a SBM_SETSCROLLINFO üzenetet a görgetősáv paramétereinek beállításához.
Az alkalmazások nem küldhetik közvetlenül ezt az üzenetet. Ehelyett a SetScrollInfo függvényt kell használniuk. Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet. Az egyéni görgetősáv-vezérlőt implementáló alkalmazásoknak válaszolniuk kell ezekre az üzenetekre a SetScrollInfo függvény megfelelő működéséhez.

Értesítések

Téma Tartalomjegyzék
WM_CTLCOLORSCROLLBAR A WM_CTLCOLORSCROLLBAR üzenet a görgetősáv-vezérlő szülőablakára kerül, amikor a vezérlő megrajzolódik. Az üzenet megválaszolásával a szülőablak a megjelenítési környezet fogópontjával beállíthatja a görgetősáv vezérlőelem háttérszínét.
Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet.
WM_HSCROLL A WM_HSCROLL üzenetet akkor küldi el a rendszer egy ablakba, amikor az ablak normál vízszintes görgetősávján görgetési esemény történik. Ez az üzenet egy vízszintes görgetősáv-vezérlő tulajdonosának is el lesz küldve, amikor görgetési esemény történik a vezérlőben.
Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet.
WM_VSCROLL A WM_VSCROLL üzenetet a rendszer egy ablakba küldi, amikor az ablak normál függőleges görgetősávján görgetési esemény történik. Ez az üzenet egy függőleges görgetősáv-vezérlő tulajdonosának is el lesz küldve, amikor görgetési esemény történik a vezérlőben.
Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet.

Struktúrák

Téma Tartalomjegyzék
SCROLLBARINFO A SCROLLBARINFO struktúra görgetősáv-információkat tartalmaz.
SCROLLINFO A SCROLLINFO struktúra olyan görgetősáv-paramétereket tartalmaz, amelyeket a SetScrollInfo függvény (vagy SBM_SETSCROLLINFO üzenet) állít be, vagy amelyeket a GetScrollInfo függvény (vagy SBM_GETSCROLLINFO üzenet) kér le.

Állandók

Téma Tartalomjegyzék
görgetősáv vezérlőstílusai Görgetősáv-vezérlő létrehozásához a CreateWindow vagy CreateWindowEx függvénnyel adja meg a SCROLLBAR osztályt, a megfelelő ablakstílus-állandókat és a következő görgetősáv-vezérlőstílusok kombinációját. Egyes stílusok létrehoznak egy görgetősáv-vezérlőt, amely alapértelmezett szélességet vagy magasságot használ. A CreateWindow vagy CreateWindowEx hívásakor azonban mindig meg kell adnia a görgetősáv x- és y koordinátáit, valamint a görgetősáv egyéb dimenzióit.