Sign in Join
FPDoc Onlineexperiment

FindResourceEx function

In unit System

Find a resource based on type, name, language.

Declaration

pascal
function FindResourceEx(ModuleHandle: TFPResourceHMODULE; 
 ResourceType: PAnsiChar; 
 ResourceName: PAnsiChar; Language: Word)
: TFPResourceHandle

Description

FindResourceEx looks in module ModuleHandle for a resource of type ResourceType and name ResourceName with language ID Language. Both Resourcename and ResourceName can be specified as a null-terminated array of characters, or as an AnsiString.

If the requested language/sublanguage is not found, then the search is conducted

  1. with only primary language.
  2. with the neutral language (LANG_NEUTRAL)
  3. with the English language

If none of these has returned a match, then the first available language is returned.

If a match is found, a handle to the resource is returned. If none is found, an empty handle (nil or 0) is returned.

Errors

None.

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.