Hide Comments
Hide Comments

Comments (0)

Represents type TRSLocalChartAxis.

Namespace: FMX.RS.ChartPanel

expandingInheritance Hierarchy

TInterfacedPersistent
  FMX.RS.ChartPanel.TRSChartGraphic
    FMX.RS.ChartPanel.TRSChartGraphicArea
      FMX.RS.ChartPanel.TRSChartAxis
        FMX.RS.ChartPanel.TRSLocalChartAxis
 

expandingSyntax

Delphi

type
  TRSLocalChartAxis = class(TRSChartAxis)
  end;
 

expandingConstructors

 

Name

Description

public constructor

Create(TRSCustomChart)

Initializes a new instance of the TRSLocalChartAxis class.

public constructor

Create(TRSCustomChartPanel)

Overloaded. Initializes a new instance of the TRSChartAxis class. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

Top

expandingProperties

 

Name

Description


published property

Brush

Represents property Brush. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)


public property

Chart

Represents property Chart.


public property

Charts

Tracks the list of FMX.RS.ChartPanel.TRSCustomChart components that are using this axis, either as their HorizontalAxis or VerticalAxis. Use the Charts property to iterate over all the charts for the axis.
 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)


published property

DateTimeFormat

Specifies the format of the chart values when the axis represents date time values. If the axis does not represent date time values, the Format property specifies the format of the chart values. The two format properties are used by the     FormatValue method to return the proper string representation of a chart value. Use the     IsDateTime method to determine if the axis is displaying date time values.

The DateTimeFormat string is like other Delphi Date-Time Format Strings that specify the formatting of date-time values (such as TDateTime) when they are converted to strings.

Date Time Format Strings are composed from specifiers that represent values to be inserted into the formatted string. Some specifiers (such as "d"), simply format numbers or strings. Other specifiers (such as "/") refer to locale-specific strings from global variables.

In the following table, specifiers are given in lower case. Case is ignored in formats, except for the "am/pm" and "a/p" specifiers.


c

Displays the date using the format given by the ShortDateFormat global variable, followed by the time using the format given by the LongTimeFormat global variable. The time is not displayed if the date-time value indicates midnight precisely.
 



d

Displays the day as a number without a leading zero (1-31).
 



dd

Displays the day as a number with a leading zero (01-31).
 



ddd

Displays the day as an abbreviation (Sun-Sat) using the strings given by the ShortDayNames global variable.
 



dddd

Displays the day as a full name (Sunday-Saturday) using the strings given by the LongDayNames global variable.
 



ddddd

Displays the date using the format given by the ShortDateFormat global variable



dddddd

Displays the date using the format given by the LongDateFormat global variable.
 



e

(Windows only) Displays the year in the current period/era as a number without a leading zero (Japanese, Korean and Taiwanese locales only).



ee

(Windows only) Displays the year in the current period/era as a number with a leading zero (Japanese, Korean and Taiwanese locales only).



g

(Windows only) Displays the period/era as an abbreviation (Japanese and Taiwanese locales only).



gg

(Windows only) Displays the period/era as a full name. (Japanese and Taiwanese locales only).



m

Displays the month as a number without a leading zero (1-12). If the m specifier immediately follows an h or hh specifier, the minute rather than the month is displayed



mm

Displays the month as a number with a leading zero (01-12). If the mm specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.
 



mmm

Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames global variable



mmmm

Displays the month as a full name (January-December) using the strings given by the LongMonthNames global variable



yy

Displays the year as a two-digit number (00-99).



yyyy

Displays the year as a four-digit number (0000-9999).



h

Displays the hour without a leading zero (0-23).
 



hh

Displays the hour with a leading zero (00-23).
 



n

Displays the minute without a leading zero (0-59).



nn

Displays the minute with a leading zero (00-59).
 



s

Displays the second without a leading zero (0-59).



ss

Displays the second with a leading zero (00-59).
 



z

Displays the millisecond without a leading zero (0-999).
 



zzz

Displays the millisecond with a leading zero (000-999).
 



t

Displays the time using the format given by the ShortTimeFormat global variable



tt

