Hide Comments
Hide Comments

Comments (0)

Provides design-time (and run-time) access to an SVG document. Specify the Filename of the SVG to load or use the Lines property to "bundle" your SVG into the application

Namespace: FMX.RS.SVGCtrls

expandingInheritance Hierarchy

TComponent
  FMX.RS.SVGCtrls.TRSFmxSVGDocument
 
expandingSyntax

Delphi

type 
  TRSFmxSVGDocument = class(TComponent) 
  end; 
 
expandingConstructors

 

Name

Description

public constructor

Create(TComponent)

Initializes a new instance of the TRSFmxSVGDocument class.

public destructor

Destroy

Represents the destructor of the TRSFmxSVGDocument class.

Top
expandingProperties

 

Name

Description

published property

DefaultAspectRatio

Defines the default aspect ratio for the SVG. If the SVG does not specify a preserveAspectRatio attribute, the SVG will use this default instead.

published property

DPI

Dots per inch used in calculating the unit factors for conversion of string lengths into actual values. The DPI should be set before loading a SVG.

For example, if the input string contains '1cm', the DPI helps the SVG library figure out how large a centimeter is.

published property

EmbedSVGAsBinary

Controls whether the SVG document is embedded into the form as Delphi binary

alert_noteTip

Set EmbedSVGAsBinary to true to embed the SVG into the form as binary. Embedding SVGs as binary allows in general faster form initialization as opposed to using the FMX.RS.SVGCtrls.TRSFmxSVGDocument.Lines property or loading the SVG from a file. It is also a very useful way to deploy an SVG for mobile applications.

published property

Filename

Defines the filename of the SVG document to load at design-time and run-time.

alert_noteTip

Use the FMX.RS.SVGCtrls.TRSFmxSVGDocument.EmbedSVGAsBinary property to embed the SVG into the form as binary data.

Use the FMX.RS.SVGCtrls.TRSFmxSVGDocument.Lines property to load and embed an SVG as XML text.

published property

Lines

Defines the XML text of a SVG to load.

alert_noteTip

Use the FMX.RS.SVGCtrls.TRSFmxSVGDocument.EmbedSVGAsBinary property to embed the SVG into the form as binary data.

Use the FMX.RS.SVGCtrls.TRSFmxSVGDocument.Lines property to load and embed an SVG as XML text.

published property

OnChange

Occurs when the SVG has changed and after viewers are notified

published property

OnChanging

Occurs when the SVG has changed and before viewers are notified

published property

Options

Defines options for reading, displaying, and writing the document

published property

PreferredLanguage

Specifies the preferred language to use for the SVG. The TSVGSwitch element uses the language and the SystemLanguage property of TSVGElements to choose the SVG element to display (conceptually, this is localization of text or even graphics for an SVG)

public property

SVG

Provides access to the loaded SVG document

public property

Viewers

Lists the SVG Viewers that are interested in this SVG document. When the SVG document is changed, all viewers in the list are notified so that they can update their display.

Top
expandingMethods

 

Name

Description

protected method

Change

Call this method when the SVG changes. This method triggers an FMX.RS.SVGCtrls.TRSFmxSVGDocument.OnChange event and notifies all FMX.RS.SVGCtrls.TRSFmxSVGDocument.Viewers that the SVG has changed.

protected method

CreateSVGDocument

Creates the TSVGDocument for the component

protected method

DefineProperties(TFiler)

Represents method DefineProperties(TFiler).

protected method

LinesChange(TObject)

Called when the Lines property changes

public method

LoadSVGFromStrings(TStrings)

Loads the SVG from the TStrings parameter

protected method

Notification(TComponent,TOperation)

Represents method Notification(TComponent,TOperation).

protected method

ReadSVG(TReader)

Reads the FMX.RS.SVGCtrls.TRSFmxSVGDocument.SVG property as a binary property from the component stream.

noteNote

The DefineProperties overridden method defines the binary SVGX property if FMX.RS.SVGCtrls.TRSFmxSVGDocument.EmbedSVGAsBinary is true.

