CreateCaret

A função CreateCaret cria uma Novo forma para o cursor do sistema e atribui apropriar o cursor para a janela especificada. A forma de cursor pode ser uma linha, um bloco ou um bitmap.

(BOOL CreateCaret HWND  hWnd, / / identificador para janela de proprietárioHBITMAPhBitmap, / / identificador para o bitmap para a forma de cursorintnWidth, / / largura do cursorintnHeight / / altura do acento circunflexo);
 

Parâmetros

hWnd

Identifica a janela que possui o acento circunflexo.

hBitmap

Identifica o bitmap que define a forma de cursor. Se este parâmetro é NULL, o acento circunflexo é sólido. Se este parâmetro for (HBITMAP) 1, o acento circunflexo é cinza. Se este parâmetro é um identificador de bitmap, o acento circunflexo é o bitmap especificado. O identificador de bitmap deve ter sido criado pelo CreateBitmap, CreateDIBitmap, ou função LoadBitmap.

Se um identificador de bitmap hBitmap , CreateCaret ignora o nWidth e nHeight parâmetros; o bitmap define sua própria largura e altura.

nWidth

Especifica a largura do acento circunflexo em unidades lógicas. Se este parâmetro for zero, a largura é definida como a largura de borda de janela definida pelo sistema. Se um identificador de bitmap hBitmap , CreateCaret ignora esse parâmetro.

nHeight

Especifica a altura, em unidades lógicas, do acento circunflexo. Se este parâmetro for zero, a altura é definida como a altura de borda de janela definida pelo sistema. Se um identificador de bitmap hBitmap , CreateCaret ignora esse parâmetro.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Os parâmetros nWidth e nHeight especificam largura e a altura, do acento circunflexo em unidades lógicas; a largura exata e altura, em pixels, dependem do modo de mapeamento da janela.

CreateCaret automaticamente destrói a forma de cursor anterior, se houver, independentemente da janela que possui o acento circunflexo. O acento circunflexo está oculto até que o aplicativo chama o ShowCaret função para tornar visível o acento circunflexo.

O sistema fornece uma acento circunflexo por fila. Uma janela deve criar um acento circunflexo apenas quando ele tem o foco do teclado ou está ativo. A janela deve destruir o acento circunflexo antes de perder o foco do teclado ou tornar-se inativo.

Você pode recuperar a largura ou a altura da borda da janela do sistema usando o GetSystemMetrics função, especificando os valores SM_CXBORDER e SM_CYBORDER. Usando a janela borda largura ou altura garante que o acento circunflexo estará visível em uma tela de alta resolução.

Windows CE: Windows CE não oferece suporte o parâmetro hBitmap e deve ser definido como NULL. Padrões do Windows CE para um cursor sólido.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de acentos circunflexos, funções acento circunflexo, CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index