Bagikan melalui

Kelas CMFCRibbonGallery

Menerapkan galeri pita gaya Office 2007. Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

Sintaks

class CMFCRibbonGallery : public CMFCRibbonButton

Anggota

Konstruktor Publik

Nama Deskripsi
CMFCRibbonGallery::CMFCRibbonGallery Membuat dan menginisialisasi CMFCRibbonGallery objek.

Metode Publik

Nama Deskripsi
CMFCRibbonGallery::AddGroup Menambahkan grup baru ke galeri.
CMFCRibbonGallery::AddSubItem Menambahkan item menu baru ke menu drop-down.
CMFCRibbonGallery::Clear Menghapus konten galeri.
CMFCRibbonGallery::EnableMenuResize Mengaktifkan atau menonaktifkan perubahan ukuran panel menu.
CMFCRibbonGallery::EnableMenuSideBar Mengaktifkan atau menonaktifkan bilah samping di sebelah kiri menu popup.
CMFCRibbonGallery::GetCompactSize (Penimpaan CMFCRibbonButton::GetCompactSize.)
CMFCRibbonGallery::GetDroppedDown (Penimpaan CMFCRibbonBaseElement::GetDroppedDown.)
CMFCRibbonGallery::GetGroupName Mengembalikan nama grup yang terletak di indeks yang ditentukan.
CMFCRibbonGallery::GetGroupOffset
CMFCRibbonGallery::GetIconsInRow Mengembalikan jumlah item dalam baris galeri pita.
CMFCRibbonGallery::GetItemToolTip Mengembalikan teks tipsalat yang terkait dengan item di galeri.
CMFCRibbonGallery::GetLastSelectedItem Mengembalikan indeks item terakhir di galeri yang dipilih pengguna.
CMFCRibbonGallery::GetPaletteID Mengembalikan ID perintah galeri saat ini.
CMFCRibbonGallery::GetRegularSize (Penimpaan CMFCRibbonButton::GetRegularSize.)
CMFCRibbonGallery::GetSelectedItem
CMFCRibbonGallery::HasMenu (Penimpaan CMFCRibbonButton::HasMenu.)
CMFCRibbonGallery::IsButtonMode Menentukan apakah galeri terkandung dalam tombol galeri.
CMFCRibbonGallery::IsMenuResizeEnabled Menentukan apakah ukuran menu diaktifkan atau dinonaktifkan.
CMFCRibbonGallery::IsMenuResizeVertical
CMFCRibbonGallery::IsMenuSideBar Menentukan apakah bilah samping diaktifkan atau dinonaktifkan.
CMFCRibbonGallery::OnAfterChangeRect (Mengambil alih CMFCRibbonButton::OnAfterChangeRect.)
CMFCRibbonGallery::OnDraw (Penimpaan CMFCRibbonButton::OnDraw.)
CMFCRibbonGallery::OnEnable (Mengambil alih CMFCRibbonBaseElement::OnEnable.)
CMFCRibbonGallery::OnRTLChanged (Penimpaan CMFCRibbonBaseelement::OnRTLChanged.)
CMFCRibbonGallery::RedrawIcons Menguras ulang galeri.
CMFCRibbonGallery::RemoveItemToolTips Menghapus tipsalat dari semua item di galeri.
CMFCRibbonGallery::SelectItem
CMFCRibbonGallery::SetACCData (Penimpaan CMFCRibbonButton::SetACCData.)
CMFCRibbonGallery::SetButtonMode Menentukan apakah akan menampilkan galeri pita sebagai tombol drop-down atau sebagai palet langsung pada pita.
CMFCRibbonGallery::SetGroupName Mengatur nama grup.
CMFCRibbonGallery::SetIconsInRow Menentukan jumlah item per baris di galeri.
CMFCRibbonGallery::SetItemToolTip Mengatur teks tipsalat untuk item di galeri.
CMFCRibbonGallery::SetPalette Melampirkan palet ke galeri pita.
CMFCRibbonGallery::SetPaletteID Menentukan ID perintah yang dikirim dalam pesan WM_COMMAND saat item galeri telah dipilih.

