Função CreateCursor (winuser.h)
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 |