Displays the time using the format given by the LongTimeFormat global variable.



am/pm

Uses the 12-hour clock for the preceding h or hh specifier, and displays 'am' for any hour before noon, and 'pm' for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly



a/p

Uses the 12-hour clock for the preceding h or hh specifier, and displays 'a' for any hour before noon, and 'p' for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly



ampm

Uses the 12-hour clock for the preceding h or hh specifier, and displays the contents of the TimeAMString global variable for any hour before noon, and the contents of the TimePMString global variable for any hour after noon



/

Displays the date separator character given by the DateSeparator global variable



:

Displays the time separator character given by the TimeSeparator global variable



'xx'/"xx"

Characters enclosed in single or double quotes are displayed as-is, and do not affect formatting







 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)



protected property

Dimension

Represents property Dimension. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

EndPosition

The     StartPosition and     EndPosition properties specify the end points of the axis, in percentage of the normal axis length. The StartPosition is usually 0%, meaning that, for the BottomAxis for example, the left end of the axis is all the way to the left, aligned against the LeftAxis. The EndPosition is usually 100%, meaning that the BottomAxis' right end is all the way to the right, aligned against with the RightAxis.

Specify a value greater than 0 for the StartPosition or less than 100 for the EndPosition to move the end points in and shorten the length of the axis.
 

published property

Format

Sspecifies the format of the chart values when the axis represents floating point values. If the axis represents date time values, the   DateTimeFormat property specifies the format of the chart values. The two format properties are used by the FormatValue method to return the proper string representation of a chart value. Use the IsDateTime method to determine if the axis is displaying date time values. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

Grid

Defines the properties of the axis grid: tick marks, major and minor grid marks, and drawing pens. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public property

Height

Returns the height (in pixels) of the chart axis. The   Height and Width of the axis is calculated by the   CalculateBounds method (or every time the axis draws).
 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

InwardPosition

Controls where the chart axis paints within the chart grid. InwardPosition specifies the distance as a percentage from the edge where the axis would normally paint (left, top, right, bottom) towards the middle of the chart drawing area.

If InwardPosition is greater than 0, the chart axis is moved in toward the center, 50% would be the center of the rectangle.
 

protected property

IsDrawing

Represents property IsDrawing. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

LabelIncrement

