Kelas CMFCRibbonPanel

Artikel
10/12/2023

Mengimplementasikan panel yang berisi sekumpulan elemen pita. Ketika panel digambar, panel menampilkan elemen sebanyak mungkin, mengingat ukuran panel.

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

Sintaks

class CMFCRibbonPanel : public CObject

Anggota

Konstruktor yang Dilindungi

Nama	Deskripsi
CMFCRibbonPanel::CMFCRibbonPanel	Membuat dan menginisialisasi `CMFCRibbonPanel` objek.

Metode Publik

Nama	Deskripsi
CMFCRibbonPanel::Tambahkan	Menambahkan elemen pita ke panel.
CMFCRibbonPanel::AddSeparator	Menambahkan pemisah ke panel pita.
CMFCRibbonPanel::AddToolBar	Menambahkan bilah alat ke panel pita.
CMFCRibbonPanel::FindByData
CMFCRibbonPanel::FindByID	Mengembalikan elemen yang diidentifikasi oleh ID perintah tertentu.
CMFCRibbonPanel::GetCaptionHeight
CMFCRibbonPanel::GetCount	Mengembalikan jumlah elemen di panel pita.
CMFCRibbonPanel::GetData	Mengembalikan data yang ditentukan pengguna yang terkait dengan panel.
CMFCRibbonPanel::GetDefaultButton
CMFCRibbonPanel::GetDroppedDown
CMFCRibbonPanel::GetElement	Mengembalikan elemen pita yang terletak di indeks tertentu.
CMFCRibbonPanel::GetElements	Mengambil semua elemen yang terkandung dalam panel pita.
CMFCRibbonPanel::GetElementsByID
CMFCRibbonPanel::GetFocused	Mengembalikan elemen yang difokuskan.
CMFCRibbonPanel::GetGalleryRect	Mengembalikan persegi panjang pembatas elemen Galeri.
CMFCRibbonPanel::GetHighlighted
CMFCRibbonPanel::GetIndex
CMFCRibbonPanel::GetItemIDsList
CMFCRibbonPanel::GetName
CMFCRibbonPanel::GetParentButton
CMFCRibbonPanel::GetParentCategory	Mengembalikan kategori induk panel pita.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanel::GetPreferedMenuLocation
CMFCRibbonPanel::GetPressed
CMFCRibbonPanel::GetRect
CMFCRibbonPanel::GetVisibleElements	Mendapatkan array elemen yang terlihat.
CMFCRibbonPanel::HasElement
CMFCRibbonPanel::HitTest
CMFCRibbonPanel::HitTestEx
CMFCRibbonPanel::Insert	Menyisipkan elemen pita pada posisi yang diberikan.
CMFCRibbonPanel::InsertSeparator	Menyisipkan pemisah pada posisi yang diberikan.
CMFCRibbonPanel::IsCenterColumnVert	Menentukan apakah semua elemen panel harus dipusatkan (diratakan) secara vertikal, menurut kolom.
CMFCRibbonPanel::IsCollapsed
CMFCRibbonPanel::IsHighlighted
CMFCRibbonPanel::IsJustifyColumns	Menentukan apakah semua kolom panel memiliki lebar yang sama.
CMFCRibbonPanel::IsMainPanel
CMFCRibbonPanel::IsMenuMode
CMFCRibbonPanel::MakeGalleryItemVisible	Menggulir galeri untuk membuat elemen Pita yang ditentukan terlihat.
CMFCRibbonPanel::OnKey
CMFCRibbonPanel::RecalcWidths
CMFCRibbonPanel::Hapus	Menghapus dan secara opsional menghapus elemen yang terletak di indeks yang ditentukan.
CMFCRibbonPanel::RemoveAll	Menghapus semua elemen dari panel pita.
CMFCRibbonPanel::Replace	Mengganti satu elemen dengan elemen lain berdasarkan nilai indeks masing-masing.
CMFCRibbonPanel::ReplaceByID	Mengganti satu elemen dengan elemen lainnya berdasarkan ID perintah tertentu.
CMFCRibbonPanel::SetCenterColumnVert	Mengurutkan panel untuk meratakan elemen secara vertikal, menurut kolom.
CMFCRibbonPanel::SetData	Mengaitkan data yang ditentukan pengguna dengan panel pita.
CMFCRibbonPanel::SetElementMenu	Menetapkan menu popup ke elemen yang memiliki ID perintah yang diberikan.
CMFCRibbonPanel::SetElementRTC	Menambahkan elemen pita yang ditentukan oleh informasi kelas runtime yang disediakan ke panel pita.
CMFCRibbonPanel::SetElementRTCByID	Menambahkan elemen pita yang ditentukan oleh informasi kelas runtime yang disediakan ke panel pita.
CMFCRibbonPanel::SetFocused	Mengatur fokus ke elemen Pita yang ditentukan.
CMFCRibbonPanel::SetJustifyColumns	Mengaktifkan atau menonaktifkan pembenaran kolom.
CMFCRibbonPanel::SetKeys	Mengatur pintasan keyboard yang menampilkan panel pita.
CMFCRibbonPanel::ShowPopup

