Kelas CMFCRibbonEdit

Menerapkan kontrol edit yang terletak di bilah pita.

Sintaks

class CMFCRibbonEdit : public CMFCRibbonButton

Anggota

Konstruktor Publik

Nama	Deskripsi
CMFCRibbonEdit::CMFCRibbonSedit	Membuat CMFCRibbonEdit objek.

Metode Publik

Nama	Deskripsi
CMFCRibbonEdit::CanBeStretched	Menunjukkan apakah tinggi CMFCRibbonEdit kontrol dapat meningkat secara vertikal ke tinggi baris pita.
CMFCRibbonEdit::CMFCRibbonSedit	Membuat CMFCRibbonEdit objek.
CMFCRibbonEdit::CopyFrom	Menyalin status objek yang ditentukan CMFCRibbonEdit ke objek saat ini CMFCRibbonEdit .
CMFCRibbonEdit::CreateSedit	Membuat kotak teks baru untuk objek tersebut CMFCRibbonEdit .
CMFCRibbonEdit::D estroyCtrl	CMFCRibbonEdit Menghancurkan objek.
CMFCRibbonEdit::D ropDownList	Menurun kotak daftar.
CMFCRibbonEdit::EnableSpinButtons	Mengaktifkan dan mengatur rentang tombol putar untuk kotak teks.
CMFCRibbonEdit::GetCompactSize	Mengambil ukuran objek yang CFMCRibbonEdit ringkas.
CMFCRibbonEdit::GetEditText	Mengambil teks dalam kotak teks.
CMFCRibbonEdit::GetIntermediateSize	Mengambil ukuran CMFCRibbonEdit menengah objek.
CMFCRibbonEdit::GetTextAlign	Mengambil perataan teks dalam kotak teks.
CMFCRibbonEdit::GetWidth	Mengambil lebar, dalam piksel, kontrol CMFCRibbonEdit .
CMFCRibbonEdit::HasCompactMode	Menunjukkan apakah ukuran tampilan untuk CMFCRibbonEdit kontrol dapat ringkas.
CMFCRibbonEdit::HasFocus	Menunjukkan apakah CMFCRIbbonEdit kontrol memiliki fokus.
CMFCRibbonEdit::HasLargeMode	Menunjukkan apakah ukuran tampilan untuk CMFCRibbonEdit kontrol bisa besar.
CMFCRibbonEdit::HasSpinButtons	Menunjukkan apakah kotak teks memiliki tombol putar.
CMFCRibbonEdit::IsHighlighted	Menunjukkan apakah CMFCRibbonEdit kontrol disorot.
CMFCRibbonEdit::OnAfterChangeRect	Dipanggil oleh kerangka kerja saat dimensi persegi panjang tampilan untuk CMFCRibbonEdit kontrol berubah.
CMFCRibbonEdit::OnDraw	Dipanggil oleh kerangka kerja untuk menggambar CMFCRibbonEdit kontrol.
CMFCRibbonEdit::OnDrawLabelAndImage	Dipanggil oleh kerangka kerja untuk menggambar label dan gambar untuk CMFCRibbonEdit kontrol.
CMFCRibbonEdit::OnDrawOnList	Dipanggil oleh kerangka kerja untuk menggambar CMFCRibbonEdit kontrol dalam kotak daftar perintah.
CMFCRibbonEdit::OnEnable	Dipanggil oleh kerangka kerja untuk mengaktifkan atau menonaktifkan CMFCRibbonEdit kontrol.
CMFCRibbonEdit::OnHighlight	Dipanggil oleh kerangka kerja saat penunjuk memasuki atau meninggalkan batas CMFCRibbonEdit kontrol.
CMFCRibbonEdit::OnKey	Dipanggil oleh kerangka kerja ketika pengguna menekan tip tombol dan CMFCRibbonEdit kontrol memiliki fokus.
CMFCRibbonEdit::OnLButtonDown	Dipanggil oleh kerangka kerja untuk memperbarui CMFCRibbonEdit kontrol ketika pengguna menekan tombol mouse kiri pada kontrol.
CMFCRibbonEdit::OnLButtonUp	Dipanggil oleh kerangka kerja saat pengguna merilis tombol mouse kiri.
CMFCRibbonEdit::OnRTLChanged	Dipanggil oleh kerangka kerja untuk memperbarui CMFCRibbonEdit kontrol saat tata letak berubah arah.
CMFCRibbonEdit::OnShow	Dipanggil oleh kerangka kerja untuk menampilkan atau menyembunyikan CMFCRibbonEdit kontrol.
CMFCRibbonEdit::Redraw	Memperbarui tampilan CMFCRibbonEdit kontrol.
CMFCRibbonEdit::SetACCData	Mengatur data aksesibilitas untuk CMFCRibbonEdit objek.
CMFCRibbonEdit::SetEditText	Mengatur teks dalam kotak teks.
CMFCRibbonEdit::SetTextAlign	Mengatur perataan teks kotak teks.
CMFCRibbonEdit::SetWidth	Mengatur lebar kotak teks untuk CMFCRibbonEdit kontrol.

