CPalette 類別

發行項
10/12/2023

封裝 Windows 調色盤。

語法

class CPalette : public CGdiObject

成員

公用建構函式

名稱	描述
CPalette：：CPalette	`CPalette`建構沒有附加 Windows 調色盤的物件。您必須先使用其中一個初始化成員函式來初始化 `CPalette` 物件，才能使用它。

公用方法

名稱	描述
CPalette：：AnimatePalette	取代物件所 `CPalette` 識別之邏輯選擇區中的專案。應用程式不需要更新其工作區，因為 Windows 會立即將新專案對應至系統選擇區。
CPalette：：CreateHalftonePalette	為裝置內容建立半色調調色盤，並將它附加至 `CPalette` 物件。
CPalette：：CreatePalette	建立 Windows 調色盤，並將它附加至 `CPalette` 物件。
CPalette：：FromHandle	當指定 Windows 調色盤物件的控制碼時，傳回物件的指標 `CPalette` 。
CPalette：：GetEntryCount	擷取邏輯調色盤中的調色盤專案數目。
CPalette：：GetNearestPaletteIndex	傳回最符合色彩值之邏輯調色盤中專案的索引。
CPalette：：GetPaletteEntries	擷取邏輯調色盤中的調色盤專案範圍。
CPalette：：ResizePalette	將物件所 `CPalette` 指定的邏輯調色盤大小變更為指定的專案數目。
CPalette：：SetPaletteEntries	設定邏輯調色盤中專案範圍的 RGB 色彩值和旗標。

公用運算子

名稱	描述
CPalette：：operator HPALETTE	傳回附加至的 `CPalette` HPALETTE。

備註

調色盤提供應用程式與色彩輸出裝置之間的介面（例如顯示裝置）。介面可讓應用程式充分利用輸出裝置的色彩功能，而不會嚴重干擾其他應用程式所顯示的色彩。 Windows 會使用應用程式的邏輯調色盤（所需色彩清單）和系統調色盤（定義可用色彩）來判斷所使用的色彩。

CPalette物件會提供成員函式來操作物件所參考的調色盤。 CPalette建構物件，並使用其成員函式來建立實際調色盤、圖形裝置介面（GDI）物件，以及操作其專案和其他屬性。

如需使用 CPalette 的詳細資訊，請參閱繪圖物件。

繼承階層架構

CObject

CGdiObject

CPalette

需求

標題: afxwin.h

CPalette：：AnimatePalette

取代附加至 CPalette 物件的邏輯選擇區中的專案。

void AnimatePalette(
    UINT nStartIndex,
    UINT nNumEntries,
    LPPALETTEENTRY lpPaletteColors);

參數

nStartIndex
指定要產生動畫效果之調色盤中的第一個專案。

nNumEntries
指定要產生動畫效果之調色盤中的專案數。

lpPaletteColors
指向 PALETTEENTRY 結構陣列的第一個成員，以取代 nStartIndex 和 nNumEntries 所 識別的調色盤專案。

備註

當應用程式呼叫 AnimatePalette 時，不需要更新其工作區，因為 Windows 會立即將新專案對應至系統選擇區。

函 AnimatePalette 式只會變更附加至 CPalette 物件之 LOGPALETTE 結構的對應 palPaletteEntry 成員中設定PC_RESERVED旗標的專案。如需此結構的詳細資訊，請參閱 Windows SDK 中的 LOGPALETTE。

CPalette：：CPalette

建構 CPalette 物件。

CPalette();

備註

在您呼叫 CreatePalette 附加調色盤之前，物件沒有附加調色盤。

CPalette：：CreateHalftonePalette

建立裝置內容的半色調調色盤。

BOOL CreateHalftonePalette(CDC* pDC);

參數

pDC
識別裝置內容。

傳回值

如果函式成功則為非零，否則為 0。

備註

當裝置內容的延展模式設定為 HALFTONE 時，應用程式應該建立半色調調色盤。接著，在呼叫 CDC：：StretchBlt 或 StretchDIBits 函式之前，應該先選取 CreateHalftonePalette 成員函式所傳回的邏輯半色調調色盤，並將其實現到裝置內容中。

