CMFCColorDialog 類別
類別 CMFCColorDialog 代表色彩選取對話框。
語法
class CMFCColorDialog : public CDialogEx
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| CMFCColorDialog：：CMFCColorDialog | 建構 CMFCColorDialog 物件。 |
CMFCColorDialog::~CMFCColorDialog |
解構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CMFCColorDialog：：GetColor | 傳回目前選取的色彩。 |
| CMFCColorDialog：：GetPalette | 傳回色彩的調色盤。 |
CMFCColorDialog::PreTranslateMessage |
在分派至 TranslateMessage 和 DispatchMessage Windows 函式之前，翻譯視窗訊息。 如需語法和詳細資訊，請參閱 CWnd：:P reTranslateMessage。 (覆寫 CDialogEx::PreTranslateMessage。) |
| CMFCColorDialog：：RebuildPalette | 從系統調色盤衍生調色盤。 |
| CMFCColorDialog：：SetCurrentColor | 設定目前選取的色彩。 |
| CMFCColorDialog：：SetNewColor | 設定最相當於指定 RGB 值的色彩。 |
| CMFCColorDialog：：SetPageOne | 選取第一個屬性頁的 RGB 值。 |
| CMFCColorDialog：：SetPageTwo | 選取第二個屬性頁的 RGB 值。 |
受保護的資料成員
| 名稱 | 描述 |
|---|---|
m_bIsMyPalette |
如果色彩選取對話框使用自己的調色盤，則為TRUE;如果對話框使用建構函式中指定的 CMFCColorDialog 調色盤，則為 FALSE。 |
m_bPickerMode |
當使用者從選取對話框選取色彩時，則為TRUE;否則為 FALSE。 |
m_btnColorSelect |
用戶已選取的色彩按鈕。 |
m_CurrentColor |
目前選取的色彩。 |
m_hcurPicker |
用來挑選色彩的數據指標。 |
m_NewColor |
可能選取的色彩，可以永久選取或還原為原始色彩。 |
m_pColourSheetOne |
色彩選取屬性表之第一個屬性頁的指標。 |
m_pColourSheetTwo |
色彩選取屬性表第二個屬性頁的指標。 |
m_pPalette |
目前的邏輯選擇區。 |
m_pPropSheet |
色彩選取對話框之屬性表的指標。 |
m_wndColors |
色彩選擇器控制件物件。 |
m_wndStaticPlaceHolder |
靜態控件，是色彩選擇器屬性表的佔位元。 |
備註
色彩選取對話框會顯示為具有兩頁的屬性表。 在第一頁上，您會從系統調色盤中選取標準色彩;在第二個頁面上，選取自定義色彩。
您可以在堆疊上建構 CMFCColorDialog 物件，然後呼叫 DoModal，將初始色彩當做參數傳遞至建 CMFCColorDialog 構函式。 色彩選取對話框接著會建立數個 CMFCColorPickerCtrl類別 對象來處理每個調色盤。
繼承階層架構
範例
下列範例示範如何使用 類別中的 CMFCColorDialog 各種方法設定色彩對話框。 此範例示範如何在色彩對話框的兩個屬性頁面上設定目前和新的色彩，以及如何設定所選色彩的紅色、綠色和藍色元件。 此範例是 New Controls 範例的一部分。
// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);
需求
標頭： afxcolordialog.h
CMFCColorDialog：：CMFCColorDialog
建構 CMFCColorDialog 物件。
CMFCColorDialog(
COLORREF clrInit=0,
DWORD dwFlags=0,
CWnd* pParentWnd=NULL,
HPALETTE hPal=NULL);
參數
clrInit
[in]默認色彩選取範圍。 如果未指定任何值，則預設值為 RGB（0,0,0）（黑色）。
dwFlags
[in] 保留。
pParentWnd
[in]對話框父視窗或擁有者視窗的指標。
hPal
[in]調色盤的句柄。
傳回值
備註
CMFCColorDialog：：GetColor
擷取使用者從色彩對話框中選取的色彩。
COLORREF GetColor() const;
傳回值
COLORREF 值，其中包含色彩對話框中所選取色彩的 RGB 資訊。
備註
呼叫 方法之後，請呼叫 DoModal 此函式。
CMFCColorDialog：：GetPalette
擷取目前色彩對話框中可用的調色盤。
CPalette* GetPalette() const;
傳回值
建構函式中CMFCColorDialog指定之 物件的指標CPalette。
備註
調色盤會指定使用者可以選擇的色彩。
CMFCColorDialog：：RebuildPalette
從系統調色盤衍生調色盤。
void RebuildPalette();
CMFCColorDialog：：SetCurrentColor
設定對話框的目前色彩。
void SetCurrentColor(COLORREF rgb);
參數
rgb
[in]RGB 色彩值
備註
CMFCColorDialog：：SetNewColor
將目前調色盤中的目前色彩設定為最相似的色彩。
void SetNewColor(COLORREF rgb);
參數
rgb
[in] 指定 RGB 色彩的 COLORREF 。
備註
CMFCColorDialog：：SetPageOne
在色彩對話框的第一個屬性頁上，明確指定所選色彩的紅色、綠色和藍色元件。
void SetPageOne(
BYTE R,
BYTE G,
BYTE B);
參數
R
[in]指定 RGB 值的紅色元件。
G
[in]指定 RGB 值的綠色元件。
B
[in]指定 RGB 值的藍色元件。
備註
CMFCColorDialog：：SetPageTwo
在色彩對話框的第二個屬性頁上，明確指定所選色彩的紅色、綠色和藍色元件。
void SetPageTwo(
BYTE R,
BYTE G,
BYTE B);
參數
R
[in]指定 RGB 值的紅色元件
G
[in]指定 RGB 值的綠色元件
B
[in]指定 RGB 值的藍色元件