Aracılığıyla paylaş


CMFCRibbonProgressBar Sınıfı

Uzun bir işlemin ilerleme durumunu görsel olarak gösteren bir denetim uygular.

Sözdizimi

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
CMFCRibbonProgressBar::CMFCRibbonProgressBar Bir CMFCRibbonProgressBar nesneyi oluşturur ve başlatır.

Genel Yöntemler

Veri Akışı Adı Açıklama
CMFCRibbonProgressBar::GetPos Geçerli ilerleme durumunu döndürür.
CMFCRibbonProgressBar::GetRangeMax Geçerli aralığın en büyük değerini döndürür.
CMFCRibbonProgressBar::GetRangeMin Geçerli aralığın en düşük değerini döndürür.
CMFCRibbonProgressBar::GetRegularSize Şerit öğesinin normal boyutunu döndürür. (Geçersiz Kılmalar CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode İlerleme çubuğunun sonsuz modda çalışıp çalışmadığını belirtir.
CMFCRibbonProgressBar::OnDraw Şerit öğesini çizmek için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonProgressBar::SetInfiniteMode İlerleme çubuğunu sonsuz modda çalışacak şekilde ayarlar.
CMFCRibbonProgressBar::SetPos Geçerli ilerleme durumunu ayarlar.
CMFCRibbonProgressBar::SetRange En düşük ve en yüksek değerleri ayarlar.

Açıklamalar

A CMFCRibbonProgressBar iki modda çalışabilir: normal ve sonsuz. Normal modda ilerleme çubuğu soldan sağa doldurulur ve maksimum değere ulaştığında durur. Sonsuz modda ilerleme çubuğu, minimum değerden maksimum değere kadar art arda doldurulur. Bir işlemin devam ettiğini ancak tamamlanma süresinin bilinmediğini belirtmek için sonsuz modu kullanabilirsiniz.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCRibbonProgressBar . Örnekte ilerleme çubuğunun sonsuz modda çalışacak şekilde nasıl ayarlanacağı (işlemin tamamlanma süresinin bilinmediği), ilerleme çubuğu için en düşük ve en yüksek değerlerin nasıl ayarlanacağı ve ilerleme çubuğunun geçerli konumunun nasıl ayarlanacağı gösterilmektedir. Bu kod parçacığı MS Office 2007 Tanıtım örneğinin bir parçasıdır.

// int cxProgress
// BOOL m_bInfiniteProgressMode
CMFCRibbonProgressBar *pProgressBar = new CMFCRibbonProgressBar(ID_STATUSBAR_PROGRESS, cxProgress);

pProgressBar->SetInfiniteMode(m_bInfiniteProgressMode);
pProgressBar->SetRange(0, 200);
pProgressBar->SetPos(200, true);

Devralma Hiyerarşisi

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Gereksinimler

Üst bilgi: afxRibbonProgressBar.h

CMFCRibbonProgressBar::CMFCRibbonProgressBar

CMFCRibbonProgressBar nesnesini oluşturur ve başlatır.

CMFCRibbonProgressBar();

CMFCRibbonProgressBar(
    UINT nID,
    int nWidth = 90,
    int nHeight = 22);

Parametreler

Nıd
[in] Şerit ilerleme çubuğu için komut kimliğini belirtir.

nWidth
[in] Şerit ilerleme çubuğunun genişliğini piksel cinsinden belirtir.

nHeight
[in] Şerit ilerleme çubuğunun yüksekliğini piksel cinsinden belirtir.

CMFCRibbonProgressBar::GetPos

İlerleme çubuğunun geçerli konumunu döndürür.

int GetPos () const;

Dönüş Değeri

İlerleme çubuğunun geçerli konumunu temsil eden bir değer.

Açıklamalar

Ayarlanan aralık, CMFCRibbonProgressBar::SetRange yöntemi tarafından belirtilen aralık içinde olmalıdır.

CMFCRibbonProgressBar::GetRangeMax

İlerleme çubuğunun geçerli en büyük değerini döndürür.

int GetRangeMax() const;

Dönüş Değeri

Geçerli aralığın en büyük değeri.

Açıklamalar

CMFCRibbonProgressBar::GetRangeMin

İlerleme çubuğunun geçerli en düşük aralık değerini döndürür.

int GetRangeMin() const;

Dönüş Değeri

Geçerli aralığın en düşük değeri.

CMFCRibbonProgressBar::GetRegularSize

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

virtual CSize GetRegularSize(CDC* pDC);

Parametreler

[in] pDC

Dönüş Değeri

Açıklamalar

CMFCRibbonProgressBar::IsInfiniteMode

İlerleme çubuğunun sonsuz modda çalışıp çalışmadığını belirtir.

BOOL IsInfiniteMode() const;

Dönüş Değeri

İlerleme çubuğu sonsuz moddaysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Sonsuz modda ilerleme çubuğu, minimum değerden maksimum değere kadar art arda doldurulur. Bir işlemin devam ettiğini ancak tamamlanma süresinin bilinmediğini belirtmek için sonsuz modu kullanabilirsiniz.

CMFCRibbonProgressBar::OnDraw

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

virtual void OnDraw(CDC* pDC);

Parametreler

[in] pDC

Açıklamalar

CMFCRibbonProgressBar::SetInfiniteMode

İlerleme çubuğunu sonsuz modda çalışacak şekilde ayarlar.

void SetInfiniteMode(BOOL bSet = TRUE);

Parametreler

bSet
[in] İlerleme çubuğunun sonsuz modda olduğunu belirtmek için DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Genellikle, ilerleme çubuğu sonsuz moddaysa, kullanıcıya bir işlemin devam ettiğini, ancak tamamlanma süresinin bilinmediğini söyler. Bu nedenle, ilerleme çubuğu minimum değerden maksimum değere kadar art arda doldurulur.

CMFCRibbonProgressBar::SetPos

İlerleme çubuğunun geçerli konumunu ayarlar.

void SetPos(
    int nPos,
    BOOL bRedraw = TRUE);

Parametreler

nPos
[in] İlerleme çubuğunun ayarlanacağı konumu belirtir.

bRedraw
[in] İlerleme çubuğunun yeniden çizilip çizilmeyeceğini belirtir.

Açıklamalar

Ayarlanan aralık, CMFCRibbonProgressBar::SetRange yöntemi tarafından belirtilen aralık içinde olmalıdır.

CMFCRibbonProgressBar::SetRange

İlerleme çubuğu için en düşük ve en yüksek değerleri ayarlar.

void SetRange(
    int nMin,
    int nMax);

Parametreler

nMin
[in] Aralığın en düşük değerini belirtir.

nMax
[in] Aralığın en büyük değerini belirtir.

Açıklamalar

En düşük ve en yüksek değerleri ayarlayarak ilerleme çubuğunun aralığını tanımlamak için bu yöntemi kullanın.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCRibbonBaseElement Sınıfı
CMFCRibbonBar Sınıfı