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 |