Sdílet prostřednictvím


CWnd::ScrollWindowEx

Posune obsah oblasti okna klienta.

int ScrollWindowEx( 
   int dx, 
   int dy, 
   LPCRECT lpRectScroll, 
   LPCRECT lpRectClip, 
   CRgn* prgnUpdate, 
   LPRECT lpRectUpdate, 
   UINT flags  
);

Parametry

  • dx
    Určuje, v jednotkách zařízení, posouvání ve vodorovném směru.Tento parametr musí být záporná hodnota posun doleva.

  • dy
    Určuje, v jednotkách zařízení, svislý posuv.Tento parametr musí mít negativní hodnotu Posun nahoru.

  • lpRectScroll
    Odkazuje RECT struktury, která určuje část oblasti klienta posouvat.Pokud je tento parametr NULL, je posunul celé oblasti klienta.

  • lpRectClip
    Odkazuje RECT struktury, která určuje Obdélník ořezu posun.Tato struktura má přednost před obdélník odkazuje lpRectScroll .Jsou posunul pouze bitů uvnitř obdélníku.Bity mimo tento obdélník nejsou ovlivněny, i když jsou v lpRectScroll obdélník.Pokud je tento parametr NULL, bez ořezové proběhne na obdélník posuvníku.

  • prgnUpdate
    Identifikuje oblast upravená držet oblasti zrušena posuvem.Tento parametr může být NULL.

  • lpRectUpdate
    Odkazuje RECT struktury, která obdrží hranice zrušena posouváním obdélníku.Tento parametr může být NULL.

  • flags
    Může mít jeden z následujících hodnot:

    • SW_ERASE při s SW_INVALIDATE, vymaže oblasti nově platnost odesláním WM_ERASEBKGND do okna zprávy.

    • SW_INVALIDATE zruší platnost oblasti identifikované prgnUpdate po posouvání.

    • SW_SCROLLCHILDREN posouvá podřízených oken, které protínají obdélník odkazuje lpRectScroll o počet obrazových bodů v dx a dy.Windows odešle WM_MOVE zpráva podřízených oken, které protínají lpRectScroll , i když nejsou přesunuty.Stříška se poloha je posunul podřízeného okna a protíná kurzor obdélník obdélník posuvníku.

Vrácená hodnota

Vrácená hodnota je SIMPLEREGION (platnost pravoúhlou), COMPLEXREGION (platnost neobdélníkové oblasti; překrývající obdélníky), nebo NULLREGION (žádné neplatnou oblast), pokud je tato funkce úspěšná. v opačném případě je vrácena hodnota Při.

Poznámky

Tato funkce je podobná ScrollWindow funkce s některé další funkce.

Pokud SW_INVALIDATE a SW_ERASE nejsou zadány ScrollWindowEx posunutá mimo oblast, nezbavuje členské funkce.Pokud je nastaven buď tyto příznaky, ScrollWindowEx zruší platnost této oblasti.Oblast aktualizována až volání aplikace UpdateWindow členské funkce, volání RedrawWindow členské funkce (zadání RDW_UPDATENOW nebo RDW_ERASENOW), nebo načte WM_PAINT zprávy z fronty aplikace.

Pokud je okno WS_CLIPCHILDREN styl, vrácených plochy určené prgnUpdate a lpRectUpdate představují celkové plochy rolované okno, které musí být aktualizovány, včetně oblastí v podřízených oken, které je nutné aktualizovat.

Pokud SW_SCROLLCHILDREN je zadán příznak, systém Windows nebude správně aktualizovat obrazovky Pokud je součástí podřízené okno posunul.Část rolované podřízeného okna, která leží mimo zdrojového obdélníku nebudou smazána a nebude správně překresleny v jeho nové umístění.Použití DeferWindowPos funkce systému Windows k přesunutí podřízených oken, které nejsou zcela v rámci leží lpRectScroll obdélník.Kurzor se poloha, pokud SW_SCROLLCHILDREN je nastaven příznak a protíná stříška obdélník obdélník posuvníku.

Veškeré vstupní a výstupní souřadnice (pro lpRectScroll , lpRectClip , lpRectUpdate , a prgnUpdate) pokládány za v souřadnicích klienta, bez ohledu na to, zda má okno CS_OWNDC nebo CS_CLASSDC třídy styl.Použití LPtoDP a DPtoLP funkcí systému Windows převést z logické souřadnice a v případě potřeby.

Požadavky

Záhlaví: afxwin.h

Viz také

Referenční dokumentace

Třída CWnd

Graf hierarchie

CWnd::RedrawWindow

CDC::ScrollDC

CWnd::ScrollWindow

CWnd::UpdateWindow

DeferWindowPos

ScrollWindowEx