A FindResource função determina a localização de um recurso com o tipo especificado e o nome do módulo especificado.
(HRSRC FindResource HMODULE hModule, / / módulo de lidar comLPCTSTRlpName, / / ponteiro para nome do recursoLPCTSTRlpType / / ponteiro para recurso tipo);
Um valor de NULL especifica o identificador do módulo associado com o arquivo de imagem que o sistema operacional usado para criar o atual processo.
Valor | Significado |
---|---|
RT_ACCELERATOR | Tabela de teclas aceleradoras |
RT_ANICURSOR | Cursor animado |
RT_ANIICON | Ícone animado |
RT_BITMAP | Recurso de bitmap |
RT_CURSOR | Recurso cursor hardware-dependente |
RT_DIALOG | Caixa de diálogo |
RT_FONT | Recurso de fonte |
RT_FONTDIR | Recurso de diretório de fonte |
RT_GROUP_CURSOR | Recurso cursor hardware-independent |
RT_GROUP_ICON | Recurso ícone hardware-independent |
RT_HTML | Documento HTML |
RT_ICON | Recurso ícone hardware-dependente |
RT_MENU | Recurso de menu |
RT_MESSAGETABLE | Mensagem-entrada tabela |
RT_RCDATA | Recurso Application-defined (dados brutos) |
RT_STRING | Cadeia de caracteres-entrada tabela |
RT_VERSION | Versão do recurso |
Se a função for bem-sucedido, o valor de retorno é um identificador para bloco de info do recurso especificado. Para obter um identificador para o recurso, passar esse identificador para o LoadResource função.
Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.
Se o alto-palavra ordem do lpName ou lpType parâmetro é zero, a baixa palavra ordem Especifica o identificador inteiro do nome ou tipo de determinado recurso. Caso contrário, esses parâmetros são longos ponteiros para seqüências de caracteres terminada por caractere nulo. Se o primeiro caractere da seqüência de caracteres é um sinal de libra (#), os caracteres restantes representam um decimal número que especifica o identificador inteiro do nome ou o tipo do recurso. Por exemplo, a Cadeia de caracteres "# 258" representa o identificador inteiro 258.
Um aplicativo deve reduzir a quantidade de memória necessária para os recursos, referindo-se a eles pelo identificador inteiro em vez de por nome.
Quando você tiver terminado usando uma tabela de teclas aceleradoras, bitmap, cursor, ícone ou menu, você pode liberar seu associado memória por chamado um das funções na tabela a seguir.
Recurso | Função de lançamento |
---|---|
Tabela de teclas aceleradoras | DestroyAcceleratorTable |
Bitmap | ExcluirObjeto |
Cursor | DestroyCursor |
Ícone | DestroyIcon |
Menu | DestroyMenu |
O sistema exclui automaticamente esses recursos quando termina o processo que criado-los, no entanto, chamado de apropriado função salva memória e diminui o tamanho do conjunto de trabalho do processo.
Um aplicativo pode usar FindResource para localizar qualquer tipo de recurso, mas esta função deve ser usada somente se o aplicativo deve acessar o binário dados recurso ao fazer chamadas subseqüentes para LoadLibrary e LockResource.
Para usar um recurso imediatamente, um aplicativo deve usar uma das seguintes funções resource-specific para localizar e carregar os recursos em uma chamada:
Função | Ação |
---|---|
FormatMessage | Carrega e formata uma mensagem entrada tabela. |
LoadAccelerators | Carrega uma tabela de teclas aceleradoras. |
LoadBitmap | Carrega um recurso de bitmap. |
LoadCursor | Carrega um recurso cursor. |
LoadIcon | Carrega um recurso de ícone. |
LoadMenu | Carrega um recurso de menu. |
LoadString | Carrega uma seqüência de caracteres-entrada tabela. |
Por exemplo, um aplicativo pode usar o LoadIcon função para carregar um ícone para exibir na tela. No entanto, o aplicativo deve usar FindResource e LoadResource se ele está carregando no ícone para copiar seus dados para outro aplicativo.
Recursos de Cadeia de caracteres são armazenados nas seções de até 16 cordas por seção. As seqüências de caracteres em cada seção são armazenadas como uma seqüência de contados seqüências Unicode (não null-terminated). O LoadString função irá extrair o recurso de Cadeia de caracteres de sua seção correspondente.
Windows CE: O hModule parâmetro não pode ser um identificador NULL.
O parâmetro lpName não suporta a identificação de recurso zero — ou seja, FindResource (h, 0, t) não funciona como esperado.
Você não pode passar os valores de RT_ANICURSOR ou RT_ANIICON no lpType parâmetro.
nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinBase. h.
Biblioteca de importação:Use Kernel32. lib.
Unicode:Implementado como versões Unicode e ANSI no Windows e Windows NT.
Visão geral sobre recursos, recurso funciona, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource