Compartilhar via


Macro CopyCursor (winuser.h)

Copia o cursor especificado.

Sintaxe

HCURSOR CopyCursor(
  [in] pcur
);

Parâmetros

[in] pcur

Tipo: HCURSOR

Um identificador para o cursor a ser copiado.

Valor de retorno

Tipo: HCURSOR

Se a chamada for bem-sucedida, o valor retornado será um identificador para o cursor duplicado.

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

Observações

O CopyCursor permite que um aplicativo ou DLL obtenha o identificador para uma forma de cursor de propriedade de outro módulo. Em seguida, se o outro módulo for liberado, o aplicativo ainda poderá usar a forma do cursor.

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

Não use a função CopyCursor para cursores animados. Em vez disso, use a função CopyImage .

CopyCursor é implementado como uma chamada para a função CopyIcon .

#define CopyCursor(pcur) ((HCURSOR)CopyIcon((HICON)(pcur)))

Requirements

Requirement Value
Cliente mínimo suportado Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header winuser.h (inclua Windows.h)

Consulte também

Conceitual

CopyIcon

CopyImage

Cursores

DestroyCursor

GetCursor

Referência

SetCursor

ShowCursor