FindResource
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função determina a localidade de um recurso com o tipo especificado e o nome no módulo especificado.
Syntax
HRSRC FindResource(
HMODULE hModule,
LPCWSTR lpName,
LPCWSTR lpType
);
Parameters
- hModule
Identificador para o módulo cujo arquivo executável contém o recurso. Em Windows Embedded CE, isso não pode ser definido como NULL.
- lpName
Ponteiro para o nome do recurso. Para obter mais informações, consulte a seção " Comentários ".
lpType
Ponteiro para o tipo de recurso. Para obter mais informações, consulte a seção " Comentários ". Para padrão recurso tipos, este parâmetro podem ser uma dos seguinte valores.Valor Descrição RT_ACCELERATOR
Tabela de aceleração
RT_BITMAP
Bitmap recurso
RT_CURSOR
Hardware-dependente recurso cursor
RT_DIALOG
Caixa de diálogo
RT_FONT
Recurso de fonte
RT_FONTDIR
Fonte Diretório recurso
RT_GROUP_CURSOR
Recurso cursor Hardware-Independent
RT_GROUP_ICON
Recurso ícone Hardware-Independent
RT_ICON
Hardware-dependente ícone recurso
RT_MENU
Recurso menu
RT_MESSAGETABLE
Mensagem-entrada tabela
RT_RCDATA
Recurso Application-defined (dados não processados)
RT_STRING
Seqüência de caracteres-entrada tabela
RT_VERSION
Recurso versão
Return Value
Um identificador para bloco informações do recurso de especificado indica sucesso. Para obter um identificador para o recurso, transmitir este identificador para o LoadResource função. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Se o alto-Palavra de ordem de lpName Ou lpType parâmetro é zero, a baixa - palavra ordem especifica o identificador inteiro do nome ou tipo do determinado recurso. Caso contrário, esses parâmetros são ponteiros longos em seqüências de caracteres terminada por caractere nulo. Se o primeiro caractere do seqüência de caracteres é um sustenido (#), os caracteres restantes representam um decimal número que especifica o identificador do nome ou tipo de recurso inteiro. De exemplo, o seqüência de caracteres "#258" representa o identificador inteiro 258.
O lpName parâmetro não suporte o identificação do recurso zero — ou seja, (FindResourceh, 0, t**)** Não será trabalho conforme o esperado.
Um aplicativo deve reduzir o quantidade de memória exigido para os recursos referindo-se ao-las por inteiro identificador instead of pelo nome.
Quando você terminar com um tabela de aceleração, bitmap, cursor, ícone ou menu, você poderá versão seu associado memória por chamado um das funções no seguinte tabela.
| Recurso | Liberar função |
|---|---|
Tabela de aceleração |
|
Bitmap |
|
Cursor |
|
Ícone |
|
Menu |
O sistema exclui automaticamente esses recursos quando o processo que criou termina, no entanto, chamado de apropriado função salva memória e diminui o tamanho de conjunto de trabalho do processo.
Um aplicativo pode usar FindResource Para localizar qualquer tipo de recurso, mas esta função deve ser usado somente se o aplicativo deve acessar o binário dados recurso ao fazer chamadas subseqüentes para LoadLibrary.
Para usar um recurso imediatamente, um aplicativo deve use um das seguinte funções Resource-specific para localizar e carregar os recursos de chamar um.
| Função | Descrição |
|---|---|
Carrega e formata uma mensagem-entrada tabela. |
|
Carrega um tabela de aceleração. |
|
Carrega um recurso bitmap. |
|
Carrega um recurso cursor. |
|
Carrega um recurso ícone. |
|
Carrega um recurso menu. |
|
Carrega um seqüência de caracteres-entrada tabela. |
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 o ícone para copiar seus dados para outro aplicativo.
Recursos de seqüência de caracteres são armazenados em seções de até 16 seqüências de caracteres 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 nula-terminada). O LoadString função irá extrair o recurso seqüência de caracteres do seu correspondente seção.
Requirements
| Header | winbase.h |
| Library | coredll.lib, Nk.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
DeleteObject
DestroyAcceleratorTable
DestroyCursor
DestroyIcon
DestroyMenu
LoadAccelerators
LoadBitmap
LoadIcon
LoadMenu
LoadResource