`CMFCRibbonBar` Kelas

Artikel
10/12/2023

Kelas CMFCRibbonBar menerapkan bilah pita yang mirip dengan yang digunakan di Office 2007.

Untuk detail selengkapnya, lihat kode sumber yang mfc terletak di folder penginstalan Visual Studio Anda. Contohnya,%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintaks

class CMFCRibbonBar : public CPane

Anggota

Konstruktor Publik

Nama	Deskripsi
`CMFCRibbonBar::CMFCRibbonBar`	Konstruktor default.

Metode Publik

Nama	Deskripsi
`CMFCRibbonBar::ActivateContextCategory`	Mengaktifkan kategori konteks yang sudah terlihat.
`CMFCRibbonBar::AddCategory`	Menambahkan kategori pita baru ke pita.
`CMFCRibbonBar::AddContextCategory`	Menambahkan kategori konteks.
`CMFCRibbonBar::AddMainCategory`	Menambahkan kategori pita utama baru.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Tambahkan elemen pita ke sisi kanan bilah pita.
`CMFCRibbonBar::CreateEx`	Membuat bilah kontrol dan melampirkannya ke `CPane` objek. (Mengambil alih `CPane::CreateEx`.)
`CMFCRibbonBar::Create`	Membuat kontrol bilah pita dan melampirkannya ke bilah pita.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	Mengaktifkan atau menonaktifkan tips kunci untuk kontrol pita.
`CMFCRibbonBar::EnablePrintPreview`	Aktifkan tab Pratinjau Cetak.
`CMFCRibbonBar::EnableToolTips`	Mengaktifkan atau menonaktifkan tipsalat dan deskripsi tipsalat pada bilah pita.
`CMFCRibbonBar::FindByData`	Temukan elemen pita dengan menggunakan data yang ditentukan pengguna.
`CMFCRibbonBar::FindByID`	Menemukan elemen pita yang memiliki ID perintah yang ditentukan.
`CMFCRibbonBar::FindCategoryIndexByData`	Menemukan indeks kategori pita yang berisi data yang ditentukan pengguna.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Mendapatkan penunjuk ke kategori aktif.
`CMFCRibbonBar::GetCaptionHeight`	Mengembalikan tinggi keterangan. (Mengambil alih `CBasePane::GetCaptionHeight`.)
`CMFCRibbonBar::GetCategory`	Mendapatkan penunjuk ke kategori yang terletak di indeks tertentu.
`CMFCRibbonBar::GetCategoryCount`	Mendapatkan jumlah kategori pita di bilah pita.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Mengembalikan indeks kategori pita.
`CMFCRibbonBar::GetContextName`	Mengambil nama keterangan kategori konteks yang Anda tentukan dengan menggunakan ID.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Mendapatkan array yang berisi penunjuk ke semua elemen pita yang memiliki ID yang ditentukan.
`CMFCRibbonBar::GetApplicationButton`	Mendapatkan penunjuk ke tombol pita.
`CMFCRibbonBar::GetFocused`	Mengembalikan elemen yang difokuskan.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Mengembalikan penunjuk ke kategori pita yang saat ini dipilih.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Mengisi daftar yang berisi ID perintah semua elemen yang muncul di Toolbar Akses Cepat.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Menyembunyikan semua kategori yang aktif dan terlihat.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Menemukan penunjuk ke elemen pita yang terletak di titik yang ditentukan dalam koordinat klien bilah pita.
`CMFCRibbonBar::IsKeyTipEnabled`	Menentukan apakah tipsalat kunci diaktifkan.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Menentukan apakah tab Pratinjau Cetak diaktifkan.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Menentukan apakah Bilah Alat Akses Cepat terletak di atas bilah pita.
`CMFCRibbonBar::IsReplaceFrameCaption`	Menentukan apakah bilah pita menggantikan keterangan bingkai utama, atau ditambahkan di bawah keterangan bingkai.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Menentukan apakah deskripsi tipsalat diaktifkan.
`CMFCRibbonBar::IsToolTipEnabled`	Menentukan apakah tipsalat untuk bilah pita diaktifkan.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Menunjukkan apakah pita memiliki tampilan gaya Windows 7 (tombol aplikasi persegi kecil).
`CMFCRibbonBar::LoadFromResource`	Kelebihan beban. Memuat Bilah Pita dari sumber daya aplikasi.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Mengambil alih `CPane::OnRTLChanged`.)
`CMFCRibbonBar::OnSetAccData`	(Mengambil alih `CBasePane::OnSetAccData`.)
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Mengambil alih `CBasePane::PreTranslateMessage`.)
`CMFCRibbonBar::RecalcLayout`	(Mengambil alih `CPane::RecalcLayout`.)
`CMFCRibbonBar::RemoveAllCategories`	Menghapus semua kategori pita dari bilah pita.
`CMFCRibbonBar::RemoveAllFromTabs`	Menghapus semua elemen pita dari area tab.
`CMFCRibbonBar::RemoveCategory`	Menghapus kategori pita yang terletak di indeks yang ditentukan.
`CMFCRibbonBar::SaveToXMLBuffer`	Menyimpan Bilah Pita ke buffer.
`CMFCRibbonBar::SaveToXMLFile`	Menyimpan Bilah Pita ke file XML.
`CMFCRibbonBar::SetActiveCategory`	Mengatur kategori pita tertentu menjadi aktif.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Mengatur tips tombol yang ditentukan untuk semua elemen pita yang memiliki ID perintah yang ditentukan.
`CMFCRibbonBar::SetApplicationButton`	Menetapkan tombol pita aplikasi ke bilah pita.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Menambahkan satu atau beberapa elemen pita ke Bilah Alat Akses Cepat.
`CMFCRibbonBar::SetQuickAccessDefaultState`	Menentukan status default untuk Bilah Alat Akses Cepat.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	Memposisikan Bilah Alat Akses Cepat (QAT) di atas atau di bawah bilah pita.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Aktifkan/nonaktifkan pita tampilan bergaya Windows 7 (tombol aplikasi persegi kecil)
`CMFCRibbonBar::ShowCategory`	Memperlihatkan atau menyembunyikan kategori pita yang ditentukan.
`CMFCRibbonBar::ShowContextCategories`	Memperlihatkan atau menyembunyikan kategori konteks yang memiliki ID yang ditentukan.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	Mengalihkan bilah pita antara status yang diminimalkan dan dimaksimalkan.
`CMFCRibbonBar::TranslateChar`

