[Overview][Resource strings][Constants][Types][Classes][Index] Reference for unit 'resource' (#fcl-res)

TAbstractResource.RawData

The raw resource data stream

Declaration

Source position: resource.pp line 175

public property TAbstractResource.RawData : TStream
  read GetRawData;

Description

This property provides access to the resource raw data in a stream-like way.

When a resource has been read from a stream, RawData redirects read operations to the original stream. When RawData is written to, a copy-on-write mechanism copies data from the original stream to a memory stream.

The copy-on-write behaviour can be controlled via CacheData property.

Note that for some predefined resource types there are better ways to read and write resource data: some resource types use specific formats, so RawData might not always be what one expected. E.g. in a resource of type RT_BITMAP, RawData doesn't contain a valid BMP file: in this case it's better to use BitmapData stream of TBitmapResource class to work with a BMP-like stream.

Remark: When writing to a "specialized" stream in a descendant class (like the TBitmapResource.BitmapData stream mentioned earlier), RawData contents might not be valid anymore. If you need to access RawData again, be sure to call UpdateRawData method first.

Usually there isn't much penalty in using specialized streams in descendant classes, since data isn't duplicated in two or more streams, whenever possible. So, having a very large bitmap resource and reading/writing it via TBitmapResource.BitmapData doesn't mean the bitmap is allocated two times.

See also

TAbstractResource.CacheData

  

Controls the copy-on-write behaviour of the resource

TAbstractResource.UpdateRawData

  

Updates RawData stream.

TAbstractResource.SetCustomRawDataStream

  

Sets a custom stream as the underlying stream for RawData


Documentation generated on: Nov 14 2015