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