CWnd::CreateSolidCaret

Artigo
06/10/2015

Cria um retângulo contínuo para o sinal de intercalação e diz a propriedade caret.

void CreateSolidCaret( 
   int nWidth, 
   int nHeight  
);

Parâmetros

nWidth
Especifica a largura do acento circunflexo (em unidades lógicas). Se esse parâmetro é 0, a largura é definida como a largura definida pelo sistema de uma borda.
nHeight
Especifica a altura do acento circunflexo (em unidades lógicas). Se esse parâmetro é 0, a altura é definida como a altura do sistema definida de uma borda.

Comentários

A forma caret pode ser uma linha ou bloco.

Os parâmetros nWidth e nHeight especificam a largura e a altura do acento circunflexo (em unidades lógicas); a largura e altura exatas (em pixels) dependem do modo de mapeamento.

A largura ou altura de uma borda do sistema podem ser recuperadas pela função do windows de GetSystemMetrics com os índices de SM_CXBORDER e de SM_CYBORDER . Usar a largura ou altura de uma borda garante que o acento circunflexo está visível em uma exibição de alta resolução.

A função de membro de CreateSolidCaret for automaticamente a forma anterior caret, se houver, independentemente da janela possui o acento circunflexo. Uma vez criado, o acento circunflexo está oculto inicialmente. Para mostrar o acento circunflexo, a função de membro de ShowCaret deve ser chamada.

O sinal de intercalação é um recurso compartilhado. CWnd deve criar um sinal de intercalação somente quando tem o foco de entrada ou está ativo. Também deve o acento circunflexo antes que perde o foco de entrada ou se torne inativo.

Exemplo

// Create a 5x10 solid caret in the edit control. 
void CMyDlg::OnCreateSolidCaret()
{
   m_MyEdit.CreateSolidCaret(5, 10);
   m_MyEdit.ShowCaret();
}