Metode yang Dilindungi

Nama Deskripsi
CMFCRibbonGallery::OnDrawPaletteIcon Dipanggil oleh kerangka kerja saat ikon galeri digambar.

Keterangan

Tombol galeri berulah sama seperti tombol menu biasa kecuali tombol tersebut menampilkan galeri saat pengguna membukanya. Saat Anda memilih item di galeri, kerangka kerja mengirimkan pesan WM_COMMAND bersama dengan ID perintah tombol. Saat menangani pesan, Anda harus memanggil CMFCRibbonGallery::GetLastSelectedItem untuk menentukan item mana yang dipilih dari galeri.

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCRibbonGallery kelas untuk mengonfigurasi CMFCRibbonGallery objek. Contoh ini menggambarkan cara menentukan jumlah item per baris di galeri, mengaktifkan perubahan ukuran panel menu, mengaktifkan bilah samping di sebelah kiri menu pop-up, dan menampilkan galeri pita sebagai palet langsung di bilah pita. Cuplikan kode ini adalah bagian dari sampel Draw Client.

CMFCRibbonGallery *pBtnStyles = new CMFCRibbonGallery(ID_OBJECT_STYLES, _T("Styles\nk"), 0, 0, IDB_STYLES, 40);
pBtnStyles->SetIconsInRow(7);
pBtnStyles->EnableMenuResize(TRUE, TRUE);
pBtnStyles->EnableMenuSideBar();
pBtnStyles->SetButtonMode(false);
pBtnStyles->RedrawIcons();

Hierarki Warisan

CObject
└ CMFCRibbonBaseElement
 └ CMFCRibbonButton
  └ CMFCRibbonGallery

Persyaratan

Header: afxRibbonPaletteGallery.h

CMFCRibbonGallery::AddGroup

Menambahkan grup baru ke galeri.

void AddGroup(
    LPCTSTR lpszGroupName,
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

void AddGroup(
    LPCTSTR lpszGroupName,
    CMFCToolBarImages& imagesGroup);

void AddGroup(
    LPCTSTR lpszGroupName,
    int nIconsNum);

Parameter

lpszGroupName
[di] Menentukan nama grup.

uiImagesPaletteResID
[di] Menentukan ID sumber daya dari daftar gambar yang berisi gambar untuk grup.

cxPaletteImage
[di] Menentukan lebar dalam piksel gambar.

imagesGroup
[di] Referensi ke daftar gambar yang berisi gambar grup.

nIconsNum
[di] Menentukan jumlah ikon dalam grup. Parameter ini harus ditentukan hanya untuk grup kustom (digambar pemilik).

Keterangan

Anda bisa membagi item pada galeri pita menjadi beberapa grup dengan memanggil metode ini. Setiap grup dapat memiliki keterangan.

CMFCRibbonGallery::AddSubItem

Menambahkan item menu baru ke menu drop-down.

void AddSubItem(
    CMFCRibbonBaseElement* pSubItem,
    int nIndex=-1,
    BOOL bOnTop=FALSE);

Parameter

pSubItem
[di] Penunjuk ke item untuk ditambahkan ke menu.

nIndex
[di] Menentukan indeks berbasis nol dari lokasi tempat menyisipkan item.

bOnTop
[di] TRUE untuk menentukan bahwa item harus disisipkan sebelum galeri pita; jika tidak, FALSE.

Keterangan

Anda dapat menggabungkan galeri popup dengan item menu popup dengan memanggil metode ini. Item menu dapat ditempatkan sebelum atau sesudah galeri.

Untuk menyisipkan item sebelum galeri, atur bOnTop ke TRUE. Atur bOnTop ke FALSE untuk menyisipkan item di bawah galeri.

Catatan

Parameter nIndex menentukan indeks penyisipan baik di bagian atas galeri maupun di bagian bawah galeri. Misalnya, jika Anda perlu menyisipkan item satu posisi sebelum galeri, atur nIndex ke 1 dan bOnTop ke TRUE. Demikian pula, jika Anda perlu menyisipkan item satu posisi di bawah galeri, atur nIndex ke 1 dan bOnTop ke FALSE.

CMFCRibbonGallery::Clear

Menghapus konten galeri.

virtual void Clear();

Keterangan

Panggil metode ini untuk menghapus semua konten dari galeri pita. Ini harus dilakukan sebelum Anda melampirkan galeri pita baru atau kumpulan grup ke galeri pita.

CMFCRibbonGallery::CMFCRibbonGallery

Membuat dan menginisialisasi objek CMFCRibbonGallery .

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    UINT uiImagesPaletteResID=0,
    int cxPaletteImage=0);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CSize sizeIcon,
    int nIconsNum,
    BOOL bDefaultButtonStyle=TRUE);

