SelectObject

函數功能：

SelectObject 函數用於選擇一對象到指定的設備環境中，該新對象將替換先前的相同類型的對象。


API 函數原型：

註釋：_In_ 說明該參數是輸入的。

1. HGDIOBJ SelectObject(
   
2.   _In_  HDC hdc,
   
3.   _In_  HGDIOBJ hgdiobj
   
4. );

複製代碼

參數解析：

參數	含義
hdc	指定設備環境句柄
hgdiobj	1. 被選擇的對象的句柄 2. 該指定對象必須由以下的函數創建

hgdiobj 參數的對象必需由以下的函數創建：

對象	函數
位圖	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection （只有內存設備環境可選擇位圖，並且在同一時刻只能一個設備環境選擇位圖）
畫刷	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
字體	CreateFont, CreateFontIndirect
畫筆	CreatePen, CreatePenIndirect
區域	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

返回值：

1. 如果選擇對象不是區域並且函數調用成功，那麼返回值是被取代的對象的句柄；

2. 如果選擇對象是區域並且函數執行成功，返回以下值之一：

值	含義
SIMPLEREGION	區域由單個矩形組成
COMPLEXREGION	區域由多個矩形組成
NULLREGION	區域爲空

3. 如果發生錯誤並且選擇對象不是一個區域，那麼返回值爲 NULL，否則返回 HGDI_ERROR。


備註：

1. 該函數返回先前指定類型的選擇對象。

2. 一個應用程序在它使用新對象進行繪製完成之後，應該用原始的默認對象替換新對象。

3. 應用程序不能同時選擇一個位圖到多個設備環境中。

4. ICM：如果被選擇的對象是畫筆或筆，那麼就執行顏色管理。

【API檔案】版權歸魚C工作室（www.fishc.com）所有，轉載請註明來源。

來自羣組: WinSDK