CWnd::CreateCaret

システム カレットの新しい形を作成し、カレットの所有権を取得します。

void CreateCaret(
   CBitmap* pBitmap 
);

パラメーター

  • pBitmap
    カレットの形を定義するビットマップを識別します。

解説

ビットマップは、CBitmap::CreateBitmap メンバー関数、CreateDIBitmap Windows 関数、または CBitmap::LoadBitmap メンバー関数のいずれかによってあらかじめ作成されている必要があります。

CreateCaret はどのウィンドウが所有しているかには無関係に、以前のカレットの形を自動的に破棄します。 作成されたカレットは、最初は非表示になります。 カレットを表示するには、ShowCaret メンバー関数を呼び出します。

システム キャレットは共有リソースです。 CWnd は、入力フォーカスを持っている場合またはアクティブな場合だけキャレットを作成します。 入力フォーカスを失う前か非アクティブになる前にカレットを破棄する必要があります。

使用例

// Changes the caret of the edit control in this dialog box
void CMyDlg::OnChangeCaret() 
{
   m_pBitmapCaret = new CBitmap;
   m_pBitmapCaret->LoadBitmap(IDB_HAPPY_BITMAP);
   m_MyEdit.CreateCaret(m_pBitmapCaret);
   m_MyEdit.ShowCaret();
}

必要条件

**ヘッダー:**afxwin.h

参照

参照

CWnd クラス

階層図

CBitmap::CreateBitmap

CreateDIBitmap

DestroyCaret

CBitmap::LoadBitmap

CWnd::ShowCaret

CreateCaret

概念

CWnd のメンバー