CreateCursor

A CreateCursor função cria um cursor ter o tamanho especificado, bit padrões e ponto de acesso.

(HCURSOR CreateCursor HINSTANCE  hInst, / / identificador de instância de aplicativointxHotSpot, / / posição horizontal de hot spotintyHotSpot, / / posição vertical do hot spotintnWidth, / / largura do cursor intnHeight, / / altura do cursorVOID CONST* pvANDPlane, / / ponteiro para matriz de máscara de bits eVOID CONST* pvXORPlane / / ponteiro para matriz de máscara de bits XOR);
 

Parâmetros

hInst

Identificador para a instância atual do aplicativo criando o cursor.

xHotSpot

Especifica a posição horizontal do ponto de acesso do cursor.

yHotSpot

Especifica a posição vertical do ponto de acesso do cursor.

nWidth

Especifica a largura, em pixels, do cursor.

nHeight

Especifica a altura, em pixels, do cursor.

pvANDplane

Ponteiro para uma matriz de bytes que contém os valores bit para o máscara de bits e do cursor, as in um dispositivo-dependente bitmap monocromático.

pvXORplane

Ponteiro para uma matriz de bytes que contém os valores bit para o máscara de bits XOR do cursor, as in um dispositivo-dependente bitmap monocromático.

Retornar valores

Se a função for bem-sucedido, o valor de retorno identifica o cursor.

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

Observações

O nWidth e nHeight parâmetros devem especificar uma largura e altura que são suportadas pelo driver de vídeo atual, porque o sistema não é possível criar cursores de outros tamanhos. Para determinar a largura e altura com suporte pelo driver de Exibir, usar o GetSystemMetrics função, especificando o valor SM_CXCURSOR ou SM_CYCURSOR.

Antes de fechar, um aplicativo deve chamar o DestroyCursor função para livre quaisquer recursos sistema associado com o cursor.

QuickInfo

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

Ver também

Visão geral de cursores, funções de Cursor, CreateIcon, DestroyCursor, GetModuleHandle, GetSystemMetrics, SetCursor