Sdílet prostřednictvím

Posuvník

  • Článek

Tato část obsahuje informace o programovacích prvcích používaných s posuvníky. Okno může zobrazit datový objekt, například dokument nebo rastrový obrázek, který je větší než klientská oblast okna. Pokud je k dispozici posuvník , uživatel může v klientské oblasti posunout datový objekt, aby se zobrazily části objektu, které jsou nad hranicemi okna.

Přehledy

Námět Obsah
o posuvníků Posuvník se skládá ze stínované hřídele s tlačítkem šipky na každém konci a posuvníku (někdy označované jako palec) mezi tlačítky se šipkami.
pomocí posuvníků Při vytváření překrývajícího se, automaticky otevíraného nebo podřízeného okna můžete přidat standardní posuvníky pomocí funkce CreateWindowEx a zadáním WS_HSCROLL, WS_VSCROLLnebo obou stylů.

Funkce

Námět Obsah
EnableScrollBar Funkce EnableScrollBar povolí nebo zakáže jednu nebo obě šipky posuvníku.
GetScrollBarInfo Funkce GetScrollBarInfo načte informace o zadaném posuvníku.
GetScrollInfo Funkce GetScrollInfo načte parametry posuvníku, včetně minimální a maximální pozice posouvání, velikosti stránky a pozice posuvníku (palce).
GetScrollPos Funkce GetScrollPos načte aktuální pozici posuvníku (palce) na zadaném posuvníku. Aktuální pozice je relativní hodnota, která závisí na aktuální oblasti posouvání. Pokud je například oblast posouvání 0 až 100 a posuvník je uprostřed pruhu, aktuální pozice je 50. Poznámka: Funkce GetScrollPos je k dispozici pro zpětnou kompatibilitu. Nové aplikace by měly používat funkci GetScrollInfo.
GetScrollRange Funkce GetScrollRange načte aktuální minimální a maximální pozice posuvníku (palec). Poznámka: funkce GetScrollRange je k dispozici pouze z důvodu kompatibility. Nové aplikace by měly používat funkci GetScrollInfo.
scrollDC Funkce ScrollDC posune obdélník bitů vodorovně a svisle.
scrollWindow Funkce ScrollWindow posouvá obsah klientské oblasti zadaného okna. Poznámka: Funkce ScrollWindow je k dispozici pro zpětnou kompatibilitu. Nové aplikace by měly používat funkci ScrollWindowEx.
scrollWindowEx Funkce ScrollWindowEx posouvá obsah klientské oblasti zadaného okna.
SetScrollInfo Funkce SetScrollInfo nastaví parametry posuvníku, včetně minimální a maximální pozice posouvání, velikosti stránky a pozice posuvníku (palce). Funkce také překreslí posuvník, pokud je požadován.
SetScrollPos Funkce SetScrollPos nastaví pozici posuvníku (palce) v zadaném posuvníku a v případě potřeby překreslí posuvník tak, aby odrážel nové umístění posuvníku. Poznámka: funkce SetScrollPos je k dispozici kvůli zpětné kompatibilitě. Nové aplikace by měly používat funkci SetScrollInfo.
SetScrollRange Funkce SetScrollRange nastaví minimální a maximální pozice posuvníku pro zadaný posuvník. Poznámka: funkce SetScrollRange je k dispozici pro zpětnou kompatibilitu. Nové aplikace by měly používat funkci SetScrollInfo.
ShowScrollBar Funkce ShowScrollBar zobrazí nebo skryje zadaný posuvník.

Zprávy

