Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Nota
Pustaka Microsoft Foundation Classes (MFC) terus didukung. Namun, kami tidak lagi menambahkan fitur atau memperbarui dokumentasi.
Kelas CMFCRibbonCategory mengimplementasikan tab pita yang berisi grup panel pita.
Sintaks
class CMFCRibbonCategory : public CObject
Anggota
Konstruktor yang Dilindungi
| Nama | Deskripsi |
|---|---|
| CMFCRibbonCategory::CMFCRibbonCategory | Konstruktor. |
Metode Publik
Keterangan
Biasanya, Anda membuat kategori pita secara tidak langsung dengan memanggil CMFCRibbonBar::AddCategory, yang mengembalikan penunjuk ke kategori pita yang baru dibuat. Anda menambahkan panel ke kategori dengan memanggil CMFCRibbonCategory::AddPanel.
Kelas CMFCRibbonTab menggambar kategori pita. Ini berasal dari KELAS CMFCRibbonBaseElement.
Contoh berikut menunjukkan cara membuat kategori pita dan menambahkan panel ke dalamnya.
// Create a new ribbon category and get a pointer to it
CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory
(_T("&Write"), // Category name
IDB_WRITE, // Category small images (16 x 16)
IDB_WRITE_LARGE); // Category large images (32 x 32)
// Add a panel to the new category
CMFCRibbonPanel* pPanel = pCategory->AddPanel (
_T("Clipboard"), // Panel name
m_PanelIcons.ExtractIcon (0)); // Panel icon
Diagram berikut ini memperlihatkan gambar kategori Beranda dari aplikasi sampel RibbonApp.
Hierarki Warisan
CMFCRibbonCategory
Persyaratan
Header: afxribboncategory.h
CMFCRibbonCategory::AddHidden
Menambahkan elemen pita yang ditentukan ke array elemen pita yang ditampilkan pada kotak dialog kustomisasi.
void AddHidden(CMFCRibbonBaseElement* pElem);
Parameter
pElem
[di] Penunjuk ke elemen pita.
Keterangan
Elemen pita pada kotak dialog kustomisasi adalah perintah yang bisa Anda tambahkan ke toolbar akses cepat.
CMFCRibbonCategory::AddPanel
Membuat panel pita untuk kategori pita.
CMFCRibbonPanel* AddPanel(
LPCTSTR lpszPanelName,
HICON hIcon = 0,
CRuntimeClass* pRTI = NULL);
Parameter
lpszPanelName
[di] Penunjuk ke nama panel pita baru.
hIcon
[di] Tangani ke ikon default untuk panel pita baru.
pRTI
[di] Penunjuk ke informasi kelas runtime untuk panel pita kustom.
Tampilkan Nilai
Penunjuk ke panel pita baru jika metode berhasil; jika tidak, NULL jika panel tidak dibuat.
Keterangan
Jika Anda ingin membuat panel pita kustom, Anda harus menentukan informasi kelas runtime dalam pRTI. Kelas panel pita kustom harus berasal dari CMFCRibbonPanel kelas .
Ikon default untuk panel pita ditampilkan ketika ruang tidak mencukupi untuk menampilkan elemen pita.
Contoh
Contoh berikut menunjukkan cara menggunakan AddPanel metode di CMFCRibbonCategory kelas .
// Create "Favorites" panel:
strTemp.LoadString(IDS_RIBBON_FAVORITES);
// CMFCRibbonCategory* pCategoryCustom
CMFCRibbonPanel *pPanelFavorites = pCategoryCustom->AddPanel(strTemp,
m_PanelImages.ExtractIcon(15));
CMFCRibbonCategory::CMFCRibbonCategory
Membuat dan menginisialisasi objek CMFCRibbonCategory .
CMFCRibbonCategory(
CMFCRibbonBar* pParenrRibbonBar,
LPCTSTR lpszName,
UINT uiSmallImagesResID,
UINT uiLargeImagesResID,
CSize sizeSmallImage = CSize(16,
16),
CSize sizeLargeImage = CSize(32,
32));
Parameter
pParenrRibbonBar
[di] Penunjuk ke bilah pita induk dari kategori pita.
lpszName
[di] Nama kategori pita.
uiSmallImagesResID
[di] ID sumber daya daftar gambar untuk gambar kecil yang digunakan oleh elemen pita dalam kategori pita.
uiLargeImagesResID
[di] ID sumber daya daftar gambar untuk gambar besar yang digunakan oleh elemen pita dalam kategori pita.
sizeSmallImage
[di] Ukuran default gambar kecil untuk elemen pita dalam kategori pita.
sizeLargeImage
[di] Ukuran default gambar besar untuk elemen pita dalam kategori pita.
CMFCRibbonCategory::CopyFrom
Menyalin status CMFCRibbonCategory yang ditentukan ke objek CMFCRibbonCategory saat ini.
virtual void CopyFrom(CMFCRibbonCategory& src);
Parameter
src
[di] Objek sumber CMFCRibbonCategory .
Keterangan
CMFCRibbonCategory::FindByData
Mengambil elemen pita yang terkait dengan data yang ditentukan.
CMFCRibbonBaseElement* FindByData(
DWORD_PTR dwData,
BOOL bVisibleOnly = TRUE) const;
Parameter
dwData
[di] Data yang terkait dengan elemen pita.
bVisibleOnly
[di] TRUE untuk menyertakan elemen pita akses cepat dalam pencarian; FALSE untuk mengecualikan elemen pita akses cepat dalam pencarian.
Tampilkan Nilai
Penunjuk ke elemen pita jika metode berhasil; jika tidak, NULL.
Keterangan
CMFCRibbonCategory::FindByID
Mengambil elemen pita yang terkait dengan ID perintah yang ditentukan.
CMFCRibbonBaseElement* FindByID(
UINT uiCmdID,
BOOL bVisibleOnly = TRUE) const;
Parameter
uiCmdID
[di] ID Perintah yang terkait dengan elemen pita.
bVisibleOnly
[di] TRUE untuk menyertakan elemen pita akses cepat dalam pencarian; FALSE untuk mengecualikan elemen pita akses cepat dalam pencarian.
Tampilkan Nilai
Penunjuk ke elemen pita jika metode berhasil; jika tidak, NULL.
Keterangan
CMFCRibbonCategory::FindPanelWithElem
Mengambil panel pita yang berisi elemen pita yang ditentukan.
CMFCRibbonPanel* FindPanelWithElem(const CMFCRibbonBaseElement* pElement);
Parameter
pElement
[di] Penunjuk ke elemen pita.
Tampilkan Nilai
Penunjuk ke panel pita jika metode berhasil; jika tidak, NULL.
Keterangan
CMFCRibbonCategory::GetContextID
Mengambil ID konteks kategori pita.
UINT GetContextID() const;
Tampilkan Nilai
ID Konteks kategori pita.
Keterangan
ID konteks adalah 0 jika kategori pita bukan kategori pita konteks.
CMFCRibbonCategory::GetData
Mengambil data yang ditentukan pengguna yang terkait dengan kategori pita.
DWORD_PTR GetData() const;
Tampilkan Nilai
Data yang ditentukan pengguna yang terkait dengan kategori pita.
CMFCRibbonCategory::GetDroppedDown
Mengambil penunjuk ke elemen pita yang saat ini memiliki menu pop-up yang ditampilkan.
CMFCRibbonBaseElement* GetDroppedDown();
Tampilkan Nilai
Penunjuk ke elemen pita jika metode berhasil; jika tidak, NULL.
Keterangan
CMFCRibbonCategory::GetElements
Mengambil semua elemen pita dalam kategori pita.
void GetElements(
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameter
arElemen
[masuk, keluar] Referensi ke CArray elemen pita.
Keterangan
Elemen pita yang dirancang untuk digunakan pada toolbar akses cepat disertakan dalam array.
CMFCRibbonCategory::GetElementsByID
Mengambil semua elemen pita yang terkait dengan ID perintah yang ditentukan.
void GetElementsByID(
UINT uiCmdID,
CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Parameter
uiCmdID
[di] ID Perintah yang terkait dengan elemen pita.
arElemen
[masuk, keluar] Referensi ke CArray elemen pita.
Keterangan
Elemen pita yang dirancang untuk digunakan pada toolbar akses cepat disertakan dalam array.
CMFCRibbonCategory::GetFirstVisibleElement
Mengambil elemen pertama yang terlihat yang termasuk dalam kategori pita.
CMFCRibbonBaseElement* GetFirstVisibleElement() const;
Tampilkan Nilai
Penunjuk ke elemen pertama yang terlihat; mungkin NULL jika kategori tidak memiliki elemen yang terlihat.
Keterangan
CMFCRibbonCategory::GetFocused
Mengembalikan elemen yang difokuskan.
CMFCRibbonBaseElement* GetFocused();
Tampilkan Nilai
Penunjuk ke elemen yang difokuskan atau NULL.
Keterangan
CMFCRibbonCategory::GetHighlighted
Mengembalikan elemen yang disorot.
CMFCRibbonBaseElement* GetHighlighted();
Tampilkan Nilai
Penunjuk ke elemen yang disorot atau NULL jika tidak ada elemen yang disorot.
Keterangan
CMFCRibbonCategory::GetImageCount
Mengambil jumlah gambar dalam daftar gambar yang ditentukan yang terkandung dalam kategori pita.
int GetImageCount(BOOL bIsLargeImage) const;
Parameter
bIsLargeImage
[di] TRUE untuk jumlah gambar dalam daftar gambar besar; FALSE untuk jumlah gambar dalam daftar gambar kecil.
Tampilkan Nilai
Jumlah gambar dalam daftar gambar yang ditentukan.
Keterangan
CMFCRibbonCategory::GetImageSize
Mengambil ukuran gambar dalam daftar gambar yang ditentukan yang terkandung dalam kategori pita.
CSize GetImageSize(BOOL bIsLargeImage) const;
Parameter
bIsLargeImage
[di] TRUE untuk ukuran gambar besar; FALSE untuk ukuran gambar kecil.
Tampilkan Nilai
Ukuran gambar dalam daftar gambar yang ditentukan.
Keterangan
Ukuran yang diambil mencakup faktor skala gambar global.
CMFCRibbonCategory::GetItemIDsList
Mengambil ID perintah untuk elemen pita yang terkandung dalam kategori pita.
void GetItemIDsList(
CList<UINT, UINT>& lstItems,
BOOL bHiddenOnly = FALSE) const;
Parameter
lstItems
[out] Daftar ID perintah untuk elemen pita dalam kategori pita.
bHiddenOnly
[di] TRUE untuk mengecualikan elemen pita yang ditampilkan pada panel pita dalam kategori pita; FALSE untuk menyertakan semua elemen pita dalam kategori pita.
Keterangan
CMFCRibbonCategory::GetLargeImages
Mengambil daftar gambar besar yang terkandung dalam kategori pita.
CMFCToolBarImages& GetLargeImages();
Tampilkan Nilai
Daftar gambar besar yang terkandung dalam kategori pita.
CMFCRibbonCategory::GetLastVisibleElement
Mengambil elemen terakhir yang terlihat yang termasuk dalam kategori pita.
CMFCRibbonBaseElement* GetLastVisibleElement() const;
Tampilkan Nilai
Penunjuk ke elemen terakhir yang terlihat; mungkin NULL jika kategori tidak memiliki elemen yang terlihat.
Keterangan
CMFCRibbonCategory::GetMaxHeight
Mengambil tinggi maksimum panel pita yang terkandung dalam kategori pita.
int GetMaxHeight(CDC* pDC);
Parameter
pDC
[di] Penunjuk ke konteks perangkat untuk panel pita.
Tampilkan Nilai
Tinggi maksimum panel pita yang terkandung dalam kategori pita.
Keterangan
Nilai yang diambil mencakup tinggi margin atas dan bawah untuk panel pita.
CMFCRibbonCategory::GetName
Mengambil nama kategori pita.
LPCTSTR GetName() const;
Tampilkan Nilai
Nama kategori pita.
Keterangan
CMFCRibbonCategory::GetPanel
Mengembalikan penunjuk ke panel pita yang terletak di indeks yang ditentukan.
CMFCRibbonPanel* GetPanel(int nIndex);
Parameter
nIndex
[di] Indeks berbasis nol panel pita.
Tampilkan Nilai
Penunjuk ke panel pita yang terletak di indeks yang ditentukan.
Keterangan
Pengecualian dilemparkan jika nIndex berada di luar jangkauan.
CMFCRibbonCategory::GetPanelCount
Mengembalikan jumlah panel pita dalam kategori pita.
int GetPanelCount() const;
Tampilkan Nilai
Jumlah panel pita dalam kategori pita.
CMFCRibbonCategory::GetPanelFromPoint
Mengambil penunjuk ke panel pita jika titik yang ditentukan terletak di dalamnya.
CMFCRibbonPanel* GetPanelFromPoint(CPoint point) const;
Parameter
ujung
[di] Koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.
Tampilkan Nilai
Penunjuk ke panel pita jika metode berhasil; jika tidak, NULL.
Keterangan
Hanya panel pita yang terkandung dalam kategori pita yang diuji.
CMFCRibbonCategory::GetPanelIndex
Mengambil indeks berbasis nol dari panel pita yang ditentukan.
int GetPanelIndex(const CMFCRibbonPanel* pPanel) const;
Parameter
pPanel
[di] Penunjuk ke panel pita.
Tampilkan Nilai
Indeks berbasis nol dari panel pita yang ditentukan jika metode berhasil; jika tidak -1.
Keterangan
Hanya panel pita yang terkandung dalam kategori pita yang dicari.
CMFCRibbonCategory::GetParentButton
Mengambil elemen pita induk dari kategori pita.
CMFCRibbonBaseElement* GetParentButton() const;
Tampilkan Nilai
Mengembalikan penunjuk ke elemen pita induk, atau NULL jika tidak ada elemen induk.
Keterangan
CMFCRibbonCategory::GetParentMenuBar
Mengembalikan penunjuk ke bilah CMFCRibbonCategory menu induk objek.
CMFCRibbonPanelMenuBar* GetParentMenuBar() const;
Tampilkan Nilai
Mengembalikan konten anggota yang m_pParentMenuBar dilindungi.
Keterangan
CMFCRibbonCategory::GetParentRibbonBar
Mengambil bilah pita induk untuk kategori pita.
CMFCRibbonBar* GetParentRibbonBar() const;
Tampilkan Nilai
Penunjuk ke bilah pita induk untuk kategori pita.
Keterangan
CMFCRibbonCategory::GetRect
Mengambil persegi tampilan untuk kategori pita.
CRect GetRect() const;
Tampilkan Nilai
Persegi panjang tampilan untuk kategori pita.
Keterangan
Persegi panjang tampilan untuk kategori pita tidak menyertakan tab kategori.
CMFCRibbonCategory::GetSmallImages
Mengambil daftar gambar kecil yang terkandung dalam kategori pita.
CMFCToolBarImages& GetSmallImages();
Tampilkan Nilai
Daftar gambar kecil yang terkandung dalam kategori pita.
CMFCRibbonCategory::GetTabColor
Mengembalikan warna tab kategori pita saat ini.
AFX_RibbonCategoryColor GetTabColor() const;
Tampilkan Nilai
Warna tab kategori pita saat ini.
Keterangan
Nilai yang dikembalikan bisa menjadi salah satu nilai enumerasi berikut:
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet
CMFCRibbonCategory::GetTabRect
Mengambil persegi tampilan untuk tab kategori pita.
CRect GetTabRect() const;
Tampilkan Nilai
Persegi tampilan untuk tab kategori pita.
Keterangan
CMFCRibbonCategory::GetTextTopLine
Mengambil lokasi vertikal teks pada tombol pita dalam kategori pita yang menampilkan gambar besar.
int GetTextTopLine() const;
Tampilkan Nilai
Lokasi vertikal teks, dalam piksel, pada tombol pita yang menampilkan gambar besar.
Keterangan
CMFCRibbonCategory::GetVisibleElements
Mengambil semua elemen terlihat yang termasuk dalam kategori pita.
void GetVisibleElements(
CArray <CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);
Parameter
arElemen
Array dari semua elemen yang terlihat.
Keterangan
CMFCRibbonCategory::HighlightPanel
Menyoroti panel pita yang ditentukan.
CMFCRibbonPanel* HighlightPanel(
CMFCRibbonPanel* pHLPanel,
CPoint point);
Parameter
pHLPanel
[di] Arahkan ke panel pita untuk disorot.
ujung
[di] Koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.
Tampilkan Nilai
Penunjuk ke panel pita yang disorot sebelumnya; jika tidak, NULL jika tidak ada panel pita yang disorot ketika metode ini dipanggil.
Keterangan
Untuk informasi selengkapnya tentang menyoroti panel pita, lihat CMFCRibbonPanel::Highlight.
CMFCRibbonCategory::HitTest
Mengambil penunjuk ke elemen pita jika titik yang ditentukan terletak di dalamnya.
CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE) const;
Parameter
ujung
[di] Koordinat x dan y dari penunjuk mouse, relatif terhadap sudut kiri atas jendela.
bCheckPanelCaption
[di] TRUE untuk menguji keterangan panel pita; FALSE untuk mengecualikan keterangan panel pita.
Tampilkan Nilai
Penunjuk ke elemen pita jika metode berhasil; jika tidak, NULL.
Keterangan
Hanya elemen pita yang terkandung dalam kategori pita yang diuji.
CMFCRibbonCategory::HitTestEx
Mengambil indeks berbasis nol dari elemen pita jika titik yang ditentukan terletak di dalamnya.
int HitTestEx(CPoint point) const;
Parameter
ujung
[di] Koordinat x dan y dari penunjuk mouse, relatif terhadap sudut kiri atas jendela.
Tampilkan Nilai
Indeks berbasis nol dari elemen pita jika metode berhasil; jika tidak -1.
Keterangan
Hanya elemen pita yang terkandung dalam kategori pita yang diuji.
CMFCRibbonCategory::HitTestScrollButtons
Jika titik berada dalam tombol gulir kiri atau kanan kategori pita, mengembalikan penunjuk ke tombol tersebut.
CMFCRibbonBaseElement* HitTestScrollButtons(CPoint point) const;
Parameter
ujung
[di] Titik untuk diuji.
Tampilkan Nilai
Jika titik berada dalam persegi panjang pembatas dari tombol kiri atau kanan gulir kategori pita, mengembalikan penunjuk ke tombol tersebut, atau sebaliknya, mengembalikan NULL.
Keterangan
CMFCRibbonCategory::IsActive
Menunjukkan apakah kategori pita adalah kategori aktif pada bilah pita.
BOOL IsActive() const;
Tampilkan Nilai
TRUE jika kategori pita adalah kategori aktif; jika tidak FALSE.
Keterangan
Kategori pita aktif menampilkan panel pitanya.
CMFCRibbonCategory::IsVisible
Menunjukkan apakah kategori pita terlihat.
BOOL IsVisible() const;
Tampilkan Nilai
TRUE jika kategori pita terlihat; jika tidak FALSE.
Keterangan
Kategori pita yang terlihat menampilkan tab kategori.
CMFCRibbonCategory::IsWindows7Look
Menunjukkan apakah pita induk memiliki tampilan Windows 7 (tombol aplikasi persegi kecil).
BOOL IsWindows7Look() const;
Tampilkan Nilai
TRUE jika pita induk memiliki tampilan Windows 7; jika tidak FALSE.
Keterangan
CMFCRibbonCategory::NotifyControlCommand
Mengirimkan pesan perintah WM_NOTIFY ke semua CMFCRibbonPanel elemen di hingga pesan ditangani CMFCRibbonCategory .
virtual BOOL NotifyControlCommand(
BOOL bAccelerator,
int nNotifyCode,
WPARAM wParam,
LPARAM lParam);
Parameter
bAccelerator
[di] TRUE jika perintah ini berasal dari akselerator, atau FALSE sebaliknya.
nNotifyCode
[di] Kode pemberitahuan.
wParam
[di] Bidang pesan WPARAM.
lParam
[di] Bidang LPARAM pesan.
Tampilkan Nilai
Mengembalikan TRUE jika pesan ditangani, atau FALSE jika tidak.
Keterangan
CMFCRibbonCategory::OnCancelMode
Memanggil mode batal di semua CMFCRibbonPanel elemen CMFCRibbonCategory.
virtual void OnCancelMode();
Keterangan
CMFCRibbonCategory::OnDraw
Dipanggil oleh kerangka kerja untuk menggambar kategori pita.
virtual void OnDraw(CDC* pDC);
Parameter
pDC
[di] Penunjuk ke konteks perangkat untuk kategori pita.
Keterangan
CMFCRibbonCategory::OnDrawImage
Dipanggil oleh kerangka kerja untuk menggambar gambar yang ditentukan pada kategori pita.
virtual BOOL OnDrawImage(
CDC* pDC,
CRect rect,
CMFCRibbonBaseElement* pElement,
BOOL bIsLargeImage,
BOOL nImageIndex,
BOOL bCenter);
Parameter
pDC
[di] Penunjuk ke konteks perangkat untuk gambar.
rect
[di] Tampilkan persegi panjang untuk gambar.
pElement
[di] Penunjuk ke elemen pita yang berisi gambar.
bIsLargeImage
[di] TRUE jika gambar berukuran besar; FALSE jika gambar berukuran kecil.
nImageIndex
[di] Indeks berbasis nol gambar dalam array gambar yang terkandung dalam kategori pita.
bCenter
[di] TRUE untuk memerah gambar dalam persegi panjang tampilan; FALSE untuk menggambar gambar di sudut kiri atas persegi panjang tampilan.
Tampilkan Nilai
TRUE jika metode berhasil; jika tidak FALSE.
Keterangan
CMFCRibbonCategory::OnDrawMenuBorder
Dipanggil oleh kerangka kerja untuk menggambar batas menu popup.
virtual void OnDrawMenuBorder(
CDC* pDC,
CMFCRibbonPanelMenuBar* pMenuBar);
Parameter
pDC
[di] Parameter ini tidak digunakan.
pMenuBar
[di] Parameter ini tidak digunakan.
Keterangan
Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk menggambar batas menu popup.
CMFCRibbonCategory::OnKey
Dipanggil oleh kerangka kerja saat pengguna menekan tombol keyboard.
virtual BOOL OnKey(UINT nChar);
Parameter
nChar
Kode kunci virtual untuk kunci yang ditekan pengguna.
Keterangan
CMFCRibbonCategory::OnlButtonDown
Dipanggil oleh kerangka kerja untuk mengambil elemen pita di bawah titik yang ditentukan saat pengguna menekan tombol mouse kiri.
virtual CMFCRibbonBaseElement* OnLButtonDown(CPoint point);
Parameter
ujung
[di] Koordinat x dan y dari penunjuk mouse, relatif terhadap sudut kiri atas jendela.
Tampilkan Nilai
Penunjuk ke elemen pita jika metode berhasil; jika tidak, NULL.
Keterangan
CMFCRibbonCategory::OnlButtonUp
Dipanggil oleh kerangka kerja saat pengguna merilis tombol mouse kiri dan penunjuk berada di atas kategori pita.
virtual void OnLButtonUp(CPoint point);
Parameter
ujung
[di] Koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.
Keterangan
CMFCRibbonCategory::OnMouseMove
Dipanggil oleh kerangka kerja saat penunjuk berpindah pada bilah pita untuk memperbarui tampilan kategori pita.
virtual void OnMouseMove(CPoint point);
Parameter
ujung
[di] Koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.
Keterangan
CMFCRibbonCategory::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 panel pita dan elemen pita yang terkandung dalam kategori pita.
CMFCRibbonCategory::OnScrollHorz
Menggulir kategori pita ke arah horizontal.
virtual BOOL OnScrollHorz(
BOOL bScrollLeft,
int nScrollOffset = 0);
Parameter
bScrollLeft
[di] TRUE untuk menggulir ke kiri; FALSE untuk menggulir ke kanan.
nScrollOffset
[di] Jarak gulir dalam piksel.
Tampilkan Nilai
TRUE jika kategori pita dipindahkan ke arah horizontal; jika tidak FALSE.
Keterangan
CMFCRibbonCategory::OnUpdateCmdUI
OnUpdateCmdUI Memanggil fungsi anggota di setiap CMFCRibbonPanel elemen CMFCRibbonCategory untuk mengaktifkan atau menonaktifkan elemen antarmuka pengguna di dalamnya.
virtual void OnUpdateCmdUI(
CMFCRibbonCmdUI* pCmdUI,
CFrameWnd* pTarget,
BOOL bDisableIfNoHndler);
Parameter
pCmdUI
[di] Penunjuk ke CMFCRibbonCmdUI objek yang menentukan elemen antarmuka pengguna mana yang akan diaktifkan dan yang akan dinonaktifkan.
pTarget
[di] Penunjuk ke jendela yang mengontrol pengaktifan atau penonaktifan elemen antarmuka pengguna.
bDisableIfNoHndler
[di] TRUE untuk menonaktifkan item antarmuka pengguna jika tidak ada handler yang ditentukan dalam peta pesan; jika tidak, FALSE.
Keterangan
CMFCRibbonCategory::RecalcLayout
Menyesuaikan tata letak semua kontrol pada kategori pita.
virtual void RecalcLayout(CDC* pDC);
Parameter
pDC
[di] Penunjuk ke konteks perangkat untuk kategori pita.
Keterangan
CMFCRibbonCategory::RemovePanel
Menghapus panel pita dari kategori pita.
BOOL RemovePanel(
int nIndex,
BOOL bDelete = TRUE);
Parameter
nIndex
[di] Nomor indeks panel yang akan dihapus. Diperoleh dengan memanggil metode CMFCRibbonCategory::GetPanelIndex .
bDelete
[di] TRUE untuk menghapus objek panel dari memori; FALSE untuk menghapus objek panel tanpa menghapusnya.
Tampilkan Nilai
TRUE jika metode berhasil; jika tidak, FALSE.
CMFCRibbonCategory::ReposPanels
Menyesuaikan tata letak semua kontrol pada panel pita yang terkandung dalam kategori pita.
virtual void ReposPanels(CDC* pDC);
Parameter
pDC
[di] Penunjuk ke konteks perangkat untuk panel pita yang terkandung dalam kategori pita.
Keterangan
CMFCRibbonCategory::SetCollapseOrder
Menentukan urutan di mana panel pita kategori pita diciutkan.
void SetCollapseOrder(const CArray<int,int>& arCollapseOrder);
Parameter
arCollapseOrder
[di] Menentukan urutan ciutkan. Array berisi indeks panel pita berbasis nol.
Keterangan
Pustaka mendefinisikan urutan ciutkan. Namun, Anda dapat menyesuaikan perilaku ini dengan menyediakan kategori dengan daftar indeks yang menentukan urutan ciutkan.
Saat kategori mendeteksi bahwa kategori harus menciutkan panel pita, kategori tersebut mencari elemen berikutnya dalam daftar yang ditentukan. Jika daftar kosong, atau Anda belum menentukan elemen yang cukup, maka kategori menggunakan algoritma internal.
Misalnya, kategori memiliki tiga panel pita dan dapat diciutkan beberapa kali hingga semua panel berada dalam status diciutkan sepenuhnya. Anda dapat mengatur urutan ciutkan berikut: 0, 0, 2, 2. Dalam hal ini, kategori akan menciutkan panel 0 dua kali, panel 2 dua kali. Panel yang memiliki indeks 1 tetap tidak dicollapsed.
Contoh
Contoh berikut menunjukkan cara menggunakan SetCollapseOrder metode di CMFCRibbonCategory kelas . Contoh memperlihatkan cara membuat array untuk urutan ciutkan, dan cara mengatur urutan ciutkan ke kategori pita.
CArray<int, int> arCollapseOrder;
arCollapseOrder.Add(0);
arCollapseOrder.Add(1);
arCollapseOrder.Add(2);
// CMFCRibbonCategory* pCategoryHome
pCategoryHome->SetCollapseOrder(arCollapseOrder);
CMFCRibbonCategory::SetData
Mengatur data yang ditentukan pengguna untuk dikaitkan dengan kategori pita.
void SetData(DWORD_PTR dwData);
Parameter
dwData
[di] Data yang ditentukan pengguna.
CMFCRibbonCategory::SetKeys
Menetapkan tips tombol ke kategori pita.
void SetKeys(LPCTSTR lpszKeys);
Parameter
lpszKeys
[di] Teks tip kunci.
Keterangan
Tips tombol ditampilkan saat pengguna menekan tombol Alt atau tombol F10.
CMFCRibbonCategory::SetName
Menetapkan nama dan tips tombol ke kategori pita.
void SetName(LPCTSTR lpszName);
Parameter
lpszName
[di] Nama dan tips kunci kategori pita.
Keterangan
Untuk mengatur tips tombol untuk kategori pita, tambahkan urutan escape baris baru diikuti dengan karakter keytip ke lpszName.
CMFCRibbonCategory::SetTabColor
Mengatur warna kategori pita.
void SetTabColor(AFX_RibbonCategoryColor color);
Parameter
warna
[di] Menentukan warna baru kategori pita.
Keterangan
Warna 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