selectObject 函数 (wingdi.h)

SelectObject 函数在 DC) (指定设备上下文中选择对象。 新 对象替换同一类型的上一个对象。

语法

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

参数

[in] hdc

DC 的句柄。

[in] h

要选择的对象的句柄。 指定的对象必须已使用以下函数之一创建。

Object 函数
Bitmap

CreateBitmapCreateBitmapIndirectCreateCompatibleBitmapCreateDIBitmapCreateDIBSection

位图只能选择到内存 DC 中。 不能将单个位图同时选入多个 DC。

Brush

CreateBrushIndirectCreateDIBPatternBrushCreateDIBPatternBrushPtCreateHatchBrushCreatePatternBrushCreateSolidBrush

字体

CreateFontCreateFontIndirect

CreatePenCreatePenIndirect

区域

CombineRgnCreateEllipticRgnCreateEllipticRgnIndirectCreatePolygonRgnCreateRectRgnCreateRectRgnIndirect

返回值

如果所选对象不是区域且函数成功,则返回值是所替换对象的句柄。 如果所选对象是区域且函数成功,则返回值是以下值之一。

含义
SIMPLEREGION 区域由单个矩形组成。
COMPLEXREGION 区域由多个矩形组成。
NULLREGION 区域为空。
 

如果发生错误,并且所选对象不是区域,则返回值为 NULL。 否则,它将HGDI_ERROR。

注解

此函数返回指定类型的以前选择的对象。 应用程序在用新对象完成绘图后,应始终将新对象替换为原始的默认对象。

应用程序不能一次选择一个位图进入多个 DC。

Icm: 如果要选择的对象是画笔或笔,则执行颜色管理。

示例

有关示例,请参阅 设置笔或画笔颜色

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library 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