selectObject 函式 (wingdi.h)
SelectObject 函式會將物件選取到指定的裝置內容中, (DC) 。 新的物件會取代相同類型的先前物件。
語法
HGDIOBJ SelectObject(
[in] HDC hdc,
[in] HGDIOBJ h
);
參數
[in] hdc
DC 的句柄。
[in] h
要選取之物件的句柄。 指定的物件必須使用下列其中一個函式來建立。
Object | 函式 |
---|---|
|
CreateBitmap、 CreateBitmapIndirect、 CreateCompatibleBitmap、 CreateDIBitmap、 CreateDIBSection 點陣圖只能選擇至記憶體 DC 的 。 單一位圖無法同時選取至多個DC。 |
|
CreateBrushIndirect、CreateDIBPatternBrush、CreateDIBPatternBrushPt、CreateHatchBrush、CreatePatternBrush、CreateSolidBrush |
|
|
|
|
|
CombineRgn、 CreateEllipticRgn、 CreateEllipticRgnIndirect、 CreatePolygonRgn、 CreateRectRgn、 CreateRectRgnIndirect |
傳回值
如果選取的物件不是區域,且函式成功,則傳回值是所要取代物件的句柄。 如果選取的對像是區域且函式成功,則傳回值會是下列其中一個值。
值 | 意義 |
---|---|
SIMPLEREGION | 區域是由單一矩形所組成。 |
COMPLEXREGION | 區域包含一個以上的矩形。 |
NULLREGION | 區域是空的。 |
如果發生錯誤且選取的物件不是區域,則傳回值為 NULL。 否則,它會HGDI_ERROR。
備註
此函式會傳回先前選取的指定型別物件。 應用程式應該一律將新的物件取代為原始的默認物件,再使用新的 物件完成繪圖。
應用程式一次無法將單一位圖選取到多個 DC。
Icm: 如果選取的對像是筆刷或手寫筆,則會執行色彩管理。
範例
如需範例,請參閱 設定畫筆或筆刷色彩。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |