GetDC 함수(winuser.h)

아티클
03/04/2024

GetDC 함수는 지정된 창의 클라이언트 영역 또는 전체 화면에 대한 DC(디바이스 컨텍스트)에 대한 핸들을 검색합니다. 이후 GDI 함수에서 반환된 핸들을 사용하여 DC에서 그릴 수 있습니다. 디바이스 컨텍스트는 GDI에서 내부적으로 값을 사용하는 불투명 데이터 구조입니다.

GetDCEx 함수는 GetDC에 대한 확장으로, 애플리케이션에서 클라이언트 영역에서 클리핑이 발생하는 방법과 여부를 보다 자세히 제어할 수 있습니다.

구문

HDC GetDC(
  [in] HWND hWnd
);

매개 변수

[in] hWnd

DC를 검색할 창에 대한 핸들입니다. 이 값이 NULL이면 GetDC 는 전체 화면에 대한 DC를 검색합니다.

반환 값

함수가 성공하면 반환 값은 지정된 창의 클라이언트 영역에 대한 DC에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다.

설명

GetDC 함수는 지정된 창의 클래스 스타일에 따라 공통, 클래스 또는 프라이빗 DC를 검색합니다. 클래스 및 프라이빗 DC의 경우 GetDC 는 이전에 할당된 특성을 변경하지 않고 그대로 둡니다. 그러나 일반적인 DC의 경우 GetDC 는 검색될 때마다 DC에 기본 특성을 할당합니다. 예를 들어 기본 글꼴은 비트맵 글꼴인 System입니다. 이 때문에 GetDC 에서 반환된 공통 DC에 대한 핸들은 창을 그릴 때 사용된 글꼴, 색 또는 브러시를 알려주지 않습니다. 글꼴을 확인하려면 GetTextFace를 호출합니다.

DC에 대한 핸들은 한 번에 단일 스레드에서만 사용할 수 있습니다.

일반 DC를 사용하여 그리면 RELEASEDC 함수를 호출하여 DC를 해제해야 합니다. 클래스 및 프라이빗 DC는 릴리스할 필요가 없습니다. ReleaseDC 는 GetDC라는 동일한 스레드에서 호출되어야 합니다. DC 수는 사용 가능한 메모리에 의해서만 제한됩니다.

예제

예를 들어 마우스로 그리기를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll