Bagikan melalui

Kelas CMFCColorBar

  • Artikel

Kelas CMFCColorBar mewakili bilah kontrol docking yang dapat memilih warna dalam dokumen atau aplikasi.

Sintaks

class CMFCColorBar : public CMFCPopupMenuBar

Anggota

Konstruktor yang Dilindungi

Nama Deskripsi
CMFCColorBar::CMFCColorBar Membuat CMFCColorBar objek.

Metode Publik

Nama Deskripsi
CMFCColorBar::ContextToSize Menghitung margin vertikal dan horizontal yang diperlukan untuk memuat tombol pada kontrol bilah warna lalu menyesuaikan lokasi tombol tersebut.
CMFCColorBar::CreateControl Membuat jendela kontrol bilah warna, melampirkannya ke CMFCColorBar objek, dan mengubah ukuran kontrol agar berisi palet warna yang ditentukan.
CMFCColorBar::Create Membuat jendela kontrol bilah warna dan melampirkannya ke CMFCColorBar objek.
CMFCColorBar::EnableAutomaticButton Menampilkan atau menyembunyikan tombol otomatis.
CMFCColorBar::EnableOtherButton Mengaktifkan atau menonaktifkan tampilan kotak dialog yang memungkinkan pengguna memilih warna lainnya.
CMFCColorBar::GetColor Mengambil warna terpilih saat ini.
CMFCColorBar::GetCommandID Mengambil ID perintah kontrol bilah warna saat ini.
CMFCColorBar::GetHighlightedColor Mengambil warna yang menandakan bahwa tombol warna memiliki fokus; artinya, tombolnya panas.
CMFCColorBar::GetHorzMargin Mengambil margin horizontal, yang merupakan spasi antara sel warna kiri atau kanan dan batas area klien.
CMFCColorBar::GetVertMargin Mengambil margin vertikal, yang merupakan spasi antara sel warna atas atau bawah dan batas area klien.
CMFCColorBar::IsTearOff Menunjukkan apakah bilah warna saat ini dapat di-dock.
CMFCColorBar::SetColor Menyetel warna yang saat ini dipilih.
CMFCColorBar::SetColorName Menyetel nama baru untuk warna tertentu.
CMFCColorBar::SetCommandID Mengatur ID perintah baru untuk kontrol bilah warna.
CMFCColorBar::SetDocumentColors Menyetel daftar warna yang digunakan dalam dokumen saat ini.
CMFCColorBar::SetHorzMargin Mengatur margin horizontal, yang merupakan spasi antara sel warna kiri atau kanan dan batas area klien.
CMFCColorBar::SetVertMargin Mengatur margin vertikal, yang merupakan spasi antara sel warna atas atau bawah dan batas area klien.

Metode yang Dilindungi

Nama Deskripsi
CMFCColorBar::AdjustLocations Menyesuaikan posisi tombol warna pada kontrol bilah warna.
CMFCColorBar::AllowChangeTextLabels Menunjukkan apakah label teks tombol warna dapat berubah.
CMFCColorBar::AllowShowOnList Menunjukkan apakah objek kontrol bilah warna dapat muncul di daftar toolbar selama proses kustomisasi.
CMFCColorBar::CalcSize Dipanggil oleh kerangka kerja sebagai bagian dari proses perhitungan tata letak.
CMFCColorBar::CreatePalette Menginisialisasi palet dengan warna dalam array warna tertentu.
CMFCColorBar::GetColorGridSize Menghitung jumlah baris dan kolom dalam kisi kontrol bilah warna.
CMFCColorBar::GetExtraHeight Menghitung tinggi tambahan yang diperlukan bilah warna saat ini untuk menampilkan elemen antarmuka pengguna lain-lain seperti tombol Lainnya , warna dokumen, dan sebagainya.
CMFCColorBar::InitColors Menginisialisasi array warna dengan warna dalam palet tertentu atau palet default sistem.
CMFCColorBar::OnKey Dipanggil oleh kerangka kerja saat pengguna menekan tombol keyboard.
CMFCColorBar::OnSendCommand Dipanggil oleh kerangka kerja untuk menutup hierarki kontrol popup.
CMFCColorBar::OnUpdateCmdUI Dipanggil oleh kerangka kerja untuk mengaktifkan atau menonaktifkan item antarmuka pengguna dari kontrol bilah warna sebelum item ditampilkan.
CMFCColorBar::OpenColorDialog Membuka kotak dialog warna.
CMFCColorBar::Pembangunan ulang Sepenuhnya menggambar ulang kontrol bilah warna.
CMFCColorBar::SelectPalette Mengatur palet logis konteks perangkat yang ditentukan ke palet tombol induk kontrol bilah warna saat ini.
CMFCColorBar::SetPropList m_pWndPropList Mengatur anggota data yang dilindungi ke penunjuk yang ditentukan ke kontrol kisi properti.
CMFCColorBar::ShowCommandMessageString Meminta jendela bingkai yang memiliki kontrol bilah warna untuk memperbarui baris pesan di bilah status.

