Kelas CMFCRibbonBaseElement

Kelas CMFCRibbonBaseElement adalah kelas dasar untuk semua elemen yang bisa Anda tambahkan ke bilah pita. Contoh elemen pita adalah tombol pita, kotak centang pita, dan kotak kombo pita.

Sintaks

class CMFCRibbonBaseElement : public CObject

Anggota

Konstruktor Publik

Nama	Deskripsi
`CMFCRibbonBaseElement`	Membuat `CMFCRibbonBaseElement` objek.

Metode Publik

Nama	Deskripsi
CMFCRibbonBaseElement::AddToKeyList	Menambahkan tips tombol untuk elemen pita ke array tipsalat.
CMFCRibbonBaseElement::AddToListBox	Menambahkan elemen pita ke kotak daftar perintah pita yang ditentukan.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Menunjukkan apakah elemen pita dapat ditambahkan ke toolbar akses cepat.
CMFCRibbonBaseElement::CanBeCompacted	Menunjukkan apakah ukuran elemen pita bisa ringkas.
CMFCRibbonBaseelement::CanBeStretched	Menunjukkan apakah tinggi elemen pita dapat meningkat secara vertikal ke tinggi baris pita.
CMFCRibbonBaseelement::CanBeStretchedHorizontally	Menunjukkan apakah lebar elemen pita bisa berubah.
CMFCRibbonBaseElement::CleanUpSizes	Membersihkan pengaturan dimensi untuk elemen pita.
CMFCRibbonBaseElement::ClosePopupMenu	Menutup menu popup untuk elemen pita.
CMFCRibbonBaseElement::CopyFrom	Menyalin status yang ditentukan `CMFCRibbonBaseElement` ke objek saat ini.
CMFCRibbonBaseElement::D estroyCtrl	Menghancurkan elemen pita.
CMFCRibbonBaseElement::D rawImage	Gambar untuk elemen pita.
CMFCRibbonBaseElement::Find	Mengembalikan penunjuk yang ditentukan ke elemen pita jika menunjuk ke objek saat ini.
CMFCRibbonBaseElement::FindByData	Mengambil penunjuk ke elemen pita jika berisi data yang ditentukan.
CMFCRibbonBaseElement::FindByID	Mengambil penunjuk ke elemen pita jika elemen tersebut diidentifikasi oleh ID perintah yang ditentukan.
CMFCRibbonBaseElement::FindByOriginal	Mengambil penunjuk ke elemen pita jika elemen pita aslinya cocok dengan elemen pita yang ditentukan.
CMFCRibbonBaseElement::GetCompactSize	Mengembalikan ukuran ringkas elemen pita.
CMFCRibbonBaseElement::GetData	Mengambil data yang ditentukan pengguna yang terkait dengan elemen pita.
CMFCRibbonBaseElement::GetDescription	Mengembalikan deskripsi elemen pita.
CMFCRibbonBaseElement::GetDroppedDown	Mengambil penunjuk ke elemen pita jika menu pop-upnya dijatuhkan ke bawah.
CMFCRibbonBaseElement::GetElements	Menambahkan elemen pita saat ini ke array yang ditentukan.
CMFCRibbonBaseElement::GetElementsByID	Menambahkan elemen pita saat ini ke array yang ditentukan jika elemen pita saat ini berisi ID perintah yang ditentukan.
CMFCRibbonBaseElement::GetHighlighted	Mengambil penunjuk ke elemen pita jika disorot.
CMFCRibbonBaseElement::GetID	Mengembalikan ID perintah elemen pita.
CMFCRibbonBaseelement::GetImageSize	Mengembalikan ukuran gambar elemen pita.
CMFCRibbonBaseElement::GetIntermediateSize	Mengembalikan ukuran elemen pita dalam status menengahnya.
CMFCRibbonBaseElement::GetKeys	Mengembalikan tipsalat yang terkait dengan elemen pita.
CMFCRibbonBaseElement::GetKeyTipRect	Mengambil persegi panjang batas keytip untuk elemen pita.
CMFCRibbonBaseElement::GetKeyTipSize	Mengambil ukuran teks tip kunci.
CMFCRibbonBaseElement::GetLocationInGroup	Menunjukkan lokasi tampilan elemen pita dalam grup pita.
CMFCRibbonBaseElement::GetMenuKeys	Mengembalikan tipsalat yang terkait dengan tombol.
CMFCRibbonBaseElement::GetNotifyID	Mengambil ID perintah pemberitahuan untuk elemen pita.
CMFCRibbonBaseElement::GetOriginal	Mengambil elemen pita asli.
CMFCRibbonBaseElement::GetParentCategory	Mengambil kategori pita untuk elemen pita.
CMFCRibbonBaseElement::GetParentPanel	Mengambil panel pita yang berisi elemen pita.
CMFCRibbonBaseElement::GetParentRibbonBar	Mengambil bilah pita induk untuk elemen pita.
CMFCRibbonBaseElement::GetParentWnd	Mengambil jendela induk untuk elemen pita.
CMFCRibbonBaseElement::GetPressed	Mengambil penunjuk ke elemen pita jika pengguna saat ini menekannya.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Mengambil ID perintah elemen pita saat berada di toolbar akses cepat.
CMFCRibbonBaseElement::GetRect	Mengembalikan persegi panjang pembatas elemen pita.
CMFCRibbonBaseElement::GetRegularSize	Mengembalikan ukuran reguler elemen pita.
CMFCRibbonBaseelement::GetSize	Mengembalikan ukuran elemen pita saat ini.
CMFCRibbonBaseElement::GetText	Mengembalikan teks yang terkait dengan elemen pita.
CMFCRibbonBaseElement::GetToolTipText	Mengembalikan teks tipsalat elemen pita.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Mengambil bilah pita tingkat atas untuk elemen pita.
CMFCRibbonBaseElement::HasCompactMode	Menentukan apakah elemen pita memiliki mode ringkas.
CMFCRibbonBaseElement::HasFocus	Menunjukkan apakah elemen induk memiliki fokus keyboard.
CMFCRibbonBaseElement::HasIntermediateMode	Menentukan apakah elemen pita memiliki mode menengah.
CMFCRibbonBaseElement::HasLargeMode	Menentukan apakah elemen pita memiliki mode besar.
CMFCRibbonBaseElement::HasMenu	Menunjukkan apakah elemen pita memiliki menu.
CMFCRibbonBaseElement::HitTest	Mengambil penunjuk ke elemen pita jika titik yang ditentukan terletak di dalamnya.
CMFCRibbonBaseElement::IsAlignByColumn	Menunjukkan apakah elemen pita diratakan secara vertikal dengan elemen pita lainnya.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Menunjukkan apakah ukuran gambar elemen pita selalu besar.
CMFCRibbonBaseElement::IsAutoRepeatMode	Menunjukkan apakah elemen pita berada dalam mode pengulangan otomatis.
CMFCRibbonBaseElement::IsChecked	Menentukan apakah elemen pita dicentang.
CMFCRibbonBaseElement::IsCompactMode	Menentukan apakah elemen pita berada dalam mode ringkas.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Menentukan apakah elemen pita dinonaktifkan.
CMFCRibbonBaseElement::IsDroppedDown	Menentukan apakah elemen pita menampilkan menu popup dan dijatuhkan ke bawah.
CMFCRibbonBaseElement::IsFocused	Menentukan apakah elemen pita memiliki fokus.
CMFCRibbonBaseElement::IsGalleryIcon	Menunjukkan apakah elemen pita terkandung dalam galeri pita.
CMFCRibbonBaseElement::IsHighlighted	Menentukan apakah elemen pita disorot.
CMFCRibbonBaseElement::IsIntermediateMode	Menunjukkan apakah gambar saat ini untuk elemen pita berukuran menengah.
CMFCRibbonBaseElement::IsLargeMode	Menunjukkan apakah gambar saat ini untuk elemen pita berukuran besar.
CMFCRibbonBaseElement::IsMenuMode	Menunjukkan apakah elemen pita terkandung dalam menu.
CMFCRibbonBaseelement::IsPressed	Menunjukkan apakah pengguna telah mengklik elemen pita.
CMFCRibbonBaseElement::IsQATMode	Menunjukkan apakah elemen pita terkandung dalam toolbar akses cepat.
CMFCRibbonBaseelement::IsSeparator	Menunjukkan apakah elemen pita adalah pemisah tampilan.
CMFCRibbonBaseelement::IsShowGroupBorder	Menunjukkan apakah elemen pita terkandung dalam grup yang menampilkan batas umum.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Menunjukkan apakah tipsalat ditampilkan di bawah elemen pita.
CMFCRibbonBaseElement::IsTabStop	Menunjukkan apakah elemen pita dapat dipilih dengan keyboard.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Menunjukkan apakah teks untuk elemen pita ditampilkan di sebelah kanan.
CMFCRibbonBaseElement::IsVisible	Menunjukkan apakah elemen pita saat ini ditampilkan.
CMFCRibbonBaseElement::IsWholeRowHeight	Menunjukkan apakah heigth tampilan elemen pita sama dengan tinggi tampilan panel pita yang berisinya.
CMFCRibbonBaseElement::NotifyCommand	Mengirim pemberitahuan perintah ke jendela induk elemen pita.
CMFCRibbonBaseElement::NotifyHighlightListItem	Memberi tahu jendela induk bilah pita saat pengguna menyoroti elemen pita yang terletak di daftar.
CMFCRibbonBaseElement::OnAddToQAToolbar	Menambahkan elemen pita ke toolbar akses cepat yang ditentukan.
CMFCRibbonBaseElement::OnAfterChangeRect	Memperbarui tipsalat untuk elemen pita.
CMFCRibbonBaseElement::OnAutoRepeat	Memperbarui elemen pita sebagai respons terhadap input pengguna berkelanjutan.
CMFCRibbonBaseElement::OnCalcTextSize	Menghitung ukuran teks untuk elemen pita.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Dipanggil oleh kerangka kerja saat sorotan berubah untuk elemen pita yang terletak di menu.
CMFCRibbonBaseElement::OnDraw	Dipanggil oleh kerangka kerja untuk menggambar elemen pita.
CMFCRibbonBaseElement::OnDrawKeyTip	Dipanggil oleh kerangka kerja untuk menggambar tip tombol untuk elemen pita.
CMFCRibbonBaseElement::OnDrawMenuImage	Dipanggil oleh kerangka kerja saat gambar menu untuk elemen pita digambar.
CMFCRibbonBaseElement::OnDrawOnList	Dipanggil oleh kerangka kerja untuk menggambar elemen pita dalam kotak daftar perintah.
CMFCRibbonBaseElement::OnKey	Dipanggil oleh kerangka kerja saat pengguna menekan tip tombol dan elemen pita memiliki fokus.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Dipanggil oleh kerangka kerja saat tata letak berubah arah.
CMFCRibbonBaseelement::OnShow	Dipanggil oleh kerangka kerja untuk memperlihatkan atau menyembunyikan elemen pita.
CMFCRibbonBaseElement::OnShowPopupMenu	Dipanggil oleh kerangka kerja saat elemen pita akan menampilkan menu popup.
CMFCRibbonBaseElement::P ostMenuCommand
CMFCRibbonBaseElement::Redraw	Memperbarui tampilan untuk elemen pita.
CMFCRibbonBaseElement::SetACCData	Mengatur data aksesibilitas untuk elemen pita.
CMFCRibbonBaseElement::SetCompactMode	Mengatur ukuran tampilan untuk elemen pita.
CMFCRibbonBaseElement::SetData	Mengaitkan item data dengan elemen pita.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Mengatur deskripsi untuk elemen pita.
CMFCRibbonBaseElement::SetID	Mengatur ID perintah elemen pita.
CMFCRibbonBaseElement::SetInitialMode	Mengatur ukuran tampilan awal untuk elemen pita.
CMFCRibbonBaseElement::SetKeys	Mengatur tips tombol untuk elemen pita.
CMFCRibbonBaseElement::SetOriginal	Mengatur elemen pita asli untuk elemen pita.
CMFCRibbonBaseElement::SetParentCategory	Mengatur kategori induk untuk elemen pita.
CMFCRibbonBaseElement::SetParentMenu	Mengatur kontainer menu induk untuk elemen pita.
CMFCRibbonBaseElement::SetParentRibbonBar	Mengatur bilah pita induk untuk elemen pita.
CMFCRibbonBaseElement::SetRect	Mengatur dimensi persegi panjang tampilan untuk elemen pita.
CMFCRibbonBaseElement::SetText	Mengatur teks untuk elemen pita.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Mengatur teks untuk elemen pita yang akan ditampilkan di sebelah kanan.
CMFCRibbonBaseElement::SetToolTipText	Mengatur teks tipsalat untuk elemen pita.
CMFCRibbonBaseElement::SetVisible	Mengatur status visibilitas elemen pita.
CMFCRibbonBaseElement::StretchHorizontally	Membentangkan lebar elemen pita.
CMFCRibbonBaseElement::StretchToWholeRow	Mengubah tinggi tampilan elemen pita ke tinggi baris yang ditentukan.
CMFCRibbonBaseElement::UpdateTooltipInfo	Memperbarui teks tipsalat dengan menggunakan sumber daya perintah untuk elemen pita.