Keterangan

Microsoft memperkenalkan Pita Lancar Office saat secara bersamaan merilis Microsoft Office 2007. Bilah pita ini bukan hanya kontrol baru. Ini mewakili paradigma antarmuka pengguna baru. Pita adalah panel yang berisi sekumpulan tab yang disebut kategori. Setiap kategori dibagi secara logis menjadi panel pita dan setiap panel dapat berisi berbagai kontrol dan tombol perintah.

Elemen yang muncul di bilah pita diperluas dan dikontrak untuk memanfaatkan ruang yang tersedia dengan sebaik-baiknya. Misalnya, jika panel pita memiliki ruang yang tidak mencukupi untuk menampilkan elemennya, panel tersebut menjadi tombol menu yang menampilkan subitem pada menu pop-up. Bilah pita berulah sebagai bilah kontrol statis (non-mengambang) dan dapat ditambatkan di bagian atas bingkai.

Anda bisa menggunakan CMFCRibbonStatusBar kelas untuk menerapkan bilah status yang mirip dengan yang digunakan di Office 2007. Kategori pita berisi (dan menampilkan) grup panel pita. Setiap panel pita berisi satu atau beberapa elemen pita, yang berasal dari CMFCRibbonBaseElement.

Untuk informasi tentang cara menambahkan bilah pita ke aplikasi MFC Anda yang sudah ada, lihat Panduan: Memperbarui Aplikasi Scribble MFC.

Hierarki Warisan

Persyaratan

Header:afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Mengaktifkan kategori konteks yang sudah terlihat.

BOOL ActivateContextCategory(UINT uiContextID);

Parameter

uiContextID
[di] ID kategori konteks.

Tampilkan Nilai

TRUE jika kategori konteks dengan uiContextID ditemukan dan diaktifkan; jika tidak FALSE.

`CMFCRibbonBar::AddCategory`

Membuat dan menginisialisasi kategori pita baru untuk bilah pita.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

Parameter

lpszName
[di] Nama kategori pita.

uiSmallImagesResID
[di] ID sumber daya dari daftar gambar kecil untuk kategori pita.

uiLargeImagesResID
[di] ID sumber daya dari daftar gambar besar untuk kategori pita.

sizeSmallImage
[di] Menentukan ukuran gambar kecil untuk kategori pita.

sizeLargeImage
[di] Menentukan ukuran gambar besar untuk kategori pita.

nInsertAt
[di] Indeks berbasis nol dari lokasi kategori.

pRTI
[di] Penunjuk ke CMFCRibbonCategory kelas run-time Kelas untuk membuat kategori pita secara dinamis pada run-time.

Tampilkan Nilai

Penunjuk ke kategori pita baru jika metode berhasil; jika tidak, NULL.

Keterangan

pRTI Jika parameter tidak NULL, kategori pita baru dibuat secara dinamis menggunakan kelas run-time.

Contoh

Contoh berikut menunjukkan cara menggunakan AddCategory metode di CMFCRibbonBar kelas .

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

`CMFCRibbonBar::AddContextCategory`

Membuat dan menginisialisasi kategori konteks baru untuk bilah pita.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

Parameter

lpszName
[di] Nama kategori.

lpszContextName
[di] Nama keterangan kategori konteks.

uiContextID
[di] ID Konteks.

clrContext
[di] Warna keterangan kategori konteks.

uiSmallImagesResID
[di] ID sumber daya gambar kecil kategori konteks.

uiLargeImagesResID
[di] ID sumber daya dari gambar besar kategori konteks.

sizeSmallImage
[di] Ukuran gambar kecil.

sizeLargeImage
[di] Ukuran gambar besar.

pRTI
[di] Penunjuk ke kelas runtime.

Tampilkan Nilai

Penunjuk ke kategori yang baru dibuat, atau NULL jika CreateObject metode pRTI tidak dapat membuat kategori yang ditentukan.

Keterangan

Gunakan fungsi ini untuk menambahkan kategori konteks. Kategori konteks adalah jenis kategori khusus yang dapat ditampilkan atau disembunyikan saat runtime, tergantung pada konteks aplikasi saat ini. Misalnya, saat pengguna memilih objek, Anda dapat menampilkan tab khusus dengan kategori konteks, yang Anda gunakan untuk mengubah objek tertentu yang dipilih.

Warna kategori konteks bisa menjadi salah satu nilai berikut:

AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet

`CMFCRibbonBar::AddMainCategory`

Membuat kategori pita utama baru untuk bilah pita.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

Parameter

lpszName
[di] Nama kategori pita utama.

uiSmallImagesResID
[di] ID sumber daya gambar kecil.

uiLargeImagesResID
[di] ID sumber daya gambar besar.

sizeSmallImage
[di] Ukuran gambar kecil.

sizeLargeImage
[di] Ukuran gambar besar.

Tampilkan Nilai

Penunjuk ke kategori pita utama baru jika metode berhasil; jika tidak, NULL.

Keterangan

Jika kategori pita utama sudah ada, kategori tersebut akan dihapus.

Contoh

Contoh berikut menunjukkan cara menggunakan AddMainCategory metode di CMFCRibbonBar kelas .

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

`CMFCRibbonBar::AddPrintPreviewCategory`

Membuat kategori pratinjau cetak pada bilah pita.

CMFCRibbonCategory* AddPrintPreviewCategory();

Tampilkan Nilai

Penunjuk ke kategori pita baru jika metode berhasil; jika tidak, NULL.

Keterangan

Metode ini membuat kategori pita dan kontrol yang dibutuhkannya untuk menyediakan pratinjau cetak.

`CMFCRibbonBar::AddQATOnlyCategory`

Membuat kategori pita toolbar akses cepat.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

Parameter

lpszName
[di] Nama kategori.

uiSmallImagesResID
[di] ID sumber daya daftar gambar untuk kategori.

sizeSmallImage
[di] Ukuran gambar untuk elemen pita dalam kategori.

Tampilkan Nilai

Penunjuk ke kategori baru jika metode berhasil; jika tidak, NULL.

Keterangan

Kategori pita toolbar akses cepat hanya digunakan pada kotak dialog kustomisasi toolbar akses cepat.

