FindResource

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);
 

Parametre

hModule
Zvládnuť modulu ktorých spustiteľný súbor obsahuje prostriedok.

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.

lpName
Určuje názov zdroja. Ďalšie informácie nájdete v časti poznámky.
lpType
Určuje typ prostriedku. Ďalšie informácie nájdete v časti poznámky. Pre štandardnej zdrojov druhy, tento parameter môže byť jedna z nasledovných hodnôt:
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

Note:

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.

Poznámky

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 .

Stručné informácie

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.

Pozri tiež

Zdroje prehľad, Resource funkcie, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource

Index