Keterangan

Panel pita adalah pengelompokan logis tugas terkait yang Anda buat dalam kategori pita. Saat ukuran pita berubah, tata letak panel secara otomatis menyesuaikan untuk menampilkan elemen sebanyak mungkin.

Anda bisa mendapatkan panel pita yang terkandung dalam kategori pita dengan memanggil metode CMFCRibbonCategory::GetPanel .

Contoh

Contoh berikut menunjukkan cara mengonfigurasi CMFCRibbonPanel objek dengan menggunakan berbagai metode di CMFCRibbonPanel kelas . Contoh memperlihatkan cara mengatur pintasan keyboard yang menampilkan panel pita, meratakan elemen di panel secara vertikal menurut kolom, dan mengaktifkan pembenaran kolom. Cuplikan kode ini adalah bagian dari sampel Demo MS Office 2007.

// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();

Hierarki Warisan

CObject

CMFCRibbonPanel

Persyaratan

Header: afxRibbonPanel.h

CMFCRibbonPanel::Tambahkan

Menambahkan elemen pita yang ditentukan ke array elemen pita yang terkandung dalam panel pita.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parameter

pElem
[masuk, keluar] Penunjuk ke elemen pita.

Keterangan

CMFCRibbonPanel::AddSeparator

Menambahkan pemisah ke panel pita.

virtual void AddSeparator();

Keterangan

Panggil metode ini untuk menambahkan pemisah ke panel pita. Pemisah akan ditambahkan di samping elemen pita yang ditambahkan oleh panggilan sebelumnya ke CMFCRibbonPanel::Add. Untuk menyisipkan pemisah pada posisi tertentu, panggil CMFCRibbonPanel::InsertSeparator.

CMFCRibbonPanel::AddToolBar

Menambahkan bilah alat ke panel pita.

CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);

Parameter

uiToolbarResID
[di] Menentukan ID sumber daya bilah alat yang akan ditambahkan.

uiColdResID
[di] Menentukan ID sumber daya dari gambar dingin toolbar.

uiHotResID
[di] Menentukan ID sumber daya dari gambar panas toolbar.

uiDisabledResID
[di] Menentukan ID sumber daya dari gambar toolbar yang dinonaktifkan.

Tampilkan Nilai

Panggil metode ini untuk menambahkan bilah alat ke panel pita. Toolbar akan ditambahkan di samping elemen pita yang ditambahkan oleh panggilan sebelumnya ke CMFCRibbonPanel::Add.

Keterangan

Untuk informasi selengkapnya tentang toolbar, gambar panas, gambar dingin, dan gambar yang dinonaktifkan, lihat Kelas CMFCToolBar.

CMFCRibbonPanel::CMFCRibbonPanel

Membangun dan menginisialisasi objek CMFCRibbonPanel .

CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);

CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);

Parameter

lpszName
[di] Nama panel pita.

hIcon
[di] Tangani ke ikon tombol default untuk panel pita.

pPaletteButton
[di] Penunjuk ke galeri pita untuk panel pita.

CMFCRibbonPanel::FindByData

Mengambil elemen pita yang terkait dengan data yang ditentukan.

CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;

Parameter

dwData
[di] Data yang terkait dengan elemen pita.

Tampilkan Nilai

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

Keterangan

CMFCRibbonPanel::FindByID

Mengambil elemen pita yang diidentifikasi oleh ID perintah yang ditentukan.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;

Parameter

uiCmdID
[di] ID perintah elemen pita.

Tampilkan Nilai

Elemen pita yang diidentifikasi oleh ID perintah yang ditentukan; jika tidak, NULL jika tidak ada elemen pita yang diidentifikasi dengan ID perintah yang ditentukan.

CMFCRibbonPanel::GetCaptionHeight

Mengambil tinggi keterangan untuk panel pita.

int GetCaptionHeight() const;

Tampilkan Nilai

Tinggi, dalam piksel, keterangan untuk panel pita.

Keterangan

CMFCRibbonPanel::GetCount

Mengambil jumlah elemen pita yang terkandung dalam panel pita.

int GetCount() const;

Tampilkan Nilai

Jumlah elemen pita yang terkandung dalam panel pita.

CMFCRibbonPanel::GetData

Mengembalikan data yang ditentukan pengguna yang terkait dengan panel.

DWORD_PTR GetData() const;

Tampilkan Nilai

Data yang ditentukan pengguna yang terkait dengan panel.

CMFCRibbonPanel::GetDefaultButton

Mengambil tombol default untuk panel pita.

CMFCRibbonButton& GetDefaultButton();

Tampilkan Nilai

Tombol default untuk panel pita.

Keterangan

Tombol default ditampilkan ketika panel pita memiliki ruang yang tidak mencukupi untuk menampilkan elemen pitanya.

CMFCRibbonPanel::GetDroppedDown

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

CMFCRibbonBaseElement* GetDroppedDown() const;

Tampilkan Nilai

Penunjuk ke elemen pita yang menu pop-upnya turun bawah; jika tidak, NULL jika tidak ada elemen pita yang memiliki menu pop-up turun bawah.

Keterangan

Hanya elemen pita yang terkandung dalam panel pita yang diuji.

CMFCRibbonPanel::GetElement

Mengembalikan elemen pita yang terletak di indeks tertentu.

CMFCRibbonBaseElement* GetElement(int nIndex) const;

Parameter

nIndex
[di] Menentukan indeks berbasis nol dari elemen yang akan diambil.

Tampilkan Nilai

Penunjuk yang valid ke elemen pita dasar yang terletak di posisi nIndex di panel pita, atau NULL jika tidak ada elemen pada indeks yang ditentukan.

CMFCRibbonPanel::GetElements

Mengambil semua elemen pita yang terkandung dalam panel pita.

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

Parameter

arElemen
[out] Array untuk diisi dengan semua elemen pita yang terkandung dalam panel pita.

Keterangan

CMFCRibbonPanel::GetElementsByID

Menambahkan elemen pita yang memiliki ID perintah yang ditentukan ke array yang ditentukan.

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

Parameter

uiCmdID
[di] ID Perintah untuk elemen pita.

arElemen
[di] Array elemen pita.

Keterangan

Hanya elemen pita yang terkandung dalam panel pita yang diuji.

CMFCRibbonPanel::GetHighlighted

Mengambil elemen pita yang disorot pada panel pita.

CMFCRibbonBaseElement* GetHighlighted() const;

Tampilkan Nilai

Penunjuk ke elemen pita yang disorot pada panel pita.

Keterangan

CMFCRibbonPanel::GetIndex

Mengambil indeks berbasis nol dari elemen pita yang ditentukan dari array elemen pita yang terdapat di panel pita.

virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;

Parameter

pElem
[di] Penunjuk ke elemen pita.

Tampilkan Nilai

Indeks berbasis nol dari elemen pita yang ditentukan jika metode berhasil; jika tidak -1.

Keterangan

CMFCRibbonPanel::GetItemIDsList

Mengambil ID perintah untuk semua elemen pita di panel pita.

void GetItemIDsList(CList<UINT, UINT>& lstItems) const;

Parameter

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

Keterangan

CMFCRibbonPanel::GetName

Mengambil nama panel pita.

LPCTSTR GetName() const;

Tampilkan Nilai

Nama panel pita.

Keterangan

CMFCRibbonPanel::GetParentButton

CMFCRibbonBaseElement* GetParentButton() const;

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetParentCategory

Mengembalikan kategori induk panel pita.

CMFCRibbonCategory* GetParentCategory() const;

Tampilkan Nilai

Penunjuk ke kategori pita yang berisi panel pita ini.

CMFCRibbonPanel::GetParentMenuBar

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetPreferedMenuLocation

Mengambil persegi panjang tampilan pilihan untuk menu pop-up panel pita.

virtual BOOL GetPreferedMenuLocation(CRect& rect);

Parameter

