LoadCursor

A LoadCursor função carrega o recurso especificado cursor do executável (.Arquivo EXE) associado com uma instância de aplicativo.

Esta função foi substituída pela função LoadImage

(HCURSOR LoadCursor HINSTANCE  hInstance, / / identificador de instância de aplicativoLPCTSTRlpCursorName / / nome do identificador de recurso de Cadeia de caracteres ou o cursor);
 

Parâmetros

hInstance

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

lpCursorName

Ponteiro para uma seqüência de caracteres null-terminated que contém o nome do recurso cursor a ser carregado. Como alternativa, este parâmetro pode consistir de identificador de recurso em de baixo palavra ordem e zero de alta-ordem palavra. O MAKEINTRESOURCE macro também pode ser usado para criar esse valor.

Para usar um dos cursores Win32 predefinidos, o aplicativo deve definir hInstance parâmetro para NULL e o parâmetro lpCursorName para um do seguinte valores:

Valor	Descrição
IDC_APPSTARTING	Seta padrão e pequena ampulheta
IDC_ARROW	Seta padrão
IDC_CROSS	Fio de retículo
IDC_HAND	Windows NT 5.0 e posterior: Mão
IDC_HELP	Seta e ponto de interrogação
IDC_IBEAM	Em forma de i
IDC_ICON	Obsoleto para aplicativos marcado versão 4.0 ou posterior.
IDC_NO	Círculo cortado
IDC_SIZE	Obsoleto para aplicativos marcado versão 4.0 ou posterior. Usar IDC_SIZEALL.
IDC_SIZEALL	Seta com quatro pontas apontando para o norte, Sul, leste e oeste
IDC_SIZENESW	SUDOESTE e seta de duas pontas apontando para nordeste
IDC_SIZENS	Sul e a seta de duas pontas apontando para norte
IDC_SIZENWSE	Sudeste e a seta de duas pontas apontando para noroeste
IDC_SIZEWE	Seta de duas pontas apontando para oeste e leste
IDC_UPARROW	Seta vertical
IDC_WAIT	Ampulheta

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador para o cursor recém-carregada.

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

Observações

A LoadCursor função carrega o recurso de 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 cursor válido identificador, somente se a lpCursorName parâmetro aponta para um recurso de cursor. Se lpCursorName aponta para qualquer tipo de recurso diferente de um cursor (como um ícone), o valor de retorno não é nulo, mesmo que não seja um identificador válido cursor.

A LoadCursor função pesquisa o recurso de cursor mais apropriado para o cursor para o atual dispositivo exibir. O recurso de cursor pode ser um bitmap colorido ou monocromático.

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

SetCursor (LoadCursor (NULL, IDC_WAIT))

Use o componente mcursor ao direcionamento uma plataforma que oferece suporte a cursores de mouse. Este componente suporta a LoadCursor função as mesmas janelas de maneira fazem a área de trabalho plataformas, exceto que ele só suporta monocromático cursores. Windows CE não oferece suporte a cursores de cor. Uma tentativa de carregar um cursor de cor terá resultados imprevisíveis.

Ver também

Visão geral de cursores, funções de Cursor, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index