Funkcia FindResource určuje umiestnenie zdroja s zadaný typ a názov zadaný modul.
(HRSRC FindResource HMODULE hModule; / / Popisovač moduluLPCTSTRlpName; / / ukazovateľ na názov prostriedkuLPCTSTRlpType / / type smerník zdroja);
Hodnota NULL určuje modul popisovač priradený súbor s obrázkom, ktorý operačný systém používa na vytvorenie súčasného procesu.
| Hodnota | Význam |
|---|---|
| RT_ACCELERATOR | Akcelerátor tabuľky |
| RT_ANICURSOR | Animovaný kurzor |
| RT_ANIICON | Animovaná ikona |
| RT_BITMAP | Bitová mapa zdrojov |
| RT_CURSOR | Závislé od hardvéru kurzor zdrojov |
| RT_DIALOG | Dialógové okno |
| RT_FONT | Zdroj písmo |
| RT_FONTDIR | Písmo adresárovej prostriedkov |
| RT_GROUP_CURSOR | Kurzor hardvérom nezávislým zdrojom |
| RT_GROUP_ICON | Ikonu hardvérom nezávislým zdrojom |
| RT_HTML | Dokument vo formáte HTML |
| RT_ICON | Závislé od hardvéru ikonu zdrojov |
| RT_MENU | Ponuka zdrojov |
| RT_MESSAGETABLE | Správa položka |
| RT_RCDATA | Definovanom aplikáciou zdrojov (prvotné údaje) |
| RT_STRING | Reťazec tabuľky Položka |
| RT_VERSION | Verzia zdrojov |
Ak funkciu podarí, vrátená hodnota je rukoväť na zadanom prostriedku informácie bloku. Na získanie popisovača prostriedku prejsť popisovač LoadResource funkcia.
Ak funkcia zlyhá, vrátená hodnota je NULL. Získajte rozšírené informácie o chybách, volajte na číslo GetLastError.
Ak Rozdeli slovo parameter lpName alebo lpType je nula, nízka-order slovo Určuje celočíselnú identifikátor názov alebo typ daného zdroja. V opačnom prípade tieto parametre sú dlhé ukazovateľmi zakončený reťazce. Ak prvého znaku reťazca je znakom krížika (#), zostávajúce znaky predstavujú desiatkové číslo, ktoré určuje celočíselnú identifikátor názov alebo typ zdroja. Napríklad reťazec "# 258" predstavuje celé identifikátor 258.
Žiadosť by mala znížiť veľkosť pamäte požadovanú pre zdroje s odvolaním sa na nich ktorú celočíselné identifikátor namiesto podľa názvu.
Keď skončíte použitím akcelerátora tabuľky, bitová mapa, kurzor, ikony alebo ponuky môžete uvoľniť jej pridružené pamäte pomocou volania z funkcie v nasledujúcej tabuľke.
| Zdroj | Uvoľnenie funkcie |
|---|---|
| Akcelerátor tabuľky | DestroyAcceleratorTable |
| Bitová mapa | OdstrániťObjekt |
| Kurzor | DestroyCursor |
| Ikona | DestroyIcon |
| Ponuka | DestroyMenu |
Systém automaticky odstráni tieto zdroje, keď ukončí proces, ktorý ich vytvoril, však volá funkciu vhodné šetrí pamäť a zmenšuje veľkosť pracovnej súpravy procesu.
Jedna aplikácia môže použiť FindResource nájsť akýkoľvek typ zdroja, ale táto funkcia by použiť iba vtedy, ak žiadosť musí pristupovať binárnou zdroj údajov pri následných volaní na funkcia LoadLibrary a LockResource.
Používať prostriedok okamžite žiadosť mali používať jednu z nasledujúcich zdrojov špecifické funkcie chcete vyhľadať a načítať zdrojov v jedno volanie:
| Funkcia | Akcia |
|---|---|
| FormatMessage | Načíta a formáty správ položka. |
| LoadAccelerators | Načíta tabuľku akcelerátora. |
| LoadBitmap | Načíta prostriedok bitovej mapy. |
| LoadCursor | Načíta prostriedok kurzor. |
| LoadIcon | Načíta prostriedok ikonu. |
| LoadMenu | Načíta prostriedok ponuky. |
| LoadString | Načíta reťazcom položka. |
Napríklad, žiadosť použiť funkciu LoadIcon načítať ikonu pre zobrazenie na obrazovke. Avšak uplatňovanie mali použiť FindResource a LoadResource , ak je to načítania ikonu chcete kopírovať údaje do inej aplikácie.
Reťazec zdroje sú uložené v oddieloch až 16 strun sekciách. Reťazce v každej sekcii sú uložené ako určitý sled napočítaných (nie zakončený) Unicode reťazce. LoadString funkcia bude extrahovať prostriedok reťazca od jeho prislúchať určitá sekcia.
Windows CE: HModule parameter nemožno rukoväť NULL.
LpName parameter nepodporuje prostriedok identifikácie nula – t. j. FindResource (h 0, t) nebude pracovať podľa očakávania.
Nemôže prejsť RT_ANICURSOR alebo RT_ANIICON hodnoty v parametri lpType .
nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v winbase.h.
Importovať knižnica:Použiť kernel32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia pre Windows a Windows NT.
Zdroje prehľad, Resource funkcie, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource