Freigeben über


CWnd::CreateGrayCaret

Erstellt ein graues Rechteck für das Caretzeichen und beansprucht Besitz der Einfügemarke.

void CreateGrayCaret(
   int nWidth,
   int nHeight 
);

Parameter

  • nWidth
    Gibt die Breite der Einfügemarke an (in logischen Einheiten).Wenn dieser Parameter 0 ist, wird die Breite zur Kategorie Fensterrahmenbreite festgelegt.

  • nHeight
    Gibt die Höhe der Einfügemarke an (in logischen Einheiten).Wenn dieser Parameter 0 ist, wird die Höhe zur Kategorie Fensterrahmenhöhe festgelegt.

Hinweise

Die Einfügemarkeform kann eine Zeile oder ein Block liegen.

Die Parameter nWidth und nHeight geben der Breite und Höhe Einfügemarke an (in logischen Einheiten); die exakte Breite und Höhe (in Pixel) hängen vom Zuordnungsmodus ab.

Die Breite und die Höhe des Fensterrahmens des Systems können durch die GetSystemMetrics Windows-Funktion mit den SM_CXBORDER und SM_CYBORDER Indizes abgerufen werden.Verwenden der Fensterrahmenbreite oder höhe wird sichergestellt, dass die Einfügemarke an einer hochauflösenden Anzeige sichtbar ist.

Die CreateGrayCaret-Memberfunktion 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

// Create a 5x10 gray caret in the edit control.
void CMyDlg::OnCreateGrayCaret()
{
   m_MyEdit.CreateGrayCaret(5, 10);
   m_MyEdit.ShowCaret();
}

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWnd-Klasse

Hierarchien-Diagramm

DestroyCaret

GetSystemMetrics

CWnd::ShowCaret

CreateCaret