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);
En verdi på NULL angir modulreferanse knyttet til bildefilen som operativsystemet, brukes til å opprette den gjeldende prosessen.
| 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 |
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.
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 .
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.
Oversikt over ressurser, ressurs fungerer, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, finner, LockResource, SizeofResource