CButton::SetIcon

2011-08-09

このメンバー関数は、ボタンに新しいアイコンを結び付けるために使用します。

HICON SetIcon(
   HICON hIcon 
);

パラメーター

hIcon
アイコンのハンドル。

戻り値

以前にボタンに結び付けられたアイコンのハンドルを返します。

解説

アイコンは、既定でボタンの表面中央に自動的に置かれます。アイコンがボタンよりも大きい場合は、どちらかの端に揃えることができます。以下に示すオプションを指定できます。

BS_TOP
BS_LEFT
BS_RIGHT
BS_CENTER
BS_BOTTOM
BS_VCENTER

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

使用例

CButton myIconButton2;

// Create an icon button.
myIconButton2.Create(_T("My button"), WS_CHILD|WS_VISIBLE|BS_ICON, 
   CRect(10,10,60,50), pParentWnd, 1);

// If no icon is defined for the button, define the icon to the
// system error icon.
if (myIconButton2.GetIcon() == NULL)
   myIconButton2.SetIcon(::LoadIcon(NULL, IDI_ERROR));