Keterangan

Contoh

Contoh berikut menunjukkan cara membuat CMFCRibbonEdit objek, menampilkan tombol putar di samping kontrol edit, dan mengatur teks kontrol edit. Cuplikan kode ini adalah bagian dari sampel Demo MS Office 2007.

CMFCRibbonEdit *pEditIndentLeft = new CMFCRibbonEdit(ID_PAGELAYOUT_INDENT_LEFT, 72, _T("Left:\nil"), 13);
// specify the min and max value of the spin button control
pEditIndentLeft->EnableSpinButtons(0, 1000);
// set the text of the edit control
pEditIndentLeft->SetEditText(_T("0"));

Persyaratan

Header: afxRibbonEdit.h

CMFCRibbonEdit::CanBeStretched

Menunjukkan apakah tinggi kontrol CMFCRibbonEdit dapat meningkat secara vertikal ke tinggi baris pita.

virtual BOOL CanBeStretched();

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

CMFCRibbonEdit::CMFCRibbonSedit

Membuat objek CMFCRibbonEdit .

CMFCRibbonEdit(
    UINT nID,
    int nWidth,
    LPCTSTR lpszLabel = NULL,
    int nImage = -1);

CMFCRibbonEdit();

Parameter

Nid
[di] ID perintah untuk CMFCRibbonEdit kontrol.

nWidth
[di] Lebar, dalam piksel, dari kotak teks untuk CMFCRibbonEdit kontrol.

lpszLabel
[di] Label untuk CMFCRibbonEdit kontrol.

nImage
[di] Indeks gambar kecil yang akan digunakan untuk CMFCRibbonEdit kontrol. Kumpulan gambar kecil dipertahankan oleh kategori pita induk.

Keterangan

CMFCRibbonEdit Kontrol tidak menggunakan gambar besar.

CMFCRibbonEdit::CopyFrom

Menyalin status objek CMFCRibbonEdit yang ditentukan ke objek CMFCRibbonEdit saat ini.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parameter

src
[di] Objek sumber CMFCRibbonEdit .

Keterangan

Parameter src harus berjenis CMFCRibbonEdit.

CMFCRibbonEdit::CreateSedit

Membuat kotak teks baru untuk objek CMFCRibbonEdit .

virtual CMFCRibbonRichEditCtrl* CreateEdit(
    CWnd* pWndParent,
    DWORD dwEditStyle);

Parameter

pWndParent
[di] Penunjuk ke jendela CMFCRibbonEdit induk objek.

dwEditStyle
[di] Menentukan gaya kotak teks. Anda dapat menggabungkan gaya jendela yang tercantum di bagian Keterangan dengan gaya kontrol edit yang dijelaskan di Windows SDK.

Tampilkan Nilai

Penunjuk ke kotak teks baru jika metode berhasil; jika tidak, NULL.

Keterangan

Ambil alih metode ini di kelas turunan untuk membuat kotak teks kustom.

Anda bisa menerapkan Gaya Jendela berikut ini ke kotak teks:

• WS_CHILD

• WS_VISIBLE

• WS_DISABLED

• WS_GROUP

• WS_TABSTOP

CMFCRibbonEdit::D estroyCtrl

Menghancurkan objek CMFCRibbonEdit.

virtual void DestroyCtrl();

Keterangan

CMFCRibbonEdit::D ropDownList

Menurun kotak daftar.

virtual void DropDownList();

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk menjatuhkan kotak daftar.

CMFCRibbonEdit::EnableSpinButtons

Mengaktifkan dan mengatur rentang tombol putar untuk kotak teks.

void EnableSpinButtons(
    int nMin,
    int nMax);

Parameter

nMin
[di] Nilai minimum tombol putar.

nMax
[di] Nilai maksimum tombol putar.

Keterangan

Tombol putar menampilkan panah atas dan bawah dan memungkinkan pengguna untuk menelusuri sekumpulan nilai tetap.

CMFCRibbonEdit::GetCompactSize

Mengambil ukuran ringkas objek CMFCRibbonEdit .

