SelectObject 함수(wingdi.h)

SelectObject 함수는 지정된 DC(디바이스 컨텍스트)에 개체를 선택합니다. 새 개체는 동일한 형식의 이전 개체를 대체합니다.

구문

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

매개 변수

[in] hdc

DC에 대한 핸들입니다.

[in] h

선택할 개체에 대한 핸들입니다. 다음 함수 중 하나를 사용하여 지정된 개체를 만들어야 합니다.

Object Functions
Bitmap

CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection

비트맵은 메모리 DC에서만 선택할 수 있습니다. 단일 비트맵은 동시에 둘 이상의 DC로 선택할 수 없습니다.

Brush

CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush

글꼴

CreateFont, CreateFontIndirect

CreatePen, CreatePenIndirect

지역

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

추가 정보

CombineRgn

CreateBitmap

CreateBitmapIndirect

CreateBrushIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBitmap

CreateEllipticRgn

CreateEllipticRgnIndirect

CreateFont

CreateFontIndirect

CreateHatchBrush

CreatePatternBrush

CreatePen

CreatePenIndirect

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateSolidBrush

디바이스 컨텍스트 함수

디바이스 컨텍스트 개요

SelectClipRgn

SelectPalette