Anggota Data yang Dilindungi

Nama Deskripsi
m_bInternal Bidang Boolean yang menentukan apakah peristiwa mouse diproses. Biasanya, peristiwa mouse diproses ketika bidang ini TRUE dan mode kustomisasi FALSE.
m_bIsEnabled Boolean yang menunjukkan apakah kontrol diaktifkan.
m_bIsTearOff Boolean yang menunjukkan apakah kontrol bilah warna mendukung docking.
m_BoxSize Objek CSize yang menentukan ukuran sel dalam kisi bilah warna.
m_bShowDocColorsWhenDocked Boolean yang menunjukkan apakah akan menampilkan warna dokumen saat bilah warna ditautkan. Untuk informasi selengkapnya, lihat CMFCColorBar::SetDocumentColors.
m_bStdColorDlg Boolean yang menunjukkan apakah akan menampilkan kotak dialog warna sistem standar atau kotak dialog CMFCColorDialog . Untuk informasi selengkapnya, lihat CMFCColorBar::EnableOtherButton.
m_ColorAutomatic COLORREF yang menyimpan warna otomatis saat ini. Untuk informasi selengkapnya, lihat CMFCColorBar::EnableOtherButton.
m_ColorNames Objek CMap yang mengaitkan sekumpulan warna RGB dengan namanya.
m_colors CArray nilai COLORREF yang berisi warna yang ditampilkan dalam kontrol bilah warna.
m_ColorSelected Nilai COLORREF yang merupakan warna yang saat ini dipilih pengguna dari kontrol bilah warna.
m_lstDocColors CList nilai COLORREF yang berisi warna yang saat ini digunakan dalam dokumen.
m_nCommandID Bilangan bulat yang tidak ditandatangani yang merupakan ID perintah tombol warna.
m_nHorzMargin Bilangan bulat yang merupakan margin horizontal di antara tombol warna dalam kisi warna.
m_nHorzOffset Bilangan bulat yang merupakan offset horizontal ke tengah tombol warna. Nilai ini signifikan jika tombol menampilkan teks atau gambar selain warna.
m_nNumColumns Bilangan bulat yang merupakan jumlah kolom dalam kisi kontrol bilah warna warna.
m_nNumColumnsVert Bilangan bulat yang merupakan jumlah kolom dalam kisi warna yang berorientasi vertikal.
m_nNumRowsHorz Bilangan bulat yang merupakan jumlah kolom dalam kisi warna yang berorientasi horizontal.
m_nRowHeight Bilangan bulat yang merupakan tinggi baris tombol warna dalam kisi warna.
m_nVertMargin Bilangan bulat yang merupakan margin vertikal di antara tombol warna dalam kisi warna.
m_nVertOffset Bilangan bulat yang merupakan offset vertikal ke tengah tombol warna. Nilai ini signifikan jika tombol menampilkan teks atau gambar selain warna.
m_Palette CPalette warna yang digunakan dalam kontrol bilah warna.
m_pParentBtn Penunjuk ke objek CMFCColorButton yang merupakan induk tombol saat ini. Nilai ini signifikan jika tombol warna berada dalam hierarki kontrol toolbar atau berada dalam kontrol kisi properti warna.
m_pParentRibbonBtn Penunjuk ke objek CMFCRibbonColorButton yang ada di pita dan merupakan tombol induk tombol saat ini. Nilai ini signifikan jika tombol warna berada dalam hierarki kontrol toolbar atau berada dalam kontrol kisi properti warna.
m_pWndPropList Penunjuk ke objek CMFCPropertyGridCtrl .
m_strAutoColor CString yang merupakan teks yang ditampilkan pada tombol Otomatis. Untuk informasi selengkapnya, lihat CMFCColorBar::EnableAutomaticButton.
m_strDocColors CString yang merupakan teks yang ditampilkan pada tombol warna dokumen. Untuk informasi selengkapnya, lihat CMFCColorBar::SetDocumentColors.
m_strOtherColor CString yang merupakan teks yang ditampilkan di tombol lainnya. Untuk informasi selengkapnya, lihat CMFCColorBar::EnableOtherButton.

Keterangan

Biasanya, Anda tidak membuat objek secara CMFCColorBar langsung. Sebagai gantinya , Kelas CMFCColorMenuButton (digunakan dalam menu dan toolbar) atau Kelas CMFCColorButton membuat CMFCColorBar objek.

Kelas ini CMFCColorBar menyediakan fungsionalitas berikut:

  • Secara otomatis menyesuaikan daftar warna dokumen.

  • Menyimpan dan memulihkan statusnya, bersama dengan status dokumen.

  • Mengelola tombol "otomatis".

  • Menggunakan kontrol Kelas CMFCColorPickerCtrl untuk memilih warna kustom.

  • Mendukung status "tear-off" (jika dibuat dengan menggunakan Kelas CMFCColorMenuButton).

Untuk menggabungkan fungsionalitas CMFCColorBar ke dalam aplikasi Anda:

  1. Buat tombol menu reguler dan tetapkan ID, misalnya ID_CHAR_COLOR.

  2. Di kelas jendela bingkai Anda, ambil alih metode CFrameWndEx::OnShowPopupMenu dan ganti tombol menu reguler dengan objek Kelas CMFCColorMenuButton (dengan memanggil CMFCToolBar::ReplaceButton).

  3. Atur semua gaya dan aktifkan atau nonaktifkan fitur CMFCColorBar objek selama pembuatan Kelas CMFCColorMenuButton. Objek CMFCColorMenuButton secara dinamis membuat CMFCColorBar objek setelah kerangka kerja memanggil CreatePopupMenu metode .

Saat pengguna mengklik tombol kontrol bilah warna, kerangka kerja menggunakan ON_COMMAND makro untuk memberi tahu induk kontrol bilah warna. Dalam makro, parameter ID perintah adalah nilai yang Anda tetapkan ke tombol kontrol bilah warna di langkah 1 (ID_CHAR_COLOR dalam contoh ini). Untuk informasi selengkapnya, lihat kelas CMFCColorMenuButton Class, CMFCColorButton Class, CMFCColorPickerCtrl Class, CFrameWndEx Class, dan CMFCToolBar Class.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi bilah warna dengan menggunakan berbagai metode di CMFCColorBar kelas . Metode mengatur margin horizontal dan vertikal, mengaktifkan tombol lainnya, membuat jendela kontrol bilah warna, dan mengatur warna yang saat ini dipilih. Contoh ini adalah bagian dari sampel Kontrol Baru.

CMFCColorBar m_wndColorBar;

// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

Hierarki Warisan

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

CMFCColorBar

Persyaratan

Header: afxcolorbar.h

CMFCColorBar::AdjustLocations

Menyesuaikan posisi tombol warna pada kontrol bilah warna.

virtual void AdjustLocations();

Keterangan

Metode ini dipanggil oleh kerangka kerja selama pemrosesan pesan WM_SIZE.

CMFCColorBar::AllowChangeTextLabels

Menunjukkan apakah label teks tombol warna dapat berubah.