virtual CSize GetCompactSize(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk CMFCRibbonEdit objek.

Tampilkan Nilai

Ukuran objek yang CMFCRibbonEdit ringkas.

Keterangan

CMFCRibbonEdit::GetEditText

Mengambil teks dalam kotak teks.

CString GetEditText() const;

Tampilkan Nilai

Teks dalam kotak teks.

Keterangan

CMFCRibbonEdit::GetIntermediateSize

Mengambil ukuran menengah objek CMFCRibbonEdit .

virtual CSize GetIntermediateSize(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk CMFCRibbonEdit objek.

Tampilkan Nilai

Ukuran CMFCRibbonEdit menengah objek.

Keterangan

CMFCRibbonEdit::GetTextAlign

Mengambil perataan teks dalam kotak teks.

int GetTextAlign() const;

Tampilkan Nilai

Nilai enumerasi perataan teks. Lihat bagian Keterangan untuk nilai yang mungkin.

Keterangan

Nilai yang dikembalikan adalah salah satu gaya kontrol edit berikut:

• ES_LEFT untuk perataan kiri

• ES_CENTER untuk perataan tengah

• ES_RIGHT untuk perataan yang tepat

Untuk informasi selengkapnya tentang gaya ini, lihat Edit Gaya Kontrol.

CMFCRibbonEdit::GetWidth

Mengambil lebar, dalam piksel, dari kontrol CMFCRibbonEdit .

int GetWidth(BOOL bInFloatyMode = FALSE) const;

Parameter

bInFloatyMode
[di] TRUE jika CMFCRibbonEdit kontrol dalam mode mengambang; jika tidak, FALSE.

Tampilkan Nilai

Lebar, dalam piksel, kontrol CMFCRibbonEdit .

Keterangan

CMFCRibbonEdit::HasCompactMode

Menunjukkan apakah ukuran tampilan untuk kontrol CMFCRibbonEdit dapat ringkas.

virtual BOOL HasCompactMode() const;

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

Secara default metode ini selalu mengembalikan TRUE. Ambil alih metode ini untuk menunjukkan apakah ukuran tampilan dapat ringkas.

CMFCRibbonEdit::HasFocus

Menunjukkan apakah kontrol CMFCRibbonEdit memiliki fokus.

virtual BOOL HasFocus() const;

Tampilkan Nilai

TRUE jika CMFCRibbonEdit kontrol memiliki fokus; jika tidak FALSE.

Keterangan

CMFCRibbonEdit::HasLargeMode

Menunjukkan apakah ukuran tampilan untuk kontrol CMFCRibbonEdit bisa besar.

virtual BOOL HasLargeMode() const;

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk menunjukkan apakah ukuran tampilan bisa besar.

CMFCRibbonEdit::HasSpinButtons

Menunjukkan apakah kotak teks memiliki tombol putar.

virtual BOOL HasSpinButtons() const;

Tampilkan Nilai

TRUE jika kotak teks memiliki tombol putar; jika tidak FALSE.

Keterangan

CMFCRibbonEdit::IsHighlighted

Menunjukkan apakah kontrol CMFCRibbonEdit disorot.

virtual BOOL IsHighlighted() const;

Tampilkan Nilai

TRUE jika CMFCRibbonEdit kontrol disorot; jika tidak FALSE.

Keterangan

CMFCRibbonEdit::OnAfterChangeRect

Dipanggil oleh kerangka kerja ketika dimensi persegi panjang tampilan untuk kontrol CMFCRibbonEdit berubah.

virtual void OnAfterChangeRect(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk CMFCRibbonEdit kontrol.

Keterangan

CMFCRibbonEdit::OnDraw

Dipanggil oleh kerangka kerja untuk menggambar kontrol CMFCRibbonEdit .

virtual void OnDraw(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk CMFCRibbonEdit kontrol.

Keterangan

CMFCRibbonEdit::OnDrawLabelAndImage

Dipanggil oleh kerangka kerja untuk menggambar label dan gambar untuk kontrol CMFCRibbonEdit .

virtual void OnDrawLabelAndImage(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk CMFCRibbonEdit kontrol.

Keterangan

CMFCRibbonEdit::OnDrawOnList

Dipanggil oleh kerangka kerja untuk menggambar kontrol CMFCRibbonEdit dalam kotak daftar perintah.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk CMFCRibbonEdit kontrol.

strText
[di] Teks tampilan.

nTextOffset
[di] Jarak, dalam piksel, dari sisi kiri kotak daftar ke teks tampilan.

rect
[di] Persegi panjang tampilan untuk CMFCRibbonEdit kontrol.

bIsPilih
[di] Parameter ini tidak digunakan.

bHighlighted
[di] Parameter ini tidak digunakan.

Keterangan

Kotak daftar perintah menampilkan kontrol pita untuk memungkinkan pengguna mengkustomisasi toolbar akses cepat.

CMFCRibbonEdit::OnEnable

Dipanggil oleh kerangka kerja untuk mengaktifkan atau menonaktifkan kontrol CMFCRibbonEdit .

virtual void OnEnable(BOOL bEnable);

Parameter

bEnable
[di] TRUE untuk mengaktifkan kontrol; FALSE untuk menonaktifkan kontrol.

Keterangan

CMFCRibbonEdit::OnHighlight

Dipanggil oleh kerangka kerja ketika penunjuk memasuki atau meninggalkan batas kontrol CMFCRibbonEdit .

virtual void OnHighlight(BOOL bHighlight);

Parameter

bHighlight
[di] TRUE jika penunjuk berada di batas CMFCRibbonEdit kontrol; jika tidak, FALSE.

Keterangan

CMFCRibbonEdit::OnKey

Dipanggil oleh kerangka kerja ketika pengguna menekan tip tombol dan kontrol CMFCRibbonEdit memiliki fokus.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parameter

bIsMenuKey
[di] TRUE jika tips tombol menampilkan menu pop-up; jika tidak, FALSE.

Tampilkan Nilai

TRUE jika peristiwa ditangani; jika tidak, FALSE.

Keterangan

CMFCRibbonEdit::OnLButtonDown

Dipanggil oleh kerangka kerja untuk memperbarui kontrol CMFCRibbonEdit ketika pengguna menekan tombol mouse kiri pada kontrol.

virtual void OnLButtonDown(CPoint point);

Parameter

ujung
[di] Parameter ini tidak digunakan.

Keterangan

CMFCRibbonEdit::OnLButtonUp

Dipanggil oleh kerangka kerja saat pengguna merilis tombol mouse kiri.

virtual void OnLButtonUp(CPoint point);

Parameter

ujung
[di] Parameter ini tidak digunakan.

Keterangan

CMFCRibbonEdit::OnRTLChanged

Dipanggil oleh kerangka kerja untuk memperbarui kontrol CMFCRibbonEdit saat tata letak berubah arah.

virtual void OnRTLChanged(BOOL bIsRTL);

Parameter

bIsRTL
[di] TRUE jika tata letaknya kanan-ke-kiri; FALSE jika tata letaknya kiri-ke-kanan.

Keterangan

CMFCRibbonEdit::OnShow

Dipanggil oleh kerangka kerja untuk menampilkan atau menyembunyikan kontrol CMFCRibbonEdit .

virtual void OnShow(BOOL bShow);

Parameter

bShow
[di] TRUE untuk menampilkan kontrol; FALSE untuk menyembunyikan kontrol.

Keterangan

CMFCRibbonEdit::Redraw

Memperbarui tampilan kontrol CMFCRibbonEdit .

virtual void Redraw();

Keterangan

Metode ini menggambar ulang persegi panjang tampilan untuk CMFCRibbonEdit objek dengan secara tidak langsung memanggil bendera CWnd::RedrawWindow dengan bendera RDW_INVALIDATE, RDW_ERASE, dan RDW_UPDATENOW diatur.

CMFCRibbonEdit::SetACCData

Mengatur data aksesibilitas untuk objek CMFCRibbonEdit .

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parameter

pParent
Penunjuk ke jendela induk untuk CMFCRibbonEdit objek.

data
Data aksesibilitas untuk CMFCRibbonEdit objek.

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

CMFCRibbonEdit::SetEditText

Mengatur teks dalam kotak teks.

void SetEditText(CString strText);

Parameter

strText
[di] Teks untuk kotak teks.

CMFCRibbonEdit::SetTextAlign

Mengatur perataan teks kotak teks.

void SetTextAlign(int nAlign);

Parameter

nAlign
[di] Nilai enumerasi perataan teks. Lihat bagian Keterangan untuk nilai yang mungkin.

Keterangan

Parameter nAlign adalah salah satu gaya kontrol edit berikut:

• ES_LEFT untuk perataan kiri

• ES_CENTER untuk perataan tengah

• ES_RIGHT untuk perataan kanan

Untuk informasi selengkapnya tentang gaya ini, lihat Edit Gaya Kontrol.

CMFCRibbonEdit::SetWidth

Mengatur lebar kotak teks untuk kontrol CMFCRibbonEdit .

void SetWidth(
    int nWidth,
    BOOL bInFloatyMode = FALSE);

Parameter

nWidth
[di] Lebar, dalam piksel, dari kotak teks.

bInFloatyMode
TRUE untuk mengatur lebar untuk mode mengambang; FALSE untuk mengatur lebar untuk mode reguler.

Keterangan

Kontrol CMFCRibbonEdit memiliki dua lebar tergantung pada mode tampilannya: mode mengambang dan mode reguler.

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCRibbonButton
Kelas CMFCRibbonBar