[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'System' (#rtl)

FindResourceEx

Find a resource based on type, name, language

Declaration

Source position: line 0

function FindResourceEx(

  ModuleHandle: TFPResourceHMODULE;

  ResourceType: PChar;

  ResourceName: PChar;

  Language: Word

):TFPResourceHandle;

function FindResourceEx(

  ModuleHandle: TFPResourceHMODULE;

  ResourceType: AnsiString;

  ResourceName: AnsiString;

  Language: Word

):TFPResourceHandle;

Description

FindResourceEx looks in module ModuleHandle for a resource of type ResourceType and name ResourceName with languague 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.

The latest version of this document can be found at lazarus-ccr.sourceforge.net.