virtual BOOL AllowChangeTextLabels() const;

Tampilkan Nilai

Selalu FALSE.

Keterangan

Secara default, metode ini selalu mengembalikan FALSE, yang berarti label teks tidak dapat dimodifikasi. Ambil alih metode ini untuk mengaktifkan modifikasi label teks.

CMFCColorBar::AllowShowOnList

Menunjukkan apakah objek kontrol bilah warna dapat muncul di daftar toolbar selama proses kustomisasi.

virtual BOOL AllowShowOnList() const;

Tampilkan Nilai

Selalu BENAR.

Keterangan

Secara default, metode ini selalu mengembalikan TRUE, yang berarti kerangka kerja dapat menampilkan kontrol bilah warna selama proses penyesuaian. Ambil alih metode ini untuk menerapkan perilaku yang berbeda.

CMFCColorBar::CalcSize

Dipanggil oleh kerangka kerja sebagai bagian dari proses perhitungan tata letak.

virtual CSize CalcSize(BOOL bVertDock);

Parameter

bVertDock
[di] TRUE untuk menentukan bahwa kontrol bilah warna ditampar secara vertikal; FALSE untuk menentukan bahwa kontrol bilah warna ditampar secara horizontal.

Tampilkan Nilai

Ukuran array tombol warna dalam kontrol bilah warna.

CMFCColorBar::CMFCColorBar

Membuat CMFCColorBar objek.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

Parameter

Warna
[di] Array warna yang ditampilkan kerangka kerja pada kontrol bilah warna.

warna
[di] Warna yang awalnya dipilih.

lpszAutoColor
[di] Label teks tombol warna otomatis (default), atau NULL.

Label standar untuk tombol otomatis adalah Otomatis.

lpszOtherColor
[di] Label teks tombol lain , yang menampilkan lebih banyak pilihan warna, atau NULL.

Label standar untuk tombol lainnya adalah Warna Lainnya....

lpszDocColors
[di] Label teks tombol warna dokumen. Palet warna dokumen mencantumkan semua warna yang saat ini digunakan dokumen.

lstDocColors
[di] Daftar warna yang saat ini digunakan dokumen.

nColumns
[di] Jumlah kolom yang dimiliki array warna.

nRowsDockHorz
[di] Jumlah baris yang dimiliki bilah warna saat ditampung secara horizontal.

nColDockVert
[di] Jumlah kolom yang dimiliki bilah warna saat di-dock secara vertikal.

colorAutomatic
[di] Warna default yang diterapkan kerangka kerja saat Anda mengklik tombol otomatis.

nCommandID
[di] ID perintah kontrol bilah warna.

pParentBtn
[di] Penunjuk ke tombol induk.

src
[di] Objek yang CMFCColorBar sudah ada untuk disalin ke dalam objek baru CMFCColorBar .

uiCommandID
[di] ID perintah.

CMFCColorBar::ContextToSize

Menghitung margin vertikal dan horizontal yang diperlukan untuk memuat tombol pada kontrol bilah warna, dan menyesuaikan lokasi tombol tersebut.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

Parameter

bSquareButtons
[di] TRUE untuk menentukan bahwa bentuk tombol pada kontrol bilah warna adalah persegi; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

bCenterButtons
[di] TRUE untuk menentukan bahwa konten pada wajah tombol kontrol bilah warna di tengah; jika tidak, FALSE. Nilai defaultnya adalah TRUE.

Keterangan

CMFCColorBar::Create

Membuat jendela kontrol bilah warna dan melampirkannya ke CMFCColorBar objek.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

Parameter

pParentWnd
[di] Penunjuk ke jendela induk.

dwStyle
[di] Kombinasi bitwise (OR) gaya jendela.

Nid
[di] ID perintah.

pPalette
[di] Penunjuk ke palet warna. Defaultnya adalah NULL.

nColumns
[di] Jumlah kolom dalam kontrol bilah warna. Defaultnya adalah 0.

nRowsDockHorz
[di] Jumlah baris dalam kontrol bilah warna saat di-dock secara horizontal. Defaultnya adalah 0.