rect
[out] Parameter ini tidak digunakan.

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk mengambil persegi panjang tampilan pilihan untuk menu pop-up panel pita.

CMFCRibbonPanel::GetPressed

Mengambil penunjuk ke elemen pita pada panel pita jika pengguna saat ini menekannya.

CMFCRibbonBaseElement* GetPressed() const;

Tampilkan Nilai

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

Keterangan

CMFCRibbonPanel::GetRect

Mengambil persegi tampilan untuk panel pita.

const CRect& GetRect() const;

Tampilkan Nilai

Persegi tampilan untuk panel pita.

Keterangan

CMFCRibbonPanel::HasElement

Menunjukkan apakah panel pita berisi elemen pita yang ditentukan.

BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;

Parameter

pElem
[di] Penunjuk ke elemen pita.

Tampilkan Nilai

TRUE jika panel pita berisi elemen pita yang ditentukan; jika tidak FALSE.

Keterangan

CMFCRibbonPanel::Sorotan

Mengatur warna sorotan untuk panel pita yang dipilih dan untuk elemen pita yang ditentukan oleh titik.

virtual void Highlight(
BOOL bHighlight,
CPoint point);

Parameter

bHighlight
[di] TRUE untuk menyoroti panel pita; FALSE untuk melepas paha panel pita.

ujung
[di] Koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.

Keterangan

CMFCRibbonPanel::HitTest

Mengambil elemen pita jika titik yang ditentukan terletak di dalamnya.

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

Parameter

ujung
[di] Koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.

bCheckPanelCaption
[di] TRUE untuk menguji keterangan panel pita; jika tidak FALSE.

Tampilkan Nilai

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

Keterangan

Hanya elemen pita yang terkandung dalam panel pita yang diuji.

CMFCRibbonPanel::HitTestEx

Mengambil indeks berbasis nol dari elemen pita yang memiliki titik yang ditentukan yang terletak di dalamnya.

virtual int HitTestEx(CPoint point) const;

Parameter

ujung
[di] Koordinat x dan y penunjuk, relatif terhadap sudut kiri atas jendela.

Tampilkan Nilai

Indeks berbasis nol dari elemen pita yang memiliki titik yang ditentukan yang terletak di dalamnya; jika tidak -1.

Keterangan

Hanya elemen pita yang terkandung dalam panel pita yang diuji.

CMFCRibbonPanel::Insert

Menyisipkan elemen pita yang ditentukan pada posisi yang ditentukan dalam array elemen pita yang terkandung dalam panel pita.

virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);

Parameter

pElem
[masuk, keluar] Penunjuk ke elemen pita.

nIndex
[di] Nilai berbasis nol, mulai dari -1 hingga jumlah elemen pita yang terkandung dalam array.

Tampilkan Nilai

TRUE jika elemen pita berhasil disisipkan; jika tidak FALSE.

Keterangan

Jika nilai nIndex adalah -1, atau jika nIndex sama dengan jumlah elemen pita dalam array, elemen pita yang ditentukan ditambahkan ke akhir array. Jika nilai nIndex berada di luar rentang, metode akan gagal.

CMFCRibbonPanel::InsertSeparator

Menyisipkan pemisah pada posisi yang diberikan.

virtual BOOL InsertSeparator(int nIndex);

Parameter

nIndex
[di] Menentukan indeks berbasis nol tempat pemisah disisipkan.

Tampilkan Nilai

TRUE jika pemisah berhasil dimasukkan; jika tidak, FALSE.

Keterangan

Panggil metode ini untuk menyisipkan pemisah pada posisi yang ditentukan oleh nIndex. Untuk menyisipkan pemisah di samping elemen pita yang terakhir ditambahkan, panggil CMFCRibbonPanel::AddSeparator.

CMFCRibbonPanel::IsCenterColumnVert

Menunjukkan apakah posisi vertikal elemen pita dipusatkan di dalam persegi panjang tampilannya.

BOOL IsCenterColumnVert() const;

Tampilkan Nilai

TRUE jika posisi vertikal elemen pita dipusatkan di dalam persegi panjang tampilannya; jika tidak FALSE.

CMFCRibbonPanel::IsCollapsed

Menunjukkan apakah ukuran tampilan panel pita diminimalkan ke arah horizontal.

BOOL IsCollapsed() const;

Tampilkan Nilai