Metode yang Dilindungi

Nama	Deskripsi
CMFCRibbonBaseElement::OnProcessKey	Dipanggil oleh kerangka kerja saat pengguna menekan tombol pintasan.
CMFCRibbonBaseElement::OnSetFocus	Dipanggil oleh kerangka kerja saat elemen pita menerima atau kehilangan fokus input.

Keterangan

Kelas CMFCRibbonBaseElement menentukan properti yang umum untuk semua elemen pita yang menyertakan ID perintah, label teks, teks tipsalat, deskripsi elemen, dan status (yang dapat difokuskan, disorot, ditekan, dinonaktifkan, dicentang, atau diturunkan).

Ukuran gambar elemen pita ditentukan oleh RibbonImageType anggota, yang bisa menjadi salah satu nilai berikut:

RibbonImageLarge
RibbonImageSmall

Bergantung pada ukurannya, elemen pita menampilkan gambar kecil atau besar.

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCRibbonBaseElement kelas . Contoh memperlihatkan cara mendapatkan CMFCRibbonBaseElement objek dari CMFCRibbonStatusBar kelas, mengatur deskripsi untuk elemen pita, mengatur teks, mengatur tips tombol, dan mengatur teks tipsalat untuk elemen pita. Cuplikan kode ini adalah bagian dari sampel Draw Client.

