ScrollWindowEx

ScrollWindowEx işlevi belirtilen pencerenin istemci alanının içeriğini doğru kayar.

int ScrollWindowEx) hwnd  hWnd, / / idare penceresine kaydırırint dx, / / miktarı yatay kaydırmaint dy, / / miktarı dikey kaydırmaconst rect* prcScroll,  / / adres yapısı ile kaydırma dikdörtgenconst rect* prcClip,  / / adres yapısı ile küçük dikdörtgenhrgnhrgnUpdate, / / bölgeyi güncelleştirmek için kolulprectprcUpdate, / / adres yapısı için güncelleştirme dikdörtgenUINTbayraklar / / bayraklar kaydırma);
 

Parametreleri

hWnd
İstemci alanı kaydırılır yeri pencere kolu.
dx
Yatay kaydırma aygıtı birimler cinsinden belirtir. Bu parametre sola kaydırmak için negatif bir değer olmalıdır.
dy
Dikey kaydırma aygıtı birimler cinsinden belirtir. Bu parametre yukarı kaydırmak için negatif bir değer olmalıdır.
prcScroll
İşaretçi rect yapısı kaydırılır istemci alanının bölümü belirtme. Bu parametre null ise, tüm istemci alanının kaydırılır.
prcClip
Kırpma dikdörtgeni koordinatlarını içeren rect yapısı için işaretçi. Kırpma dikdörtgeni içinde yalnızca bit aygıt etkilenir. BITS iç dikdörtgen dışarıdan kaydırılır boyanmış; BITS dışarıya dikdörtgenin içine kaydırılır boyalı değil.
hrgnUpdate
Kaydırarak geçersiz kılınan bölge tutmak için değiştirilen bölgeye kolu. Bu parametre null olabilir.
prcUpdate
Kaydırarak geçersiz dikdörtgen sınırlarını alma rect yapısı için işaretçi. Bu parametre null olabilir.
bayraklar
Kaydırmayı denetleyen bayraklar belirtir. Bu parametre aşağıdaki değerlerden biri olabilir:
Değer Anlamı
SW_ERASE SW_INVALIDATE bayrağı belirtildiğinde penceresine wm_erasebkgnd ileti göndererek yeni geçersiz bölge siler.
SW_INVALIDATE Kaydırma sonra hrgnUpdate parametresi tarafından tanımlanan bölge geçersiz kılar.
SW_SCROLLCHILDREN PrcScroll parametresi tarafından işaret dikdörtgen kesiştiği tüm alt pencereleri doğru kayar. Alt pencereler dx ve dy parametreleri ile belirtilen piksel sayısıyla kaydırılır. Onlar hareket bile, sistem prcScroll dikdörtgen kesiştiği tüm alt pencereleri wm_move ileti gönderir.
SW_SMOOTHSCROLL Windows NT 5.0 ve sonraki sürümleri: Kesintisiz kaydırma kullanarak kaydırılır. Bayraklar parametresi HIWORD kısmı yumuşak kaydırma işlemi sürer ne kadar zaman belirtmek için kullanın.

Dönüş değerleri

İşlev başarılı olursa, SIMPLEREGION (dikdörtgen geçersiz kılınan bölgesi), COMPLEXREGION (dikdörtgen olmayan geçersiz kılınan bölge; dikdörtgenlerin örtüşen) veya NULLREGION (geçersiz kılınan bölgesi yok) the return value is.

İşlev başarısız olursa, dönüş değeri hata var. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

SW_INVALIDATE ve sw_erase bayrakları belirtilmezse, ScrollWindowEx dan kaydırılır alan kılmaz. Ya bu bayrak ayarlanırsa, ScrollWindowEx bu alanı geçersiz kılar. Alan uygulaması aramalar kadar güncelleştirilmez UpdateWindow fonksiyonu, çağrı RedrawWindow (rdw_updatenow veya rdw_erasenow bayrağı belirterek) işlevi veya Uygulama sırasından WM_PAINT iletiyi alır.

WS_CLIPCHILDREN stil penceresi varsa, toplam alanı, çocuk Windows'ta, kötü amaçlı olarak güncelleştirilmesi gereken alanlar dahil olmak üzere güncelleştirilmesi gereken kaydırılan penceresinin belirtilen hrgnUpdate ve prcUpdate tarafından döndürülen alanları temsil.

SW_SCROLLCHILDREN bayrağı belirtilmişse, alt pencere parçası kaydırılır, sistemin düzgün ekran güncelleştirmez. Kaydırılan çocuk penceresi kaynak dikdörtgen dışında kalan kısmı değil silinir ve yeni hedefine doğru çizilmez. Tamamen prcScrolltarafından belirtilen dikdörtgenin içinde yalan değil alt pencereleri taşımak için DeferWindowPos işlevini kullanın. İmleç SW_SCROLLCHILDREN bayrağı ayarlanmışsa ve şapka dikdörtgen kaydırma dikdörtgen kestiği konumlandırdığınız.

Tüm giriş ve çıkış koordinatlarını ( prcScroll, prcClip, prcUpdateve hrgnUpdate), pencere cs_owndc ya da cs_classdc sınıf stil olup ne olursa olsun istemci koordinatları olarak belirlenir. Gerekirse dönüştürmek ve mantıksal koordinatları için LPtoDP ve DPtoLP işlevleri kullanabilirsiniz.

Windows ce: Bayraklar parametresi SW_SCROLLCHILDREN desteklemiyor.

Dx ve dy parametreleri yalnızca biri sıfırdan farklı olabilir.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:WINUSER.h ilan etti.
İçe Library:User32.lib kullanma.

Ayrıca bkz:

Kaydırma çubuklarını genel bakış, kaydırma çubuğu işlevleri, DeferWindowPos, DPtoLP, LPtoDP, rect, RedrawWindow, UpdateWindow

Index