`CMFCRibbonBar::AddToTabs`

Menambahkan elemen pita yang ditentukan ke baris tab bilah pita.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parameter

pElement
[di] Penunjuk ke elemen pita.

Keterangan

Elemen pita diposisikan sebelum tombol sistem apa pun.

`CMFCRibbonBar::CMFCRibbonBar`

Membuat dan menginisialisasi CMFCRibbonBar objek.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parameter

bReplaceFrameCaption
[di] TRUE untuk bilah pita untuk mengganti keterangan jendela bingkai utama; FALSE untuk menemukan bilah pita di bawah keterangan jendela bingkai utama.

Keterangan

`CMFCRibbonBar::Create`

Membuat jendela untuk bilah pita.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parameter

pParentWnd
[di] Penunjuk ke jendela induk untuk bilah pita.

dwStyle
[di] Kombinasi gaya logis untuk jendela baru.

nID
[di] ID jendela baru.

Tampilkan Nilai

TRUE jika jendela dibuat; jika tidak FALSE.

Keterangan

Contoh

Contoh berikut menunjukkan cara menggunakan Create metode CMFCRibbonBar kelas.

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

`CMFCRibbonBar::CreateEx`

Membuat jendela untuk bilah pita.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parameter

pParentWnd
[di] Penunjuk ke jendela induk untuk bilah pita.

dwCtrlStyle
[di] Parameter ini tidak digunakan.

dwStyle
[di] Kombinasi gaya logis untuk jendela baru.

nID
[di] ID jendela baru.

Tampilkan Nilai

TRUE jika jendela dibuat; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::DeactivateKeyboardFocus`

Menutup semua kontrol tips tombol pada bilah pita.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parameter

bSetFocus
[di] TRUE untuk mengatur fokus ke jendela induk bilah pita.

Keterangan

`CMFCRibbonBar::DrawMenuImage`

Gambar untuk tombol menu.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk tombol menu.

pMenuItem
[di] Tombol menu pointer ke toolbar.

rectImage
[di] Persegi panjang tampilan untuk tombol menu.

Tampilkan Nilai

TRUE jika gambar digambar; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::DWMCompositionChanged`

Menyesuaikan tampilan bilah pita saat komposisi Desktop Window Manager (DWM) diaktifkan atau dinonaktifkan.

virtual void DWMCompositionChanged();

Keterangan

`CMFCRibbonBar::EnableKeyTips`

Mengaktifkan atau menonaktifkan fitur tip kunci untuk bilah pita.

void EnableKeyTips(BOOL bEnable = TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan fitur tipsalat; FALSE untuk menonaktifkan fitur tipsalat.

Keterangan

Saat Anda mengaktifkan fitur ini, tips kunci ditampilkan saat pengguna menekan tombol ALT atau F10 . Saat pengguna menekan tombol ALT , tips kunci ditampilkan dengan penundaan 200 milidetik. Penundaan ini memungkinkan pintasan dijalankan sehingga tombol ALT yang ditekan tidak mengganggu kombinasi lain yang menyertakan tombol ALT.

`CMFCRibbonBar::EnablePrintPreview`

Mengaktifkan atau menonaktifkan fitur Pratinjau Cetak.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan fitur Pratinjau Cetak; FALSE untuk menonaktifkan fitur Pratinjau Cetak.

Keterangan

Jika bEnable ada FALSE dan ada kategori pratinjau cetak, kategori tersebut akan dihapus.

Secara default fitur Pratinjau Cetak diaktifkan.

`CMFCRibbonBar::EnableToolTips`

Mengaktifkan atau menonaktifkan tipsalat dan deskripsi tipsalat opsional pada bilah pita.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan tipsalat pada bilah pita; FALSE untuk menonaktifkan tipsalat pada bilah pita.

bEnableDescr
[di] TRUE untuk mengaktifkan deskripsi tipsalat pada tipsalat; FALSE untuk menonaktifkan deskripsi tipsalat pada tipsalat.

Keterangan

Parameter bEnable menentukan apakah tipsalat ditampilkan saat mouse mengarahkan kursor ke elemen pita. Parameter bEnableDescr menentukan apakah teks deskriptif tambahan muncul dengan teks tipsalat.

`CMFCRibbonBar::FindByData`

Mengambil penunjuk ke elemen pita jika memiliki data dan visibilitas yang ditentukan.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

Parameter

dwData
[di] Data yang terkait dengan elemen pita.

bVisibleOnly
[di] TRUE untuk mencari elemen pita yang terlihat saja; FALSE untuk mencari semua elemen pita.

Tampilkan Nilai

Penunjuk ke elemen pita jika memiliki data dan visibilitas yang ditentukan; jika tidak NULL.

Keterangan

Elemen pita adalah kontrol apa pun yang bisa Anda tambahkan ke pita, seperti tombol pita, atau kategori pita, atau slider pita.

`CMFCRibbonBar::FindByID`

Mengambil penunjuk ke elemen pita yang memiliki ID perintah dan nilai pencarian yang ditentukan.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE,
    BOOL bExcludeQAT = FALSE) const;

Parameter

uiCmdID
[di] ID Perintah untuk elemen pita.

bVisibleOnly
[di] TRUE untuk mencari elemen pita yang terlihat saja; FALSE untuk mencari semua elemen pita.

bExcludeQAT
[di] TRUE untuk mengecualikan elemen toolbar akses cepat dari pencarian; jika tidak, FALSE.

Tampilkan Nilai

Penunjuk ke elemen pita jika memiliki ID perintah dan nilai pencarian yang ditentukan; jika tidak, NULL.

Keterangan

Elemen pita adalah kontrol pita apa pun yang bisa ditambahkan ke pita, seperti tombol pita, atau kategori pita, atau slider pita.

Secara umum, mungkin ada lebih dari satu elemen pita yang memiliki ID perintah yang sama. Jika Anda ingin mendapatkan penunjuk ke semua elemen pita yang menggunakan ID perintah tertentu, gunakan metode .CMFCRibbonBar::GetElementsByID

`CMFCRibbonBar::FindCategoryIndexByData`

Mengambil indeks kategori pita yang berisi data yang ditentukan.

int FindCategoryIndexByData(DWORD dwData) const;

Parameter

dwData
[di] Data yang terkait dengan kategori pita.

Tampilkan Nilai

