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