Defines the amount to increment the value for the Labels between each label. When LabelIncrement is 0, the TRSChartAxis calculates the increment for the labels by trying to use MinSpacing and then growing as needed. Set LabelIncrement to a non-zero value to define the amount yourself (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

Labels

Defines the properties of the chart axis labels, including Font , Alignment, and Angle. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

LabelStyle

Defines the style of the chart axes' labels, e.g., whether the labels are numeric or FMX.RS.ChartPanel.TRSChartValue   Captions. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public property

Location

Specifies the location (left, right, top, bottom) of the chart axis in the FMX.RS.ChartPanel.TRSChartPanel (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

LogarithmicType

Defines the logarithmic equation type to apply to the chart axis
 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

LogBase

Defines the log base for when the axis is displaying a grid using the logarithmic Options . (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

LogCycles

Defines whether the axis should cycle (start over) as it draws a logarithmic grid. If LogCycle is false, one cycle covers the entire axis range. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

Maximum

Specifies the maximum value for the range of the axis. The     Minimum and     Maximum properties specify the full range of the axis, regardless of whether the axis is zoomed or not. The     ZoomMinimum and     ZoomMaximum properties return the zoomed range of the axis - when the axis is not zoomed, these properties equal the minimum and maximum properties.

Use the Maximum property to set the full maximum range of the axis. Alternatively, you can include axAutomaticMaximum in the     Options property and the axis will automatically calculate the maximum value based on the chart values ( FMX.RS.ChartPanel.TRSChartValues class). Setting the Maximum property manually causes the axis to remove the axAutomaticMaximum member from the Options set.
 

protected property

MaxLabelWidth

Represents property MaxLabelWidth. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

Minimum

Specifies the minimum value for the range of the axis. The     Minimum and     Maximum properties specify the full range of the axis, regardless of whether the axis is zoomed or not. The     ZoomMinimum and     ZoomMaximum properties return the zoomed range of the axis - when the axis is not zoomed, these properties equal the minimum and maximum properties.

Use the Minimum property to set the full mnimum range of the axis. Alternatively, you can include axAutomaticMinimum in the     Options property and the axis will automatically calculate the minimum value based on the chart values ( FMX.RS.ChartPanel.TRSChartValues class). Setting the Minimum property manually causes the axis to remove the axAutomaticMinimum member from the Options set.
 

published property

MinSeparationPct

Specifies the minimum separation between labels in percent of axis size. This property controls how close together the labels will appear on the axis. This property is obviously closely tied to the   Labels property as such things as Font and Angle can affect how many labels can be squeezed into an axis. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

MinStepIncrement

Specifies the minimum amount, in chart axis values, that the major grid marks and their labels should use. This value is usually 0 to let the chart axis choose the stepping increment. For example, if the chart axis would choose an increment of 10, e.g., 0, 10, 20, 30, etc, for the major grid, by setting this property to 25 you would force the stepping increment to be 0, 25, 50, etc. Note that setting this property to 5 would have no effect on the stepping increment in the above case. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected property

NeedAxisUpdate

Represents property NeedAxisUpdate. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public property

OnChange

Occurs immediately after the chart graphic object changes. Write an OnChange event handler to take specific action when the chart graphic changes. The properties of the chart graphic reflect the new settings when OnChange occurs.

alert_cautionWarning

For chart graphics that a chart or chart panel creates, you shouldn't assign a handler to this event. The chart or chart panel has already assigned an event handler.

published property

Opacity

Represents property Opacity. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

Options

Defines the set of display and computation options for the chart axis. This property allows you to make the chart axis calculate the   Minimum and   Maximum values automatically, display labels and titles, and other options. Please see RSChartConsts|TAxisOption for more information.
 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public property

Owner

Returns the FMX.RS.ChartPanel.TRSCustomChartPanel instance that owns the chart axis. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

Pen

Represents property Pen. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

SnapGrid

Controls whether the grid (and labels) should "snap" to the evenly divisibles of the Spacing (e.g., instead of 13, 23, 33, it would be 10, 20, 30)
 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

StartPosition

The     StartPosition and     EndPosition properties specify the end points of the axis, in percentage of the normal axis length. The StartPosition is usually 0%, meaning that, for the BottomAxis for example, the left end of the axis is all the way to the left, aligned against the LeftAxis. The EndPosition is usually 100%, meaning that the BottomAxis' right end is all the way to the right, aligned against with the RightAxis.

Specify a value greater than 0 for the StartPosition or less than 100 for the EndPosition to move the end points in and shorten the length of the axis.
 

published property

Title

Defines the label and display properties of the chart axis Title. The title is the caption that describes what the axis' value labels mean, e.g., 'Temperature (C)' is a title for an axis that has values running from 0 to 100 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

TitleMargin

Defines the amount in pixels between the axis   Title and the rest of the axis. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

Visible

Represents property Visible. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public property

Width

Returns the width (in pixels) of the chart axis. The   Height and Width of the axis is calculated by the   CalculateBounds method (or every time the axis draws).
 (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public property

Zooming

Indicates if the chart axis is zoomed in or not, (e.g.,   ZoomMinimum =   Minimum and   ZoomMaximum =   Maximum). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

published property

ZoomMaximum

The ZoomMaximum and     ZoomMinimum properties allow you to programmatically zoom the chart axis to a portion of the     Maximum -     Minimum range. It allows you to change the portion of the axis that is being visually displayed. If the chart axis is not being zoomed, then these properties will equal the chart axis range (and Zooming return False).

Use ZoomMaximum and ZoomMinimum to zoom the chart axis or use the Zoom method.
 

published property

ZoomMinimum

The ZoomMaximum and     ZoomMinimum properties allow you to programmatically zoom the chart axis to a portion of the     Maximum -     Minimum range. It allows you to change the portion of the axis that is being visually displayed. If the chart axis is not being zoomed, then these properties will equal the chart axis range (and Zooming return False).

Use ZoomMaximum and ZoomMinimum to zoom the chart axis or use the Zoom method.
 

Top

expandingMethods

 

Name

Description

public method

Assign(TPersistent)

Copies the contents of another similar object to the current object

alert_noteNotes to Inheritors

Most objects override Assign to handle the assignment of properties from similar objects. When overriding Assign, call the inherited method if the destination object cannot handle the assignment of properties from the class of the Source parameter

public method

AxisToPixel(TRSChartValueType)

Converts from the chart value parameter to a pixel coordinate of the Owner FMX.RS.ChartPanel.TRSCustomChartPanel component. Based on the     ZoomMinimum and     ZoomMaximum range of the chart axis, this routine converts the parameter value into a pixel coordinate. Unlike the overloaded AxisToPixel method, this method assumes that the visual pixel range of the chart axis is defined by the chart panel's     ChartRect property. The chart axis uses the bounds of the rectangle that apply to its location, e.g., a BottomAxis chart axis would use the ChartRect's Left=ZoomMinimum and Right=ZoomMaximum fields for the calculation (the rectangle is also adjusted if StartPosition and EndPosition properties are not their defaults).

Use one of the AxisToPixel methods anytime you need to convert from internal chart axis coordinates to a visual pixel coordinate. For example, if the chart axis has a zoomed range from 0 to 100 and the ChartRect is Left=150 and Right=500, this function would return:
AxisToPixel( 0 ) = 150
AxisToPixel( 50 ) = 325
AxisToPixel( 100 ) = 500

Use one of the     PixelToAxis methods to convert back from pixel coordinates to chart coordinates.
 

public method

AxisToPixel(TRSChartValueType,TCanvasRect)

Overloaded.  Converts from the chart value parameter to a pixel coordinate of the specified ChartRect parameter. Based on the     ZoomMinimum and     ZoomMaximum range of the chart axis, this routine converts the parameter value into a pixel coordinate. Unlike the overloaded AxisToPixel method, this method assumes that the visual pixel range of the chart axis is defined by the ChartRect property. The chart axis uses the bounds of the rectangle that apply to its location, e.g., a BottomAxis chart axis would use the ChartRect's Left=ZoomMinimum and Right=ZoomMaximum fields for the calculation (the rectangle is also adjusted if StartPosition and EndPosition properties are not their defaults).

Use one of the AxisToPixel methods anytime you need to convert from internal chart axis coordinates to a visual pixel coordinate. For example, if the chart axis has a zoomed range from 0 to 100 and the ChartRect is Left=150 and Right=500, this function would return:
AxisToPixel( 0 ) = 150
AxisToPixel( 50 ) = 325
AxisToPixel( 100 ) = 500

Use one of the     PixelToAxis methods to convert back from pixel coordinates to chart coordinates.
 

protected method

AxisToPixel(TRSLogarithmicType,TRSChartValueType,TCanvasRect,TRSChartValueType,TRSChartValueType,Boolean)

Overloaded. Represents method AxisToPixel(TRSLogarithmicType,TRSChartValueType,TCanvasRect,TRSChartValueType,TRSChartValueType,Boolean). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

CalculateBounds(TCanvas,TCanvasRect)

Sets the chart axis' Width and Height to their proper values based on the ARect parameter.

alert_noteTip

Usually, this method does not need to be called directly as it is automatically called when the chart axis is painted. However, when the chart axis has not been painted yet (e.g., the OnCreate event of the form) and you want to use the chart axis, call this method first.

protected method

Changed

Overloaded. Represents method Changed. (Overrides FMX.RS.ChartPanel.TRSChartGraphic.Changed.)

protected method

Changed(TObject)

Overloaded. Represents method Changed(TObject). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

ChartListNotify(TObject,TRSCustomChart,TRSListNotification)

Represents method ChartListNotify(TObject,TRSCustomChart,TRSListNotification). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

Clone

Creates a "deep" copy of the chart graphic. It constructs a new chart graphic of the correct type and then calls the   Assign method to copy its properties to the new copy. (Inherited from FMX.RS.ChartPanel.TRSChartGraphic.)

public method

Draw(TCanvas,TCanvasRect)

Overloaded. Paints the chart graphic to the specified Canvas in the specified location. It uses the current canvas' brush and pen. Use the Draw method to paint the chart graphic to any canvas and anywhere and with any size on the canvas.

alert_noteNotes to Inheritors

Descendant classes of TRSChartGraphic override the InternalDraw method to actually paint themselves.

public method

Draw(TCanvas,TCanvasRect,TRSChartAxis,TRSChartAxis)

Overloaded.  Paints the chart graphic to the specified Canvas in the specified location. It uses the current canvas' brush and pen. Use the Draw method to paint the chart graphic to any canvas and anywhere and with any size on the canvas.

The VertAxis and HorizAxis parameters can be used to provide point to pixel conversions (see FMX.RS.ChartPanel.TRSChartAxis ).

alert_noteNotes to Inheritors

Descendant classes of TRSChartGraphic override the InternalDraw method to actually paint themselves.

protected method

DrawAxis(TCanvas,TCanvasRect)

Represents method DrawAxis(TCanvas,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

DrawAxisLine(TCanvas,TCanvasRect)

Represents method DrawAxisLine(TCanvas,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

DrawGrid(TCanvas,TCanvasRect)

Represents method DrawGrid(TCanvas,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

Drawing(TCanvas,TCanvasRect)

Represents method Drawing(TCanvas,TCanvasRect). (Overrides FMX.RS.ChartPanel.TRSChartGraphic.Drawing(TCanvas,TCanvasRect).)

protected method

DrawLabels(TCanvas,TCanvasRect)

Represents method DrawLabels(TCanvas,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

Drawn(TCanvas,TCanvasRect)

Represents method Drawn(TCanvas,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSChartGraphic.)

protected method

DrawTitle(TCanvas,TCanvasRect)

Represents method DrawTitle(TCanvas,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

FormatValue(TRSChartValueType)

Returns a string representation of the chart value based on the     Format or     DateTimeFormat properties. Based on the     IsDateTime method, the FormatValue function converts the floating point value to a string using the     Format property or a date time string using the     DateTimeFormat property.

Use the FormatValue method to convert a value to a string using the formatting of the chart axis
 

protected method

FreeNotification(TObject)

Represents method FreeNotification(TObject). (Inherited from FMX.RS.ChartPanel.TRSChartGraphic.)

protected method

GetAxisLabelStyle

Represents method GetAxisLabelStyle. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

GetHalfRect(TCanvasRect,Boolean)

Represents method GetHalfRect(TCanvasRect,Boolean). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

GetLabelSpacing(TCanvas,TCanvasRect,TRSChartValueType,TRSChartValueType)

Represents method GetLabelSpacing(TCanvas,TCanvasRect,TRSChartValueType,TRSChartValueType). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

GetLogCycleAxis(TCanvasRect,TRSChartValueType,TRSChartValueType,TRSChartValueType)

Represents method GetLogCycleAxis(TCanvasRect,TRSChartValueType,TRSChartValueType,TRSChartValueType). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

GetLogCycleZoomChart(TCanvasRect,TRSChartValueType,TRSChartValueType,TRSChartValueType)

Represents method GetLogCycleZoomChart(TCanvasRect,TRSChartValueType,TRSChartValueType,TRSChartValueType). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

Initialize

Represents method Initialize. (Overrides FMX.RS.ChartPanel.TRSChartGraphicArea.Initialize.)

protected method

InitializeEvents

Represents method InitializeEvents. (Overrides FMX.RS.ChartPanel.TRSChartGraphicArea.InitializeEvents.)

protected method

InternalDraw(TCanvas,TCanvasRect)

Represents method InternalDraw(TCanvas,TCanvasRect). (Overrides FMX.RS.ChartPanel.TRSChartGraphicArea.InternalDraw(TCanvas,TCanvasRect).)

public method

IsDateTime

Returns whether the axis is displaying chart values using a date time string representation or a floating point string representation. The chart axis displays date time values when the   ActiveChart (the first visible chart in the   Charts list) specifies its   IsDateTime property to True. When the chart axis displays date time values, the   FormatValue method uses the   DateTimeFormat property for formatting. Otherwise, the FormatValue method uses the   Format property for formatting. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

Pan(Integer)

Overloaded.  Moves the visual window, specified by the     ZoomMinimum and     ZoomMaximum properties, by the amount. The Amount parameter, which is based on pixels, is first converted into the equivalent amount based on chart axis values. Specifying a positive amount moves the zoomed window right and a negative amount moves it left.

Use the overloaded Pan method to move the visual window using chart axis values directly.

The Pan method does nothing if the chart axis is not zoomed in (     Zooming = True).
 

public method

Pan(TRSChartValueType)

Overloaded.  Moves the visual window, specified by the     ZoomMinimum and     ZoomMaximum properties, by the amount. The Amount parameter is based on chart axis values. Specifying a positive amount moves the zoomed window right and a negative amount moves it left.

Use the overloaded Pan method to move the visual window using pixel amounts directly.

The Pan method does nothing if the chart axis is not zoomed in (     Zooming = True).
 

public method

PixelToAxis(TCanvasPixel,Boolean)

Converts from a canvas pixel coordinate to a chart axis coordinate. Based on the     ZoomMinimum and     ZoomMaximum range of the chart axis, this routine converts the parameter value into a chart axis coordinate. Unlike the overloaded PixelToAxis method, this method assumes that the visual pixel range of the chart axis is defined by the chart panel's ChartRect property (obtained through the Owner property). The chart axis uses the bounds of the rectangle that apply to its location, e.g., a BottomAxis chart axis would use the ChartRect's Left=ZoomMinimum and Right=ZoomMaximum fields for the calculation (the rectangle is also adjusted if StartPosition and EndPosition properties are not their defaults).

Use one of the PixelToAxis methods anytime you need to convert from a canvas pixel coordinate to the internal chart axis coordinates. For example, if the chart axis has a zoomed range from 0 to 100 and the ChartRect is Left=150 and Right=500, this function would return:
PixelToAxis( 150 ) = 0
PixelToAxis( 325 ) = 50
PixelToAxis( 500 ) = 100

Use one of the AxisToPixel methods to convert back from chart coordinates to canvas pixel coordinates.
 

public method

PixelToAxis(TCanvasPixel,TCanvasRect,Boolean)

Overloaded.  Converts from a canvas pixel coordinate to a chart axis coordinate. Based on the     ZoomMinimum and     ZoomMaximum range of the chart axis, this routine converts the parameter value into a chart axis coordinate. This method uses the ChartRect parameter to specify the visual pixel range of the chart axis. The chart axis uses the bounds of the rectangle that apply to its location, e.g., a BottomAxis chart axis would use the ChartRect's Left=ZoomMinimum and Right=ZoomMaximum fields for the calculation (the rectangle is also adjusted if StartPosition and EndPosition properties are not their defaults).

Use one of the PixelToAxis methods anytime you need to convert from a canvas pixel coordinate to the internal chart axis coordinates. For example, if the chart axis has a zoomed range from 0 to 100 and the ChartRect is Left=150 and Right=500, this function would return:
PixelToAxis( 150 ) = 0
PixelToAxis( 325 ) = 50
PixelToAxis( 500 ) = 100

Use one of the AxisToPixel methods to convert back from chart coordinates to canvas pixel coordinates.
 

protected method

PixelToAxis(TRSLogarithmicType,TCanvasPixel,TCanvasRect,TRSChartValueType,TRSChartValueType,Boolean)

Overloaded. Represents method PixelToAxis(TRSLogarithmicType,TCanvasPixel,TCanvasRect,TRSChartValueType,TRSChartValueType,Boolean). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

SenderChanged(TObject)

Overloaded. Represents method SenderChanged(TObject). (Inherited from FMX.RS.ChartPanel.TRSChartGraphic.)

public method

SizeUnzoomed

Returns the size of the axis (Maximum-Minimum) (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

SizeZoomed

Returns the size of the zoomed axis (ZoomMaximum-ZoomMinimum) (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

TiledDraw(TCanvas,TCanvasRect,TTileGraphic,TCanvasPixel,TCanvasPixel)

Overloaded.  Tiles the image across the entire input rectangle.

The Image is drawn at full size from the top left of the ARect across and down until outside of the input rectangle. Use the overloaded TiledDraw methods to constrain the size of the Image.

public method

TiledDraw(TCanvas,TCanvasRect,TTileGraphic,TCanvasPixel,TCanvasPixel,TCanvasPixel,TCanvasPixel)

Overloaded.  Tiles the image across the entire input rectangle.

The Image is drawn at ImageWidth, ImageHeight size from the top left of the ARect across and down until outside of the input rectangle.

public method

TiledDraw(TCanvas,TCanvasRect,TTileGraphic,TCanvasRect)

Overloaded.  Tiles the image across the entire input rectangle.

The Image is drawn at ImageRect size from the top left of the ARect across and down until outside of the input rectangle.

protected method

UnboundPixelToAxis(TCanvasPixel,TCanvasRect)

Represents method UnboundPixelToAxis(TCanvasPixel,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

Unzoom

Unzooms the axis to its full range. The Unzoom method changes the visual portion of the chart axis' range to its full range (e.g.,   ZoomMinimum =   Minimum and   ZoomMaximum =   Maximum). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

UpdateAxisValues

Represents method UpdateAxisValues. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

UpdateChartAxisInfo

Represents method UpdateChartAxisInfo. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

ValueChanged(TRSCustomChart)

Represents method ValueChanged(TRSCustomChart). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

protected method

VisibleChanged(TRSCustomChart)

Overloaded. Represents method VisibleChanged(TRSCustomChart). (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

Zoom(TRSChartValueType,Single)

Overloaded.  Zoom a specific part of the axis range by specifying the center (in chart values, not pixel values) and zoom magnification amount. The Zoom method changes the     ZoomMinimum and     ZoomMaximum properties to zoom the axis into that visual portion of the range. It allows you to change the portion of the axis that is being visually displayed.

The overloaded Zoom method zooms the axis using chart values. The ZoomPixelArea method zooms the axis using canvas rectangle values instead of chart values.
 

public method

Zoom(TRSRect)

Overloaded.  Zoom the axis in on (or magnify) a portion of the axis' range. The Zoom method accepts a rectangle using chart axis coordinates and changes the     ZoomMinimum and     ZoomMaximum properties to zoom the axis into that visual portion of the range. It allows you to change the portion of the axis that is being visually displayed.

The ZoomPixelArea method zooms the axis using canvas rectangle values instead of chart values.
 

public method

ZoomAmount

Returns the current zoom amount or magnification. A value of 1 means no magnification. (Inherited from FMX.RS.ChartPanel.TRSChartAxis.)

public method

ZoomPixelArea(TCanvasRect)

Overloaded.  Zoom the axis in on (or magnify) a portion of the axis' range. The Zoom method accepts a canvas pixel rectangle and changes the     ZoomMinimum and     ZoomMaximum properties to zoom the axis into that visual portion of the range. It allows you to change the portion of the axis that is being visually displayed.

The overloaded Zoom method zooms the axis using chart values instead of canvas rectangle values.
 

Top

expandingEvents

 

Name

Description

public event

OnDraw

Occurs just after the chart graphic is painted. Write an OnDraw event handler to take specific action when the chart graphic has finished painting. The OnDraw event also allows you to do custom painting after the chart graphic has painted. (Inherited from FMX.RS.ChartPanel.TRSChartGraphic.)

public event

OnDrawing

Occurs just before the chart graphic is painted. Write an OnDrawing event handler to take specific action when the chart graphic is about to paint. If the event handler sets the DoDraw parameter to False, the chart graphic will not be painted. The OnDraw event also allows you to do custom painting before the chart graphic has been painted. (Inherited from FMX.RS.ChartPanel.TRSChartGraphic.)

Top

expandingSee Also

Reference

Comments (0)

RiverSoftAVG Charting Component Suite (RCCS) © 2005-2015, Thomas G. Grubb