TRUE jika ukuran tampilan panel pita diminimalkan ke arah horizontal; jika tidak FALSE.

Keterangan

Saat panel pita diciutkan, panel pita hanya menampilkan tombol default, namanya, dan panah turun bawah.

CMFCRibbonPanel::IsHighlighted

Menunjukkan apakah tampilan panel pita disorot.

BOOL IsHighlighted() const;

Tampilkan Nilai

TRUE jika tampilan panel pita disorot; jika tidak FALSE.

Keterangan

Tampilan panel pita disorot saat penunjuk berada di atasnya.

CMFCRibbonPanel::IsJustifyColumns

Menunjukkan apakah dimensi tampilan elemen pita yang berada di kolom yang sama di panel pita diatur ke lebar yang sama.

BOOL IsJustifyColumns() const;

Tampilkan Nilai

TRUE jika dimensi tampilan elemen pita yang berada di kolom yang sama di panel pita diatur ke lebar yang sama; jika tidak FALSE.

CMFCRibbonPanel::IsMainPanel

Menunjukkan apakah panel pita adalah panel pita utama.

virtual BOOL IsMainPanel() const;

Tampilkan Nilai

Selalu mengembalikan FALSE.

Keterangan

Metode ini selalu mengembalikan FALSE. Ambil alih metode ini untuk menunjukkan apakah panel pita adalah panel pita utama.

Panel pita utama ditampilkan saat pengguna memilih tombol aplikasi.

CMFCRibbonPanel::IsMenuMode

BOOL IsMenuMode() const;

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::OnKey

virtual BOOL OnKey(UINT nChar);

Parameter

[di] nChar

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::RecalcWidths

Menghitung ulang lebar setiap konfigurasi tata letak tampilan untuk panel pita.

virtual void RecalcWidths(
CDC* pDC,
int nHeight);

Parameter

pDC
[di] Penunjuk ke konteks perangkat untuk panel pita.

nHeight
[di] Tinggi panel pita.

Keterangan

Panel pita mengubah konfigurasi tata letaknya saat lebar yang tersedia berubah.

CMFCRibbonPanel::Hapus

Menghapus dan secara opsional menghapus elemen yang terletak di indeks yang ditentukan.

BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);

Parameter

nIndex
[di] Menentukan indeks berbasis nol elemen yang dihapus dari panel pita.

bDelete
[di] TRUE untuk menghapus elemen yang dihapus; jika tidak, FALSE.

Tampilkan Nilai

TRUE jika elemen telah dihapus dan dihapus (jika bDelete TRUE); FALSE jika elemen tidak dihapus atau jika tidak ada elemen pita yang terletak di nIndex.

Keterangan

Panggil metode ini untuk menghapus elemen dari panel pita.

CMFCRibbonPanel::RemoveAll

Menghapus semua elemen pita dari panel pita.

void RemoveAll();

Keterangan

Semua elemen pita dihapus dari panel pita dan dihancurkan.

CMFCRibbonPanel::Replace

Mengganti satu elemen dengan elemen lain berdasarkan nilai indeksnya.

BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);

Parameter

nIndex
[di] Menentukan indeks berbasis nol dari elemen yang akan diganti.

pElem
[masuk, keluar] Penunjuk yang valid ke elemen yang menggantikan elemen asli.

Tampilkan Nilai

TRUE jika elemen pita asli telah berhasil digantikan oleh elemen pita baru; FALSE jika elemen pita tidak diganti atau jika tidak ada elemen pada indeks yang ditentukan.

Keterangan

Untuk mengganti elemen pita menurut ID perintah, panggil CMFCRibbonPanel::ReplaceByID.

CMFCRibbonPanel::ReplaceByID

Mengganti satu elemen dengan elemen lainnya berdasarkan ID perintah tertentu.

BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);

Parameter

uiCmdID
[di] Menentukan ID perintah elemen yang akan diganti.

pElem
[masuk, keluar] Penunjuk yang valid ke elemen yang akan menggantikan elemen asli.

Tampilkan Nilai

TRUE jika elemen pita asli telah berhasil digantikan oleh elemen pita baru; FALSE jika elemen pita tidak diganti atau jika tidak ada elemen dengan ID perintah yang ditentukan benar-benar ada.

Keterangan

Untuk mengganti elemen pita berdasarkan posisi, panggil CMFCRibbonPanel::Replace.

CMFCRibbonPanel::SetCenterColumnVert

