Kelas CMFCRibbonProgressBar

Menerapkan kontrol yang secara visual menunjukkan kemajuan operasi yang panjang.

Sintaks

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Anggota

Konstruktor Publik

Nama	Deskripsi
CMFCRibbonProgressBar::CMFCRibbonProgressBar	Membuat dan menginisialisasi CMFCRibbonProgressBar objek.

Metode Publik

Nama	Deskripsi
CMFCRibbonProgressBar::GetPos	Mengembalikan kemajuan saat ini.
CMFCRibbonProgressBar::GetRangeMax	Mengembalikan nilai maksimum rentang saat ini.
CMFCRibbonProgressBar::GetRangeMin	Mengembalikan nilai minimum rentang saat ini.
CMFCRibbonProgressBar::GetRegularSize	Mengembalikan ukuran reguler elemen pita. (Penimpaan CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode	Menentukan apakah bilah kemajuan berfungsi dalam mode tak terbatas.
CMFCRibbonProgressBar::OnDraw	Dipanggil oleh kerangka kerja untuk menggambar elemen pita. (Penimpaan CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonProgressBar::SetInfiniteMode	Mengatur bilah kemajuan untuk bekerja dalam mode tak terbatas.
CMFCRibbonProgressBar::SetPos	Mengatur kemajuan saat ini.
CMFCRibbonProgressBar::SetRange	Mengatur nilai minimum dan maksimum.

Keterangan

Dapat CMFCRibbonProgressBar beroperasi dalam dua mode: reguler dan tak terbatas. Dalam mode reguler, bilah kemajuan diisi dari kiri ke kanan dan berhenti ketika mencapai nilai maksimum. Dalam mode tak terbatas, bilah kemajuan berulang kali diisi dari nilai minimum ke nilai maksimum. Anda mungkin menggunakan mode tak terbatas untuk menunjukkan bahwa operasi sedang berlangsung, tetapi waktu penyelesaian tidak diketahui.

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCRibbonProgressBar kelas . Contoh menunjukkan cara mengatur bilah kemajuan agar berfungsi dalam mode tak terbatas (di mana waktu penyelesaian operasi tidak diketahui), atur nilai minimum dan maksimum untuk bilah kemajuan, dan atur posisi bilah kemajuan saat ini. Cuplikan kode ini adalah bagian dari sampel Demo MS Office 2007.

// 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);

Hierarki Warisan

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Persyaratan

Header: afxRibbonProgressBar.h

CMFCRibbonProgressBar::CMFCRibbonProgressBar

Membuat dan menginisialisasi objek CMFCRibbonProgressBar .

CMFCRibbonProgressBar();

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

Parameter

Nid
[di] Menentukan ID perintah untuk bilah kemajuan pita.

nWidth
[di] Menentukan lebar, dalam piksel, dari bilah kemajuan pita.

nHeight
[di] Menentukan tinggi, dalam piksel, dari bilah kemajuan pita.

CMFCRibbonProgressBar::GetPos

Mengembalikan posisi bilah kemajuan saat ini.

int GetPos () const;

Tampilkan Nilai

Nilai yang mewakili posisi bilah kemajuan saat ini.

Keterangan

Rentang yang diatur harus berada dalam rentang yang ditentukan oleh metode CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::GetRangeMax

Mengembalikan nilai maksimum bilah kemajuan saat ini.

int GetRangeMax() const;

Tampilkan Nilai

Nilai maksimum rentang saat ini.

Keterangan

CMFCRibbonProgressBar::GetRangeMin

Mengembalikan nilai rentang minimum bilah kemajuan saat ini.

int GetRangeMin() const;

Tampilkan Nilai

Nilai minimum rentang saat ini.

CMFCRibbonProgressBar::GetRegularSize

Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

virtual CSize GetRegularSize(CDC* pDC);

Parameter

[di] pDC

Tampilkan Nilai

Keterangan

CMFCRibbonProgressBar::IsInfiniteMode

Menentukan apakah bilah kemajuan berfungsi dalam mode tak terbatas.

BOOL IsInfiniteMode() const;

Tampilkan Nilai

TRUE jika bilah kemajuan dalam mode tak terbatas; jika tidak, FALSE.

Keterangan

Dalam mode tak terbatas, bilah kemajuan diisi berulang kali dari nilai minimum ke nilai maksimum. Anda mungkin menggunakan mode tak terbatas untuk menunjukkan bahwa operasi sedang berlangsung, tetapi waktu penyelesaian tidak diketahui.

CMFCRibbonProgressBar::OnDraw

Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

virtual void OnDraw(CDC* pDC);

Parameter

[di] pDC

Keterangan

CMFCRibbonProgressBar::SetInfiniteMode

Mengatur bilah kemajuan untuk bekerja dalam mode tak terbatas.

void SetInfiniteMode(BOOL bSet = TRUE);

Parameter

bSet
[di] TRUE untuk menentukan bahwa bilah kemajuan dalam mode tak terbatas; jika tidak, FALSE.

Keterangan

Biasanya, jika bilah kemajuan dalam mode tak terbatas, itu memberi tahu pengguna bahwa operasi sedang berlangsung, tetapi bahwa waktu penyelesaian tidak diketahui. Dengan demikian, bilah kemajuan diisi berulang kali dari nilai minimum ke nilai maksimum.

CMFCRibbonProgressBar::SetPos

Mengatur posisi bilah kemajuan saat ini.

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

Parameter

nPos
[di] Menentukan posisi di mana bilah kemajuan diatur.

bRedraw
[di] Menentukan apakah bilah kemajuan harus digambar ulang.

Keterangan

Rentang yang diatur harus berada dalam rentang yang ditentukan oleh metode CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::SetRange

Mengatur nilai minimum dan maksimum untuk bilah kemajuan.

void SetRange(
    int nMin,
    int nMax);

Parameter

nMin
[di] Menentukan nilai minimum rentang.

nMax
[di] Menentukan nilai maksimum rentang.

Keterangan

Gunakan metode ini untuk menentukan rentang bilah kemajuan dengan mengatur nilai minimum dan maksimum.

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCRibbonBaseElement
Kelas CMFCRibbonBar