Skip to content

TResources.LoadFromFile

Loads the contents of the object from a file

Declaration

Source position: resource.pp line 277

public 
procedure LoadFromFile(aFileName: string);  overload; overload;

procedure LoadFromFile(aFileName: string; 
                      aReader: TAbstractResourceReader);  overload; overload;

Description

This method clears the TResources object and loads its contents from the file passed as parameter.

If a reader is specified, that reader is used. Otherwise, the file is probed to find a suitable reader.

Remark:

If CacheData is set to true, the file will be left open and used as the underlying stream of each resource RawData stream. This means that the file will be open until the TResources object is cleared or is loaded again from a different source. If you want the file to be closed while there are still resources, disable the copy-on-write mechanism by setting CacheData property to false.

Sample code

This code extracts resources from an exe file

var
  resources : TResources;
begin
  resources:=TResources.Create;
  resources.LoadFromFile('myexe.exe');
  resources.WriteToFile('myexe.res');
  resources.Free;
end;

Errors

If no reader is passed and probing fails, an EResourceReaderNotFoundException exception is raised.

See also

Name Description
TAbstractResourceReader Base abstract resource reader class
TAbstractResource.RawData The raw resource data stream
TAbstractResource.CacheData Controls the copy-on-write behaviour of the resource
TResources.CacheData Controls the copy-on-write behaviour of all resources
TResources.LoadFromStream Loads the contents of the object from a stream
TResources.Clear Deletes all resources
TResources.FindReader Searches for a suitable resource reader