CreateCompatibleBitmap

CreateCompatibleBitmap

지정된 디바이스 콘텍스트에 관련지을 수 있었던 디바이스와 호환성이 있는 비트 맵을 작성합니다.

HBITMAP CreateCompatibleBitmap(
    HDC hDC,          // 디바이스 콘텍스트의 핸들
    int nWitdh,       // 폭
    int nHeight       // 높이
);

GDI32.DLL

인수

hDC

디바이스 콘텍스트의 핸들을 지정합니다.이 디바이스 콘텍스트에 관련하는 디바이스와 호환성이 있는 비트 맵을 작성합니다.

nWitdh, nHeight

작성하는 비트 맵의 사이즈를 피크셀 단위로 지정합니다.

반환값

성공하면 작성된 비트 맵의 핸들이 돌아갑니다.

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

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

해설

작성되는 비트 맵의 색형식은,hDC파라미터로 지정한 디바이스의 색형식과 일치합니다.이 비트 맵은 원래의 디바이스와 호환성이 있는 어느 메모리데바이스콘테키스트에도 선택할 수 있습니다.

메모리데바이스콘테키스트에서는 칼라 비트 맵과 흑백 비트 맵의 어디라도 취급할 수 있기 위해, 지정된 디바이스 콘텍스트가 메모리데바이스콘테키스트일 때, 이 함수에 의해서 돌려주어지는 비트 맵의 형식은 다릅니다.그러나, 비메모리데바이스콘테키스트를 위해서 작성된 호환 비트 맵은 항상 같은 색형식을 가지고 있어 지정된 디바이스 콘텍스트와 같은 칼라 팔레트를 사용합니다.

CreateCompatibleDC함수에 의해서 메모리데바이스콘테키스트가 작성되면, 처음은1×1피크셀의 흑백 비트 맵이 선택된 상태가 되어 있습니다.이 디바이스 콘텍스트를 지정해 비트 맵을 작성하면, 흑백 비트 맵이 작성됩니다, 칼라 비트 맵을 작성하려면 , 새롭게 작성된 디바이스 콘텍스트가 아니고, 그 디바이스 콘텍스트를 작성할 때에CreateCompatibleDC함수에게 건네진 원래의 디바이스 콘텍스트의 핸들을CreateCompatibleBitmap함수에 건네주도록(듯이) 합니다.

nWitdh또는nHeight에0(을)를 지정하면,1×1피크셀의 흑백 비트 맵의 핸들이 돌아갑니다.

hDC파라미터로 지정된 디바이스 콘텍스트에DIB섹션이 선택되고 있는 경우, 이 함수는 DIB섹션을 작성합니다.

비트 맵이 불필요하게 되면 DeleteObject함수로 삭제하지 않으면 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후