FindResource

FindResource işlevi belirtilen modül adı ve belirtilen türü kaynak konumu belirler.

hrsrc FindResource) hmodule  hModule, / / modül elelpctstrlpName, / / işaretçi kaynak adılpctstrlpType / / kaynak için işaretçi türü);
 

Parametreleri

hModule
Kolu olan yürütülebilir dosya kaynağı içeren modülü.

Null değeri geçerli işlem oluşturmak için işletim sistemi kullanılan görüntü dosyasıyla ilişkilendirilen modülü tanıtıcıyı belirtir.

lpName
Kaynağın adını belirtir. Daha fazla bilgi için açıklamalar bölümüne bakın.
lpType
Kaynak türünü belirtir. Daha fazla bilgi için açıklamalar bölümüne bakın. Standart kaynak türleri için bu parametre aşağıdaki değerlerden biri olabilir:
Değer Anlamı
RT_ACCELERATOR Hızlandırıcı tablosu
RT_ANICURSOR Animasyonlu işaretçi
RT_ANIICON Animasyonlu simge
RT_BITMAP Bit eşlem kaynak
RT_CURSOR Donanım bağımlı imleç kaynak
RT_DIALOG İletişim kutusu
RT_FONT Yazı tipi kaynağı
RT_FONTDIR Yazı tipi dizini kaynak
RT_GROUP_CURSOR Donanımdan bağımsız imleç kaynak
RT_GROUP_ICON Donanımdan bağımsız simge kaynak
RT_HTML Html belgesi
RT_ICON Donanım bağımlı simge kaynak
RT_MENU Menü kaynak
RT_MESSAGETABLE İleti-Tablo girişi
RT_RCDATA Uygulama tanımlı kaynak (ham veri)
RT_STRING Dize tablosu girdisi
RT_VERSION Sürüm kaynak

Dönüş değerleri

İşlev başarılı olursa, dönüş değeri belirtilen kaynağın bilgi engellemek için bir tanıtıcı iş. Kaynak için bir tanıtıcı elde etmek için bu kolu LoadResource işlevine geçmektedir.

İşlev başarısız olursa, dönüş değeri null olur. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

LpName veya lpType parametresinin yüksek sıralı word sıfır ise, alt sıra word adı veya belirli bir kaynak türü tamsayı tanımlayıcısı belirtir. Aksi takdirde, bu parametrelerin uzun dizeleri boşlukla sonlandırılmış işaretçilerdir. İlk karakter dizesi sayı işareti (#) ise, kalan karakterleri kaynağın adı veya türü tamsayı tanımlayıcısı belirten bir ondalık sayı temsil eder. Örneğin "# 258" dizesinin tamsayı tanımlayıcısı 258 gösterir.

Uygulama kaynaklarını onlara göre tamsayı tanımlayıcısı yerine adıyla başvurarak gerekli bellek miktarını azaltmak gerekir.

Bir Hızlandırıcı tablo, bit eşlem, imleç, simge veya menü kullanmayı bitirdiğinizde, aşağıdaki tabloda işlevlerinden birini çağırarak ilişkili belleği serbest bırakabilirsiniz.

Kaynak İşlev sürümü
Hızlandırıcı tablosu DestroyAcceleratorTable
Bit eşlem NesneSil
İmleç DestroyCursor
Simge DestroyIcon
Menü DestroyMenu

Onları oluşturan işlemi sonlandırır sistem otomatik olarak bu kaynakları siler, ancak uygun işlevini çağırarak belleğine kaydeder ve işlemin çalışma kümesi boyutunu azaltır.

Uygulama FindResource her tür kaynak bulmak için kullanabilirsiniz, ancak yalnızca uygulama ikili kaynak veri için sonraki aramalar yaparken erişmesi gerekiyorsa bu işlevin kullanılması gereken LoadLibrary ve LockResource.

Kaynak kullanmak için hemen bir uygulama aşağıdaki kaynağa özgü işlevleri bulmak ve bir arama kaynakları yüklemek için kullanmanız gerekir:

İşlevi Eylem
FormatMessage Yükler ve ileti tabloda biçimleri.
LoadAccelerators Bir Hızlandırıcı tablosuna yükler.
LoadBitmap Bir bitmap kaynak yükler.
LoadCursor Bir imleç kaynak yükler.
LoadIcon Bir simge kayna?ynyn yükler.
LoadMenu Bir menü kaynak yükler.
LoadString Bir dize tablosu girdisi yükler.

Örneğin, bir uygulama ekranında görüntülemek için simge yüklemek için LoadIcon işlevini kullanabilirsiniz. Verileri başka bir uygulamaya kopyalamak için simgeyi yükleniyor, ancak uygulama FindResource ve LoadResource kullanmalısınız.

Dize kaynakları bölümleri bölüm başına 16 dizeleri saklanır. Dizelerin her bölümde sayılan (değil biten) Unicode dizeleri dizisi depolanır. LoadString fonksiyonu ile ilgili bölümünden dize kaynağı özü.

Windows ce: HModule parametresi null tanıtıcı olamaz.

LpName parametresi kaynak kimliği sıfır desteklemiyor — başka bir deyişle, FindResource (h, 0, t) çalışmaz beklendiği gibi.

Sen cant'geçmek belgili RT_ANICURSOR veya RT_ANIICON değerleri lpType parametresinde.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:Winbase.h ilan etti.
İçe Library:Kernel32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows ve Windows NT olarak uygulanır.

Ayrıca bkz:

Kaynaklarına genel bakış, kaynak fonksiyonları, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource

Index