Parameter

Nid
Menentukan ID perintah dari perintah yang akan dijalankan saat pengguna mengklik tombol .

lpszText
Menentukan teks yang akan muncul pada tombol.

nSmallImageIndex
Indeks berbasis nol dari gambar kecil untuk muncul pada tombol .

nLargeImageIndex
Indeks berbasis nol dari gambar besar untuk muncul pada tombol .

imagesPalette
Referensi ke objek CMFCToolBarImages yang berisi gambar untuk muncul di galeri.

uiImagesPaletteResID
ID sumber daya daftar gambar yang akan ditampilkan di galeri.

cxPaletteImage
Menentukan lebar, dalam piksel, gambar di galeri.

sizeIcon
Menentukan ukuran, dalam piksel, gambar galeri.

nIconsNum
Menentukan jumlah ikon di galeri.

bDefaultButtonStyle
Menentukan apakah akan menggunakan gaya tombol default atau digambar pemilik.

Keterangan

CMFCRibbonGallery::EnableMenuResize

Mengaktifkan atau menonaktifkan perubahan ukuran panel menu.

void EnableMenuResize(
    BOOL bEnable = TRUE,
    BOOL bVertcalOnly = FALSE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan mengubah ukuran menu; jika tidak, FALSE.

bVertcalOnly
[di] TRUE untuk menentukan bahwa galeri hanya dapat diubah ukurannya secara vertikal; FALSE untuk menentukan bahwa galeri dapat diubah ukurannya secara vertikal dan horizontal.

Keterangan

Gunakan metode ini untuk mengaktifkan atau menonaktifkan mengubah ukuran galeri pita. Saat mengubah ukuran diaktifkan, galeri pita menampilkan pencengkeram yang bisa digunakan pengguna untuk mengubah ukurannya.

CMFCRibbonGallery::EnableMenuSideBar

Mengaktifkan atau menonaktifkan bilah samping di sebelah kiri menu popup.

void EnablMenuSideBar(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk menentukan bahwa bilah samping diaktifkan; jika tidak, FALSE.

Keterangan

Panggil metode ini untuk mengaktifkan atau menonaktifkan bilah samping gaya Office XP di sisi kiri menu.

CMFCRibbonGallery::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

Parameter

[di] pDC

Tampilkan Nilai

Keterangan

CMFCRibbonGallery::GetDroppedDown

virtual CMFCRibbonBaseElement* GetDroppedDown();

Tampilkan Nilai

Keterangan

CMFCRibbonGallery::GetGroupName

Mengembalikan nama grup yang terletak di indeks yang ditentukan.

LPCTSTR GetGroupName(int nGroupIndex) const;

Parameter

nGroupIndex
[di] Menentukan indeks berbasis nol untuk grup yang namanya ingin Anda ambil.

Tampilkan Nilai

Nama grup yang terletak di indeks yang ditentukan. Meneruskan indeks yang tidak valid akan mengakibatkan pernyataan yang gagal.

Keterangan

CMFCRibbonGallery::GetGroupOffset

virtual int GetGroupOffset() const;

Tampilkan Nilai

Keterangan

CMFCRibbonGallery::GetIconsInRow

Mengembalikan jumlah item dalam baris galeri pita.

int GetIconsInRow() const;

Tampilkan Nilai

Jumlah item berturut-turut.

Keterangan

CMFCRibbonGallery::GetItemToolTip

Mengembalikan teks tipsalat yang terkait dengan item di galeri.

LPCTSTR GetItemToolTip(int nItemIndex) const;

Parameter

nItemIndex
[di] Menentukan indeks berbasis nol item untuk mengambil teks tipsalat.

Tampilkan Nilai

Penunjuk ke string tipsalat yang ditetapkan ke item di galeri pita. Ini bisa NULL jika tidak ada tipsalat yang ditetapkan ke item tersebut.

Keterangan

CMFCRibbonGallery::GetLastSelectedItem

Mengembalikan indeks item terakhir di galeri pita yang dipilih pengguna.

static int GetLastSelectedItem(UINT uiCmdID);

Parameter

uiCmdID
[di] Menentukan ID perintah item menu yang membuka galeri pita.

Tampilkan Nilai

Saat pengguna memilih item apa pun di galeri pita, pustaka mengirimkan pesan WM_COMMAND bersama dengan ID Perintah tombol menu yang membuka galeri pita.

Keterangan

CMFCRibbonGallery::GetPaletteID

Mengembalikan ID perintah palet saat ini.

int GetPaletteID() const;

Tampilkan Nilai

ID perintah palet yang saat ini dipilih.

Keterangan

CMFCRibbonGallery::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

Parameter

[di] pDC

Tampilkan Nilai

Keterangan

CMFCRibbonGallery::GetSelectedItem

int GetSelectedItem() const;

Tampilkan Nilai

Keterangan

CMFCRibbonGallery::HasMenu

virtual BOOL HasMenu() const;

Tampilkan Nilai

Keterangan

CMFCRibbonGallery::IsButtonMode

Menentukan apakah palet terkandung dalam tombol galeri.

BOOL IsButtonMode() const;

Tampilkan Nilai

TRUE jika palet ditampilkan sebagai tombol menu drop-down; FALSE jika palet ditampilkan langsung pada pita.

Keterangan

CMFCRibbonGallery::IsMenuResizeEnabled

Menentukan apakah ukuran menu diaktifkan.

BOOL IsMenuResizeEnabled() const;

Tampilkan Nilai

TRUE jika pengurangan ukuran menu telah diaktifkan; jika tidak, FALSE.

Keterangan

CMFCRibbonGallery::IsMenuResizeVertical

BOOL IsMenuResizeVertical() const;

Tampilkan Nilai

Keterangan

CMFCRibbonGallery::IsMenuSideBar

Menentukan apakah bilah samping diaktifkan atau dinonaktifkan.

BOOL IsMenuSideBar() const;

Tampilkan Nilai

TRUE jika bilah samping gaya Office XP digambar di sisi kiri menu popup; jika tidak, FALSE.

Keterangan

CMFCRibbonGallery::OnAfterChangeRect

virtual void OnAfterChangeRect(CDC* pDC);

Parameter

[di] pDC

Keterangan

CMFCRibbonGallery::OnDraw

virtual void OnDraw(CDC* pDC);

Parameter

[di] pDC

Keterangan

CMFCRibbonGallery::OnDrawPaletteIcon

Dipanggil oleh kerangka kerja saat ikon galeri digambar.

virtual void OnDrawPaletteIcon(
    CDC* pDC,
    CRect rectIcon,
    int nIconIndex,
    CMFCRibbonGalleryIcon* pIcon,
    COLORREF clrText);

Parameter

pDC
[di] Penunjuk ke konteks perangkat yang digunakan untuk menggambar.

rectIcon
[di] Menentukan persegi panjang batas ikon yang akan digambar.

nIconIndex
[di] Menentukan indeks berbasis nol dalam daftar gambar ikon galeri ikon yang akan digambar.

pIcon
[di] Penunjuk ke ikon yang sedang digambar.

clrText
[di] Menentukan warna untuk teks item yang akan digambar.

Keterangan

Anda dapat mengambil alih metode ini di kelas turunan untuk mengkustomisasi tampilan galeri pita.

CMFCRibbonGallery::OnEnable

virtual void OnEnable(BOOL bEnable);

Parameter

[di] bEnable

Keterangan

CMFCRibbonGallery::OnRTLChanged

virtual void OnRTLChanged(BOOL bIsRTL);

Parameter

[di] bIsRTL

Keterangan

CMFCRibbonGallery::RedrawIcons

Menguras ulang galeri.

void RedrawIcons();

Keterangan

Panggil fungsi ini untuk menggambar ulang galeri. Anda harus memanggil metode ini jika Anda telah mengubah konten galeri saat runtime.

CMFCRibbonGallery::RemoveItemToolTips

Menghapus tipsalat dari semua item di galeri.

void RemoveItemToolTips();

Keterangan

CMFCRibbonGallery::SelectItem

void SelectItem(int nItemIndex);

Parameter

[di] nItemIndex

Keterangan

CMFCRibbonGallery::SetACCData

Mengisi objek yang ditentukan CAccessibilityData dengan menggunakan data aksesibilitas dari galeri pita.

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

Parameter

pParent
[di] Jendela induk jendela galeri pita.

data
[out] Objek CAccessibilityData yang menerima data aksesibilitas dari galeri pita.

Tampilkan Nilai

Keterangan

TRUE jika metode berhasil; jika tidak, FALSE.

CMFCRibbonGallery::SetButtonMode

Menentukan apakah akan menampilkan galeri pita sebagai tombol drop-down atau sebagai palet langsung pada pita.

void SetButtonMode(BOOL bSet=TRUE);

Parameter

bSet
[di] TRUE untuk menampilkan galeri pita sebagai tombol menu drop-down; FALSE untuk menampilkan konten galeri pita langsung pada pita.

Keterangan

CMFCRibbonGallery::SetGroupName

Mengatur nama grup.

void SetGroupName(
    int nGroupIndex,
    LPCTSTR lpszGroupName);

Parameter

nGroupIndex
[di] Menentukan indeks berbasis nol untuk grup yang namanya sedang diubah.

lpszGroupName
[di] Menentukan nama baru untuk grup.

Keterangan

Grup yang namanya sedang diubah harus ditambahkan menggunakan metode CMFCRibbonGallery::AddGroup .

CMFCRibbonGallery::SetIconsInRow

Menentukan jumlah item per baris di galeri.

void SetIconsInRow(int nIconsInRow);

Parameter

nIconsInRow
[di] Menentukan jumlah item yang akan muncul di setiap baris galeri.

Keterangan

Gunakan metode ini untuk menentukan lebar galeri pita.

CMFCRibbonGallery::SetItemToolTip

Mengatur teks tipsalat untuk item di galeri.

void SetItemToolTip(
    int nItemIndex,
    LPCTSTR lpszToolTip);

Parameter

nItemIndex
[di] Indeks berbasis nol dari item palet untuk mengaitkan tipsalat.

lpszToolTip
[di] Teks yang akan muncul di tipsalat.

Keterangan

CMFCRibbonGallery::SetPalette

Melampirkan palet ke galeri pita.

void SetPalette(CMFCToolBarImages& imagesPalette);

void SetPalette(
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

Parameter

imagesPalette
[di] Menentukan daftar gambar yang berisi ikon yang akan muncul pada galeri.

uiImagesPaletteResID
[di] Menentukan ID sumber daya dari daftar gambar yang berisi ikon untuk muncul di galeri.

cxPaletteImage
[di] Menentukan lebar, dalam piksel, gambar di galeri.

Keterangan

CMFCRibbonGallery::SetPaletteID

Menentukan ID perintah yang dikirim dalam pesan WM_COMMAND saat pengguna memilih item galeri.

void SetPaletteID(UINT nID);

Parameter

Nid
[di] Menentukan ID perintah yang dikirim dalam pesan WM_COMMAND saat pengguna memilih item galeri.

Keterangan

Untuk menentukan item tertentu yang dipilih pengguna dari galeri, panggil metode statis CMFCRibbonGallery::GetLastSelectedItem .

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCRibbonButton
Kelas CMFCRibbonGalleryMenuButton