// CMFCRibbonStatusBar m_wndStatusBar
CMFCRibbonBaseElement *pPane = m_wndStatusBar.FindByID(nID);

pPane->SetDescription(_T("a pane"));
// CString strText
pPane->SetText(strText);
pPane->SetKeys(_T("p"));
pPane->SetToolTipText(_T("this is a pane"));

Hierarki Warisan

CObject

CMFCRibbonBaseElement

Persyaratan

Header: afxbaseribbonelement.h

CMFCRibbonBaseElement::AddToKeyList

Menambahkan tips tombol untuk elemen pita ke array tipsalat.

virtual void AddToKeyList(
    CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);

Parameter

arElems
[di] Referensi ke CArray tip kunci.

Keterangan

Saat fitur tips tombol pita diaktifkan, kerangka kerja menampilkan tips tombol pita saat pengguna menekan tombol ALT atau tombol F10.

CMFCRibbonBaseElement::AddToListBox

Menambahkan elemen pita ke kotak daftar perintah pita yang ditentukan.

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Parameter

pWndListBox
[di] Penunjuk ke kotak daftar perintah.

bDeep
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Indeks berbasis nol dari elemen pita yang ditambahkan.

Keterangan

Kerangka kerja menambahkan elemen pita ke kotak daftar perintah untuk memungkinkan pengguna mengkustomisasi antarmuka pengguna.

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Menunjukkan apakah elemen pita dapat ditambahkan ke toolbar akses cepat.

virtual BOOL CanBeAddedToQuickAccessToolBar() const;

Tampilkan Nilai

TRUE jika elemen dapat ditambahkan; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseElement::CanBeCompacted

Menunjukkan apakah ukuran elemen pita bisa ringkas.

virtual BOOL CanBeCompacted() const;

Tampilkan Nilai

TRUE jika ukuran elemen pita bisa ringkas; jika tidak, FALSE.

Keterangan

Ukuran elemen pita bisa ringkas, menengah, atau besar.

CMFCRibbonBaseelement::CanBeStretched

Menunjukkan apakah tinggi elemen pita dapat meningkat secara vertikal ke tinggi baris pita.

virtual BOOL CanBeStretched();

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

Secara default metode ini selalu mengembalikan TRUE. Ambil alih metode ini untuk menunjukkan apakah tinggi elemen pita dapat meningkat secara vertikal ke tinggi baris pita.

CMFCRibbonBaseelement::CanBeStretchedHorizontally

Menunjukkan apakah lebar elemen pita bisa berubah.

virtual BOOL CanBeStretchedHorizontally();

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk menunjukkan apakah lebar elemen pita bisa berubah.

CMFCRibbonBaseElement::CleanUpSizes

Membersihkan pengaturan dimensi untuk elemen pita.

virtual void CleanUpSizes();

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini dalam kelas turunan untuk mengatur ulang pengaturan dimensi untuk elemen pita.

CMFCRibbonBaseElement::ClosePopupMenu

Menutup menu pop-up untuk elemen pita.

virtual void ClosePopupMenu();

Keterangan

CMFCRibbonBaseElement::CopyFrom

Menyalin status CMFCRibbonBaseElement yang ditentukan ke objek saat ini.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parameter

src
[di] Objek CMFCRibbonBaseElement sumber.

Keterangan

CMFCRibbonBaseElement::D estroyCtrl

Menghancurkan elemen pita.

virtual void DestroyCtrl();

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini dalam kelas turunan untuk menghancurkan elemen pita.

CMFCRibbonBaseElement::D rawImage

Gambar untuk elemen pita.

virtual void DrawImage(
    CDC* pDC,
    RibbonImageType type,
    CRect rectImage);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

jenis
[di] Nilai enumerasi jenis gambar. Lihat bagian Keterangan untuk daftar nilai yang mungkin.

rectImage
[di] Persegi gambar.

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini dalam kelas turunan untuk menggambar gambar untuk elemen pita.

Tabel berikut ini mencantumkan nilai yang mungkin untuk parameter jenis :

Nilai	Deskripsi
`RibbonImageLarge`	Ukuran gambar piksel 32x32 besar.
`RibbonImageSmall`	Ukuran gambar piksel 16x16 kecil.

CMFCRibbonBaseElement::Find

Mengembalikan penunjuk yang ditentukan jika menunjuk ke objek saat ini.

virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);

Parameter

pElement
[di] Penunjuk ke elemen pita.

Tampilkan Nilai

Penunjuk ke elemen pita jika pElement menunjuk ke objek saat ini; jika tidak, NULL.

Keterangan

CMFCRibbonBaseElement::FindByData

Mengambil penunjuk ke elemen pita jika berisi data yang ditentukan.

virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);

Parameter

dwData
[di] Data yang terkait dengan elemen pita.

Tampilkan Nilai

Penunjuk ke elemen pita jika berisi data yang ditentukan; jika tidak, NULL.

Keterangan

CMFCRibbonBaseElement::FindByID

Mengambil penunjuk ke elemen pita jika elemen tersebut diidentifikasi oleh ID perintah yang ditentukan.

virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);

Parameter

uiCmdID
[di] ID Perintah untuk elemen pita.

Tampilkan Nilai

Penunjuk ke elemen pita jika elemen tersebut diidentifikasi oleh ID perintah yang ditentukan; jika tidak, NULL.

Keterangan

CMFCRibbonBaseElement::FindByOriginal

Mengambil penunjuk ke elemen pita saat ini jika elemen pita aslinya cocok dengan elemen pita yang ditentukan.

virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);

Parameter

pOriginal
[di] Penunjuk ke elemen pita.

Tampilkan Nilai

Penunjuk ke elemen pita jika elemen pita aslinya cocok dengan elemen pita yang ditentukan; jika tidak, NULL.

