Partager via


CWnd::CreateGrayCaret

Crée un rectangle gris pour le signe insertion et réclame la propriété du signe insertion.

void CreateGrayCaret(
   int nWidth,
   int nHeight 
);

Paramètres

  • nWidth
    Spécifie la largeur du signe insertion (en unités logiques).Si ce paramètre est 0, la largeur est définie à la largeur définie par le système de bordure fenêtres.

  • nHeight
    Spécifie la hauteur du signe insertion (en unités logiques).Si ce paramètre est 0, la hauteur est définie à la hauteur définie par le système de bordure fenêtres.

Notes

La forme de signe insertion peut être une ligne ou un bloc.

Les paramètres nWidth et nHeight spécifient la largeur et la hauteur du signe insertion (en unités logiques) ; la largeur et la hauteur exacte (en pixels) dépendent du mode de mappage.

La largeur ou la hauteur de fenêtres la bordure du système peut être récupérée par la fonction Windows de GetSystemMetrics avec les index de SM_CXBORDER et de SM_CYBORDER .À l'aide de la largeur et la hauteur des fenêtres de bordure garantit que le signe insertion sera visible sur un écran haute résolution.

La fonction membre d' CreateGrayCaret détruit automatiquement la forme précédente du signe insertion, dont le cas échéant, quelle que soit la fenêtre possède le signe insertion.Une fois créé, le signe insertion est initialement masqué.Pour afficher le signe insertion, la fonction membre de ShowCaret doit être appelée.

Le signe insertion est une ressource partagée.CWnd doit créer un signe insertion uniquement lorsqu'il a le focus d'entrée ou est actif.Il doit détruire le signe insertion avant qu'il ne perde le focus d'entrée ou devienne inactive.

Exemple

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

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

DestroyCaret

GetSystemMetrics

CWnd::ShowCaret

CreateCaret