LoadCursor

9/9/2008

Essa função carrega um recurso cursor.

Syntax

HCURSOR LoadCursor( 
  HINSTANCE hInstance, 
  LPCTSTR lpCursorName
);

Parameters

• hInstance
  [no] Identificador para uma instância do módulo cujo arquivo executável contém o cursor a ser carregado.

• lpCursorName
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que contém o nome do recurso de cursor a ser carregado. Além disso, este parâmetro pode consistir de identificador de recurso na baixa - palavra ordem e zero de alta - palavra ordem. O MAKEINTRESOURCE macro também pode ser usado para criar esse valor.

  Para usar um dos cursores Microsoft Win32 predefinidas, o aplicativo deve definir a hInstance parâmetro para NULL e o lpCursorName parâmetro para um valor específico. A seguinte tabela mostra os valores possíveis. Este parâmetro deve ser definido como um destes valores.

  Valor	Descrição
  IDC_APPSTARTING	Padrão SETA e ampulheta pequena.
  IDC_ARROW	Padrão SETA.
  IDC_CROSS	Fio de Retículo.
  IDC_HAND	Mão.
  IDC_HELP	SETA e ponto de interrogação.
  IDC_ICON	Obsoleto.
  IDC_NO	Círculo cortado.
  IDC_SIZE	Obsoleto; Use IDC_SIZEALL.
  IDC_SIZEALL	SETA Four-pointed apontando Norte, Sul, Leste e Oeste.
  IDC_SIZENESW	SETA Double-pointed apontando nordeste e sudoeste.
  IDC_SIZENS	SETA Double-pointed apontando norte e sul.
  IDC_SIZENWSE	SETA Double-pointed apontando noroeste e sudeste.
  IDC_SIZEWE	SETA Double-pointed apontando Leste e Oeste.
  IDC_UPARROW	SETA vertical.
  IDC_WAIT	Ampulheta.

Return Value

O identificador para o cursor recém-carregada indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Essa função carrega o recurso cursor somente se ele não tenha sido carregado; caso contrário, ele recupera o identificador para o recurso existente. Essa função retorna um válido cursor identificador somente se o lpCursorName parâmetro aponta para um recurso cursor. Se lpCursorName Aponta para qualquer tipo de recurso Other Than um cursor (such as um ícone), o valor de retorno não é NULL, embora ele não seja um válido identificador cursor.

Essa função procura o recurso cursor mais apropriado para o cursor para o atual dispositivo exibir. O recurso cursor pode ser um bitmap monocromático ou cor.

Usar o componente cursor ao direcionamento uma plataforma que faz não mouse suporte cursores. O cursor somente oferece suporte a esse componente é a cursor de espera (IDC_WAIT). Use o LoadCursor função em conjunto com o SetCursor função para definir a cursor de espera.

SetCursor(LoadCursor(NULL, IDC_WAIT));

Use o componente mcursor quando direcionamento uma plataforma que não suporte mouse cursores. Esse componente oferece suporte a LoadCursor função da mesma maneira área de trabalho Windows plataformas fazer, Except that-suporta apenas monocromático cursores. Windows Embedded CE não suporte cor cursores. Tentar carregar um cursor cor terá resultados imprevisíveis.

Requirements

Header	winuser.h
Library	Cursor.lib, Mcursor.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

SetCursor
SetCursorPos
ShowCursor
MAKEINTRESOURCE