CreateBitmap

CreateBitmap

지정된 폭, 높이, 색형식을 가지는 비트 맵을 작성합니다.이 함수는, 흑백 비트 맵의 작성에 사용합니다.

HBITMAP CreateBitmap(
    int  nWitdh,         // 폭
    int  nHeight         // 높이
    UINT cPranes,        // 칼라플레인의 수
    UINT cBitsPerPel,    // 1 피크셀의 비트수
    CONST VOID *pvBits   // 피크셀의 색데이터
);

GDI32.DLL

인수

nWitdh, nHeight

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

cPranes

디바이스가 사용하는 칼라플레인의 수를 지정합니다.흑백 비트 맵의 작성을 위해서는1(을)를 지정합니다.

cBitsPerPel

1피크셀의 색을 식별하는데 필요한 비트수를 지정합니다.흑백 비트 맵의 작성을 위해서는1(을)를 지정합니다.

pvBits

피크셀의 색데이터가 들어간 배열에의 포인터를 지정합니다.방형의 각 주사행은, 워드 경계에 정렬되어 있지 않으면 안됩니다 (남은 아르바이트는0그리고 묻지 않으면 안됩니다) .0 (NULL) (을)를 지정하면, 비트 맵의 내용은 초기화되지 않고 부정이 됩니다.

반환값

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

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

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

해설

이 함수는 디바이스 의존 비트 맵을 작성합니다.

비트 맵 작성 후, SelectObject함수를 호출하고, 디바이스 콘텍스트에 선택할 수 있습니다.이 때, 비트 맵과 디바이스 콘텍스트는 같은 형식이 아니면 안됩니다.

이 함수를 사용해 칼라 비트 맥을 작성하는 것은 가능합니다만, 퍼포먼스상의 문제로부터, 어플리케이션은 흑백 비트 맵의 작성에는CreateBitmap함수를 사용해, 칼라 비트 맵의 작성에는 CreateCompatibleBitmap함수를 사용해야 합니다.CreateBitmap함수로 작성된 비트 맵이 디바이스 콘텍스트에 선택될 때에, 시스템은 비트 맵이 디바이스 콘텍스트의 형식과 합치하고 있을지를 체크합니다.CreateCompatibleBitmap함수는 지정된 디바이스 콘텍스트와 같은 형식의 비트 맵을 작성하기 위해(때문에),CreateBitmap함수에 의한 칼라 비트 맵보다CreateCompatibleBitmap함수에 의한 칼라 비트 맵이SelectObject함수의 호출이 고속으로 됩니다.

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

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

대응 정보

Windows 95 이후 / Windows NT 3.1 이후