CStatic::SetIcon

2008-09-17

更新 : 2007 年 11 月

新しいアイコンイメージを静的コントロールに関連付けます。

HICON SetIcon(
   HICON hIcon 
);

パラメータ

hIcon
静的コントロールに描画されるアイコンのハンドル。

戻り値

正常終了した場合は、静的コントロールに関連付けられたアイコンのハンドルを返します。静的コントロールに関連付けられたアイコンがない場合は、NULL を返します。

解説

アイコンは静的コントロールに自動的に描画されます。既定では、アイコンは左上隅に描画され、静的コントロールはアイコンのサイズにサイズが変更されます。

以下のようなウィンドウとスタティックコントロールスタイルを使用できます。

SS_ICON カーソルとアイコンでは常にこのスタイルを使います。
SS_CENTERIMAGE 静的コントロールの中央に揃えるのに使います。イメージが静的コントロールより大きいときは、クリッピングされます。静的コントロールより小さいときは、イメージの周囲の空の領域は静的コントロールの背景色で塗りつぶされます。

使用例

CStatic myStatic;

// Create a child icon static control.
myStatic.Create(_T("my static"), 
   WS_CHILD|WS_VISIBLE|SS_ICON|SS_CENTERIMAGE, CRect(10,10,150,50), 
   pParentWnd);

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