CListCtrl::SetBkImage

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

リストビューコントロールの背景イメージを設定します。

BOOL SetBkImage(
   LVBKIMAGE* plvbkImage 
);
BOOL SetBkImage(
   HBITMAP hbm,
   BOOL fTile = TRUE,
   int xOffsetPercent = 0,
   int yOffsetPercent = 0
);
BOOL SetBkImage(
   LPTSTR pszUrl,
   BOOL fTile = TRUE,
   int xOffsetPercent = 0,
   int yOffsetPercent = 0 
);

パラメータ

plvbkImage
新しい背景イメージ情報を保持する LVBKIMAGE 構造体のアドレス。
hbm
ビットマップへのハンドル。
pszUrl
背景イメージの URL を示す NULL で終わる文字列。
fTile
イメージ群をリストビューコントロールの背景に並べて表示する場合は 0 以外。それ以外の場合は 0。
xOffsetPercent
リストビューコントロールの原点からイメージの左端までのオフセット (ピクセル単位)。
yOffsetPercent
リストビューコントロールの原点からイメージの上端までのオフセット (ピクセル単位)。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

メモ :
CListCtrl::SetBkImage は OLE COM 機能を使用するので、SetBkImage を使用する前に、OLE ライブラリを初期化する必要があります。アプリケーションの初期化時に COM ライブラリを初期化し、アプリケーションの終了時にライブラリを初期化前の状態に戻すことをお勧めします。ActiveX テクノロジ、OLE オートメーション、OLE リンク/埋め込み、または ODBC/DAO 操作を使用する MFC アプリケーションでは、自動的に行われます。

CListCtrl::SetBkImage は OLE COM 機能を使用するので、SetBkImage を使用する前に、OLE ライブラリを初期化する必要があります。アプリケーションの初期化時に COM ライブラリを初期化し、アプリケーションの終了時にライブラリを初期化前の状態に戻すことをお勧めします。ActiveX テクノロジ、OLE オートメーション、OLE リンク/埋め込み、または ODBC/DAO 操作を使用する MFC アプリケーションでは、自動的に行われます。