CButton::SetBitmap

2011-08-09

更新 : 2010 年 6 月

このメンバー関数は、ボタンに新しいビットマップを結び付けるために使用します。

HBITMAP SetBitmap(
   HBITMAP hBitmap 
);

パラメーター

hBitmap
ビットマップのハンドル。

戻り値

以前にボタンに結び付けられたビットマップのハンドルを返します。

解説

ビットマップは、既定でボタンの表面中央に自動的に置かれます。ビットマップがボタンよりも大きいときは、いずれかの端に揃えることができます。以下に示すオプションを指定できます。

BS_TOP
BS_LEFT
BS_RIGHT
BS_CENTER
BS_BOTTOM
BS_VCENTER

1 つのボタンで 4 つのビットマップを使用する CBitmapButton と違い、SetBitmap は 1 つのボタンで 1 つのビットマップを使用します。ボタンが押されると、ビットマップは右下にシフトして表示されます。

作業が完了すると、ビットマップを解放するために責任があります。

使用例

CButton myBitmapButton;

// Create a bitmap button.
myBitmapButton.Create(_T("My button"), WS_CHILD|WS_VISIBLE|BS_BITMAP, 
   CRect(10,10,60,50), pParentWnd, 1);

// If no bitmap is defined for the button, define the bitmap to the
// system close bitmap.
if (myBitmapButton.GetBitmap() == NULL)
   myBitmapButton.SetBitmap(::LoadBitmap(NULL, MAKEINTRESOURCE(OBM_CLOSE)));