Keterangan

Elemen pita yang disalin ke kontainer lain mempertahankan penunjuk ke elemen pita asli.

CMFCRibbonBaseElement::GetCompactSize

Mengembalikan ukuran ringkas elemen pita.

virtual CSize GetCompactSize(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Tampilkan Nilai

Ukuran ringkas elemen pita.

Catatan

Ukuran ringkas berarti elemen pita terpotong (menampilkan gambar kecil, atau gambar tanpa teks).

CMFCRibbonBaseElement::GetData

Mengambil data yang ditentukan pengguna yang terkait dengan elemen pita.

DWORD_PTR GetData() const;

Tampilkan Nilai

Data yang ditentukan pengguna yang terkait dengan elemen pita.

CMFCRibbonBaseElement::GetDescription

Mengembalikan deskripsi elemen pita.

virtual CString GetDescription() const;

Tampilkan Nilai

Deskripsi elemen pita. Deskripsi ditampilkan baik di bilah status, atau di tipsalat, atau di bawah tombol menu jika elemen pita terletak di Kelas CMFCRibbonMainPanel.

CMFCRibbonBaseElement::GetDroppedDown

Mengambil penunjuk ke elemen pita jika menu pop-upnya dijatuhkan ke bawah.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Tampilkan Nilai

Penunjuk ke elemen pita jika menu pop-upnya dijatuhkan ke bawah; jika tidak, NULL.

Keterangan

CMFCRibbonBaseElement::GetElements

Menambahkan elemen pita saat ini ke array yang ditentukan.

virtual void GetElements(
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parameter

arElemen
[masuk, keluar] Array elemen pita.

Keterangan

CMFCRibbonBaseElement::GetElementsByID

Menambahkan elemen pita saat ini ke array yang ditentukan jika elemen pita saat ini berisi ID perintah yang ditentukan.

virtual void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parameter

uiCmdID
[di] ID Perintah elemen pita.

arElemen
[di] Array elemen pita.

Keterangan

CMFCRibbonBaseElement::GetHighlighted

Mengambil penunjuk ke elemen pita jika disorot.

virtual CMFCRibbonBaseElement* GetHighlighted();

Tampilkan Nilai

Penunjuk ke elemen pita jika disorot; jika tidak, NULL.

Keterangan

CMFCRibbonBaseElement::GetID

Mengembalikan ID perintah elemen pita.

UINT GetID() const;

Tampilkan Nilai

ID perintah elemen pita.

CMFCRibbonBaseelement::GetImageSize

Mengembalikan ukuran gambar elemen pita.

virtual CSize GetImageSize(RibbonImageType R) const;

Tampilkan Nilai

Ukuran gambar elemen pita.

CMFCRibbonBaseElement::GetIntermediateSize

Mengembalikan ukuran elemen pita dalam status menengahnya.

virtual CSize GetIntermediateSize(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Tampilkan Nilai

Ukuran elemen pita dalam status menengahnya.

CMFCRibbonBaseElement::GetKeys

Mengembalikan tipsalat yang terkait dengan elemen pita.

LPCTSTR GetKeys() const;

Tampilkan Nilai

Tips kunci yang terkait dengan elemen pita.

CMFCRibbonBaseElement::GetKeyTipRect

Mengambil persegi panjang batas keytip untuk elemen pita.

virtual CRect GetKeyTipRect(
    CDC* pDC,
    BOOL bIsMenu);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

bIsMenu
[di] TRUE jika elemen pita menampilkan menu pop-up; jika tidak FALSE.

Tampilkan Nilai

Selalu mengembalikan persegi panjang dengan 0 nilai.

Keterangan

Ambil alih metode ini dalam kelas turunan untuk mengembalikan persegi panjang batas keytip.

CMFCRibbonBaseElement::GetKeyTipSize

Mengambil ukuran teks tip kunci.

virtual CSize GetKeyTipSize(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Tampilkan Nilai

Ukuran teks tipsalat.

Keterangan

CMFCRibbonBaseElement::GetLocationInGroup

Menunjukkan lokasi tampilan elemen pita dalam grup pita.

RibbonElementLocation GetLocationInGroup() const;

Tampilkan Nilai

Nilai RibbonElementLocation enumerasi. Tabel berikut ini mencantumkan nilai yang mungkin.

Nilai	Deskripsi
`RibbonElementNotInGroup`	Elemen pita tidak terkandung dalam grup pita.
`RibbonElementSingleInGroup`	Elemen pita ditampilkan sebagai satu-satunya item dalam grup pita.
`RibbonElementFirstInGroup`	Elemen pita ditampilkan di ujung kiri grup pita.
`RibbonElementLastInGroup`	Elemen pita ditampilkan di ujung kanan grup pita.
`RibbonElementMiddleInGroup`	Elemen pita tidak ditampilkan di salah satu akhir grup pita.

Keterangan

Grup elemen pita hanya diratakan secara horizontal.

CMFCRibbonBaseElement::GetMenuKeys

Mengembalikan tips tombol menu untuk elemen pita.

LPCTSTR GetMenuKeys() const;

Tampilkan Nilai

Tips tombol menu yang terkait dengan elemen pita.

Keterangan

Saat dipanggil, tips tombol menu menampilkan menu pop-up.

CMFCRibbonBaseElement::GetNotifyID

Mengambil ID perintah pemberitahuan untuk elemen pita.

virtual UINT GetNotifyID();

Tampilkan Nilai

ID perintah pemberitahuan.

Keterangan

CMFCRibbonBaseElement::GetOriginal

Mengambil elemen pita asli.

CMFCRibbonBaseElement* GetOriginal() const;

Tampilkan Nilai

Penunjuk ke elemen pita asli.

Keterangan

Elemen pita yang disalin ke kontainer lain mempertahankan penunjuk ke elemen pita asli.

CMFCRibbonBaseElement::GetParentCategory

Mengambil kategori pita untuk elemen pita.

CMFCRibbonCategory* GetParentCategory() const;

Tampilkan Nilai

Penunjuk ke kategori pita.

Keterangan

CMFCRibbonBaseElement::GetParentPanel

Mengambil panel pita yang berisi elemen pita.

virtual CMFCRibbonPanel* GetParentPanel() const;

Tampilkan Nilai

Penunjuk ke panel pita yang berisi elemen pita.

Keterangan

CMFCRibbonBaseElement::GetParentRibbonBar

Mengambil bilah pita induk untuk elemen pita.

CMFCRibbonBar* GetParentRibbonBar() const;

Tampilkan Nilai

Penunjuk ke bilah pita induk untuk elemen pita.

Keterangan

CMFCRibbonBaseElement::GetParentWnd

Mengambil jendela induk untuk elemen pita.

virtual CWnd* GetParentWnd() const;

Tampilkan Nilai

Penunjuk ke jendela induk untuk elemen pita jika metode berhasil; jika tidak, NULL.

Keterangan

Jendela induk untuk elemen pita adalah Kelas CMFCRibbonBar atau CMFCRibbonPanelMenuBar.

CMFCRibbonBaseElement::GetPressed

Mengambil penunjuk ke elemen pita jika pengguna saat ini menekannya.

virtual CMFCRibbonBaseElement* GetPressed();

Tampilkan Nilai

Penunjuk ke elemen pita jika pengguna saat ini menekannya; jika tidak, NULL.

Keterangan

CMFCRibbonBaseElement::GetQuickAccessToolBarID

Mengambil ID perintah elemen pita saat berada di toolbar akses cepat.

virtual UINT GetQuickAccessToolBarID() const;

Tampilkan Nilai

ID perintah elemen pita saat berada di toolbar akses cepat.

Keterangan

CMFCRibbonBaseElement::GetRect

Mengembalikan persegi panjang pembatas elemen pita.

CRect GetRect() const;

Tampilkan Nilai

Persegi panjang pembatas elemen pita. Posisi persegi panjang berada dalam koordinat kontrol Pita induk.

CMFCRibbonBaseElement::GetRegularSize

Mengembalikan ukuran reguler elemen pita.

virtual CSize GetRegularSize(CDC* pDC) = 0;

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Tampilkan Nilai

Ukuran reguler elemen pita.

Keterangan

Catatan

Ukuran reguler adalah ukuran maksimal yang mungkin dari elemen pita.

CMFCRibbonBaseelement::GetSize

Mengembalikan ukuran elemen pita saat ini.

virtual CSize GetSize(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Tampilkan Nilai

Ukuran elemen pita saat ini.

CMFCRibbonBaseElement::GetText

Mengembalikan teks yang terkait dengan elemen pita.

LPCTSTR GetText() const;

Tampilkan Nilai

Teks yang terkait dengan elemen pita.

CMFCRibbonBaseElement::GetToolTipText

Mengembalikan teks tipsalat elemen pita.

virtual CString GetToolTipText() const;

Tampilkan Nilai

Teks tipsalat elemen pita.

CMFCRibbonBaseElement::GetTopLevelRibbonBar

Mengambil bilah pita tingkat atas untuk elemen pita.

CMFCRibbonBar* GetTopLevelRibbonBar() const;

Tampilkan Nilai

Penunjuk ke bilah pita tingkat atas untuk elemen pita jika metode berhasil; jika tidak, NULL.

Keterangan

CMFCRibbonBaseElement::HasCompactMode

Menentukan apakah elemen pita memiliki mode ringkas.

virtual BOOL HasCompactMode() const;

Tampilkan Nilai

TRUE jika elemen pita memiliki mode ringkas. FALSE jika tidak.

Keterangan

Catatan

Dalam mode ringkas, elemen hanya menampilkan gambar kecil.

CMFCRibbonBaseElement::HasIntermediateMode

Menentukan apakah elemen pita memiliki mode menengah.

virtual BOOL HasIntermediateMode() const;

Tampilkan Nilai

TRUE jika elemen pita memiliki mode menengah, FALSE jika tidak. Dalam mode perantara, elemen menampilkan gambar dan teks kecil di sebelah kanan gambar.

Keterangan

CMFCRibbonBaseElement::HasLargeMode

Menentukan apakah elemen pita memiliki mode besar.

virtual BOOL HasLargeMode() const;

Tampilkan Nilai

TRUE jika elemen pita memiliki mode besar. FALSE jika tidak.

Keterangan

Dalam mode besar, elemen dapat mengambil tinggi penuh panel induk.

CMFCRibbonBaseElement::HasMenu

Menunjukkan apakah elemen pita memiliki menu.

virtual BOOL HasMenu() const;

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini dalam kelas turunan untuk menunjukkan apakah elemen pita memiliki menu.

CMFCRibbonBaseElement::HitTest

Mengambil penunjuk ke elemen pita jika titik yang ditentukan terletak di dalamnya.

virtual CMFCRibbonBaseElement* HitTest(CPoint point);

Parameter

ujung
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Penunjuk ke elemen pita jika ada; jika tidak FALSE.

Keterangan

Secara default metode ini selalu mengembalikan penunjuk yang valid ke elemen pita saat ada. Ambil alih metode ini untuk menunjukkan apakah titik berada di elemen pita.

CMFCRibbonBaseElement::IsAlignByColumn

Menunjukkan apakah elemen pita diratakan secara vertikal dengan elemen pita lainnya.

virtual BOOL IsAlignByColumn() const;

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

Secara default metode ini selalu mengembalikan TRUE. Ambil alih metode ini dalam kelas turunan untuk menunjukkan apakah elemen pita turunan diratakan secara vertikal dengan elemen pita lainnya.

CMFCRibbonBaseElement::IsAlwaysLargeImage

Menunjukkan apakah ukuran gambar elemen pita selalu besar.

virtual BOOL IsAlwaysLargeImage() const;

Tampilkan Nilai

TRUE jika ukuran gambar elemen pita selalu besar; jika tidak FALSE.

Keterangan

Ukuran gambar besar adalah 32 x 32 piksel.

CMFCRibbonBaseElement::IsAutoRepeatMode

Menunjukkan apakah elemen pita berada dalam mode pengulangan otomatis.

virtual BOOL IsAutoRepeatMode(int& nDelay) const;

Parameter

nDelay
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk menunjukkan apakah elemen pita berada dalam mode pengulangan otomatis.

Dalam mode pengulangan otomatis, elemen pita merespons pada interval yang ditetapkan, diukur dalam milidetik, untuk input pengguna berkelanjutan.

CMFCRibbonBaseElement::IsChecked

Menentukan apakah elemen pita dicentang.

virtual BOOL IsChecked() const;

Tampilkan Nilai

TRUE jika elemen pita dicentang; jika tidak FALSE.

CMFCRibbonBaseElement::IsCompactMode

Menentukan apakah elemen pita berada dalam mode ringkas.

BOOL IsCompactMode() const;

Tampilkan Nilai

TRUE jika elemen pita berada dalam mode ringkas; jika tidak FALSE.

CMFCRibbonBaseElement::IsDefaultMenuLook

Menunjukkan apakah elemen pita diatur agar muncul sebagai perintah pop-up.

BOOL IsDefaultMenuLook() const;

Tampilkan Nilai

TRUE jika elemen pita diatur agar muncul sebagai perintah pop-up; jika tidak FALSE.

Keterangan

CMFCRibbonBaseElement::IsDisabled

Menentukan apakah elemen pita dinonaktifkan.

virtual BOOL IsDisabled() const;

Tampilkan Nilai

TRUE jika elemen pita dinonaktifkan; jika tidak FALSE.

CMFCRibbonBaseElement::IsDroppedDown

Menentukan apakah elemen pita menampilkan menu pop-up dan turun bawah.

virtual BOOL IsDroppedDown() const;

Tampilkan Nilai

TRUE jika elemen pita diturunkan ke bawah dan menampilkan menu pop-up; jika tidak FALSE.

CMFCRibbonBaseElement::IsFocused

Menentukan apakah elemen pita memiliki fokus.

virtual BOOL IsFocused() const;

Tampilkan Nilai

TRUE jika elemen pita memiliki fokus; jika tidak FALSE.

CMFCRibbonBaseElement::IsGalleryIcon

Menunjukkan apakah elemen pita terkandung dalam galeri pita.

virtual BOOL IsGalleryIcon() const;

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini dalam kelas turunan untuk menunjukkan apakah elemen pita terkandung dalam galeri pita.

CMFCRibbonBaseElement::IsHighlighted

Menentukan apakah elemen pita disorot.

virtual BOOL IsHighlighted() const;

Tampilkan Nilai

TRUE jika elemen pita disorot; jika tidak FALSE.

Keterangan

CMFCRibbonBaseElement::IsIntermediateMode

Menunjukkan apakah gambar saat ini untuk elemen pita berukuran menengah.

BOOL IsIntermediateMode() const;

Tampilkan Nilai

TRUE jika gambar untuk elemen pita berukuran menengah; jika tidak FALSE.

Keterangan

Ukuran gambar menengah adalah 16 x 16 piksel.

CMFCRibbonBaseElement::IsLargeMode

Menunjukkan apakah gambar saat ini untuk elemen pita berukuran besar.

BOOL IsLargeMode() const;

Tampilkan Nilai

TRUE jika gambar untuk elemen pita berukuran besar; jika tidak FALSE.

Keterangan

Ukuran gambar besar adalah 32 x 32 piksel.

CMFCRibbonBaseElement::IsMenuMode

Menunjukkan apakah elemen pita terkandung dalam menu.

BOOL IsMenuMode() const;

Tampilkan Nilai

TRUE jika elemen pita terkandung dalam menu; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseelement::IsPressed

Menunjukkan apakah pengguna telah mengklik elemen pita.

virtual BOOL IsPressed() const;

Tampilkan Nilai

TRUE jika pengguna telah mengklik elemen pita; jika tidak FALSE.

CMFCRibbonBaseElement::IsQATMode

Menunjukkan apakah elemen pita terkandung dalam toolbar akses cepat.

BOOL IsQATMode() const;

Tampilkan Nilai

TRUE jika elemen pita terkandung dalam toolbar akses cepat; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseelement::IsSeparator

Menunjukkan apakah elemen pita adalah pemisah tampilan.

virtual BOOL IsSeparator() const;

Tampilkan Nilai

TRUE jika elemen pita adalah pemisah tampilan; jika tidak FALSE.

Keterangan

CMFCRibbonBaseelement::IsShowGroupBorder

Menunjukkan apakah elemen pita terkandung dalam grup yang menampilkan batas umum.

BOOL IsShowGroupBorder() const;

Tampilkan Nilai

TRUE jika elemen pita terkandung dalam grup yang menampilkan batas umum; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseElement::IsShowTooltipOnBottom

Menunjukkan apakah tipsalat ditampilkan di bawah elemen pita.

virtual BOOL IsShowTooltipOnBottom() const;

Tampilkan Nilai

TRUE jika tipsalat ditampilkan di bawah elemen pita; FALSE jika tipsalat ditampilkan di dekat penunjuk.

Keterangan

CMFCRibbonBaseElement::IsTabStop

Menunjukkan apakah elemen pita dapat dipilih dengan keyboard.

virtual BOOL IsTabStop() const;

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

Secara default metode ini selalu mengembalikan TRUE. Ambil alih metode ini untuk menunjukkan apakah elemen pita dapat dipilih dengan keyboard.

CMFCRibbonBaseElement::IsTextAlwaysOnRight

Menunjukkan apakah teks untuk elemen pita ditampilkan di sebelah kanan.

BOOL IsTextAlwaysOnRight() const;

Tampilkan Nilai

TRUE jika teks untuk elemen pita ditampilkan di sebelah kanan; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseElement::IsVisible

Menunjukkan apakah elemen pita saat ini ditampilkan.

BOOL IsVisible() const;

Tampilkan Nilai

TRUE jika elemen pita saat ini ditampilkan; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseElement::IsWholeRowHeight

Menunjukkan apakah tinggi tampilan elemen pita sama dengan tinggi tampilan panel pita yang berisinya.

virtual BOOL IsWholeRowHeight() const;

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk menunjukkan apakah tinggi tampilan elemen pita sama dengan tinggi tampilan panel pita yang berisinya.

CMFCRibbonBaseElement::NotifyCommand

Mengirim pemberitahuan perintah ke jendela induk elemen pita.

BOOL NotifyCommand(BOOL bWithDelay = FALSE);

Parameter

bWithDelay
[di] TRUE untuk menambahkan pemberitahuan perintah ke antrean pesan jendela induk; FALSE untuk segera mengirim pesan ke jendela induk.

Tampilkan Nilai

TRUE jika pesan dikirim; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseElement::NotifyHighlightListItem

Memberi tahu jendela induk bilah pita saat pengguna menyoroti elemen pita yang terletak di daftar.

virtual void NotifyHighlightListItem(int nIndex);

Parameter

nIndex
[di] Indeks elemen pita dalam daftar.

Keterangan

CMFCRibbonBaseElement::OnAddToQAToolbar

Menambahkan elemen pita ke toolbar akses cepat yang ditentukan.

virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);

Parameter

qat
[di] Toolbar akses cepat.

Tampilkan Nilai

Selalu mengembalikan TRUE yang menunjukkan elemen pita ditambahkan ke toolbar akses cepat.

Keterangan

CMFCRibbonBaseElement::OnAfterChangeRect

Memperbarui tipsalat untuk elemen pita.

virtual void OnAfterChangeRect(CDC* pDC);

Parameter

pDC
[di] Parameter ini tidak digunakan.

Keterangan

Secara default metode ini memperbarui tipsalat untuk elemen pita. Ambil alih metode ini untuk memperbarui elemen pita setelah persegi panjang tampilannya berubah.

CMFCRibbonBaseElement::OnAutoRepeat

Memperbarui elemen pita sebagai respons terhadap input pengguna berkelanjutan.

virtual BOOL OnAutoRepeat();

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk memproses input pengguna berkelanjutan.

CMFCRibbonBaseElement::OnCalcTextSize

Menghitung ukuran teks untuk elemen pita.

virtual void OnCalcTextSize(CDC* pDC);

Parameter

pDC
[di] Parameter ini tidak digunakan.

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk menghitung ukuran teks untuk elemen pita.

CMFCRibbonBaseElement::OnChangeMenuHighlight

Dipanggil oleh kerangka kerja saat sorotan berubah untuk elemen pita yang terletak di menu.

virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
    CMFCRibbonBaseElement* pHot);

Parameter

pPanelMenuBar
[di] Parameter ini tidak digunakan.

pHot
[di] Parameter ini tidak digunakan.

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk memperbarui elemen pita yang terletak di menu saat sorotan berubah.

CMFCRibbonBaseElement::OnDraw

Dipanggil oleh kerangka kerja untuk menggambar elemen pita.

virtual void OnDraw(CDC* pDC) = 0;

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Keterangan

Ambil alih metode ini di kelas turunan jika Anda ingin mengkustomisasi gambar elemen pita tertentu.

CMFCRibbonBaseElement::OnDrawKeyTip

Dipanggil oleh kerangka kerja untuk menggambar tip tombol untuk elemen pita.

virtual void OnDrawKeyTip(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsMenu);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi panjang batas untuk tipsalat.

bIsMenu
[di] TRUE jika tip tombol adalah untuk tombol menu pop-up; jika tidak, FALSE.

Keterangan

CMFCRibbonBaseElement::OnDrawMenuImage

Dipanggil oleh kerangka kerja saat gambar menu untuk elemen pita digambar.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    CRect rect);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi gambar menu.

Tampilkan Nilai

Selalu mengembalikan TRUE untuk menunjukkan gambar digambar.

Keterangan

CMFCRibbonBaseElement::OnDrawOnList

Dipanggil oleh kerangka kerja untuk menggambar elemen pita 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 elemen pita.

strText
[di] Teks tampilan.

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

rect
[di] Persegi tampilan untuk elemen pita.

bIsPilih
[di] Parameter ini tidak digunakan.

bHighlighted
[di] Parameter ini tidak digunakan.

Keterangan

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

CMFCRibbonBaseElement::OnKey

Dipanggil oleh kerangka kerja saat pengguna menekan tip tombol dan elemen pita 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

CMFCRibbonBaseElement::OnMenuKey

Dipanggil oleh kerangka kerja ketika pengguna menekan tips tombol menu pada panel utama.

virtual BOOL OnMenuKey(UINT nUpperChar);

Parameter

nUpperChar
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk merespons ketika pengguna menekan tips tombol menu pada panel utama.

CMFCRibbonBaseElement::OnProcessKey

Dipanggil oleh kerangka kerja saat pengguna menekan tombol pintasan.

virtual BOOL OnProcessKey(UINT nChar);

Parameter

nChar
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Ambil alih metode ini jika Anda ingin elemen pita memproses kunci pintasan.

CMFCRibbonBaseElement::OnRTLChanged

Dipanggil oleh kerangka kerja saat tata letak berubah arah.

virtual void OnRTLChanged(BOOL bIsRTL);

Parameter

bIsRTL
[di] Parameter ini tidak digunakan.

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk menyesuaikan elemen pita saat tata letak berubah arah. Arah tata letak default adalah kiri-ke-kanan.

CMFCRibbonBaseElement::OnSetFocus

Dipanggil oleh kerangka kerja saat elemen pita menerima atau kehilangan fokus input.

virtual void OnSetFocus(BOOL B);

Keterangan

Ambil alih metode ini di kelas turunan jika Anda ingin aplikasi Anda menangani perubahan dalam fokus elemen pita.

CMFCRibbonBaseelement::OnShow

Dipanggil oleh kerangka kerja untuk memperlihatkan atau menyembunyikan elemen pita.

virtual void OnShow(BOOL bShow);

Parameter

bShow
[di] Parameter ini tidak digunakan.

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk memperlihatkan atau menyembunyikan elemen pita.

CMFCRibbonBaseElement::OnShowPopupMenu

Dipanggil oleh kerangka kerja sebelum elemen pita memperlihatkan menu pop-up.

virtual void OnShowPopupMenu();

Keterangan

Metode ini memberi tahu jendela induk bilah pita bahwa elemen pita akan menampilkan menu pop-up.

CMFCRibbonBaseElement::P ostMenuCommand

Menutup menu pop-up untuk elemen pita dan mengirim pesan dekat ke menu induk.

void PostMenuCommand(UINT uiCmdId);

Parameter

uiCmdId
[di] Parameter tidak digunakan.

Keterangan

Pesan tutup hanya dikirim jika elemen pita terletak di menu pop-up.

CMFCRibbonBaseElement::Redraw

Memperbarui tampilan untuk elemen pita.

virtual void Redraw();

Keterangan

Metode ini menggambar ulang persegi panjang tampilan untuk elemen pita dengan memanggil set bendera CWnd::RedrawWindow dengan bendera RDW_INVALIDATE, RDW_ERASE, dan RDW_UPDATENOW diatur.

CMFCRibbonBaseElement::SetACCData

Mengatur data aksesibilitas untuk elemen pita.

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

Parameter

pParent
Jendela induk untuk elemen pita.

data
Data aksesibilitas untuk elemen pita.

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

Secara default metode ini mengatur data aksesibilitas untuk elemen pita dan selalu mengembalikan TRUE. Ambil alih metode ini untuk mengatur data aksesibilitas dan mengembalikan nilai yang menunjukkan keberhasilan atau kegagalan.

CMFCRibbonBaseElement::SetCompactMode

Mengatur ukuran tampilan untuk elemen pita.

virtual void SetCompactMode(BOOL bCompactMode = TRUE);

Parameter

bCompactMode
[di] TRUE untuk mengurangi ukuran tampilan elemen pita; FALSE untuk meningkatkan ukuran tampilan elemen pita.

Keterangan

Tabel berikut ini meringkas logika untuk metode ini.

bCompactMode	Ukuran elemen pita saat ini	Ukuran elemen pita baru
BENAR	Compact	Tidak Ada Perubahan.
BENAR	Menengah	Padatkan jika memungkinkan.
BENAR	Bentuk dan	Perantara jika memungkinkan.
SALAH	Compact	Menengah jika memungkinkan; jika tidak besar.

CMFCRibbonBaseElement::SetData

Mengaitkan item data dengan elemen pita.

void SetData(DWORD_PTR dwData);

Parameter

dwData
[di] Nilai data.

CMFCRibbonBaseElement::SetDefaultMenuLook

Mengatur elemen pita agar muncul sebagai perintah pop-up.

void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);

Parameter

bIsDefaultMenuLook
[di] TRUE untuk mengatur elemen pita agar muncul sebagai perintah pop-up; jika tidak FALSE.

Keterangan

CMFCRibbonBaseElement::SetDescription

Mengatur deskripsi untuk elemen pita.

virtual void SetDescription(LPCTSTR lpszText);

Parameter

lpszText
[di] Deskripsi untuk elemen pita.

Keterangan

Kerangka kerja menampilkan deskripsi baru baik pada bilah status, atau di tipsalat, atau di bawah tombol menu.

CMFCRibbonBaseElement::SetID

Mengatur ID perintah elemen pita.

virtual void SetID(UINT nID);

Parameter

Nid
[di] ID perintah.

CMFCRibbonBaseElement::SetInitialMode

Mengatur ukuran tampilan awal untuk elemen pita.

virtual void SetInitialMode(BOOL bOneRow = FALSE);

Parameter

bOneRow
[di] TRUE untuk membatasi ukuran tampilan elemen pita agar ringkas atau menengah; jika tidak, FALSE.

Keterangan

Ukuran tampilan elemen pita bisa ringkas, menengah, atau besar.

CMFCRibbonBaseElement::SetKeys

Mengatur tipsalat untuk elemen pita.

virtual void SetKeys(
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys=NULL);

Parameter

lpszKeys
[di] Tipsalat untuk elemen pita.

lpszMenuKeys
[di] Tips tombol untuk menu pop-up elemen pita.

CMFCRibbonBaseElement::SetOriginal

Mengatur elemen pita asli untuk elemen pita.

virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);

Parameter

pOriginal
[di] Penunjuk ke elemen pita.

Keterangan

Elemen pita yang disalin ke kontainer lain mempertahankan penunjuk ke elemen pita asli.

CMFCRibbonBaseElement::SetParentCategory

Mengatur kategori induk untuk elemen pita.

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Parameter

pParent
[di] Penunjuk ke kategori pita.

Keterangan

Grup bertab dalam kontrol pita disebut kategori.

CMFCRibbonBaseElement::SetParentMenu

Mengatur kontainer menu induk untuk elemen pita.

virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);

Parameter

pMenuBar
[di] Menu induk.

Keterangan

CMFCRibbonBaseElement::SetParentRibbonBar

Mengatur bilah pita induk untuk elemen pita.

virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);

Parameter

pRibbonBar
[di] Penunjuk ke bilah pita induk.

Keterangan

CMFCRibbonBaseElement::SetRect

Mengatur dimensi persegi panjang tampilan untuk elemen pita.

void SetRect(CRect rect);

Parameter

rect
[di] Dimensi persegi panjang.

Keterangan

CMFCRibbonBaseElement::SetText

Mengatur teks dan tips tombol untuk elemen pita.

virtual void SetText(LPCTSTR lpszText);

Parameter

lpszText
[di] Teks dan tipsalat untuk elemen pita.

