LoadBitmapA 함수(winuser.h)

아티클
08/27/2023

[LoadBitmap 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 LoadImage 및 DrawFrameControl을 사용합니다.]

LoadBitmap 함수는 모듈의 실행 파일에서 지정된 비트맵 리소스를 로드합니다.

구문

HBITMAP LoadBitmapA(
  [in] HINSTANCE hInstance,
  [in] LPCSTR    lpBitmapName
);

매개 변수

[in] hInstance

실행 파일에 로드할 비트맵이 포함된 모듈의 instance 대한 핸들입니다.

[in] lpBitmapName

로드할 비트맵 리소스의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 또는 이 매개 변수는 하위 단어의 리소스 식별자와 상위 단어의 0으로 구성됩니다. MAKEINTRESOURCE 매크로를 사용하여 이 값을 만들 수 있습니다.

반환 값

함수가 성공하면 반환 값은 지정된 비트맵에 대한 핸들입니다.

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

설명

lpBitmapName 매개 변수가 가리키는 비트맵이 없거나 비트맵을 로드할 메모리가 부족하면 함수가 실패합니다.

LoadBitmap 은 프린터로 선택할 수 없는 디스플레이의 호환되는 비트맵을 만듭니다. 프린터에 선택할 수 있는 비트맵을 로드하려면 LoadImage 를 호출하고 LR_CREATEDIBSECTION 지정하여 DIB 섹션을 만듭니다. DIB 섹션은 모든 디바이스에서 선택할 수 있습니다.

애플리케이션은 LoadBitmap 함수를 사용하여 미리 정의된 비트맵에 액세스할 수 있습니다. 이렇게 하려면 애플리케이션에서 hInstance 매개 변수를 NULL 로 설정하고 lpBitmapName 매개 변수를 다음 값 중 하나로 설정해야 합니다.

비트맵 이름	비트맵 이름
OBM_BTNCORNERS	OBM_OLD_RESTORE
OBM_BTSIZE	OBM_OLD_RGARROW
OBM_CHECK	OBM_OLD_UPARROW
OBM_CHECKBOXES	OBM_OLD_ZOOM
OBM_CLOSE	OBM_REDUCE
OBM_COMBO	OBM_REDUCED
OBM_DNARROW	OBM_RESTORE
OBM_DNARROWD	OBM_RESTORED
OBM_DNARROWI	OBM_RGARROW
OBM_LFARROW	OBM_RGARROWD
OBM_LFARROWD	OBM_RGARROWI
OBM_LFARROWI	OBM_SIZE
OBM_MNARROW	OBM_UPARROW
OBM_OLD_CLOSE	OBM_UPARROWD
OBM_OLD_DNARROW	OBM_UPARROWI
OBM_OLD_LFARROW	OBM_ZOOM
OBM_OLD_REDUCE	OBM_ZOOMD

OBM_OLD 시작하는 비트맵 이름은 3.0 이전 Windows의 16비트 버전에서 사용하는 비트맵을 나타냅니다.

애플리케이션에서 OBM_ 상수를 사용하려면 Windows.h 헤더 파일이 포함되기 전에 상수 OEMRESOURCE를 정의해야 합니다.

애플리케이션은 DeleteObject 함수를 호출하여 LoadBitmap 함수에서 반환하는 각 비트맵 핸들을 삭제해야 합니다.

예제

예제는 메뉴 사용에서 Menu-Item 비트맵의 예를 참조하세요.

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-draw-l1-1-1(Windows 8.1 도입)