CStatic::SetIcon

[アーティクル]
08/09/2011

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

HICON SetIcon(
   HICON hIcon 
);

パラメーター

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

戻り値

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

解説

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

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

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

CStaticオブジェクトは自動的に削除されません、関連付けられたアイコン。使用後、メモリリークを避けるために、アイコンを削除する必要があります。

使用例

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));