Keterangan

Untuk mengatur tips tombol untuk elemen pita, tambahkan urutan escape baris baru diikuti dengan karakter keytip ke lpszText.

Contoh

//Set the text for the ribbon element
SetText(_T("Margins"))
//Set the text and a single-letter keytip
SetText(_T("Margins\nm"))
//Set the text and a multiple-letter keytip
SetText(_T("Line Numbers\nln"))

CMFCRibbonBaseElement::SetTextAlwaysOnRight

Mengatur teks untuk elemen pita yang akan ditampilkan di sebelah kanan.

virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);

Parameter

bSet
[di] TRUE untuk menampilkan teks di sebelah kanan; jika tidak FALSE.

Keterangan

CMFCRibbonBaseElement::SetToolTipText

Mengatur teks tipsalat untuk elemen pita.

virtual void SetToolTipText(LPCTSTR lpszText);

Parameter

lpszText
[di] Teks tipsalat.

CMFCRibbonBaseElement::SetVisible

Mengatur visibilitas elemen pita.

void SetVisible(BOOL bIsVisible);

Parameter

bIsVisible
[di] TRUE untuk menampilkan elemen pita; FALSE untuk menyembunyikan elemen pita.

Keterangan

CMFCRibbonBaseElement::StretchHorizontally