Indeks berbasis nol dari kategori pita jika metode berhasil; jika tidak -1.

`CMFCRibbonBar::ForceRecalcLayout`

Menyesuaikan tata letak semua item di bilah pita dan jendela induk dan menggambar ulang seluruh jendela.

void ForceRecalcLayout();

Keterangan

`CMFCRibbonBar::GetActiveCategory`

Mengambil penunjuk ke kategori pita aktif.

CMFCRibbonCategory* GetActiveCategory() const;

Tampilkan Nilai

Penunjuk ke kategori pita aktif; atau NULL jika tidak ada kategori yang aktif.

Keterangan

Kategori aktif jika memiliki fokus. Secara default, kategori aktif adalah kategori pertama di sisi kiri bilah pita.

Kategori utama ditampilkan ketika pengguna menekan tombol aplikasi dan tidak dapat menjadi kategori aktif.

`CMFCRibbonBar::GetApplicationButton`

Mengambil penunjuk ke tombol aplikasi.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Tampilkan Nilai

Penunjuk ke tombol aplikasi; atau NULL jika tombol belum diatur.

`CMFCRibbonBar::GetCaptionHeight`

Mengambil tinggi area keterangan untuk bilah pita.

int GetCaptionHeight() const;

Tampilkan Nilai

Tinggi, dalam piksel, dari area keterangan untuk bilah pita.

Keterangan

`CMFCRibbonBar::GetCategory`

Mengambil penunjuk ke kategori pita pada indeks yang ditentukan.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parameter

nIndex
[di] Indeks berbasis nol kategori pita dalam daftar kategori pita yang terdapat di bilah pita.

Tampilkan Nilai

Penunjuk ke kategori pita pada indeks yang ditentukan; jika tidak, NULL jika nIndex berada di luar jangkauan.

`CMFCRibbonBar::GetCategoryCount`

Mengambil jumlah kategori pita di bilah pita.

int GetCategoryCount() const;

Tampilkan Nilai

Jumlah kategori pita di bilah pita.

`CMFCRibbonBar::GetCategoryHeight`

Mengambil tinggi kategori.

int GetCategoryHeight() const;

Tampilkan Nilai

Tinggi kategori.

Keterangan

Tinggi kategori mencakup tinggi tab kategori.

`CMFCRibbonBar::GetCategoryIndex`

Mengambil indeks kategori pita yang ditentukan.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parameter

pCategory
[di] Penunjuk ke kategori pita.

Tampilkan Nilai

Indeks berbasis nol dari kategori pita yang ditentukan oleh pCategory; atau -1 jika kategori pita tidak ditemukan.

`CMFCRibbonBar::GetContextName`

Mengambil nama keterangan kategori konteks yang ditentukan oleh ID konteks.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

Parameter

uiContextID
[di] ID konteks kategori pita.

strName
[out] Nama keterangan kategori konteks.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak, FALSE jika uiContextID bukan nol atau keterangan kategori konteks tidak ditemukan.

`CMFCRibbonBar::GetDroppedDown`

Mengambil elemen pita yang saat ini diturunkan.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Tampilkan Nilai

Elemen pita yang saat ini diturunkan; atau NULL jika tidak ada elemen pita yang saat ini diturunkan.

Keterangan

`CMFCRibbonBar::GetElementsByID`

Mengambil array pointer ke semua elemen pita yang memiliki ID perintah tertentu.

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

Parameter

uiCmdID
[di] ID Perintah elemen pita.

arButtons
[out] Array penunjuk ke elemen pita.

Keterangan

Beberapa elemen pita bisa memiliki ID perintah yang sama karena beberapa elemen pita dapat disalin ke toolbar akses cepat.

`CMFCRibbonBar::GetHideFlags`

Mengambil bendera yang menunjukkan berapa banyak bilah pita yang terlihat.

DWORD GetHideFlags() const;

Tampilkan Nilai

Bendera yang menunjukkan berapa banyak bilah pita yang terlihat.

Keterangan

Tabel berikut mencantumkan kemungkinan kombinasi bendera untuk nilai pengembalian:

Bendera	Deskripsi
`AFX_RIBBONBAR_HIDE_ELEMENTS`	Bilah pita diminimalkan secara vertikal dan hanya tab kategori, tombol utama, dan toolbar akses cepat yang terlihat.
`AFX_RIBBONBAR_HIDE_ALL`	Lebar bilah pita kurang dari lebar minimum dan sepenuhnya tersembunyi.

`CMFCRibbonBar::GetItemIDsList`

Mengambil ID perintah untuk kumpulan elemen pita yang ditentukan pada bilah pita.