Námět Obsah
SBM_ENABLE_ARROWS Aplikace odešle SBM_ENABLE_ARROWS zprávu, která povolí nebo zakáže jednu nebo obě šipky ovládacího prvku posuvníku.
SBM_GETPOS Zpráva SBM_GETPOS se odešle, aby se načetla aktuální pozice posuvníku ovládacího prvku posuvníku. Aktuální pozice je relativní hodnota, která závisí na aktuální oblasti posouvání. Pokud je například oblast posouvání 0 až 100 a posuvník je uprostřed pruhu, aktuální pozice je 50.
Aplikace by tuto zprávu neměly odesílat přímo. Místo toho by měli použít funkci GetScrollPos. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc. Aplikace, které implementují vlastní ovládací prvek posuvníku, musí na tyto zprávy reagovat, aby funkce GetScrollPos fungovala správně.
SBM_GETRANGE Zpráva SBM_GETRANGE se odešle, aby se načetly minimální a maximální hodnoty pozice pro ovládací prvek posuvníku.
Aplikace by tuto zprávu neměly odesílat přímo. Místo toho by měli použít funkci GetScrollRange. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc. Aplikace, které implementují vlastní ovládací prvek posuvníku, musí na tyto zprávy reagovat, aby funkce GetScrollRange fungovala správně.
SBM_GETSCROLLBARINFO Aplikace byla odeslána k načtení informací o zadaném posuvníku.
SBM_GETSCROLLINFO Zpráva SBM_GETSCROLLINFO se odešle, aby se načetly parametry posuvníku.
Aplikace by tuto zprávu neměly odesílat přímo. Místo toho by měli použít funkci GetScrollInfo. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc. Aplikace, které implementují vlastní ovládací prvek posuvníku, musí na tyto zprávy reagovat, aby funkce GetScrollInfo fungovala správně.
SBM_SETPOS Zpráva SBM_SETPOS se odešle k nastavení pozice posuvníku (palce) a v případě potřeby překreslete posuvník tak, aby odrážel nové umístění posuvníku.
Aplikace by tuto zprávu neměly odesílat přímo. Místo toho by měli použít funkci SetScrollPos. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc. Aplikace, které implementují vlastní ovládací prvek posuvníku, musí na tyto zprávy reagovat, aby funkce SetScrollPos fungovala správně.
SBM_SETRANGE Zpráva SBM_SETRANGE se odešle, aby se nastavily minimální a maximální hodnoty pozice pro ovládací prvek posuvníku.
Aplikace by tuto zprávu neměly odesílat přímo. Místo toho by měli použít funkci SetScrollRange. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc. Aplikace, které implementují vlastní ovládací prvek posuvníku, musí na tyto zprávy reagovat, aby funkce SetScrollRange fungovala správně.
SBM_SETRANGEREDRAW Aplikace odešle SBM_SETRANGEREDRAW zprávu do ovládacího prvku posuvníku, který nastaví minimální a maximální hodnoty pozice a překreslí ovládací prvek.
SBM_SETSCROLLINFO Zpráva SBM_SETSCROLLINFO se odešle, aby se nastavily parametry posuvníku.
Aplikace by tuto zprávu neměly odesílat přímo. Místo toho by měli použít funkci SetScrollInfo. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc. Aplikace, které implementují vlastní ovládací prvek posuvníku, musí na tyto zprávy reagovat, aby funkce SetScrollInfo fungovala správně.

Upozornění

Námět Obsah
WM_CTLCOLORSCROLLBAR Zpráva WM_CTLCOLORSCROLLBAR se odešle do nadřazeného okna ovládacího prvku posuvníku, když se má ovládací prvek vykreslit. Když na tuto zprávu odpovíte, nadřazené okno může pomocí kontextového úchytu zobrazení nastavit barvu pozadí ovládacího prvku posuvníku.
Okno obdrží tuto zprávu prostřednictvím funkce WindowProc.
WM_HSCROLL Zpráva WM_HSCROLL se odešle do okna, když dojde k události posouvání ve standardním vodorovném posuvníku okna. Tato zpráva se také odešle vlastníkovi ovládacího prvku vodorovného posuvníku, když v ovládacím prvku dojde k události posouvání.
Okno obdrží tuto zprávu prostřednictvím funkce WindowProc.
WM_VSCROLL Zpráva WM_VSCROLL se odešle do okna, když dojde k události posouvání ve standardním svislém posuvníku okna. Tato zpráva se také odešle vlastníkovi svislého ovládacího prvku posuvníku, když v ovládacím prvku dojde k události posouvání.
Okno obdrží tuto zprávu prostřednictvím funkce WindowProc.

Struktury

Námět Obsah
SCROLLBARINFO Struktura SCROLLBARINFO obsahuje informace o posuvníku.
SCROLLINFO Struktura SCROLLINFO obsahuje parametry posuvníku, které mají být nastaveny funkcí SetScrollInfo (nebo zprávou SBM_SETSCROLLINFO) nebo načtenou funkcí GetScrollInfo (nebo zprávou SBM_GETSCROLLINFO).

Konstanty

Námět Obsah
styly ovládacích prvků posuvníku Chcete-li vytvořit ovládací prvek posuvníku pomocí CreateWindow nebo CreateWindowEx funkce určit třídu SCROLLBAR, odpovídající styl okna konstanty a kombinaci následujících stylů ovládacích prvků posuvníku. Některé styly vytvářejí ovládací prvek posuvníku, který používá výchozí šířku nebo výšku. Při volání CreateWindow nebo CreateWindowEx však musíte vždy zadat souřadnice x a y a další rozměry posuvníku .