Membentangkan lebar elemen pita.

virtual void StretchHorizontally();

Keterangan

Secara default metode ini menghasilkan kegagalan pernyataan dalam build debug dan oleh karena itu tidak boleh dipanggil. Ambil alih metode ini untuk membentangkan lebar elemen pita.

CMFCRibbonBaseElement::StretchToWholeRow

Mengubah tinggi tampilan elemen pita ke tinggi baris yang ditentukan.

virtual BOOL StretchToWholeRow(
    CDC* pDC,
    int nHeight);

Parameter

pDC
[di] Parameter ini tidak digunakan.

nHeight
[di] Tinggi baris.

Tampilkan Nilai

TRUE jika tinggi tampilan diatur; jika tidak, FALSE.

Keterangan

Ambil alih metode ini untuk mengubah tinggi tampilan elemen pita ke tinggi baris yang ditentukan.

CMFCRibbonBaseElement::UpdateTooltipInfo

Memperbarui teks tipsalat dengan menggunakan sumber daya perintah untuk elemen pita.

virtual void UpdateTooltipInfo();

Keterangan

CMFCRibbonBaseElement::HasFocus

Menunjukkan apakah elemen induk memiliki fokus keyboard.

virtual BOOL HasFocus() const;

Tampilkan Nilai

TRUE jika elemen pita difokuskan; jika tidak FALSE.