nColDockVert
[di] Jumlah kolom dalam kontrol bilah warna saat di-dock secara vertikal. Defaultnya adalah 0.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Untuk membuat CMFCColorBar objek, panggil konstruktor kelas, lalu metode ini. Metode ini Create membuat kontrol Windows dan menginisialisasi daftar warna.

CMFCColorBar::CreateControl

Membuat jendela kontrol bilah warna, melampirkannya ke CMFCColorBar objek, dan mengubah ukuran jendela kontrol agar berisi palet warna yang ditentukan.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

Parameter

pParentWnd
[di] Penunjuk ke jendela induk. Tidak boleh NULL.

rect
[di] Persegi panjang pembatas yang menentukan tempat menggambar kontrol bilah warna.

Nid
[di] ID kontrol.

nColumns
[di] Jumlah kolom yang ideal dalam kontrol bilah warna. Metode ini memodifikasi angka tersebut agar sesuai dengan palet warna yang ditentukan. Defaultnya adalah -1, yang berarti parameter ini tidak ditentukan.

pPalette
[di] Penunjuk ke palet warna, atau NULL. Jika parameter ini NULL, metode ini menghitung ukuran kontrol bilah warna seolah-olah 20 warna ditentukan. Defaultnya adalah NULL.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak FALSE.

Keterangan

Metode ini menggunakan parameter rect, nColumns, dan pPalette untuk menghitung jumlah atau baris dan kolom yang sesuai dalam kontrol bilah warna, lalu memanggil metode CMFCColorBar::Create .

CMFCColorBar::CreatePalette

Menginisialisasi palet dengan warna dalam array warna tertentu.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

Parameter

arColors
[di] Array warna.

Palet
[di] Palet warna.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

CMFCColorBar::EnableAutomaticButton

Menampilkan atau menyembunyikan tombol otomatis.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parameter

lpszLabel
[di] Label teks tombol warna otomatis (default), atau NULL.

Label standar untuk tombol otomatis adalah Otomatis.

colorAutomatic
[di] Warna default yang diterapkan kerangka kerja saat Anda mengklik tombol otomatis.

bEnable
[di] TRUE untuk mengaktifkan tombol otomatis; FALSE untuk menonaktifkan tombol otomatis. Nilai defaultnya adalah TRUE.

Keterangan

Label teks tombol otomatis dihapus jika parameter lpszLabel adalah NULL atau parameter bEnable adalah FALSE.

CMFCColorBar::EnableOtherButton

Mengaktifkan atau menonaktifkan tampilan kotak dialog yang memungkinkan pengguna memilih warna lainnya.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

Parameter

lpszLabel
[di] Label teks tombol lain , yang menampilkan lebih banyak pilihan warna, atau NULL.

Label standar untuk tombol ini adalah Warna Lainnya....

bAltColorDlg
[di] TRUE untuk menampilkan kotak dialog CMFCColorDialog; FALSE untuk menampilkan kotak dialog CColorDialog standar. Nilai defaultnya adalah TRUE.

bEnable
[di] TRUE untuk mengaktifkan tombol; FALSE untuk menonaktifkan tombol . Nilai defaultnya adalah TRUE.

CMFCColorBar::GetColor

Mengambil warna terpilih saat ini.

COLORREF GetColor() const;

Tampilkan Nilai

Warna yang saat ini dipilih.

CMFCColorBar::GetColorGridSize

Menghitung jumlah baris dan kolom dalam kisi kontrol bilah warna.

CSize GetColorGridSize(BOOL bVertDock) const;

Parameter

bVertDock
[di] TRUE untuk melakukan perhitungan untuk kontrol bilah warna yang ditampar secara vertikal; jika tidak, lakukan penghitungan untuk kontrol yang ditampar secara horizontal.

Tampilkan Nilai

Objek CSize yang komponennya cx berisi jumlah kolom dan komponennya cy berisi jumlah baris.

CMFCColorBar::GetCommandID

Mengambil ID perintah kontrol bilah warna saat ini.

