Sign in Join
FPDoc Onlineexperiment

TResources.LoadFromFile procedure

Member of TResourcespublicIn unit resource

Loads the contents of the object from a file

Declaration

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

Arguments

aFileName

The name of file to read from

aReader

The reader to use to read the file

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.

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

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