Keterangan

Lihat juga

Bagan Hierarki
Kelas

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-11-07

Bagikan melalui

Kelas CMFCRibbonBaseElement

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Metode yang Dilindungi

Keterangan

Contoh

Hierarki Warisan

Persyaratan

CMFCRibbonBaseElement::AddToKeyList

Parameter

Keterangan

CMFCRibbonBaseElement::AddToListBox

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::CanBeCompacted

Tampilkan Nilai

Keterangan

CMFCRibbonBaseelement::CanBeStretched

Tampilkan Nilai

Keterangan

CMFCRibbonBaseelement::CanBeStretchedHorizontally

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::CleanUpSizes

Keterangan

CMFCRibbonBaseElement::ClosePopupMenu

Keterangan

CMFCRibbonBaseElement::CopyFrom

Parameter

Keterangan

CMFCRibbonBaseElement::D estroyCtrl

Keterangan

CMFCRibbonBaseElement::D rawImage

Parameter

Keterangan

CMFCRibbonBaseElement::Find

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::FindByData

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::FindByID

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::FindByOriginal

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::GetCompactSize

Parameter

Tampilkan Nilai

CMFCRibbonBaseElement::GetData

Tampilkan Nilai

CMFCRibbonBaseElement::GetDescription

Tampilkan Nilai

CMFCRibbonBaseElement::GetDroppedDown

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::GetElements

Parameter

Keterangan

CMFCRibbonBaseElement::GetElementsByID

Parameter

Keterangan

CMFCRibbonBaseElement::GetHighlighted

Tampilkan Nilai

Keterangan

CMFCRibbonBaseElement::GetID

Tampilkan Nilai

CMFCRibbonBaseelement::GetImageSize