UINT GetCommandID() const;

Tampilkan Nilai

ID perintah.

Keterangan

Saat pengguna memilih warna baru, kerangka kerja mengirimkan ID perintah dalam pesan WM_COMMAND untuk memberi tahu induk CMFCColorBar objek.

CMFCColorBar::GetExtraHeight

Menghitung tinggi tambahan yang diperlukan bilah warna saat ini untuk menampilkan elemen antarmuka pengguna lain-lain, seperti tombol Lainnya atau warna dokumen.

int GetExtraHeight(int nNumColumns) const;

Parameter

nNumColumns
[di] Jika kontrol bilah warna berisi warna dokumen, jumlah kolom yang akan ditampilkan dalam kisi warna dokumen. Jika tidak, nilai ini tidak digunakan.

Tampilkan Nilai

Tinggi ekstra terhitung yang diperlukan.

CMFCColorBar::GetHighlightedColor

Mengambil warna yang menandakan bahwa tombol warna memiliki fokus; artinya, tombolnya panas.

COLORREF GetHighlightedColor() const;

Tampilkan Nilai

Nilai RGB.

Keterangan

CMFCColorBar::GetHorzMargin

Mengambil margin horizontal, yang merupakan spasi antara sel warna kiri atau kanan dan batas area klien.

int GetHorzMargin();

Tampilkan Nilai

Margin horizontal.

CMFCColorBar::GetVertMargin

Mengambil margin vertikal, yang merupakan spasi antara sel warna atas atau bawah dan batas area klien.

int GetVertMargin() const;

Tampilkan Nilai

Margin vertikal.

CMFCColorBar::InitColors

Menginisialisasi array warna dengan warna dalam palet tertentu, atau dengan palet default sistem.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

Parameter

pPalette
[di] Penunjuk ke objek palet, atau NULL. Jika parameter ini NULL, metode ini menggunakan palet default sistem operasi.

arColors
[di] Array warna.

Tampilkan Nilai

Jumlah elemen dalam array warna.

CMFCColorBar::IsTearOff

Menunjukkan apakah bilah warna saat ini dapat di-dock.

BOOL IsTearOff() const;

Tampilkan Nilai

TRUE jika kontrol bilah warna saat ini dapat di-dock; jika tidak, FALSE.

Keterangan

Jika kontrol bilah warna dapat di-dock, kontrol dapat dirobek bilah kontrol dan ditampar di lokasi lain.

CMFCColorBar::OnKey

Dipanggil oleh kerangka kerja saat pengguna menekan tombol keyboard.

virtual BOOL OnKey(UINT nChar);

Parameter

nChar
[di] Kode kunci virtual untuk kunci yang ditekan pengguna.

Tampilkan Nilai

TRUE jika metode ini memproses kunci yang ditentukan; jika tidak, FALSE.

CMFCColorBar::OnSendCommand

Dipanggil oleh kerangka kerja untuk menutup hierarki kontrol pop-up.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parameter

pButton
[di] Penunjuk ke kontrol yang berada di toolbar.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

CMFCColorBar::OnUpdateCmdUI

Dipanggil oleh kerangka kerja untuk mengaktifkan atau menonaktifkan item antarmuka pengguna dari kontrol bilah warna sebelum item ditampilkan.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parameter

pTarget
[di] Penunjuk ke jendela yang berisi item antarmuka pengguna untuk diperbarui.

bDisableIfNoHndler
[di] TRUE untuk menonaktifkan item antarmuka pengguna jika tidak ada handler yang ditentukan dalam peta pesan; jika tidak, FALSE.

Keterangan

Saat pengguna aplikasi Anda mengklik item antarmuka pengguna, item harus mengetahui apakah item harus ditampilkan sebagai diaktifkan atau dinonaktifkan. Target pesan perintah menyediakan informasi ini dengan menerapkan handler perintah ON_UPDATE_COMMAND_UI. Gunakan metode ini untuk membantu memproses perintah. Untuk informasi selengkapnya, lihat Kelas CCmdUI.

CMFCColorBar::OpenColorDialog

