İlerleme Çubuğu Denetimleri Hakkında
İlerleme çubuğu, bir uygulamanın uzun bir işlemin ilerleme durumunu belirtmek için kullanabileceği bir penceredir.
İşlem ilerledikçe animasyonlu bir dikdörtgenden oluşur.
Aşağıdaki çizimde görsel stilleri kullanmayan bir ilerleme çubuğu gösterilmektedir.
İlerleme durumunu göstermek için çizgiye dikdörtgenler ekleyen ilerleme çubuğunun ekran görüntüsünü 
Aşağıdaki çizimde görsel stilleri kullanan bir ilerleme çubuğu gösterilmektedir. Denetimin görünümü, işletim sistemine ve seçilen temaya bağlı olarak değişir. Daha fazla bilgi için bkz. Görsel Stiller.
Aşağıdaki başlıklar altında daha fazla bilgi yer alır.
İlerleme Çubuklarını Kullanma
PROGRESS_CLASS pencere sınıfını belirterek CreateWindowEx işlevini kullanarak ilerleme çubuğu oluşturabilirsiniz. Ortak denetimler DLL yüklendiğinde bu pencere sınıfı kaydedilir. Daha fazla bilgi için bkz. Ortak Denetimler Hakkında.
Denetim, İlerleme Denetimi olarak adlandırılan Microsoft Visual Studio Araç Kutusu'nda da kullanılabilir.
Aralık ve Geçerli Konum
İlerleme çubuğunun aralığı işlemin tüm süresini temsil eder ve geçerli konum uygulamanın işlemi tamamlamaya yönelik ilerleme durumunu temsil eder. Pencere işlevi, vurgu rengiyle doldurulacak ilerleme çubuğunun yüzdesini belirlemek için aralığı ve mevcut konumu kullanır.
Aralık değerlerini ayarlamazsanız, sistem en düşük değeri 0, maksimum değeri 100 olarak ayarlar. PBM_SETRANGE iletisini kullanarak aralığı uygun tamsayılara ayarlayabilirsiniz.
İlerleme çubuğu, geçerli konumu ayarlamak için kullanabileceğiniz birkaç ileti sağlar. PBM_SETPOS iletisi, konumu belirli bir değere ayarlar. PBM_DELTAPOS iletisi, geçerli konuma belirtilen bir değer ekleyerek konumu ilerletir.
PBM_SETSTEP iletisi, ilerleme çubuğu için bir adım artışı belirtmenize olanak tanır. Daha sonra, PBM_STEPIT iletisini ilerleme çubuğuna her gönderdiğinizde, geçerli konum belirtilen artışa göre ilerler. Varsayılan olarak, adım artışı 10 olarak ayarlanır.
Varsayılan İletişim İşleme için İlerleme Çubuğu
Bu bölümde, PROGRESS_CLASS sınıfı için pencere yordamı tarafından işlenen iletiler açıklanmaktadır.
| İleti | İşleme gerçekleştirildi |
|---|---|
| WM_CREATE | İlk yapıyı ayırır ve başlatır. |
| WM_DESTROY | İlerleme çubuğuyla ilişkili tüm kaynakları serbest bırakır. |
| WM_ERASEBKGND | İlerleme çubuğunun arka planını ve kenarlıklarını çizer. |
| WM_GETFONT | Geçerli yazı tipinin tutamacını döndürür. İlerleme çubuğu şu anda metin çizmiyor, bu nedenle bu iletinin gönderilmesi denetimi etkilemez. |
| WM_PAINT | İlerleme çubuğunu çizer. wParam parametresiNULLdeğilse, denetim değerin bir HDC olduğunu varsayar ve bu cihaz bağlamını kullanarak boyar. |
| WM_SETFONT | Tutamacı yeni yazı tipine kaydeder ve tutamacı önceki yazı tipine döndürür. İlerleme çubuğu şu anda metin çizmiyor, bu nedenle bu iletinin gönderilmesi denetimi etkilemez. |
Kayan Yazı Stili
İlerleme çubuğu denetimini PBS_MARQUEE stiliyle oluşturarak, etkinliği gösteren ancak görevin hangi oranının tamamlandığını belirtmeyen bir şekilde animasyon ekleyebilirsiniz. İlerleme çubuğunun vurgulanan bölümü, çubuğun uzunluğu boyunca art arda hareket eder. PBM_SETMARQUEE iletisini göndererek animasyonu başlatıp durdurabilir ve hızını denetleyebilirsiniz. Kayan yazı ilerleme çubuklarının aralığı veya konumu yoktur.
Aşağıdaki çizimde, kayan yazı modunda ilerleme çubuğu gösterilmektedir. Vurgulanan bölüm çubuk boyunca hareket eder.
