Freigeben über


CWnd::CreateCaret

Erstellt eine neue Form für das Caretzeichen und beansprucht Besitz der Einfügemarke.

void CreateCaret(
   CBitmap* pBitmap 
);

Parameter

  • pBitmap
    Identifiziert die Bitmap, die die Einfügemarkeform definiert.

Hinweise

Die Bitmap muss durch die CBitmap::CreateBitmap-Memberfunktion, die CreateDIBitmap Windows-Funktion oder die CBitmap::LoadBitmap-Memberfunktion zuvor erstellt worden sein.

CreateCaret zerstört automatisch die vorherige Einfügemarkeform ggf. unabhängig von der Fenster die Einfügemarke besitzt.Einmal erstellt, wird die Einfügemarke zuerst ausgeblendet.Um die Einfügemarke anzuzeigen, muss die ShowCaret-Memberfunktion aufgerufen werden.

Das Caretzeichen ist eine freigegebene Ressource.CWnd sollte eine Einfügemarke nur erstellen, wenn sie den Eingabefokus hat oder aktiv ist.Sie sollte die Einfügemarke zerstören, bevor der Eingabefokus verliert oder inaktiv ist.

Beispiel

// 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();
}

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWnd-Klasse

Hierarchien-Diagramm

CBitmap::CreateBitmap

CreateDIBitmap

DestroyCaret

CBitmap::LoadBitmap

CWnd::ShowCaret

CreateCaret