void GetItemIDsList(CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

Parameter

lstItems
[out] Daftar ID perintah untuk elemen pita yang terdapat di bilah pita.

bHiddenOnly
[di] TRUE untuk mengecualikan elemen pita yang ditampilkan; FALSE untuk menyertakan semua elemen pita di bilah pita.

Keterangan

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Mengambil tingkat navigasi saat ini saat pengguna menekan tips tombol yang terkandung pada bilah pita.

int GetKeyboardNavigationLevel() const;

Tampilkan Nilai

Tingkat navigasi saat ini saat pengguna menekan tips tombol yang terkandung pada bilah pita. Tabel berikut ini mencantumkan kemungkinan nilai pengembalian:

Nilai	Deskripsi
-1	Tips kunci tidak ditampilkan.
0	Tipsalat kunci ditampilkan.
1	Pengguna telah menekan tip tombol yang ditampilkan.

Keterangan

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Mengambil objek navigasi keyboard saat ini pada bilah pita.

CObject* GetKeyboardNavLevelCurrent() const;

Tampilkan Nilai

Objek navigasi keyboard saat ini pada bilah pita; jika tidak NULL , jika tidak ada objek yang saat ini menampilkan tipsalat.

Keterangan

Objek yang saat ini menampilkan tip tombol adalah objek navigasi keyboard saat ini.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Mengambil objek navigasi keyboard induk pada bilah pita.

CObject* GetKeyboardNavLevelParent() const;

Tampilkan Nilai

Objek navigasi keyboard induk pada bilah pita; jika tidak NULL.

Keterangan

Saat pengguna menekan tip tombol pada bilah pita, objek navigasi keyboard saat ini menjadi objek navigasi keyboard induk.

`CMFCRibbonBar::GetMainCategory`

Mengambil penunjuk ke kategori pita utama.

CMFCRibbonCategory* GetMainCategory() const;

Tampilkan Nilai

Penunjuk ke kategori pita utama.

Keterangan

Kategori pita utama berisi panel pita utama.

`CMFCRibbonBar::GetQATCommandsLocation`

Mengambil persegi panjang tampilan untuk bagian perintah toolbar akses cepat.

CRect GetQATCommandsLocation() const;

Tampilkan Nilai

Persegi panjang tampilan untuk bagian perintah toolbar akses cepat.

Keterangan

Bagian perintah dari persegi panjang tampilan tidak menyertakan tombol kustomisasi.

`CMFCRibbonBar::GetQATDroppedDown`

Mengambil penunjuk ke elemen pita pada toolbar akses cepat yang menu pop-upnya turun bawah.

CMFCRibbonBaseElement* GetQATDroppedDown();

Tampilkan Nilai

Penunjuk ke elemen pita pada toolbar akses cepat yang menu pop-upnya turun bawah.

Keterangan

`CMFCRibbonBar::GetQuickAccessCommands`

Mengambil daftar ID perintah untuk elemen pita pada toolbar akses cepat.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

Parameter

lstCommands
[out] Daftar ID perintah untuk elemen pita pada toolbar akses cepat.

Keterangan

Daftar tidak berisi elemen pita yang merupakan pemisah kontrol.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

Mengambil persegi panjang tampilan untuk toolbar akses cepat.

CRect GetQuickAccessToolbarLocation() const;

Tampilkan Nilai

Persegi panjang tampilan untuk bilah alat akses cepat.

Keterangan

`CMFCRibbonBar::GetTabTrancateRatio`

Mengambil pengurangan ukuran persen dalam lebar tampilan tab kategori.

int GetTabTrancateRatio() const;

Tampilkan Nilai

Pengurangan ukuran persen dalam lebar tampilan tab kategori.

Keterangan

Tab Kategori dikurangi lebarnya saat tidak ada cukup lebar pada bilah pita.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Mengambil ukuran besar lebar tipsalat untuk bilah pita.

int GetTooltipFixedWidthLargeImage() const;

Tampilkan Nilai

Ukuran besar lebar tipsalat dalam piksel.

Keterangan

Jika ukuran besar lebar tipsalat adalah 0, lebarnya bervariasi.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Mengambil ukuran lebar tipsalat reguler untuk bilah pita.

int GetTooltipFixedWidthRegular() const;

Tampilkan Nilai

Ukuran reguler lebar tipsalat dalam piksel.

Keterangan

Jika ukuran lebar tipsalat reguler adalah 0, lebarnya bervariasi.

`CMFCRibbonBar::GetVisibleCategoryCount`

Mengambil jumlah kategori yang terlihat pada bilah pita.

int GetVisibleCategoryCount() const;

Tampilkan Nilai

Jumlah kategori yang terlihat pada bilah pita.

Keterangan

`CMFCRibbonBar::HideAllContextCategories`

Menyembunyikan semua kategori konteks pada bilah pita.

BOOL HideAllContextCategories();

Tampilkan Nilai

TRUE jika setidaknya satu kategori konteks disembunyikan; jika tidak, FALSE.

Keterangan

Jika kategori konteks aktif, kategori aktif diatur ulang ke kategori pertama yang terlihat dalam daftar kategori.

`CMFCRibbonBar::HideKeyTips`

Menyembunyikan semua tips tombol pada bilah pita.

void HideKeyTips();

Keterangan

`CMFCRibbonBar::HitTest`

Mengambil penunjuk ke elemen pita yang ditentukan oleh lokasi titik.

virtual CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckActiveCategory= FALSE,
    BOOL bCheckPanelCaption= FALSE);

Parameter

point
[di] Lokasi titik dalam koordinat bilah pita.

bCheckActiveCategory
[di] TRUE untuk mencari kategori aktif; FALSE tidak mencari kategori aktif.

bCheckPanelCaption
[di] TRUE untuk menguji keterangan panel pita dengan titik yang terletak di dalamnya; FALSE tidak menguji keterangan panel pita dengan titik yang terletak di dalamnya. Lihat bagian Keterangan untuk informasi lebih lanjut.

Tampilkan Nilai

Penunjuk ke elemen pita yang terletak di titik yang ditentukan; jika tidak NULL , jika titik tidak terletak di elemen pita.

Keterangan

Keterangan panel pita dengan titik yang terletak di dalamnya tidak diuji kecuali bCheckActiveCategory parameternya adalah TRUE.

`CMFCRibbonBar::IsKeyTipEnabled`

Menunjukkan apakah fitur tips kunci diaktifkan.

BOOL IsKeyTipEnabled() const;

Tampilkan Nilai

TRUE jika fitur tipsalat diaktifkan; jika tidak FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Menunjukkan apakah bilah pita adalah bilah pita utama.

virtual BOOL IsMainRibbonBar() const;

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

Secara default metode ini selalu mengembalikan TRUE. Ambil alih metode ini untuk menunjukkan apakah bilah pita adalah bilah pita utama.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Menunjukkan apakah fitur Pratinjau Cetak diaktifkan.

BOOL IsPrintPreviewEnabled() const;

Tampilkan Nilai

TRUE jika fitur Pratinjau Cetak diaktifkan; jika tidakFALSE.

`CMFCRibbonBar::IsQATEmpty`

Menunjukkan apakah toolbar akses cepat berisi tombol perintah.

BOOL IsQATEmpty() const;

Tampilkan Nilai

TRUE jika toolbar akses cepat berisi tombol perintah; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

Menunjukkan apakah toolbar akses cepat terletak di atas atau di bawah bilah pita.

BOOL IsQuickAccessToolbarOnTop() const;

Tampilkan Nilai

TRUE jika toolbar akses cepat terletak di atas bilah pita; FALSE jika toolbar akses cepat terletak di bawah bilah pita.

`CMFCRibbonBar::IsReplaceFrameCaption`

Menunjukkan apakah bilah pita diganti atau berada di bawah keterangan jendela bingkai utama.

BOOL IsReplaceFrameCaption() const;

Tampilkan Nilai

TRUE jika bilah pita menggantikan keterangan jendela bingkai utama; FALSE jika bilah pita berada di bawah keterangan jendela bingkai utama.

`CMFCRibbonBar::IsShowGroupBorder`

Menunjukkan apakah grup tombol yang terletak di bilah pita menampilkan batas grup.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parameter

pGroup
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Secara default metode ini selalu mengembalikan FALSE. Ganti metode ini untuk menunjukkan apakah grup tombol yang terletak di bilah pita menampilkan batas grup.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Menunjukkan apakah deskripsi tipsalat diaktifkan.

BOOL IsToolTipDescrEnabled() const;

Tampilkan Nilai

TRUE jika deskripsi tipsalat diaktifkan; FALSE jika deskripsi tipsalat dinonaktifkan.

Keterangan

Deskripsi tipsalat adalah teks deskriptif tambahan yang ditampilkan dengan teks tipsalat.

`CMFCRibbonBar::IsToolTipEnabled`

Menunjukkan apakah tipsalat diaktifkan atau dinonaktifkan untuk bilah pita.

BOOL IsToolTipEnabled() const;

Tampilkan Nilai

TRUE jika tipsalat diaktifkan; FALSE jika tipsalat dinonaktifkan.

`CMFCRibbonBar::IsTransparentCaption`

Menunjukkan apakah tampilan diatur untuk skema warna Windows Aero.

BOOL IsTransparentCaption() const;

Tampilkan Nilai

TRUE jika skema warnanya adalah Windows Aero; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::OnClickButton`

Metode ini dipertahankan untuk kompatibilitas mundur dengan aplikasi yang ada dan tidak boleh digunakan untuk pengembangan baru.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

Parameter

pButton
[di] Penunjuk ke tombol yang diklik.

point
[di] Parameter ini tidak digunakan.

Keterangan

`CMFCRibbonBar::OnEditContextMenu`

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

Parameter

[in] pEdit
[in] point

Keterangan

`CMFCRibbonBar::OnRTLChanged`

Dipanggil oleh kerangka kerja 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

Metode ini menyesuaikan tata letak semua kontrol pada bilah pita untuk arah tata letak baru.

`CMFCRibbonBar::OnSetAccData`

Metode ini bersifat internal untuk Kerangka Kerja dan tidak dimaksudkan untuk dipanggil dari kode pengguna.

BOOL OnSetAccData(long lVal);

Parameter

panjang lVal Indeks objek yang dapat diakses.

Tampilkan Nilai

S_OK jika berhasil; jika tidak FALSE , atau S_FALSE.

Keterangan

`CMFCRibbonBar::OnShowRibbonContextMenu`

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parameter

[in] pWnd
[in] x
[in] y
[in] pHit

Tampilkan Nilai

Keterangan

`CMFCRibbonBar::OnShowRibbonQATMenu`

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parameter

[in] pWnd
[in] x
[in] y
[in] pHit

Tampilkan Nilai

Keterangan

`CMFCRibbonBar::OnSysKeyDown`

Dipanggil oleh kerangka kerja saat pengguna menekan tombol F10 atau menahan tombol ALT lalu menekan tombol lain.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parameter

pFrameWnd
[di] Penunjuk ke jendela bingkai utama induk bilah pita.

wParam
[di] Kode kunci virtual tombol yang sedang ditekan.

lParam
[di] Status keyboard ditandai ketika tombol ditekan.

Tampilkan Nilai

TRUE jika peristiwa penekanan tombol diproses; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::OnSysKeyUp`

Dipanggil oleh kerangka kerja ketika pengguna merilis kunci F10 , tombol ALT , atau tombol yang ditekan saat tombol ALT ditahan.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parameter

pFrameWnd
[di] Penunjuk ke jendela bingkai utama induk bilah pita.

wParam
[di] Kode kunci virtual kunci yang dirilis.

lParam
[di] Parameter ini tidak digunakan.

Tampilkan Nilai

TRUE jika peristiwa penekanan tombol diproses; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::PopTooltip`

Menghapus tipsalat dari tampilan.

void PopTooltip();

Keterangan

`CMFCRibbonBar::PreTranslateMessage`

Menentukan apakah pesan yang ditentukan diproses oleh bilah pita.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameter

pMsg
[di] Arahkan ke pesan.

Tampilkan Nilai

TRUE jika pesan diproses oleh bilah pita; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::RecalcLayout`

Menyesuaikan tata letak semua kontrol pada bilah pita.

virtual void RecalcLayout();

Keterangan

Setelah penyesuaian tata letak, tampilan bilah pita diperbarui.

`CMFCRibbonBar::RemoveAllCategories`

Menghapus semua kategori pita dari bilah pita.

void RemoveAllCategories();

Keterangan

Metode ini menghapus semua kategori pita dari memori dan dari daftar kategori.

`CMFCRibbonBar::RemoveAllFromTabs`

Menghapus semua elemen pita dari area tab.

void RemoveAllFromTabs();

Keterangan

Gunakan fungsi ini jika Anda ingin menghapus semua elemen yang Anda tambahkan ke area tab dengan menggunakan CMFCRibbonBar::AddToTabs metode .

`CMFCRibbonBar::RemoveCategory`

Menghapus kategori pita yang ditentukan dari bilah pita.

BOOL RemoveCategory(int nIndex);

Parameter

nIndex
[di] Indeks berbasis nol kategori dalam daftar kategori pita yang terkandung dalam bilah pita.

Tampilkan Nilai

TRUE jika kategori pita yang ditentukan dihapus; jika tidak FALSE.

Keterangan

Kategori pita yang ditentukan dihapus dari memori dan dari daftar kategori.

`CMFCRibbonBar::SetActiveCategory`

Mengatur kategori pita yang ditentukan sebagai kategori aktif.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

Parameter

pCategory
[di] Kategori pita yang ada di bilah pita.

bForceRestore
[di] TRUE untuk memaksimalkan bilah pita jika diminimalkan; FALSE untuk menampilkan kategori aktif di jendela pop-up jika bilah pita diminimalkan.

Tampilkan Nilai

TRUE jika kategori yang ditentukan ditetapkan sebagai kategori aktif; jika tidak FALSE.

Keterangan

Kategori pita utama tidak bisa menjadi kategori aktif.

Jika kategori yang ditentukan oleh pCategory tidak ditampilkan, kategori tersebut tidak dapat diatur sebagai kategori aktif.

`CMFCRibbonBar::SetActiveMDIChild`

