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.
Kelas CMFCRibbonColorButton mengimplementasikan tombol warna yang bisa Anda tambahkan ke bilah pita. Tombol warna pita menampilkan menu drop-down yang berisi satu atau beberapa palet warna.
Sintaks
class CMFCRibbonColorButton : public CMFCRibbonGallery
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CMFCRibbonColorButton::CMFCRibbonColorButton |
Metode Publik
Keterangan
Tombol warna pita menampilkan bilah warna saat pengguna menekannya. Secara default, bilah warna ini berisi palet pilihan warna yang disebut area warna reguler. Secara opsional, bilah warna dapat menampilkan tombol Otomatis , yang memungkinkan pengguna untuk memilih warna default, dan tombol Lainnya , yang menampilkan palet warna popup yang berisi warna tambahan.
Contoh
Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCRibbonColorButton kelas . Contoh menunjukkan cara membuat CMFCRibbonColorButton objek, mengatur gambar besar, mengaktifkan tombol Otomatis , mengaktifkan tombol Lainnya , mengatur jumlah kolom, mengatur ukuran semua elemen warna yang muncul pada bilah warna, menambahkan sekelompok warna ke area warna reguler, dan menentukan daftar nilai RGB untuk ditampilkan di area warna dokumen. Cuplikan kode ini adalah bagian dari sampel Draw Client.
// Create the "Paper Color" button
CMFCRibbonColorButton *pBtnPaperColor = new CMFCRibbonColorButton(ID_VIEW_PAPERCOLOR, _T("Paper Color\ng"), TRUE, 13, 1);
pBtnPaperColor->SetAlwaysLargeImage();
pBtnPaperColor->EnableAutomaticButton(_T("&Automatic"), RGB(255, 255, 255));
pBtnPaperColor->EnableOtherButton(_T("&More Colors..."), _T("More Colors"));
pBtnPaperColor->SetColumns(10);
pBtnPaperColor->SetColorBoxSize(CSize(17, 17));
// CList<COLORREF,COLORREF> m_lstMainColors
pBtnPaperColor->AddColorsGroup(_T("Theme Colors"), m_lstMainColors, TRUE);
// CList<COLORREF,COLORREF> m_lstAdditionalColors
pBtnPaperColor->AddColorsGroup(_T(""), m_lstAdditionalColors, FALSE);
// CList<COLORREF,COLORREF> m_lstStandardColors
pBtnPaperColor->AddColorsGroup(_T("Standard Colors"), m_lstStandardColors, TRUE);
CList<COLORREF, COLORREF> lstColors;
lstColors.AddTail(RGB(255, 0, 0));
lstColors.AddTail(RGB(0, 255, 0));
lstColors.AddTail(RGB(0, 0, 255));
pBtnPaperColor->SetDocumentColors(_T("Document Colors"), lstColors);
Hierarki Warisan
Persyaratan
Header: afxribboncolorbutton.h
CMFCRibbonColorButton::AddColorsGroup
Menambahkan sekelompok warna ke area warna reguler.
void AddColorsGroup(
LPCTSTR lpszName,
const CList<COLORREF,COLORREF>& lstColors,
BOOL bContiguousColumns=FALSE);
Parameter
lpszName
[di] Nama grup.
lstColors
[di] Daftar warna.
bContiguousColumns
[di] Mengontrol bagaimana item warna ditampilkan dalam grup. Jika TRUE, item warna digambar tanpa penspasian vertikal. Jika FALSE, item warna digambar dengan penspasian vertikal.
Keterangan
Gunakan fungsi ini untuk membuat tampilan pop-up warna beberapa grup warna. Anda dapat mengontrol bagaimana warna ditampilkan dalam grup.
CMFCRibbonColorButton::CMFCRibbonColorButton
Membuat CMFCRibbonColorButton objek.
CMFCRibbonColorButton();
CMFCRibbonColorButton(
UINT nID,
LPCTSTR lpszText,
int nSmallImageIndex,
COLORREF color = RGB(0, 0, 0));
CMFCRibbonColorButton(
UINT nID,
LPCTSTR lpszText,
BOOL bSimpleButtonLook,
int nSmallImageIndex,
int nLargeImageIndex,
COLORREF color = RGB(0, 0, 0));
Parameter
Nid
[di] Menentukan ID perintah dari perintah yang akan dijalankan saat pengguna mengklik tombol .
lpszText
[di] Menentukan teks yang akan muncul pada tombol.
nSmallImageIndex
[di] Indeks berbasis nol dari gambar kecil untuk muncul pada tombol .
warna
[di] Warna tombol (default ke hitam).
bSimpleButtonLook
[di] Jika TRUE, tombol digambar sebagai persegi panjang sederhana.
nLargeImageIndex
[di] Indeks berbasis nol dari gambar besar untuk muncul pada tombol .
Tampilkan Nilai
Keterangan
CMFCRibbonColorButton::EnableAutomaticButton
Menentukan apakah tombol Otomatis diaktifkan.
void EnableAutomaticButton(
LPCTSTR lpszLabel,
COLORREF colorAutomatic,
BOOL bEnable=TRUE,
LPCTSTR lpszToolTip=NULL,
BOOL bOnTop=TRUE,
BOOL bDrawBorder=FALSE);
Parameter
lpszLabel
[di] Label untuk tombol Otomatis .
colorAutomatic
[di] Nilai RGB yang menentukan warna default tombol Otomatis .
bEnable
[di] TRUE jika tombol Otomatis diaktifkan; FALSE jika dinonaktifkan.
lpszToolTip
[di] Tipsalat tombol Otomatis .
bOnTop
[di] Menentukan apakah tombol Otomatis berada di bagian atas, sebelum palet warna.
bDrawBorder
[di] TRUE jika aplikasi menggambar batas di sekitar bilah warna pada tombol warna pita. Bilah warna menampilkan warna yang saat ini dipilih. FALSE jika aplikasi tidak menggambar batas
CMFCRibbonColorButton::EnableOtherButton
Mengaktifkan tombol Lainnya .
void EnableOtherButton(
LPCTSTR lpszLabel,
LPCTSTR lpszToolTip=NULL);
Parameter
lpszLabel
Label tombol.
lpszToolTip
Teks tipsalat untuk tombol Lainnya .
Keterangan
Tombol Lainnya adalah tombol yang ditampilkan di bawah grup warna. Saat pengguna mengklik tombol Lainnya , tombol tersebut menampilkan dialog warna.
CMFCRibbonColorButton::GetAutomaticColor
Mengambil warna tombol otomatis saat ini.
COLORREF GetAutomaticColor() const;
Tampilkan Nilai
Nilai warna RGB yang mewakili warna tombol otomatis saat ini.
Keterangan
Warna tombol otomatis diatur oleh parameter yang diteruskan colorAutomatic ke CMFCRibbonColorButton::EnableAutomaticButton metode .
CMFCRibbonColorButton::GetColor
Mengembalikan warna terpilih saat ini.
COLORREF GetColor() const;
Tampilkan Nilai
Warna dipilih dengan mengklik tombol .
CMFCRibbonColorButton::GetColorBoxSize
Mengembalikan ukuran elemen warna yang muncul pada bilah warna.
CSize GetColorBoxSize() const;
Tampilkan Nilai
Ukuran tombol warna di palet warna drop-down.
CMFCRibbonColorButton::GetColumns
Mendapatkan jumlah item dalam baris tampilan galeri tombol warna pita.
int GetColumns() const;
Tampilkan Nilai
Mengembalikan jumlah ikon di setiap baris.
Keterangan
CMFCRibbonColorButton::GetHighlightedColor
Mengembalikan warna elemen yang saat ini dipilih pada palet warna pop-up.
COLORREF GetHighlightedColor() const;
Tampilkan Nilai
Warna elemen yang saat ini dipilih pada palet warna pop-up.
CMFCRibbonColorButton::RemoveAllColorGroups
Menghapus semua grup warna dari area warna reguler.
void RemoveAllColorGroups();
CMFCRibbonColorButton::SetColor
Memilih warna dari area warna reguler.
void SetColor(COLORREF color);
Parameter
warna
[di] Warna yang akan diatur.
CMFCRibbonColorButton::SetColorBoxSize
Mengatur ukuran semua elemen warna yang muncul pada bilah warna.
void SetColorBoxSize(CSize sizeBox);
Parameter
sizeBox
[di] Ukuran baru tombol warna di palet warna.
CMFCRibbonColorButton::SetColorName
Menyetel nama baru untuk warna tertentu.
static void __stdcall SetColorName(
COLORREF color,
const CString& strName);
Parameter
warna
[di] Nilai RGB warna.
strName
[di] Nama baru untuk warna yang ditentukan.
Keterangan
Karena memanggil CMFCColorBar::SetColorName, metode ini mengubah nama warna yang ditentukan di semua CMFCColorBar objek di aplikasi Anda.
CMFCRibbonColorButton::SetColumns
Mengatur jumlah kolom yang ditampilkan dalam tabel warna yang disajikan kepada pengguna selama proses pemilihan warna pengguna.
void SetColumns(int nColumns);
Parameter
nColumns
[di] Jumlah ikon warna untuk ditampilkan di setiap baris.
Keterangan
CMFCRibbonColorButton::SetDocumentColors
Menentukan daftar nilai RGB untuk ditampilkan di area warna dokumen.
void SetDocumentColors(
LPCTSTR lpszLabel,
CList<COLORREF,COLORREF>& lstColors);
Parameter
lpszLabel
[di] Teks yang akan ditampilkan dengan warna dokumen.
lstColors
[di] Referensi ke daftar nilai RGB.
CMFCRibbonColorButton::SetPalette
Menentukan warna standar untuk ditampilkan dalam tabel warna yang ditampilkan tombol warna.
void SetPalette(CPalette* pPalette);
Parameter
pPalette
[di] Penunjuk ke palet warna.
Keterangan
CMFCRibbonColorButton::UpdateColor
Dipanggil oleh kerangka kerja saat pengguna memilih warna dari tabel warna yang ditampilkan saat pengguna mengklik tombol warna.
void UpdateColor(COLORREF color);
Parameter
warna
[di] Warna yang dipilih oleh pengguna.
Keterangan
Metode mengubah CMFCRibbonColorButton::UpdateColor warna tombol yang saat ini dipilih dan memberi tahu induknya dengan mengirim pesan WM_COMMAND dengan pemberitahuan standar BN_CLICKED. Gunakan metode CMFCRibbonColorButton::GetColor untuk mengambil warna yang dipilih.