Mengaktifkan atau menonaktifkan pusat posisi vertikal elemen pita dalam persegi panjang tampilannya.

void SetCenterColumnVert(BOOL bSet = TRUE);

Parameter

bSet
[di] TRUE untuk memposisikan posisi vertikal elemen pita dalam persegi panjang tampilannya; FALSE untuk menonaktifkan fitur ini.

Keterangan

CMFCRibbonPanel::SetData

Mengaitkan data yang ditentukan pengguna dengan panel pita.

void SetData(DWORD_PTR dwData);

Parameter

dwData
[di] Menentukan data yang ditentukan pengguna untuk diatur.

Keterangan

Panggil metode ini untuk mengaitkan data yang ditentukan pengguna dengan panel pita.

CMFCRibbonPanel::SetElementMenu

Menetapkan menu popup ke elemen yang memiliki ID perintah yang diberikan.

BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

Parameter

uiCmdID
[di] Menentukan ID perintah elemen pita tempat menu ditambahkan.

hMenu
[di] Menentukan handel ke menu Windows untuk ditambahkan ke panel pita.

bIsDefautCommand
[di] TRUE untuk menentukan bahwa perintah yang terkait dengan elemen pita harus dijalankan jika elemen pita diklik. Dalam hal ini, menu hanya dibuka saat pengguna mengklik panah di samping elemen pita. FALSE untuk menentukan bahwa perintah yang terkait dengan elemen pita tidak boleh dijalankan jika elemen pita diklik. Dalam hal ini, menu popup muncul terlepas dari di mana pengguna mengklik elemen .

bRightAlign
[di] TRUE untuk menentukan bahwa menu popup rata kanan; jika tidak, FALSE.

uiMenuResID
[di] Menentukan ID sumber daya menu untuk ditambahkan ke panel pita.

Tampilkan Nilai

TRUE jika menu telah ditetapkan ke elemen pita; jika tidak, FALSE.

Keterangan

Panggil metode ini untuk menetapkan menu popup ke elemen pita yang memiliki ID perintah yang diberikan.

CMFCRibbonPanel::SetElementRTC

Menambahkan elemen pita yang ditentukan oleh informasi kelas runtime yang disediakan ke panel pita.

CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);

Parameter

nIndex
[di] Menentukan indeks berbasis nol dari elemen pita yang akan ditambahkan.

pRTC
[masuk, keluar] Penunjuk ke informasi kelas runtime untuk elemen pita yang ditambahkan ke panel pita.

Tampilkan Nilai

Elemen pita yang dibuat dengan menggunakan informasi kelas runtime yang ditentukan.

Keterangan

Jika Anda ingin menambahkan elemen kustom (misalnya, tombol warna) ke panel pita, Anda harus menentukan informasi kelas runtime elemen kustom. Pita menyimpan informasi ini, membuat elemen kustom, dan mengganti elemen yang ada yang terletak (diidentifikasi oleh) ID perintah yang ditentukan. Pita kemudian mengembalikan penunjuk ke elemen yang baru dibuat.

CMFCRibbonPanel::SetElementRTCByID

Menambahkan elemen pita yang ditentukan oleh informasi kelas runtime yang disediakan ke panel pita.

CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);

Parameter

uiCmdID
[di] Menentukan ID perintah elemen pita yang akan ditambahkan.

pRTC
[masuk, keluar] Penunjuk ke informasi kelas runtime yang terkait dengan elemen pita yang ditambahkan ke panel pita.

Tampilkan Nilai

Elemen pita yang dibuat dengan menggunakan informasi kelas runtime yang ditentukan.

Keterangan

Jika Anda ingin menambahkan elemen kustom (misalnya, tombol warna) ke panel pita, Anda harus menentukan informasi kelas runtime elemen kustom. Pita menyimpan informasi ini, membuat elemen kustom, dan mengganti elemen yang ada yang terletak di id perintah yang ditentukan. Kemudian mengembalikan penunjuk ke elemen yang baru dibuat.

Contoh

Contoh berikut menunjukkan cara menggunakan SetElementRTCByID metode :

// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:

pPanel->AddToolBar(IDR_MAINFRAME,
    IDB_MAINFRAME256);

CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
    RUNTIME_CLASS (CMFCRibbonColorButton));

// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
    which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
    RGB (0,
    0,
    0));

CMFCRibbonPanel::SetJustifyColumns