Mengaitkan tombol sistem pada bilah pita yang termasuk dalam jendela turunan antarmuka beberapa dokumen (MDI) ke jendela anak MDI yang ditentukan.

void SetActiveMDIChild(CWnd* pWnd);

Parameter

pWnd
[di] Penunjuk ke jendela anak MDI.

Keterangan

`CMFCRibbonBar::SetApplicationButton`

Menetapkan tombol pita aplikasi ke bilah pita.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parameter

pButton
[di] Penunjuk ke tombol pita aplikasi.

sizeButton
[di] Ukuran tombol pita aplikasi.

Keterangan

Tombol pita aplikasi adalah tombol bulat besar yang terletak di sudut kiri atas kontrol Pita.

Contoh

Contoh berikut menunjukkan cara menggunakan SetApplicationButton metode di CMFCRibbonBar kelas .

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

`CMFCRibbonBar::SetElementKeys`

Mengatur tipsalat untuk semua elemen pita yang memiliki ID perintah yang ditentukan.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

Parameter

uiCmdID
[di] ID perintah elemen pita.

lpszKeys
[di] Tipsalat kunci.

lpszMenuKeys
[di] Tips tombol menu.

Tampilkan Nilai

TRUE jika tips kunci setidaknya satu elemen pita diatur; jika tidak FALSE.

Keterangan

Tips tombol menu opsional adalah untuk elemen pita dengan tombol pisah yang membuka menu popup.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

Mengatur tingkat navigasi keyboard saat pengguna menekan tips tombol yang terkandung pada bilah pita.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

Parameter

pLevel
[di] Penunjuk ke objek navigasi keyboard saat ini.

bSetFocus
[di] TRUE untuk mengatur fokus keyboard ke bilah pita.

Keterangan

Navigasi keyboard bilah pita dimulai saat pengguna menekan tombol ALT atau F10 . Pengguna memilih tingkat navigasi berikutnya dengan menekan tips tombol pada bilah pita. Pengguna dapat kembali ke tingkat navigasi sebelumnya dengan menekan tombol escape.

`CMFCRibbonBar::SetMaximizeMode`

Menyesuaikan bilah pita saat ukuran jendela jendela anak antarmuka beberapa dokumen (MDI) memasuki atau meninggalkan status maksimal.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

Parameter

bMax
[di] TRUE untuk menampilkan tombol sistem untuk jendela anak MDI pada bilah pita; FALSE untuk menghapus tombol sistem untuk jendela anak MDI dari bilah pita.

pWnd
[di] Penunjuk ke jendela bingkai utama untuk bilah pita.

Keterangan

Bilah pita menampilkan tombol sistem untuk jendela anak MDI di baris tab saat jendela anak MDI dimaksimalkan.

`CMFCRibbonBar::SetQuickAccessCommands`

Menambahkan satu atau beberapa elemen pita ke Bilah Alat Akses Cepat.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

Parameter

lstCommands
[di] Daftar perintah yang akan ditempatkan pada Toolbar Akses Cepat.

bRecalcLayout
[di] TRUE jika ingin menggambar ulang pita setelah Anda menambahkan elemen pita; FALSE Sebaliknya.

Contoh

Contoh berikut menunjukkan cara menggunakan SetQuickAccessCommands metode di CMFCRibbonBar kelas .

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

`CMFCRibbonBar::SetQuickAccessDefaultState`

Mengatur toolbar akses cepat ke status default.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parameter

state
[di] Status default toolbar akses cepat.

Keterangan

Status toolbar akses cepat menyertakan daftar perintah dan visibilitasnya.

Contoh

Contoh berikut menunjukkan cara menggunakan SetQuickAccessDefaultState metode di CMFCRibbonBar kelas .

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

`CMFCRibbonBar::SetQuickAccessToolbarOnTop`

Memposisikan bilah alat akses cepat di atas atau di bawah bilah pita.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parameter

bOnTop
[di] TRUE untuk memposisikan toolbar akses cepat di atas bilah pita; FALSE untuk memposisikan toolbar akses cepat di bawah bilah pita.

`CMFCRibbonBar::SetTooltipFixedWidth`

Mengatur ukuran teratur dan besar tipsalat lebar tetap untuk bilah pita.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parameter

nWidthRegular
[di] Lebar, dalam piksel, dari tipsalat berukuran tetap biasa.

nWidthLargeImage
[di] Lebar, dalam piksel, dari tipsalat berukuran tetap besar.

Keterangan

Mengatur parameter ke 0 menyebabkan lebar yang sesuai bervariasi.

`CMFCRibbonBar::ShowCategory`

Memperlihatkan atau menyembunyikan kategori pita yang ditentukan.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

Parameter

nIndex
[di] Indeks kategori pita.

bShow
[di] Jika TRUE, perlihatkan kategori pita; jika tidak, sembunyikan kategori pita.

`CMFCRibbonBar::ShowContextCategories`

Memperlihatkan atau menyembunyikan kategori konteks yang memiliki ID yang ditentukan.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

Parameter

uiContextID
[di] ID kategori konteks.

bShow
[di] Jika TRUE, tampilkan kategori yang memiliki ID yang ditentukan; jika tidak, sembunyikan kategori yang memiliki ID yang ditentukan.

`CMFCRibbonBar::ShowKeyTips`

Memperlihatkan tipsalat untuk setiap elemen pita pada bilah pita.

void ShowKeyTips();

Keterangan

`CMFCRibbonBar::ToggleMimimizeState`

Mengalihkan bilah pita antara status yang diminimalkan dan dimaksimalkan.

void ToggleMimimizeState();

Keterangan

Kesalahan ejaan dalam nama metode adalah masalah yang diketahui.

Dalam status diminimalkan, kontrol pita disembunyikan dan hanya tab yang ditampilkan. Saat pengguna mengklik tab, kontrol pita ditampilkan sebagai jendela popup. Jendela ditutup ketika pengguna mengklik menjauh atau menjalankan perintah.

`CMFCRibbonBar::TranslateChar`

Menentukan apakah kode karakter penekanan tombol yang ditentukan diproses oleh bilah pita.

virtual BOOL TranslateChar(UINT nChar);

Parameter

nChar
[di] Kode karakter penekanan kunci pengguna.

Tampilkan Nilai

