Funcția FindResource determină locația o resursă cu tipul specificat și numele modulului specifică.
(HRSRC FindResource HMODULE hModule, / / modulul mânerLPCTSTRlpName, / / indicatorul la numele resurseiLPCTSTRlpType / / indicatorul de resurse de tip);
O valoare NULL specifică ghidajul de modulul asociat cu fișierul de imagine pe care sistemul de operare utilizat pentru a crea procesul curent.
Valoarea | Sensul |
---|---|
RT_ACCELERATOR | Accelerator tabel |
RT_ANICURSOR | Cursorul animate |
RT_ANIICON | Pictogramă animată |
RT_BITMAP | Resurse bitmap |
RT_CURSOR | Cursorul hardware-dependente de resurse |
RT_DIALOG | Caseta de dialog |
RT_FONT | Font resurse |
RT_FONTDIR | Font director de resurse |
RT_GROUP_CURSOR | Resurse cursorul hardware-independent |
RT_GROUP_ICON | Resurse independente de articole de fier icon |
RT_HTML | HTML document |
RT_ICON | Resurse dependente de articole de fier icon |
RT_MENU | Meniul resurse |
RT_MESSAGETABLE | Intrare mesaj-tabel |
RT_RCDATA | Definite de aplicare resurse (datele primare) |
RT_STRING | String-tabelul Intrare |
RT_VERSION | Versiunea resurse |
Dacă funcția reușește, valoarea returnată este un handle-ul specificat al resursei info bloc. Pentru a obține un mâner resursei, trece acest mâner pentru funcția de LoadResource.
Dacă funcția nu reușește, valoarea returnată este NULL. Pentru a obține extins informa?ii eroare, apel GetLastError.
În cazul în care cuvântul high-ordinea de parametrul lpName sau lpType este zero, cuvântul-low-comandă identificatorul întreg numele sau tipul de resurse dat. În caz contrar, parametrii sunt indicatori lung null-terminated siruri de caractere. Dacă primul caracter al șirului este un diez (#), caractere rămase reprezintă un număr zecimal care specifică identificatorul întreg numele sau tipul resursei. De exemplu, sirul de caractere "# 258" reprezintă identificatorul întreg 258.
O cerere ar reduce cantitatea de memorie necesară pentru resursele de la le de identificator întreg în loc de numele.
Când ați terminat folosind un accelerator tabel, bitmap, cursorul, pictograma sau meniu, aveți posibilitatea să lansați memorie asociate de una din funcțiile de asteptare în tabelul următor.
Resurse | Funcția de presă |
---|---|
Accelerator tabel | DestroyAcceleratorTable |
Bitmap | ȘtergereObiect |
Cursorul | DestroyCursor |
Pictogramă | DestroyIcon |
Meniul | DestroyMenu |
Sistemul șterge automat aceste resurse atunci când se termină procesul care le-a creat, cu toate acestea, apel funcția corespunzătoare economisește memorie și Micșorează dimensiunea lui procesul set de lucru.
Cererea poate utiliza FindResource pentru a găsi orice tip de resurse, dar această funcție ar trebui să fie utilizate numai în cazul în care cererea trebuie să acceseze date binare resurse atunci când se face apeluri ulterioare la LoadLibrary și LockResource.
Pentru a utiliza o resursă imediat, cererea ar trebui să utilizați una din următoarele func?ii specifice de resurse pentru a găsi și a încărca resursele din un apel:
Funcția | Acțiune |
---|---|
FormatMessage | Încarcă și formatează o intrare în tabelul de mesaj. |
LoadAccelerators | Încarcă un tabel accelerator. |
LoadBitmap | Încarcă o resursă bitmap. |
LoadCursor | Încarcă o resursă cursorul. |
LoadIcon | Încarcă o resursă icon. |
LoadMenu | Încarcă o resursă de meniu. |
LoadString | Încarcă o intrare în tabelul șir. |
De exemplu, o cerere poate funcția LoadIcon pentru a încărca o pictogramă pentru afișare pe ecran. Cu toate acestea, aplicarea ar trebui să utilizați FindResource și LoadResource în cazul în care acesta este de încărcare pictograma pentru a copia datele sale de o altă aplicație.
Șir de resurse sunt stocate în secțiunile de siruri de caractere până la 16 pe secțiune. Siruri de caractere în fiecare sec?iune sunt stocate ca o secvență de numărate șiruri Unicod (nu null-terminated). LoadString funcția va extrage resursă șir din partea corespunzătoare.
Windows CE: Parametrul hModule nu poate fi un handle NULL.
Parametrul lpName nu acceptă Identificatorul de resursă zero adică, FindResource (h, 0, t) nu va funcționa cum era de așteptat.
Tu nu poate trece valorile RT_ANICURSOR sau RT_ANIICON în parametrul lpType .
nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winbase.h.
Import Biblioteca:Utilizarea kernel32.lib.
Unicode:Pus în aplicare ca versiunile Unicode și ANSI pe Windows și Windows NT.
Ansamblu de resurse, resurse funcții, FindResourceEx, FormatMessage, LoadAccelerators, , LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource