FindResource

Funksjonen FindResource bestemmer plasseringen til en ressurs med den angitte typen og navnet i den angitte modulen.

() HRSRC FindResource HMODULE  hModule, / / modulreferanseLPCTSTRlpName, / / peker til ressursnavnLPCTSTRlpType / / peker til ressurs-type);
 

Parametere

hModule
Håndtere til modulen der kjørbare fil inneholder ressursen.

En verdi på NULL angir modulreferanse knyttet til bildefilen som operativsystemet, brukes til å opprette den gjeldende prosessen.

lpName
Angir navnet på ressursen. Hvis du vil ha mer informasjon, se under Merknader.
lpType
Angir ressurstypen. Hvis du vil ha mer informasjon, se under Merknader. For standard ressurstyper, kan denne parameteren være en av følgende verdier:
Verdi Betydning
RT_ACCELERATOR Accelerator tabell
RT_ANICURSOR Animert markør
RT_ANIICON Animerte ikonet
RT_BITMAP Punktgrafikk-ressurs
RT_CURSOR Maskinvareavhengig markøren ressurs
RT_DIALOG Dialogboksen
RT_FONT Skrift-ressurs
RT_FONTDIR Skrift directory-ressursen
RT_GROUP_CURSOR Maskinvare-uavhengig markøren ressurs
RT_GROUP_ICON Maskinvare-uavhengig ikonet ressurs
RT_HTML HTML-dokument
RT_ICON Maskinvareavhengig ikonet ressurs
RT_MENU Menyen ressurs
RT_MESSAGETABLE Oppføring i melding-tabellen
RT_RCDATA Programdefinert ressurs (rådata)
RT_STRING Streng-tabellelementet
RT_VERSION Versjonsressurs

Returverdier

Hvis funksjonen lykkes, er returverdien en referanse til den angitte ressursen informasjonsblokk. Hvis du vil hente en referanse til ressursen, kan du sende denne referansen til LoadResource -funksjonen.

Hvis funksjonen mislykkes, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Hvis ordet signifikante til lpName eller lpType -parameteren er null, angir signifikante ordet heltall-identifikator for navnet eller den angitte ressurstypen. Ellers er disse parameterne lang pekere til null-terminert strenger. Hvis det første tegnet i strengen er et nummertegn (#), representerer gjenværende tegnene et desimaltall som angir identifikatoren heltall til ressursens navnet eller typen. Strengen "# 258" representerer for eksempel heltall identifikatoren 258.

Et program bør redusere mengden minne som kreves for ressurser ved å referere til dem av heltall identifikator i stedet for etter navn.

Når du er ferdig med å bruke en accelerator tabell, punktgrafikk, markøren, ikon eller menyen, kan du frigi tilknyttede minnet av en av funksjonene i følgende tabell.

Ressurs Release-funksjonen
Accelerator tabell DestroyAcceleratorTable
Punktgrafikk SlettObjekt
Markøren DestroyCursor
Ikonet DestroyIcon
Menyen DestroyMenu

Systemet sletter automatisk disse ressursene når du avslutter prosessen som opprettet dem, men kaller den relevante funksjonen sparer du minne, og reduserer størrelsen på prosessens arbeidssett.

Et program kan bruke FindResource til å finne alle typer ressurs, men denne funksjonen bør bare brukes hvis programmet må få tilgang til binære ressursdata når du foretar påfølgende samtaler til LoadLibrary - og LockResource.

For å bruke en ressurs umiddelbart, bør et program bruke en av følgende ressurs-spesifikke funksjoner vil finne og laste ressurser i ett anrop:

Funksjonen Handling
FormatMessage Laster inn og formaterer en oppføring i melding-tabellen.
LoadAccelerators Laster en Web Slice-tabellen.
LoadBitmap Laster en punktgrafikk-ressurs.
LoadCursor Laster en markør-ressurs.
LoadIcon Laster en ikon-ressurs.
LoadMenu Laster en menyen-ressurs.
Finner Laster inn en oppføring i streng-tabellen.

Et program kan for eksempel bruke funksjonen LoadIcon for å laste et ikon for visning på skjermen. Men bør programmet bruke FindResource og LoadResource Hvis det er lasting ikonet for å kopiere data til et annet program.

Strengressurser for lagres i inndelinger med opptil 16 strenger per inndeling. Strengene i hver inndeling lagres som en sekvens av opptalte (ikke null-terminert) Unicode-strenger. Den finner funksjonen vil trekke ut strengen ressursen fra den tilsvarende delen.

Windows CE: HModule -parameteren kan ikke være en NULL-referanse.

Støtter ikke lpName parameteren ressurs-IDEN null – det vil si FindResource (h, 0, t) vil ikke fungere som forventet.

Du kan ikke sende RT_ANICURSOR eller RT_ANIICON verdiene i parameteren lpType .

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winbase.h.
Importere biblioteket:Bruk kernel32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner i Windows og Windows NT.

Se også

Oversikt over ressurser, ressurs fungerer, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, finner, LockResource, SizeofResource

Index