protected method

SVGChange(TObject)

Called when FMX.RS.SVGCtrls.TRSFmxSVGDocument.SVG changes

protected method

ViewerNotify(TObject,ISVGViewer,TCollectionNotification)

Called when a ISVGViewer is added or removed from the   Viewers property

protected method

WriteSVG(TWriter)

Writes the FMX.RS.SVGCtrls.TRSFmxSVGDocument.SVG property as a binary property to the component stream.

noteNote

The DefineProperties overridden method defines the binary SVGX property if FMX.RS.SVGCtrls.TRSFmxSVGDocument.EmbedSVGAsBinary is true.

Top
expandingEvents

 

Name

Description

published event

OnAddStyle

Occurs when a style is added to the document

published event

OnDisableAppearance

Occurs just before a disabled element is about to be drawn to the canvas. Use this event to modify the Canvas, Matrix, or aRect to provide a special appearance for disabled elements.

Set the DoDefault parameter to false to prevent the default disabled appearance (making the element grayscale) from being performed

published event

OnDrawing

Occurs just before drawing the current element and its children. The event fires after the canvas brush, pen, font, clipping, etc are set up but before the actual drawing.

published event

OnDrawn

Occurs just after a SVG element is drawn. The event fires after drawing the current element and its children but before the canvas is returned to its initial state.

published event

OnElementFound

Occurs when an SVG element is found at the specified position during aa ElementAtPos method call. Set Element to nil to have the ElementAtPos method ignore this element and keep searching

published event

OnParsedNode

Occurs just after a SVG element's children are parsed by the RSCL. This event occurs when a SVG element and all of its children are loaded and parsed

published event

OnParsingNode

Occurs just before a SVG element's children are parsed by the RSCL. This event occurs when a SVG element has been parsed for its own attributes but before any of its children are loaded and parsed

published event

OnRemoveStyle

Occurs when a style is extracted or removed from the document

published event

OnSavedElement

Occurs just after a SVG element and its children are saved to an IXMLNode.

published event

OnSavingElement

Occurs just before an SVG element and its children are saved to an IXMLNode. Set DoSave to False to prevent the SVG element from being saved

Top
expandingRemarks

alert_noteTip

One SVG document component can serve as the data provider for multiple TRSSVGImage controls. For example, if the SVG document contained an entire deck of cards, you could set up multiple TRSSVGImage controls for each card using the SVGRoot property
 

 
MultipleImageFromDocFMX

alert_noteTip

Use the TRS[FMX]SVGDocument.Lines property to "bundle" your SVG document into the application

expandingExamples

To load and draw a SVG at run-time, create the SVG document and the SVG Image:

Delphi

 
 SVGDoc := TRSFmxSVGDocument.Create(Self);
 SVGDoc.Filename := 'c:\MySVG.svg';
 SVGImage := TRSSVGImage.Create(Self);
 SVGImage.Parent := Self;
 SVGImage.SVGDocument := SVGDoc;

At design-time, you would:

• Drop an SVG document component on your form ( RSSVGCtrls|TRSSVGDocument for VCL, TRSFMXSVGDocument for FMX) SelectComponentVcl

• Set the TRS[FMX]SVGDocument.Filename property to the SVG file. Alternatively, you can directly paste the SVG into the Lines property (warning: Delphi's TStrings editor will truncate long lines causing problems with some SVG text)

• Drop a TRSSVGImage component on the form

• Connect the TRSSVGImage.SVGDocument to the RSSVGDocument1 (VCL) or RSFMXSVGDocument1 (FMX) SelectSVGDocVcl

• Optionally, if you only want to display one branch of the SVG document, you can set the TRSSVGImage.SVGRoot property to the SVG element you want to display. If the SVGRoot is not empty and it does not equal any SVG element in the document, nothing is displayed.

expandingSee Also

Reference

•FMX.RS.SVGCtrls

Comments (0)

RiverSoftAVG SVG Component Library (RSCL) © 2013-2016, Thomas G. Grubb