FindResourceEx

Funkcia FindResourceEx určuje umiestnenie zdroja s zadaný typ, meno a jazyk v module špecifikované.

(HRSRC FindResourceEx HMODULE  hModule; / / Popisovač modulu zdrojovLPCTSTRlpType; / / type smerník zdrojaLPCTSTRlpName; / / ukazovateľ na názov prostriedkuProgram WORDwLanguage / / zdrojov jazyk ) 

Parametre

hModule
Popisovač modulu ktorých spustiteľný súbor obsahuje prostriedok. Ak má tento parameter hodnotu NULL, funkcia vyhľadá modul používa na vytvorenie súčasného procesu.
lpType
Smerník na reťazec zakončený nulou určujúci názov typu 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

lpName
Smerník na reťazec zakončený nulou určujúci názov pracovného prostriedku. Ďalšie informácie nájdete v časti poznámky.
wLanguage
Určuje jazyk zdroja. Ak tento parameter nie je MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL), sa použije aktuálny jazyk priradený vláknu volajúceho.

Ak chcete určiť iný jazyk ako aktuálny jazyk, použite MAKELANGID makro vytvoriť tento parameter. Ďalšie informácie nájdete v téme MAKELANGID.

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 vysoko slovo parameter lpType alebo lpName je nula, nízke slovo Určuje celočíselnú identifikátor typu alebo názov daného zdroja. V opačnom prípade tieto parametre sú 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.

Aplikácie by mali 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ť FindResourceEx 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 funkcie.

Ak chcete použiť prostriedok okamžite, žiadosť by použite nasledujúce funkcie špecifické pre zdroj 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ť FindResourceEx 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.

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:Nepodporované.
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, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadString, LoadResource, MAKELANGID

Index