GetObject(A)

GetObject(A)

지정된 그래픽 오브젝트의 정보를 취득합니다.

int GetObjectA(
    HGDIOBJ hgdiobj,  // 오브젝트의 핸들
    int     cbBuffer, // 버퍼 사이즈
    PVOID   pvObject  // 정보를 격납하는 버퍼
);

GDI32.DLL

인수

hgdiobj

그래픽 오브젝트의 핸들을 지정합니다.지정할 수 있는 그래픽 오브젝트의 종류는, 논리 비트 맵, 브러쉬, 폰트, 팔레트, 펜, CreateDIBSection 함수로 작성되었다 DIB (디바이스 독립 비트 맵)의 머지않아인가입니다.

cbBuffer

pvObject 파라미터로 나타나는 버퍼의 사이즈를 지정합니다.

pvObject

오브젝트 정보를 격납하는 버퍼의 주소를 지정합니다.

0 (NULL) (을)를 지정하면, 반환값으로서 정보를 격납하기 위해서 필요한 버퍼의 사이즈가 돌아갑니다.

오브젝트의 종류와 버퍼가 받는 데이터형(구조체)과의 대응을 다음에 나타냅니다.버퍼는 대응하는 구조체의 사이즈와 같다확보되어 있지 않으면 안됩니다.

오브젝트의 종류 (핸들의 형태)	구조체	구조체 사이즈
비트 맵 (HBITMAP 형)	BITMAP 구조체	24
CreateDIBSection 함수로 작성되었다 DIB (HBITMAP 형)	DIBSECTION 구조체 (cbBuffer = 84 때) BITMAP 구조체 (cbBuffer = 24 때)	84 (DIBSECTION), 24 (BITMAP)
팔레트 (HPALETTE 형)	WORD 형 (논리 팔레트의 엔트리수가 격납됩니다)	2
펜 (HPEN 형)	LOGPEN 구조체	16
ExtCreatePen 함수로 작성된 펜 (HPEN 형)	EXTLOGPEN 구조체	28
브러쉬 (HBRUSH 형)	LOGBRUSH 구조체	12
폰트 (HFONT 형)	LOGFONT 구조체	60

반환값

함수가 성공해, 한편, lpvObject 파라미터에 유효한 버퍼의 포인터를 지정했을 경우는, 버퍼에 격납한 정보의 아르바이트수가 돌아갑니다.

함수가 성공해, 한편, lpvObject 파라미터에 0 (NULL) (을)를 지정했을 경우는, 정보를 격납하기 위해서 필요한 버퍼의 아르바이트 단위의 사이즈가 돌아갑니다.

실패하면 0 하지만 돌아갑니다.

Windows NT/2000/XP： 확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후