Kaydırma Çubukları Hakkında

Pencere, belge veya bit eşlem gibi pencerenin istemci alanından daha büyük bir veri nesnesi görüntüleyebilir. Kaydırma çubuğuyla birlikte sağlandığında, kullanıcı istemci alanındaki bir veri nesnesini kaydırarak nesnenin pencere kenarlıklarının ötesine uzanan bölümlerini görüntüleyebilir.

Kaydırma çubukları, istemci alanının içeriğinin pencerenin kenarlıklarının ötesine genişletildiği herhangi bir pencereye eklenmelidir. Kaydırma çubuğunun yönü, kullanıcı kaydırma çubuğunu çalıştırdığında kaydırmanın hangi yönde gerçekleşeceğini belirler. Yatay kaydırma çubuğu, kullanıcının pencerenin içeriğini sola veya sağa kaydırmasına olanak tanır. Dikey kaydırma çubuğu, kullanıcının içeriği yukarı veya aşağı kaydırmasına olanak tanır.

Bu bölümde aşağıdaki konular ele alınıyor.

• Kaydırma Çubuğu Bölümleri
• Standart Kaydırma Çubukları ve Kaydırma Çubuğu Denetimleri
• Kaydırma Kutusu Konumu ve Kaydırma Aralığı
• Kaydırma Çubuğu Görünürlüğü
• Kaydırma Çubuğu İstekleri
• Kaydırma Çubuğu için Klavye Arabirimi
• İstemci Alanını Kaydırma
• Kaydırma Çubuğu Renkleri ve Ölçümleri

Kaydırma Çubuğunun Bölümleri

Kaydırma çubuğu, her ucunda ok düğmesi bulunan gölgeli bir milden ve ok düğmeleri arasında kaydırma kutusundan (bazen başparmak olarak adlandırılır) oluşur. Kaydırma çubuğu, pencerenin istemci alanındaki bir veri nesnesinin genel uzunluğunu veya genişliğini temsil eder; kaydırma kutusu, nesnenin istemci alanında görünen bölümünü temsil eder. Kullanıcı bir veri nesnesini kaydırıp farklı bir bölümünü görüntülemek için her kaydırışında kaydırma kutusunun konumu değişir. Sistem ayrıca bir kaydırma çubuğunun kaydırma kutusunun boyutunu, tüm veri nesnesinin şu anda pencerede hangi bölümünün görünür olduğunu gösterecek şekilde ayarlar. Nesnenin çoğu görünür durumdaysa, kaydırma kutusu kaydırma çubuğu milinin büyük bölümünü kaplar. Benzer şekilde, nesnenin yalnızca küçük bir kısmı görünür durumdaysa, kaydırma kutusu kaydırma çubuğu milinin küçük bir bölümünü kaplar.

Kullanıcı, ok düğmelerinden birine tıklayarak, gölgeli kaydırma çubuğu milindeki alana tıklayarak veya kaydırma kutusunu sürükleyerek pencerenin içeriğini kaydırır. Kullanıcı bir ok düğmesine tıkladığında, uygulama içeriği bir birim (genellikle tek bir satır veya sütun) kaydırıyor. Kullanıcı gölgeli alanlara tıkladığında, uygulama içeriği bir pencere kaydırır. Kullanıcı kaydırma kutusunu sürüklediğinde oluşan kaydırma miktarı, kullanıcının kaydırma kutusunu sürükleme mesafesine ve kaydırma çubuğunun kaydırma aralığına bağlıdır. Kaydırma aralığı hakkında daha fazla bilgi için bkz. Kaydırma Kutusu Konumu ve Kaydırma Aralığı.

Aşağıdaki ekran görüntüsünde, Windows Vista'da görünebilecekleri için dikey ve yatay kaydırma çubuklarıyla zengin bir düzenleme denetimi gösterilmektedir. Ekran görüntüsü alındığında fare işaretçisi üzerine geldiğinden dikey kaydırma çubuğu şu anda "sıcak" durumdadır.

Zengin düzenleme denetiminin

Standart Kaydırma Çubukları ve Kaydırma Çubuğu Denetimleri

