GetStockObject 함수(wingdi.h)
GetStockObject 함수는 스톡 펜, 브러시, 글꼴 또는 팔레트 중 하나에 대한 핸들을 검색합니다.
구문
HGDIOBJ GetStockObject(
[in] int i
);
매개 변수
[in] i
스톡 개체의 형식입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
검은색 브러시. |
|
진한 회색 브러시. |
|
단색 브러시입니다. 기본 색은 흰색입니다. SetDCBrushColor 함수를 사용하여 색을 변경할 수 있습니다. 자세한 내용은 주의 섹션을 참조하세요. |
|
회색 브러시. |
|
속이 빈 브러시(NULL_BRUSH 해당) |
|
연한 회색 브러시. |
|
Null 브러시(HOLLOW_BRUSH 해당) |
|
흰색 브러시. |
|
검은색 펜. |
|
단색 펜 색입니다. 기본 색은 검은색입니다. SetDCPenColor 함수를 사용하여 색을 변경할 수 있습니다. 자세한 내용은 주의 섹션을 참조하세요. |
|
Null 펜입니다. null 펜은 아무 것도 그리지 않습니다. |
|
흰색 펜. |
|
Windows 고정 피치(모노스페이스) 시스템 글꼴입니다. |
|
Windows 가변 피치(비례 공간) 시스템 글꼴입니다. |
|
디바이스 종속 글꼴입니다. |
|
메뉴 및 대화 상자와 같은 사용자 인터페이스 개체의 기본 글꼴입니다. DEFAULT_GUI_FONT 또는 SYSTEM_FONT 사용하여 대화 상자와 창에서 사용하는 글꼴을 가져오는 것은 권장되지 않습니다. 자세한 내용은 설명 섹션을 참조하세요.
기본 글꼴은 Tahoma입니다. |
|
OEM(Original Equipment Manufacturer) 종속 고정 피치(monospace) 글꼴입니다. |
|
시스템 글꼴입니다. 기본적으로 시스템은 시스템 글꼴을 사용하여 메뉴, 대화 상자 컨트롤 및 텍스트를 그립니다. DEFAULT_GUI_FONT 또는 SYSTEM_FONT 사용하여 대화 상자와 창에서 사용하는 글꼴을 가져오는 것은 권장되지 않습니다. 자세한 내용은 설명 섹션을 참조하세요.
기본 시스템 글꼴은 Tahoma입니다. |
|
고정 피치(모노스페이스) 시스템 글꼴입니다. 이 스톡 개체는 3.0 이전의 16비트 Windows 버전과의 호환성을 위해서만 제공됩니다. |
|
기본 색상표입니다. 이 색상표는 시스템 팔레트의 정적 색으로 구성됩니다. |
반환 값
함수가 성공하면 반환 값은 요청된 논리 개체에 대한 핸들입니다.
함수가 실패하면 반환 값은 NULL입니다.
설명
대화 상자와 창에서 사용되는 현재 글꼴을 가져오려면 이 메서드를 사용하지 않는 것이 좋습니다. 대신 systemParametersInfo 함수를 SPI_GETNONCLIENTMETRICS 매개 변수와 함께 사용하여 현재 글꼴을 검색합니다. SystemParametersInfo 는 현재 테마를 고려하여 캡션, 메뉴 및 메시지 대화 상자에 대한 글꼴 정보를 제공합니다.
CS_HREDRAW 및 CS_VREDRAW 스타일이 있는 창에서만 DKGRAY_BRUSH, GRAY_BRUSH 및 LTGRAY_BRUSH 스톡 개체를 사용합니다. 다른 창 스타일에서 회색 스톡 브러시를 사용하면 창을 이동하거나 크기를 조정한 후 브러시 패턴이 잘못 정렬될 수 있습니다. 스톡 브러시의 원점은 조정할 수 없습니다.
HOLLOW_BRUSH 및 NULL_BRUSH 스톡 개체는 동일합니다.
DeleteObject를 호출하여 스톡 개체를 삭제할 필요는 없지만 유해하지는 않습니다.
DC_BRUSH 및 DC_PEN 모두 BLACK_BRUSH 및 BLACK_PEN 같은 다른 스톡 개체와 교환하여 사용할 수 있습니다. 현재 펜 또는 브러시 색을 검색하는 방법에 대한 자세한 내용은 GetDCBrushColor 및 GetDCPenColor를 참조하세요. 색 설정 예제는 펜 또는 브러시 색 설정을 참조하세요. DC_BRUSH 또는 DC_PEN 인수가 있는 GetStockObject 함수는 SetDCPenColor 및 SetDCBrushColor 함수와 교환하여 사용할 수 있습니다.
예제
예를 들어 펜 또는 브러시 색 설정을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h(Windows.h 포함) |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기