Mengaktifkan atau menonaktifkan penyesuaian lebar elemen pita di kolom yang sama.

void SetJustifyColumns(BOOL bSet = TRUE);

Parameter

bSet
[di] TRUE untuk menyesuaikan lebar elemen pita dalam kolom yang sama dengan lebar elemen pita terbesar di kolom; FALSE untuk menonaktifkan penyesuaian lebar ini.

Keterangan

Saat fitur ini diaktifkan di panel pita, lebar elemen pita dalam kolom yang sama disesuaikan dengan lebar elemen pita terbesar di kolom yang sama.

CMFCRibbonPanel::SetKeys

Mengatur tipsalat untuk tombol default panel pita.

void SetKeys(LPCTSTR lpszKeys);

Parameter

lpszKeys
[di] Tipsalat untuk tombol default panel pita.

Keterangan

Tombol default ditampilkan ketika panel pita memiliki ruang yang tidak mencukupi untuk menampilkan elemen pitanya.

CMFCRibbonPanel::ShowPopup

Membuat dan menampilkan menu pop-up untuk panel pita.

CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);

Parameter

pButton
[di] Penunjuk ke tombol default untuk panel pita.

Tampilkan Nilai

Penunjuk ke menu pop-up untuk panel pita jika metode berhasil; jika tidak, NULL.

Keterangan

Menu pop-up untuk panel pita hanya tersedia saat tampilan panel pita diciutkan.

CMFCRibbonPanel::SetFocused

Mengatur fokus ke elemen Pita yang ditentukan.

void SetFocused(CMFCRibbonBaseElement* pNewFocus);

Parameter

pNewFocus
Penunjuk ke elemen Pita yang menerima fokus.

Keterangan

CMFCRibbonPanel::MakeGalleryItemVisible

Menggulir galeri untuk membuat elemen Pita yang ditentukan terlihat.

void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);

Parameter

pItem
Penunjuk ke elemen Pita untuk diperlihatkan.

Keterangan

CMFCRibbonPanel::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

CMFCRibbonPanel::GetVisibleElements

Mengambil array elemen yang terlihat.

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

Parameter

arElemen
Saat fungsi kembali, parameter ini berisi array elemen yang terlihat.

Keterangan

CMFCRibbonPanel::GetGalleryRect

Mengembalikan persegi panjang pembatas elemen Galeri.

CRect GetGalleryRect();

Tampilkan Nilai

Ukuran dan posisi elemen Galeri dalam panel ini.

Keterangan

CMFCRibbonPanel::GetFocused

Mengembalikan elemen yang difokuskan.

CMFCRibbonBaseElement* GetFocused() const;

Tampilkan Nilai

Penunjuk ke elemen yang difokuskan atau NULL.

Keterangan

Lihat juga

Bagan Hierarki
Kelas
Kelas CObject
Kelas CMFCRibbonCategory
Kelas CMFCRibbonBaseElement

Bagikan melalui

Kelas CMFCRibbonPanel

Sintaks

Anggota

Konstruktor yang Dilindungi

Metode Publik

Keterangan

Contoh

Hierarki Warisan

Persyaratan

CMFCRibbonPanel::Tambahkan

Parameter

Keterangan

CMFCRibbonPanel::AddSeparator

Keterangan

CMFCRibbonPanel::AddToolBar

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::CMFCRibbonPanel

Parameter

CMFCRibbonPanel::FindByData

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::FindByID

Parameter

Tampilkan Nilai

CMFCRibbonPanel::GetCaptionHeight

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetCount

Tampilkan Nilai

CMFCRibbonPanel::GetData

Tampilkan Nilai

CMFCRibbonPanel::GetDefaultButton

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetDroppedDown

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetElement

Parameter

Tampilkan Nilai

CMFCRibbonPanel::GetElements

Parameter

Keterangan

CMFCRibbonPanel::GetElementsByID

Parameter

Keterangan

CMFCRibbonPanel::GetHighlighted

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetIndex

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetItemIDsList

Parameter

Keterangan

CMFCRibbonPanel::GetName

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetParentButton

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetParentCategory

Tampilkan Nilai

CMFCRibbonPanel::GetParentMenuBar

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetPreferedMenuLocation

Parameter

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetPressed

Tampilkan Nilai

Keterangan

CMFCRibbonPanel::GetRect

Tampilkan Nilai