Membuka kotak dialog warna.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

Parameter

colorDefault
[di] Warna yang dipilih secara default saat kotak dialog warna terbuka.

colorRes
[out] Warna yang dipilih pengguna.

Tampilkan Nilai

TRUE jika pengguna memilih warna; FALSE jika pengguna membatalkan kotak dialog warna.

Keterangan

CMFCColorBar::Pembangunan ulang

Sepenuhnya menggambar ulang kontrol bilah warna.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Mengatur palet logis konteks perangkat yang ditentukan ke palet tombol induk kontrol bilah warna saat ini.

CPalette* SelectPalette(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat dari tombol induk kontrol bilah warna saat ini.

Tampilkan Nilai

Penunjuk ke palet yang digantikan oleh palet tombol induk kontrol bilah warna saat ini.

CMFCColorBar::SetColor

Menyetel warna yang saat ini dipilih.

void SetColor(COLORREF color);

Parameter

warna
[di] Nilai warna RGB.

CMFCColorBar::SetColorName

Menyetel nama baru untuk warna tertentu.

static void SetColorName(
    COLORREF color,
    const CString& strName);

Parameter

warna
[di] Nilai RGB warna.

strName
[di] Nama baru untuk warna yang ditentukan.

Keterangan

Metode ini mengubah nama warna yang ditentukan di semua CMFCColorBar objek dalam aplikasi Anda.

CMFCColorBar::SetCommandID

Mengatur ID perintah baru untuk kontrol bilah warna.

void SetCommandID(UINT nCommandID);

Parameter

nCommandID
[di] ID perintah.

Keterangan

Panggil metode ini untuk mengubah ID perintah kontrol bilah warna dan untuk memberi tahu jendela induk kontrol bahwa ID telah berubah.

CMFCColorBar::SetDocumentColors

Menyetel daftar warna yang digunakan dalam dokumen saat ini.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

Parameter

lpszCaption
[di] Keterangan yang ditampilkan saat kontrol bilah warna tidak ditampung.

lstDocColors
[di] Daftar warna yang menggantikan warna dokumen saat ini.

bShowWhenDocked
[di] TRUE untuk memperlihatkan warna dokumen saat kontrol bilah warna ditampar; jika tidak, FALSE. Nilai defaultnya adalah FALSE.

Keterangan

Warna dokumen adalah warna yang saat ini digunakan dalam dokumen. Kerangka kerja secara otomatis mempertahankan daftar warna dokumen, tetapi Anda dapat menggunakan metode ini untuk mengubah daftar.

CMFCColorBar::SetHorzMargin

Mengatur margin horizontal, yang merupakan spasi antara sel warna kiri atau kanan dan batas area klien.

void SetHorzMargin(int nHorzMargin);

Parameter

nHorzMargin
[di] Margin horizontal, dalam piksel.

Keterangan

Secara default, konstruktor CMFCColorBar::CMFCColorBar mengatur margin horizontal menjadi 4 piksel.

CMFCColorBar::SetPropList

m_pWndPropList Mengatur anggota data yang dilindungi ke penunjuk yang ditentukan ke kontrol kisi properti.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parameter

pWndList
[di] Penunjuk ke objek kontrol kisi properti.

CMFCColorBar::SetVertMargin

Mengatur margin vertikal, yang merupakan spasi antara sel warna atas atau bawah dan batas area klien.

void SetVertMargin(int nVertMargin);

Parameter

nVertMargin
[di] Margin vertikal, dalam piksel.

Keterangan

Secara default, konstruktor CMFCColorBar::CMFCColorBar mengatur margin vertikal menjadi 4 piksel.

CMFCColorBar::ShowCommandMessageString

Meminta jendela bingkai yang memiliki kontrol bilah warna untuk memperbarui baris pesan di bilah status.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parameter

uiCmdId
[di] ID perintah. (Parameter ini diabaikan.)

Keterangan

Metode ini mengirimkan pesan WM_SETMESSAGESTRING kepada pemilik kontrol bilah warna.

Lihat juga

Bagan Hierarki
Kelas