如需和 StretchDIBits 的詳細資訊 CreateHalftonePalette ，請參閱 Windows SDK。

CPalette：：CreatePalette

CPalette建立 Windows 邏輯調色盤並將其附加至 CPalette 物件，以初始化物件。

BOOL CreatePalette(LPLOGPALETTE lpLogPalette);

參數

lpLogPalette
指向 LOGPALETTE 結構，其中包含邏輯調色盤中色彩的相關資訊。

傳回值

如果成功則為非零；否則為 0。

備註

如需結構的詳細資訊， LOGPALETTE 請參閱 Windows SDK。

CPalette：：FromHandle

當指定 Windows 調色盤物件的控制碼時，傳回物件的指標 CPalette 。

static CPalette* PASCAL FromHandle(HPALETTE hPalette);

參數

hPalette
Windows GDI 調色盤的控制碼。

傳回值

如果成功， CPalette 則為物件的指標，否則為 Null。

備註

CPalette如果物件尚未附加至 Windows 調色盤，則會建立並附加暫存 CPalette 物件。這個暫存 CPalette 物件只有在下次應用程式在其事件迴圈中有閒置時間為止才有效，此時會刪除所有暫存繪圖物件。換句話說，暫存物件只有在處理一個視窗訊息時才有效。

CPalette：：GetEntryCount

呼叫這個成員函式，以擷取指定邏輯選擇區中的專案數目。

int GetEntryCount();

傳回值

邏輯選擇區中的專案數。

CPalette：：GetNearestPaletteIndex

傳回最符合指定色彩值之邏輯調色盤中專案的索引。

UINT GetNearestPaletteIndex(COLORREF crColor) const;

參數

crColor
指定要比對的色彩。

傳回值

邏輯選擇區中專案的索引。專案包含最接近符合指定色彩的色彩。

CPalette：：GetPaletteEntries

擷取邏輯調色盤中的調色盤專案範圍。

UINT GetPaletteEntries(
    UINT nStartIndex,
    UINT nNumEntries,
    LPPALETTEENTRY lpPaletteColors) const;

參數

nStartIndex
指定要擷取之邏輯選擇區中的第一個專案。

nNumEntries
指定要擷取之邏輯選擇區中的專案數目。

lpPaletteColors
指向 PALETTEENTRY 資料結構的陣列，以接收調色盤專案。陣列必須至少包含 nNumEntries 所指定的資料結構。

傳回值

從邏輯選擇區擷取的專案數;如果函式失敗，則為 0。

CPalette：：operator HPALETTE

使用此運算子取得物件的附加 Windows GDI 控制碼 CPalette 。

operator HPALETTE() const;

傳回值

如果成功，則為物件所 CPalette 代表之 Windows GDI 物件的控制碼，否則為 Null。

備註

此運算子是轉換運算子，可支援直接使用 HPALETTE 物件。

如需使用繪圖物件的詳細資訊，請參閱 Windows SDK 中的繪圖物件一文。

CPalette：：ResizePalette

將附加至 CPalette 物件的邏輯選擇區大小變更為 nNumEntries 所指定的專案數目。

BOOL ResizePalette(UINT nNumEntries);

參數

nNumEntries
指定調色盤中調整大小之後的專案數。

傳回值

如果調色盤已成功調整大小，則為非零;否則為 0。

備註

如果應用程式呼叫 ResizePalette 以減少調色盤的大小，則調整大小調色盤中剩餘的專案會保持不變。如果應用程式呼叫 ResizePalette 以放大調色盤，其他調色盤專案會設定為黑色（紅色、綠色和藍色值全部為 0），而所有其他專案的旗標會設定為 0。

如需 Windows API ResizePalette 的詳細資訊，請參閱 Windows SDK 中的 ResizePalette 。

CPalette：：SetPaletteEntries

設定邏輯調色盤中專案範圍的 RGB 色彩值和旗標。

UINT SetPaletteEntries(
    UINT nStartIndex,
    UINT nNumEntries,
    LPPALETTEENTRY lpPaletteColors);

參數

nStartIndex
指定要設定之邏輯選擇區中的第一個專案。

nNumEntries
指定要設定之邏輯選擇區中的專案數目。