Skip to content

    FindResourceEx

    Find a resource based on type, name, language.

    Declaration

    Source position: resh.inc line 67

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

    function FindResourceEx(ModuleHandle: TFPResourceHMODULE; 
                       const ResourceType: AnsiString; 
                       const ResourceName: AnsiString; Language: Word)
                        : TFPResourceHandle;

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

    function FindResourceEx(ModuleHandle: TFPResourceHMODULE; 
                       const ResourceType: AnsiString; 
                       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.