Compartilhar via

Função CreateCursor (winuser.h)

  • Artigo

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 de acesso do cursor.

[in] yHotSpot

Tipo: int

A posição vertical do ponto de acesso 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. Confira as 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. Confira as observações.

Valor de retorno

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.

Observações

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. Para obter mais informações, consulte Desenvolvimento de Aplicativos da Área de Trabalho de Alta DPI no Windows.

Para obter mais informações sobre pvANDPlane e parâmetros de pvXORPlane, consulte a 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 Exposição
0 0 Preto
0 1 Branco
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 pelo 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

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winuser.h (inclua Windows.h)
biblioteca User32.lib
de DLL User32.dll

Consulte também

CreateIcon

CreateIconIndirect

DestroyCursor

GetSystemMetrics

SetCursor

cursores