TRUE jika kode karakter diproses oleh bilah pita; jika tidak FALSE.

Keterangan

Fitur tips tombol memungkinkan pengguna menavigasi bilah pita dengan menggunakan keyboard.

`CMFCRibbonBar::GetFocused`

Mengembalikan elemen yang difokuskan.

virtual CMFCRibbonBaseElement* GetFocused();

Tampilkan Nilai

Penunjuk ke elemen terfokus atau NULL.

Keterangan

`CMFCRibbonBar::IsWindows7Look`

Menunjukkan apakah pita memiliki tampilan Windows 7 (tombol aplikasi persegi kecil).

BOOL IsWindows7Look() const;

Tampilkan Nilai

TRUE jika pita memiliki tampilan Windows 7; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::LoadFromResource`

Kelebihan beban. Memuat Bilah Pita dari sumber daya aplikasi.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

Parameter

uiXMLResID
Menentukan ID sumber daya string XML dengan informasi Bilah Pita.

lpszResType
Menentukan jenis sumber daya yang terletak di uiXMLResID.

hInstance
Tangani ke modul yang file yang dapat dieksekusi berisi sumber daya. Jika hInstance adalah NULL, sistem memuat sumber daya dari modul yang digunakan untuk membuat proses saat ini.

lpszXMLResID
Menentukan ID sumber daya (dalam formulir string) dengan informasi Bilah Pita.

Tampilkan Nilai

TRUE jika beban berhasil; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::SaveToXMLBuffer`

Menyimpan Bilah Pita ke buffer.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parameter

ppBuffer
Ketika fungsi ini kembali, ppBuffer arahkan ke buffer yang dialokasikan oleh metode ini dan berisi informasi Bilah Pita dalam format XML.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::SaveToXMLFile`

Menyimpan Bilah Pita ke file XML.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parameter

lpszFilePath
Menentukan file output.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

`CMFCRibbonBar::SetWindows7Look`

Mengaktifkan atau menonaktifkan tampilan Windows 7 (tombol aplikasi persegi kecil) untuk Pita.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

Parameter

bWindows7Look
TRUE mengatur tampilan Windows 7; FALSE Sebaliknya.

bRecalc
TRUE menghitung ulang tata letak pita; FALSE Sebaliknya.

Keterangan

Lihat juga

Bagan Hierarki
Kelas
CPane Kelas
CMFCRibbonCategory Kelas
CMFCRibbonPanel Kelas
CMFCRibbonBaseElement Kelas
Panduan: Memperbarui Aplikasi Scribble MFC

Bagikan melalui

CMFCRibbonBar Kelas

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Keterangan

Hierarki Warisan

Persyaratan

CMFCRibbonBar::ActivateContextCategory

Parameter

Tampilkan Nilai

CMFCRibbonBar::AddCategory

Parameter

Tampilkan Nilai

Keterangan

Contoh

CMFCRibbonBar::AddContextCategory

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBar::AddMainCategory

Parameter

Tampilkan Nilai

Keterangan

Contoh

CMFCRibbonBar::AddPrintPreviewCategory

Tampilkan Nilai

Keterangan

CMFCRibbonBar::AddQATOnlyCategory

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBar::AddToTabs

Parameter

Keterangan

CMFCRibbonBar::CMFCRibbonBar

Parameter

Keterangan

CMFCRibbonBar::Create

Parameter

Tampilkan Nilai

Keterangan

Contoh

CMFCRibbonBar::CreateEx

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBar::DeactivateKeyboardFocus

Parameter

Keterangan

CMFCRibbonBar::DrawMenuImage

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBar::DWMCompositionChanged

Keterangan

CMFCRibbonBar::EnableKeyTips

Parameter

Keterangan

CMFCRibbonBar::EnablePrintPreview

Parameter

Keterangan

CMFCRibbonBar::EnableToolTips

Parameter

Keterangan

CMFCRibbonBar::FindByData

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBar::FindByID

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonBar::FindCategoryIndexByData

Parameter

Tampilkan Nilai

CMFCRibbonBar::ForceRecalcLayout

Keterangan

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar` Kelas

`CMFCRibbonBar::ActivateContextCategory`

`CMFCRibbonBar::AddCategory`

`CMFCRibbonBar::AddContextCategory`

`CMFCRibbonBar::AddMainCategory`

`CMFCRibbonBar::AddPrintPreviewCategory`

`CMFCRibbonBar::AddQATOnlyCategory`

`CMFCRibbonBar::AddToTabs`

`CMFCRibbonBar::CMFCRibbonBar`

`CMFCRibbonBar::Create`

`CMFCRibbonBar::CreateEx`

`CMFCRibbonBar::DeactivateKeyboardFocus`

`CMFCRibbonBar::DrawMenuImage`

`CMFCRibbonBar::DWMCompositionChanged`

`CMFCRibbonBar::EnableKeyTips`

`CMFCRibbonBar::EnablePrintPreview`

`CMFCRibbonBar::EnableToolTips`

`CMFCRibbonBar::FindByData`

`CMFCRibbonBar::FindByID`

`CMFCRibbonBar::FindCategoryIndexByData`

`CMFCRibbonBar::ForceRecalcLayout`

`CMFCRibbonBar::GetActiveCategory`

`CMFCRibbonBar::GetApplicationButton`

`CMFCRibbonBar::GetCaptionHeight`

`CMFCRibbonBar::GetCategory`

`CMFCRibbonBar::GetCategoryCount`

`CMFCRibbonBar::GetCategoryHeight`

`CMFCRibbonBar::GetCategoryIndex`

`CMFCRibbonBar::GetContextName`

`CMFCRibbonBar::GetDroppedDown`

`CMFCRibbonBar::GetElementsByID`

`CMFCRibbonBar::GetHideFlags`

`CMFCRibbonBar::GetItemIDsList`

`CMFCRibbonBar::GetKeyboardNavigationLevel`

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

`CMFCRibbonBar::GetKeyboardNavLevelParent`

`CMFCRibbonBar::GetMainCategory`

`CMFCRibbonBar::GetQATCommandsLocation`

`CMFCRibbonBar::GetQATDroppedDown`

`CMFCRibbonBar::GetQuickAccessCommands`

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

`CMFCRibbonBar::GetTabTrancateRatio`

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

`CMFCRibbonBar::GetVisibleCategoryCount`