Share via


selectObject 函式 (wingdi.h)

SelectObject 函式會將物件選取到指定的裝置內容中, (DC) 。 新的物件會取代相同類型的先前物件。

語法

HGDIOBJ SelectObject(
  [in] HDC     hdc,
  [in] HGDIOBJ h
);

參數

[in] hdc

DC 的句柄。

[in] h

要選取之物件的句柄。 指定的物件必須使用下列其中一個函式來建立。

Object 函式
點陣圖

CreateBitmapCreateBitmapIndirectCreateCompatibleBitmapCreateDIBitmapCreateDIBSection

點陣圖只能選擇至記憶體 DC 的 。 單一位圖無法同時選取至多個DC。

Brush

CreateBrushIndirectCreateDIBPatternBrushCreateDIBPatternBrushPtCreateHatchBrushCreatePatternBrush、CreateSolidBrush

字型

CreateFontCreateFontIndirect

CreatePenCreatePenIndirect

區域

CombineRgnCreateEllipticRgnCreateEllipticRgnIndirectCreatePolygonRgnCreateRectRgnCreateRectRgnIndirect

傳回值

如果選取的物件不是區域,且函式成功,則傳回值是所要取代物件的句柄。 如果選取的對像是區域且函式成功,則傳回值會是下列其中一個值。

意義
SIMPLEREGION 區域是由單一矩形所組成。
COMPLEXREGION 區域包含一個以上的矩形。
NULLREGION 區域是空的。
 

如果發生錯誤且選取的物件不是區域,則傳回值為 NULL。 否則,它會HGDI_ERROR。

備註

此函式會傳回先前選取的指定型別物件。 應用程式應該一律將新的物件取代為原始的默認物件,再使用新的 物件完成繪圖。

應用程式一次無法將單一位圖選取到多個 DC。

Icm: 如果選取的對像是筆刷或手寫筆,則會執行色彩管理。

範例

如需範例,請參閱 設定畫筆或筆刷色彩

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

CombineRgn

CreateBitmap

CreateBitmapIndirect

CreateBrushIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBitmap

CreateEllipticRgn

CreateEllipticRgnIndirect

CreateFont

CreateFontIndirect

CreateHatchBrush

CreatePatternBrush

CreatePen

CreatePenIndirect

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateSolidBrush

裝置內容函式

裝置內容概觀

SelectClipRgn

SelectPalette