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
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ı