Função CreateCursor (winuser.h)

Artigo
02/01/2024

Cria um cursor monocromático com o tamanho, os padrões de bit e o ponto de acesso especificados.

Para criar um cursor colorido em tempo de execução, você pode usar a função CreateIconIndirect , que cria um cursor com base no conteúdo de uma estrutura ICONINFO .

Sintaxe

HCURSOR CreateCursor(
  [in, optional] HINSTANCE  hInst,
  [in]           int        xHotSpot,
  [in]           int        yHotSpot,
  [in]           int        nWidth,
  [in]           int        nHeight,
  [in]           const VOID *pvANDPlane,
  [in]           const VOID *pvXORPlane
);

Parâmetros

[in, optional] hInst

Tipo: HINSTANCE

Um identificador para a instância atual do aplicativo que cria o cursor.

[in] xHotSpot

Tipo: int

A posição horizontal do ponto quente do cursor.

[in] yHotSpot

Tipo: int

A posição vertical do ponto quente do cursor.

[in] nWidth

Tipo: int

A largura do cursor, em pixels.

[in] nHeight

Tipo: int

A altura do cursor, em pixels.

[in] pvANDPlane

Tipo: const VOID*

Uma matriz de bytes que contém os valores de bit para a máscara AND do cursor, como em um bitmap monocromático. Consulte Observações.

[in] pvXORPlane

Tipo: const VOID*

Uma matriz de bytes que contém os valores de bit para a máscara XOR do cursor, como em um bitmap monocromático. Consulte Observações.

Retornar valor

Tipo: HCURSOR

Se a função for bem-sucedida, o valor retornado será um identificador para o cursor.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para determinar o tamanho nominal de um cursor, use a função GetSystemMetrics , especificando o valor SM_CXCURSOR ou SM_CYCURSOR . Além disso, você pode usar a versão com reconhecimento de DPI dessa API, consulte (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Para obter mais informações, consulte High DPI Desktop Application Development on Windows.

Para obter mais informações sobre os parâmetros pvANDPlane e pvXORPlane , consulte descrição do parâmetro lpBits da função CreateBitmap .

CreateCursor aplica a seguinte tabela de verdade às máscaras de bits AND e XOR:

Máscara de bits AND	Máscara de bits XOR	Monitor
0	0	Preto
0	1	Branca
1	0	Tela
1	1	Tela inversa

Antes de fechar, um aplicativo deve chamar a função DestroyCursor para liberar todos os recursos do sistema associados ao cursor.

Virtualização de DPI

Essa API não participa da virtualização de DPI. A saída retornada é em termos de coordenadas físicas e não é afetada pela DPI do thread de chamada. Observe que o cursor criado ainda pode ser dimensionado para corresponder ao DPI de qualquer janela em que ele é desenhado.

Exemplos

Para obter um exemplo, consulte Criando um cursor.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll