GetObjectW 함수(wingdi.h)

아티클
08/27/2023

GetObject 함수는 지정된 그래픽 개체에 대한 정보를 검색합니다.

구문

int GetObjectW(
        HANDLE h,
        int    c,
        LPVOID pv
);

매개 변수

h

c

pv

반환 값

함수가 성공하고 lpvObject 가 유효한 포인터인 경우 반환 값은 버퍼에 저장된 바이트 수입니다.

함수가 성공하고 lpvObject 가 NULL이면 반환 값은 함수가 버퍼에 저장할 정보를 저장하는 데 필요한 바이트 수입니다.

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

설명

lpvObject 매개 변수가 가리키는 버퍼는 그래픽 개체에 대한 정보를 수신하기에 충분히 커야 합니다. 그래픽 개체에 따라 함수는 BITMAP, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT 또는 LOGPEN 구조체 또는 테이블 항목 수(논리 팔레트의 경우)를 사용합니다.

hgdiobj가 CreateDIBSection을 호출하여 만든 비트맵에 대한 핸들이고 지정된 버퍼가 충분히 큰 경우 GetObject 함수는 DIBSECTION 구조를 반환합니다. 또한 DIBSECTION 내에 포함된 BITMAP 구조체의 bmBits 멤버에는 비트맵의 비트 값에 대한 포인터가 포함됩니다.

hgdiobj가 다른 수단에서 만든 비트맵에 대한 핸들인 경우 GetObject는 비트맵의 너비, 높이 및 색 형식 정보만 반환합니다. GetDIBits 또는 GetBitmapBits 함수를 호출하여 비트맵의 비트 값을 가져올 수 있습니다.

hgdiobj가 논리 팔레트에 대한 핸들인 경우 GetObject는 색상표의 항목 수를 지정하는 2바이트 정수를 검색합니다. 함수는 팔레트를 정의하는 LOGPALETTE 구조를 검색하지 않습니다. 팔레트 항목에 대한 정보를 검색하기 위해 애플리케이션은 GetPaletteEntries 함수를 호출할 수 있습니다.

hgdiobj가 글꼴에 대한 핸들인 경우 반환되는 LOGFONT는 글꼴을 만드는 데 사용되는 LOGFONT입니다. 정확한 LOGFONT 를 나타낼 수 없기 때문에 Windows에서 글꼴을 보간해야 하는 경우 보간이 LOGFONT에 반영되지 않습니다. 예를 들어 세로 그리기를 지원하지 않는 글꼴의 세로 버전을 요청하는 경우 LOGFONT 는 글꼴이 세로임을 나타내지만 Windows는 가로로 그립니다.

예제

예제는 이미지 저장을 참조하세요.

참고

wingdi.h 헤더는 GETObject를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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