Kaydırma çubuğu, bir pencereye standart kaydırma çubuğu veya kaydırma çubuğu denetimi olarak eklenir. Standart kaydırma çubuğu, pencerenin istemci olmayan alanında bulunur. Pencere ile birlikte oluşturulur ve pencere açıldığında görüntülenir. Standart kaydırma çubuğunun tek amacı, kullanıcının istemci alanının tüm içeriğini görüntülemek için kaydırma istekleri oluşturmasını sağlamaktır. Pencereyi oluştururken WS_HSCROLL, WS_VSCROLLveya her iki stili belirterek pencereye standart bir kaydırma çubuğu ekleyebilirsiniz. WS_HSCROLL stili, istemci alanının en altına yerleştirilmiş yatay bir kaydırma çubuğu oluşturur. WS_VSCROLL stili, istemci alanının sağında konumlandırılmış bir dikey kaydırma çubuğu oluşturur. SM_CXHSCROLL ve SM_CYHSCROLL sistem ölçüm değerleri, standart yatay kaydırma çubuğunun genişliğini ve yüksekliğini tanımlar. SM_CXVSCROLL ve SM_CYVSCROLL değerleri, standart dikey kaydırma çubuğunun genişliğini ve yüksekliğini tanımlar. Standart kaydırma çubuğu ilişkili penceresinin bir parçasıdır ve bu nedenle kendi pencere tutamacına sahip değildir.

Kaydırma çubuğu denetimi, SCROLLBAR pencere sınıfına ait bir denetim penceresidir. Kaydırma çubuğu denetimi görünür ve standart kaydırma çubuğu gibi çalışır, ancak ayrı bir penceredir. Ayrı bir pencere olarak, kaydırma çubuğu denetimi doğrudan giriş odağını alır. Standart kaydırma çubuğunun aksine, kaydırma çubuğu denetiminin yerleşik klavye arabirimi de vardır.

Tek bir pencerede gerektiği kadar kaydırma çubuğu denetimi kullanabilirsiniz. Kaydırma çubuğu denetimi oluşturduğunuzda, kaydırma çubuğunun boyutunu ve konumunu belirtmeniz gerekir. Ancak, kaydırma çubuğu denetiminin penceresi yeniden boyutlandırılabilirse, pencerenin boyutu her değiştiğinde kaydırma çubuğunun boyutuna yönelik ayarlamalar yapılmalıdır.

Standart kaydırma çubuğu kullanmanın avantajı, sistemin kaydırma çubuğunu oluşturması ve boyutunu ve konumunu otomatik olarak ayarlamasıdır. Ancak standart kaydırma çubukları bazen çok kısıtlayıcı olabilir. Örneğin, bir istemci alanını çeyreklere bölmek ve her çeyreğin içeriğini denetlemek için ayrı bir kaydırma çubuğu kümesi kullanmak istediğinizi varsayalım. Belirli bir pencere için yalnızca bir kaydırma çubuğu kümesi oluşturabildiğiniz için standart kaydırma çubuklarını kullanamazsınız. Bunun yerine kaydırma çubuğu denetimlerini kullanın, çünkü pencereye istediğiniz kadar çok denetim ekleyebilirsiniz.

Uygulamalar, bir pencerenin içeriğini kaydırmak dışında amaçlar için kaydırma çubuğu denetimleri sağlayabilir. Örneğin, ekran koruyucu uygulaması grafiklerin ekranda taşınma hızını ayarlamak için bir kaydırma çubuğu sağlayabilir.

Kaydırma çubuğu denetiminin, kaydırma çubuğunun yönünü ve konumunu denetlemeye yönelik bir dizi stili olabilir. Kaydırma çubuğu denetimi oluşturmak için createWindowExişleviniçağırdığınızda istediğiniz stilleri belirtirsiniz. Stillerden bazıları, varsayılan genişlik veya yükseklik kullanan bir kaydırma çubuğu denetimi oluşturur. Ancak, her zaman x ve y koordinatlarını ve kaydırma çubuğunun diğer boyutlarını belirtmeniz gerekir.

Kaydırma çubuğu denetim stilleri tablosu için bkz. Kaydırma Çubuğu Denetim Stilleri.

Kaydırma Kutusu Konumu ve Kaydırma Aralığı

Kaydırma kutusunun konumu tamsayı olarak gösterilir; kaydırma çubuğunun yatay veya dikey olmasına bağlı olarak kaydırma çubuğunun sol veya üst ucuna göre değişir. Konum, kaydırma aralığının en düşük ve en yüksek değerleri içinde olmalıdır. Örneğin, 0 ile 100 arasında bir kaydırma çubuğunda, 50 konumu ortadadır ve kalan konumlar kaydırma çubuğu boyunca eşit olarak dağıtılır. İlk aralık kaydırma çubuğuna bağlıdır. Standart kaydırma çubuklarının başlangıç aralığı 0 ile 100 arasındadır; kaydırma çubuğu denetimleri, denetim oluşturulduğunda açık bir aralık sağlamadığınız sürece boş bir aralığa sahiptir (hem minimum hem de maksimum değerler sıfırdır). Aralığı istediğiniz zaman değiştirebilirsiniz. Aralık değerlerini ayarlamak için SetScrollInfo işlevini ve geçerli aralık değerlerini almak için GetScrollInfoişlevinikullanabilirsiniz.

Uygulama genellikle kaydırma aralığını uygun tamsayılara ayarlayarak kaydırma kutusu konumunu kaydırılacak veri nesnesine karşılık gelen bir değere çevirmeyi kolaylaştırır. Örneğin, bir uygulamanın bir kerede yalnızca 16 satır gösterebilen bir pencerede metin dosyasının 260 satırı görüntülemesi gerekiyorsa, dikey kaydırma çubuğu aralığı 1 ile 244 arasında ayarlanabilir. Kaydırma kutusu 1 konumundaysa, ilk satır pencerenin en üstünde olur. Kaydırma kutusu 244 konumundaysa, pencerenin en altında son satır (satır 260) yer alır. Bir uygulama minimumdan küçük veya maksimumdan daha büyük bir konum değeri belirtmeye çalışırsa, bunun yerine en düşük veya en yüksek kaydırma aralığı değeri kullanılır.

Kaydırma çubuğu için sayfa boyutu ayarlayabilirsiniz. sayfa boyutu, geçerli boyutuna göre sahip penceresinin istemci alanına sığabilecek veri birimi sayısını temsil eder. Örneğin, istemci alanı 16 satır metin barındırabiliyorsa, uygulama sayfa boyutunu 16 olarak ayarlar. Sistem, kaydırma kutusunun boyutunu ayarlamak için sayfa boyutunu, kaydırma çubuğu milinin kaydırma aralığı ve uzunluğuyla birlikte kullanır. Kaydırma çubuğu içeren bir pencere yeniden boyutlandırılırken, uygulamanın sayfa boyutunu ayarlamak için SetScrollInfo işlevini çağırması gerekir. Uygulama, gönderen GetScrollInfo işlevini çağırarak geçerli sayfa boyutunu alabilir.

Kaydırma çubuğu aralığı ile veri nesnesi arasında yararlı bir ilişki kurmak için, veri nesnesinin boyutu her değiştiğinde uygulamanın aralığı ayarlaması gerekir.

Kullanıcı kaydırma çubuğunu kaydırma çubuğuna taşırken, kaydırma çubuğu kaydırma kutusu konumunu kaydırma aralığında tamsayı olarak bildirir. Konum en düşük değerse, kaydırma kutusu dikey kaydırma çubuğunun en üstünde veya yatay kaydırma çubuğunun sol ucundadır. Konum maksimum değerse, kaydırma kutusu dikey kaydırma çubuğunun en altında veya yatay kaydırma çubuğunun sağ ucundadır.

Kaydırma çubuğunun bildirebileceği maksimum değer (maksimum kaydırma konumu) sayfa boyutuna bağlıdır. Kaydırma çubuğunun sayfa boyutu birden büyükse, maksimum kaydırma konumu maksimum aralık değerinden küçüktür. En yüksek kaydırma konumunu hesaplamak için aşağıdaki formülü kullanabilirsiniz:

MaxScrollPos = MaxRangeValue - (PageSize - 1) 

Uygulamanın kaydırma kutusunu bir kaydırma çubuğunda hareket ettirmesi gerekir. Kullanıcı kaydırma çubuğunda kaydırma isteğinde bulunsa da, kaydırma çubuğu kaydırma kutusu konumunu otomatik olarak güncelleştirmez. Bunun yerine, isteği üst pencereye geçirir ve bu pencere verileri kaydırmalı ve kaydırma kutusu konumunu güncelleştirmelidir. Uygulama, kaydırma kutusu konumunu güncelleştirmek için SetScrollInfoişlevini kullanır; aksi takdirde, SetScrollPos işlevini kullanır. Kaydırma kutusu hareketini denetlediğinden, uygulama kaydırma kutusunu kaydırılan veriler için en uygun olan artışlarla taşıyabilir.

Kaydırma Çubuğu Görünürlüğü

Eşit minimum ve maksimum değerler belirtildiğinde sistem standart kaydırma çubuğunu gizler ve devre dışı bırakır. Ayrıca, kaydırma çubuğunun tüm kaydırma aralığını içeren bir sayfa boyutu belirtirseniz sistem standart bir kaydırma çubuğunu gizler ve devre dışı bırakır. Bu, istemci alanının içeriği için gerekli olmadığında kaydırma çubuğunu geçici olarak gizlemenin yoludur. Kaydırma çubuğu gizlendiğinde kaydırma isteğinde bulunmaya gerek yoktur. Sistem, kaydırma çubuğunu etkinleştirir ve minimum ve maksimum değerleri eşit olmayan değerlere ayarladığınızda ve sayfa boyutu kaydırma aralığının tamamını içermediğinde yeniden gösterir. ShowScrollBar işlevi, kaydırma çubuğunu gizlemek veya göstermek için de kullanılabilir. Kaydırma çubuğunun aralığını, sayfa boyutunu veya kaydırma kutusu konumunu etkilemez.

EnableScrollBar işlevi, kaydırma çubuğunun bir veya her iki okunu devre dışı bırakmak için kullanılabilir. Bir uygulama devre dışı bırakılmış okları gri olarak görüntüler ve kullanıcı girişine yanıt vermez.

Kaydırma Çubuğu İstekleri

Kullanıcı, kaydırma çubuğunun çeşitli bölümlerine tıklayarak kaydırma isteklerinde bulunur. Sistem, isteği belirtilen pencereye WM_HSCROLL veya WM_VSCROLL iletisi biçiminde gönderir. Yatay kaydırma çubuğu WM_HSCROLL iletisini gönderir; dikey kaydırma çubuğu WM_VSCROLL iletisini gönderir. Her ileti, kullanıcının eylemine, kaydırma çubuğunun tutamacının (yalnızca kaydırma çubuğu denetimleri) ve bazı durumlarda kaydırma kutusunun konumuna karşılık gelen bir istek kodu içerir.

Aşağıdaki diyagramda, kullanıcının kaydırma çubuğunun çeşitli bölümlerine tıklandığında oluşturduğu istek kodu gösterilmektedir.

İki kaydırma çubuğundaki her bölgeyle ilişkili istek kodlarını gösteren

SB_ değerleri kullanıcının gerçekleştirilen eylemi belirtir. Uygulama, WM_HSCROLL ve WM_VSCROLL iletilerine eşlik eden kodları inceler ve ardından uygun kaydırma işlemini gerçekleştirir. Aşağıdaki tabloda, her değer için kullanıcının eylemi belirtilir ve ardından uygulamanın yanıtı gelir. Her durumda, uygulama tarafından veriler için uygun şekilde bir birim tanımlanır. Örneğin, metni dikey kaydırmaya yönelik tipik birim bir metin satırıdır.

Kaydırma çubuğu, kullanıcı kaydırma kutusuna tıklayıp sürüklediğinde SB_THUMBPOSITION ve SB_THUMBTRACK istek kodu oluşturur. Bir uygulama, SB_THUMBTRACK veya SB_THUMBPOSITION istek kodunu işlemek için programlanmalıdır.

SB_THUMBPOSITION istek kodu, kullanıcı kaydırma kutusuna tıkladıktan sonra fare düğmesini serbest bıraktığında oluşur. Bu iletiyi işleyen bir uygulama, kullanıcı kaydırma kutusunu istenen konuma sürükledikten ve fare düğmesini serbest bıraktıktan sonra kaydırma işlemini gerçekleştirir.

kullanıcı kaydırma kutusunu sürükledikçe SB_THUMBTRACK istek kodu oluşur. Uygulama SB_THUMBTRACK istek kodlarını işlerse, kullanıcı kaydırma kutusunu sürüklerken pencerenin içeriğini kaydırabilir. Ancak, kaydırma çubuğu kısa süre içinde birçok SB_THUMBTRACK istek kodu oluşturabilir, bu nedenle uygulamanın bu istek kodlarını işlemesi için pencerenin içeriğini hızla yeniden boyayabilmesi gerekir.

Kaydırma Çubuğu için Klavye Arabirimi

Kaydırma çubuğu denetimi, kullanıcının klavyeyi kullanarak kaydırma istekleri göndermesini sağlayan yerleşik bir klavye arabirimi sağlar; standart kaydırma çubuğu bunu yapmaz. Kaydırma çubuğu kontrolü klavye odağına sahip olduğunda, kullanıcı ok tuşlarına bastığında ana penceresine WM_HSCROLL ve WM_VSCROLL iletileri gönderir. İstek kodu, kullanıcının bastığı ok tuşuna karşılık gelen her iletiyle birlikte gönderilir. Ok tuşları ve buna karşılık gelen istek kodları aşağıdadır.

Standart kaydırma çubuğu için klavye arabirimi istiyorsanız, pencere yordamınızda WM_KEYDOWN iletisini işleyip iletiye eşlik eden sanal anahtar kodunu temel alarak uygun kaydırma eylemini gerçekleştirerek kendiniz bir tane oluşturabilirsiniz. Kaydırma çubuğu için klavye arabirimi oluşturma hakkında bilgi için bkz. standart kaydırma çubuğu için klavye arabirimi oluşturma .

İstemci Alanını Kaydırmak

İstemci alanının içeriğini kaydırmanın en basit yolu, içeriği silmek ve sonra yeniden çizmektir. Bu yöntem, uygulamanın genellikle tamamen yeni içerik gerektiren SB_PAGEUP, SB_PAGEDOWN ve SB_TOP istek kodlarıyla kullanma olasılığı olan yöntemdir.

SB_LINEUP ve SB_LINEDOWN gibi bazı istek kodları için, kaydırma gerçekleştikten sonra bazı içerik görünür kaldığından içeriğin tümü silinmez. ScrollWindowEx işlevi istemci alanının içeriğinin bir bölümünü korur, korunan kısmı belirtilen miktarda taşır ve ardından istemci alanının geri kalanını yeni bilgileri boyamak için hazırlar. ScrollWindowEx, veri nesnesinin belirli bir bölümünü istemci alanında yeni bir konuma taşımak için BitBlt işlevini kullanır. Bir sonraki WM_PAINT iletisi gerçekleştiğinde istemci alanının (korunmayan herhangi bir şey) herhangi bir kısmı geçersiz hale getirilir, silinir ve boyanır.

ScrollWindowEx işlevi, istemci alanının bir bölümünü kaydırma işleminin dışında tutmak için kullanılabilir. Sabit konumlara sahip alt pencereler gibi öğelerin istemci alanı içinde hareket etmesini engeller. Yeni bilgileri alacak istemci alanının bölümünü otomatik olarak geçersiz kılar, böylece uygulamanın kendi kırpma bölgelerini hesaplamasına gerek kalmaz. Kırpma hakkında daha fazla bilgi için bakınız Kırpma.

Genellikle bir uygulama, bir pencerenin içeriğini kaydırma çubuğunun gösterdiği yönün karşısında kaydırıyor. Örneğin, kullanıcı kaydırma kutusunun altındaki alanda kaydırma çubuğu miline tıkladığında, uygulama penceredeki nesneyi yukarı kaydırarak nesnenin görünür bölümün altındaki bir kısmını gösterir.

Ayrıca ScrollDC işlevini kullanarak dikdörtgen bir bölgeyi kaydırabilirsiniz.

Kaydırma Çubuğu Renkleri ve Ölçümleri

Sistem tarafından tanımlanan renk değeri COLOR_SCROLLBAR, kaydırma çubuğu mili içindeki rengi denetler. Kaydırma çubuğu milinin rengini belirlemek için GetSysColor işlevini ve kaydırma çubuğu milinin rengini ayarlamak için SetSysColorsişlevinikullanın. Ancak, bu renk değişikliğinin sistemdeki tüm kaydırma çubuklarını etkilediğine dikkat edin.

GetSystemMetrics işlevini çağırarak sistemin standart kaydırma çubuklarında kullandığı bit eşlemlerin boyutlarını alabilirsiniz. Kaydırma çubuklarıyla ilişkili sistem ölçüm değerleri aşağıdadır.