LogarithmicAxis Class
Definition
A logarithmic axis for displaying data with exponential ranges on a chart.
public class LogarithmicAxis
Remarks
Logarithmic axes are useful for data that spans multiple orders of magnitude, such as financial data, scientific measurements, or frequency responses.
The axis transforms values using the formula: screenPosition = log(value) / log(base). Values must be positive (greater than 0). Zero and negative values are not supported and will be clamped to a minimum positive value.
Constructors
| Name | Description |
|---|---|
| LogarithmicAxis | No summary available. |
LogarithmicAxis Constructor
public LogarithmicAxis()
Methods
| Name | Description |
|---|---|
| AddHandler (2 overloads) | Adds a handler for the specified routed event. Inherited from Interactive. |
| ApplyStyling | Applies styling to the control if the control is initialized and styling is not already applied. Inherited from StyledElement. |
| ApplyTemplate | Creates the visual children of the control, if necessary Inherited from TemplatedControl. |
| Arrange | Arranges the control and its children. Inherited from Layoutable. |
| BeginInit | Inherited from StyledElement. |
| Bind (8 overloads) | Binds a Avalonia.AvaloniaProperty to an Avalonia.Data.BindingBase. Inherited from AvaloniaObject. |
| CheckAccess | Returns a value indicating whether the current thread is the UI thread. Inherited from AvaloniaObject. |
| ClearValue (4 overloads) | Clears a Avalonia.AvaloniaProperty's local value. Inherited from AvaloniaObject. |
| CoerceValue | Coerces the specified Avalonia.AvaloniaProperty. Inherited from AvaloniaObject. |
| EndInit | Inherited from StyledElement. |
| Equals | Compares two objects using reference equality. Inherited from AvaloniaObject. |
| Focus | Focuses the control. Inherited from InputElement. |
| FormatLabel (2 overloads) | Formats a value for display as an axis label. |
| GenerateTickValues | Generates tick values for the logarithmic axis. |
| GetBaseValue | Inherited from AvaloniaObject. |
| GetFlowDirection | Gets the value of the attached Avalonia.Visual.FlowDirectionProperty on a control. Inherited from Visual. |
| GetHashCode | Gets the hash code for the object. Inherited from AvaloniaObject. |
| GetIsHoldingEnabled | Inherited from InputElement. |
| GetIsHoldWithMouseEnabled | Inherited from InputElement. |
| GetIsTemplateFocusTarget | Gets the value of the IsTemplateFocusTargetProperty attached property on a control. Inherited from TemplatedControl. |
| GetValue (3 overloads) | Gets a Avalonia.AvaloniaProperty value. Inherited from AvaloniaObject. |
| InvalidateArrange | Invalidates the arrangement of the control and queues a new layout pass. Inherited from Layoutable. |
| InvalidateMeasure | Invalidates the measurement of the control and queues a new layout pass. Inherited from Layoutable. |
| InvalidateVisual | Invalidates the visual and queues a repaint. Inherited from Visual. |
| IsAnimating | Checks whether a Avalonia.AvaloniaProperty is animating. Inherited from AvaloniaObject. |
| IsSet | Checks whether a Avalonia.AvaloniaProperty is set on this object. Inherited from AvaloniaObject. |
| LogPositionToValue | Converts a logarithmic position (0 to 1 normalized) back to a data value. |
| Measure | Carries out a measure of the control. Inherited from Layoutable. |
| RaiseEvent | Raises a routed event. Inherited from Interactive. |
| RemoveHandler (2 overloads) | Removes a handler for the specified routed event. Inherited from Interactive. |
| Render | Renders the visual to a Avalonia.Media.DrawingContext. Inherited from Visual. |
| SetCurrentValue (2 overloads) | Sets the value of a dependency property without changing its value source. Inherited from AvaloniaObject. |
| SetFlowDirection | Sets the value of the attached Avalonia.Visual.FlowDirectionProperty on a control. Inherited from Visual. |
| SetIsHoldingEnabled | Inherited from InputElement. |
| SetIsHoldWithMouseEnabled | Inherited from InputElement. |
| SetIsTemplateFocusTarget | Sets the value of the IsTemplateFocusTargetProperty attached property on a control. Inherited from TemplatedControl. |
| SetValue (3 overloads) | Sets a Avalonia.AvaloniaProperty value. Inherited from AvaloniaObject. |
| TryGetResource | Inherited from StyledElement. |
| UpdateLayout | Executes a layout pass. Inherited from Layoutable. |
| ValueToLogPosition | Converts a data value to its logarithmic position (0 to 1 normalized). |
| VerifyAccess | Checks that the current thread is the UI thread and throws if not. Inherited from AvaloniaObject. |
FormatLabel overloads
FormatLabel Method
Formats a value for display as an axis label.
public string FormatLabel(object value)
Parameters
value object
Returns
string
FormatLabel Method
Formats a value for display as an axis label using the specified culture.
public string FormatLabel(object value, System.Globalization.CultureInfo culture)
Parameters
value object
culture System.Globalization.CultureInfo
Returns
string
GenerateTickValues Method
Generates tick values for the logarithmic axis.
public double[] GenerateTickValues(double minValue, double maxValue)
Parameters
minValue double
The minimum data value.
maxValue double
The maximum data value.
Returns
double[]
An array of tick values.
LogPositionToValue Method
Converts a logarithmic position (0 to 1 normalized) back to a data value.
public double LogPositionToValue(double position, double minValue, double maxValue)
Parameters
position double
The normalized position (0 to 1).
minValue double
The minimum axis value.
maxValue double
The maximum axis value.
Returns
double
The data value.
ValueToLogPosition Method
Converts a data value to its logarithmic position (0 to 1 normalized).
public double ValueToLogPosition(double value, double minValue, double maxValue)
Parameters
value double
The data value (must be positive).
minValue double
The minimum axis value.
maxValue double
The maximum axis value.
Returns
double
A normalized position between 0 and 1.
Properties
| Name | Description |
|---|---|
| ActualThemeVariant | Gets the UI theme that is currently used by the element, which might be different than the RequestedThemeVariantProperty. Inherited from StyledElement. |
| AxisLineDashStyle | Gets or sets the dash style for the axis line. Inherited from ChartAxis. |
| AxisLineStroke | Gets or sets the brush for the axis line. When set, overrides the default axis brush for this axis's line. Inherited from ChartAxis. |
| AxisLineStrokeThickness | Gets or sets the thickness of the axis line. Inherited from ChartAxis. |
| Background | Gets or sets the brush used to draw the control's background. Inherited from TemplatedControl. |
| BackgroundSizing | Gets or sets how the control's background is drawn relative to the control's border. Inherited from TemplatedControl. |
| BorderBrush | Gets or sets the brush used to draw the control's border. Inherited from TemplatedControl. |
| BorderThickness | Gets or sets the thickness of the control's border. Inherited from TemplatedControl. |
| Bounds | Gets the bounds of the control relative to its parent. Inherited from Visual. |
| CacheMode | Gets or sets the cache mode of the visual. Inherited from Visual. |
| Classes | Gets or sets the styled element's classes. Inherited from StyledElement. |
| Clip | Gets or sets the geometry clip for this visual. Inherited from Visual. |
| ClipToBounds | Gets or sets a value indicating whether the control should be clipped to its bounds. Inherited from Visual. |
| ContextFlyout | Gets or sets a context flyout to the control Inherited from Control. |
| ContextMenu | Gets or sets a context menu to the control. Inherited from Control. |
| CornerRadius | Gets or sets the radius of the border rounded corners. Inherited from TemplatedControl. |
| Cursor | Gets or sets associated mouse cursor. Inherited from InputElement. |
| DataContext | Gets or sets the control's data context. Inherited from StyledElement. |
| DataTemplates | Gets or sets the data templates for the control. Inherited from Control. |
| DesiredSize | Gets the size that this element computed during the measure pass of the layout process. Inherited from Layoutable. |
| Dispatcher | Returns the Avalonia.AvaloniaObject.Dispatcher that this Avalonia.AvaloniaObject is associated with. Inherited from AvaloniaObject. |
| Effect | Gets or sets the effect of the control. Inherited from Visual. |
| FlowDirection | Gets or sets the text flow direction. Inherited from Visual. |
| Focusable | Gets or sets a value indicating whether the control can receive focus. Inherited from InputElement. |
| FocusAdorner | Gets or sets the control's focus adorner. Inherited from Control. |
| FontFamily | Gets or sets the font family used to draw the control's text. Inherited from TemplatedControl. |
| FontFeatures | Gets or sets the font features turned on/off. Inherited from TemplatedControl. |
| FontSize | Gets or sets the size of the control's text in points. Inherited from TemplatedControl. |
| FontStretch | Gets or sets the font stretch used to draw the control's text. Inherited from TemplatedControl. |
| FontStyle | Gets or sets the font style used to draw the control's text. Inherited from TemplatedControl. |
| FontWeight | Gets or sets the font weight used to draw the control's text. Inherited from TemplatedControl. |
| Foreground | Gets or sets the brush used to draw the control's text and other foreground elements. Inherited from TemplatedControl. |
| GestureRecognizers | Inherited from InputElement. |
| GridLineBrush | Gets or sets the brush for this axis's grid lines. When set, overrides the owning chart's Avalonia.Controls.Charts.IGridLineBrushChart.GridLineBrush for this axis. Inherited from ChartAxis. |
| GridLineCap | Gets or sets the line cap style for major grid lines. Inherited from ChartAxis. |
| GridLineDashStyle | Gets or sets the dash style for major grid lines. Inherited from ChartAxis. |
| GridLineJoin | Gets or sets the line join style for major grid lines. Inherited from ChartAxis. |
| GridLineStrokeThickness | Gets or sets the thickness of grid lines. Inherited from ChartAxis. |
| HasMirrorTransform | Gets or sets a value indicating whether to apply mirror transform on this control. Inherited from Visual. |
| Height | Gets or sets the height of the element. Inherited from Layoutable. |
| HorizontalAlignment | Gets or sets the element's preferred horizontal alignment in its parent. Inherited from Layoutable. |
| IsArrangeValid | Gets a value indicating whether the control's layouts arrange is valid. Inherited from Layoutable. |
| IsEffectivelyEnabled | Gets a value indicating whether this control and all its parents are enabled. Inherited from InputElement. |
| IsEffectivelyVisible | Gets a value indicating whether this control and all its parents are visible. Inherited from Visual. |
| IsEnabled | Gets or sets a value indicating whether the control is enabled for user interaction. Inherited from InputElement. |
| IsFocused | Gets a value indicating whether the control is focused. Inherited from InputElement. |
| IsHitTestVisible | Gets or sets a value indicating whether the control is considered for hit testing. Inherited from InputElement. |
| IsInitialized | Gets a value that indicates whether the element has finished initialization. Inherited from StyledElement. |
| IsKeyboardFocusWithin | Gets a value indicating whether keyboard focus is anywhere within the element or its visual tree child elements. Inherited from InputElement. |
| IsLoaded | Gets a value indicating whether the control is fully constructed in the visual tree and both layout and render are complete. Inherited from Control. |
| IsMeasureValid | Gets a value indicating whether the control's layout measure is valid. Inherited from Layoutable. |
| IsPointerOver | Gets a value indicating whether the pointer is currently over the control. Inherited from InputElement. |
| IsTabStop | Gets or sets a value that indicates whether the control is included in tab navigation. Inherited from InputElement. |
| IsVisible | Gets or sets a value indicating whether this control is visible. Inherited from Visual. |
| Item | Inherited from AvaloniaObject. |
| KeyBindings | Inherited from InputElement. |
| LabelFitMode | Gets or sets how axis labels should fit. Inherited from ChartAxis. |
| LabelFontSize | Gets or sets the font size for axis labels. Inherited from ChartAxis. |
| LabelForeground | Gets or sets the foreground brush for axis labels. Inherited from ChartAxis. |
| LabelFormat | Gets or sets the format string for axis labels. Inherited from ChartAxis. |
| LabelRotation | Gets or sets the rotation angle for labels (in degrees) when Avalonia.Controls.Charts.ChartAxis.LabelFitMode is Avalonia.Controls.Charts.LabelFitMode.CustomRotation. Inherited from ChartAxis. |
| LetterSpacing | Gets or sets the letter spacing for the control's text content. Inherited from TemplatedControl. |
| LogBase | Gets or sets the logarithm base for the axis scale. |
| MajorStep | Gets or sets the major step as a multiplier between tick marks. If null, auto-calculated based on the log base. |
| Margin | Gets or sets the margin around the element. Inherited from Layoutable. |
| MaxHeight | Gets or sets the maximum height of the element. Inherited from Layoutable. |
| Maximum | Gets or sets the maximum value of the axis (in actual units, not log-transformed). If null, auto-calculated from data. Must be greater than 0. |
| MaxWidth | Gets or sets the maximum width of the element. Inherited from Layoutable. |
| MinHeight | Gets or sets the minimum height of the element. Inherited from Layoutable. |
| Minimum | Gets or sets the minimum value of the axis (in actual units, not log-transformed). If null, auto-calculated from data. Must be greater than 0. |
| MinorGridLineBrush | Gets or sets the brush for minor grid lines. Inherited from ChartAxis. |
| MinorGridLineCap | Gets or sets the line cap style for minor grid lines. Inherited from ChartAxis. |
| MinorGridLineDashStyle | Gets or sets the dash style for minor grid lines. Inherited from ChartAxis. |
| MinorGridLineJoin | Gets or sets the line join style for minor grid lines. Inherited from ChartAxis. |
| MinorGridLineStrokeThickness | Gets or sets the thickness of minor grid lines. Inherited from ChartAxis. |
| MinorTickCount | Gets or sets the number of minor ticks between major ticks. Inherited from ChartAxis. |
| MinWidth | Gets or sets the minimum width of the element. Inherited from Layoutable. |
| Name | Gets or sets the name of the styled element. Inherited from StyledElement. |
| Opacity | Gets or sets the opacity of the control. Inherited from Visual. |
| OpacityMask | Gets or sets the opacity mask of the control. Inherited from Visual. |
| Padding | Gets or sets the padding placed between the border of the control and its content. Inherited from TemplatedControl. |
| Parent | Gets the styled element's logical parent. Inherited from StyledElement. |
| PlotBands | Gets the collection of plot bands for this axis. Inherited from ChartAxis. |
| RenderTransform | Gets or sets the render transform of the control. Inherited from Visual. |
| RenderTransformOrigin | Gets or sets the transform origin of the control. Inherited from Visual. |
| Resources | Gets or sets the styled element's resource dictionary. Inherited from StyledElement. |
| ShowAxisLine | Gets or sets whether to show the axis line. Inherited from ChartAxis. |
| ShowGridLines | Gets or sets whether grid lines are shown. Inherited from ChartAxis. |
| ShowLabels | Gets or sets whether to show axis labels. Inherited from ChartAxis. |
| ShowMinorGridLines | Gets or sets whether minor grid lines are shown. Inherited from ChartAxis. |
| ShowTickLines | Gets or sets whether to show tick marks at each label position. Inherited from ChartAxis. |
| StyleKey | Gets the type by which the element is styled. Inherited from StyledElement. |
| Styles | Gets the styles for the styled element. Inherited from StyledElement. |
| TabIndex | Gets or sets a value that determines the order in which elements receive focus when the user navigates through controls by pressing the Tab key. Inherited from InputElement. |
| Tag | Gets or sets a user-defined object attached to the control. Inherited from Control. |
| Template | Gets or sets the template that defines the control's appearance. Inherited from TemplatedControl. |
| TemplatedParent | Gets the styled element whose lookless template this styled element is part of. Inherited from StyledElement. |
| Theme | Gets or sets the theme to be applied to the element. Inherited from StyledElement. |
| TickLineLength | Gets or sets the length of tick marks in pixels. Inherited from ChartAxis. |
| TickLineStroke | Gets or sets the brush for tick marks. Inherited from ChartAxis. |
| TickLineStrokeThickness | Gets or sets the thickness of tick marks. Inherited from ChartAxis. |
| Title | Gets or sets the axis title. Inherited from ChartAxis. |
| TitleFontSize | Gets or sets the font size for the axis title. Inherited from ChartAxis. |
| TitleForeground | Gets or sets the foreground brush for the axis title. Inherited from ChartAxis. |
| Transitions | Gets or sets the property transitions for the control. Inherited from Animatable. |
| UseLayoutRounding | Gets or sets a value that determines whether the element should be snapped to pixel boundaries at layout time. Inherited from Layoutable. |
| VerticalAlignment | Gets or sets the element's preferred vertical alignment in its parent. Inherited from Layoutable. |
| Width | Gets or sets the width of the element. Inherited from Layoutable. |
| ZIndex | Gets or sets the Z index of the control. Inherited from Visual. |
LogBase Property
Gets or sets the logarithm base for the axis scale.
public double LogBase { get; set; }
Value
Common values are:
- 10 (default) - Decades (1, 10, 100, 1000)
- 2 - Binary (1, 2, 4, 8, 16)
- Math.E (~2.718) - Natural logarithm
MajorStep Property
Gets or sets the major step as a multiplier between tick marks. If null, auto-calculated based on the log base.
public Nullable<double> MajorStep { get; set; }
Remarks
For a base-10 axis, a step of 10 means labels at 1, 10, 100, 1000. For a base-2 axis, a step of 2 means labels at 1, 2, 4, 8, 16.
Maximum Property
Gets or sets the maximum value of the axis (in actual units, not log-transformed). If null, auto-calculated from data. Must be greater than 0.
public Nullable<double> Maximum { get; set; }
Minimum Property
Gets or sets the minimum value of the axis (in actual units, not log-transformed). If null, auto-calculated from data. Must be greater than 0.
public Nullable<double> Minimum { get; set; }
Fields
LogBaseProperty Field
Identifies the Avalonia.Controls.Charts.LogarithmicAxis.LogBase Avalonia property.
public Avalonia.StyledProperty<double> LogBaseProperty
MajorStepProperty Field
Identifies the Avalonia.Controls.Charts.LogarithmicAxis.MajorStep Avalonia property.
public Avalonia.StyledProperty<Nullable<double>> MajorStepProperty
MaximumProperty Field
Identifies the Avalonia.Controls.Charts.LogarithmicAxis.Maximum Avalonia property.
public Avalonia.StyledProperty<Nullable<double>> MaximumProperty
MinimumProperty Field
Identifies the Avalonia.Controls.Charts.LogarithmicAxis.Minimum Avalonia property.
public Avalonia.StyledProperty<Nullable<double>> MinimumProperty
Events
| Name | Description |
|---|---|
| ActualThemeVariantChanged | Raised when the theme variant is changed on the element or an ancestor of the element. Inherited from StyledElement. |
| AttachedToLogicalTree | Raised when the styled element is attached to a rooted logical tree. Inherited from StyledElement. |
| AttachedToVisualTree | Raised when the control is attached to a rooted visual tree. Inherited from Visual. |
| AxisChanged | Raised when a property of the axis changes that requires the owning chart to redraw. This complements Avalonia.Visual.InvalidateVisual on the axis itself: the axis invalidation covers standalone/template rendering, while this event covers chart-owned axis rendering in Cartesian and financial charts. Inherited from ChartAxis. |
| ContextCanceled | Occurs when the context input gesture continues into another gesture, to notify the element that the context flyout should not be opened. Inherited from InputElement. |
| ContextRequested | Occurs when the user has completed a context input gesture, such as a right-click. Inherited from InputElement. |
| DataContextChanged | Occurs when the Avalonia.StyledElement.DataContext property changes. Inherited from StyledElement. |
| DetachedFromLogicalTree | Raised when the styled element is detached from a rooted logical tree. Inherited from StyledElement. |
| DetachedFromVisualTree | Raised when the control is detached from a rooted visual tree. Inherited from Visual. |
| DoubleTapped | Occurs when the user briefly contacts and releases twice on a single point, without significant movement. Inherited from InputElement. |
| EffectiveViewportChanged | Occurs when the element's effective viewport changes. Inherited from Layoutable. |
| GettingFocus | Occurs before the control receives focus. Inherited from InputElement. |
| GotFocus | Occurs when the control receives focus. Inherited from InputElement. |
| Holding | Occurs when the user makes a single contact, then maintains contact beyond a given time threshold without releasing or making another contact. Inherited from InputElement. |
| Initialized | Occurs when the styled element has finished initialization. Inherited from StyledElement. |
| KeyDown | Occurs when a key is pressed while the control has focus. Inherited from InputElement. |
| KeyUp | Occurs when a key is released while the control has focus. Inherited from InputElement. |
| LayoutUpdated | Occurs when a layout pass completes for the control. Inherited from Layoutable. |
| Loaded | Occurs when the control has been fully constructed in the visual tree and both layout and render are complete. Inherited from Control. |
| LosingFocus | Occurs before the control loses focus. Inherited from InputElement. |
| LostFocus | Occurs when the control loses focus. Inherited from InputElement. |
| Pinch | Occurs when the user moves two contact points closer together. Inherited from InputElement. |
| PinchEnded | Occurs when the user releases both contact points used in a pinch gesture. Inherited from InputElement. |
| PointerCaptureLost | Occurs when the control or its child control loses the pointer capture for any reason, event will not be triggered for a parent control if capture was transferred to another child of that parent control. Inherited from InputElement. |
| PointerEntered | Occurs when the pointer enters the control. Inherited from InputElement. |
| PointerExited | Occurs when the pointer leaves the control. Inherited from InputElement. |
| PointerMoved | Occurs when the pointer moves over the control. Inherited from InputElement. |
| PointerPressed | Occurs when the pointer is pressed over the control. Inherited from InputElement. |
| PointerReleased | Occurs when the pointer is released over the control. Inherited from InputElement. |
| PointerTouchPadGestureMagnify | Occurs when the user moves two contact points away from each other on a touchpad. Inherited from InputElement. |
| PointerTouchPadGestureRotate | Occurs when the user places two contact points and moves them in a circular motion on a touchpad. Inherited from InputElement. |
| PointerTouchPadGestureSwipe | Occurs when the user performs a rapid dragging motion in a single direction on a touchpad. Inherited from InputElement. |
| PointerWheelChanged | Occurs when the mouse is scrolled over the control. Inherited from InputElement. |
| PropertyChanged | Raised when a Avalonia.AvaloniaProperty value changes on this object. Inherited from AvaloniaObject. |
| PullGesture | Occurs when the user drags from the edge of a control. Inherited from InputElement. |
| PullGestureEnded | Occurs when the user releases the pointer after a pull gesture. Inherited from InputElement. |
| ResourcesChanged | Occurs when a resource in this styled element or a parent styled element has changed. Inherited from StyledElement. |
| RightTapped | Occurs when the user briefly contacts and releases a single point, without significant movement, using a mechanism on the input device recognized as a right button or equivalent. Inherited from InputElement. |
| ScrollGesture | Occurs when the user continuously moves the pointer in the same direction within the control’s boundaries. Inherited from InputElement. |
| ScrollGestureEnded | Occurs when a scroll gesture has fully stopped, taking into account any inertial movement that continues the scroll after the user has released the pointer. Inherited from InputElement. |
| ScrollGestureInertiaStarting | Occurs within a scroll gesture, when the user releases the pointer, and scrolling continues by transitioning to momentum-based gliding movement. Inherited from InputElement. |
| SizeChanged | Occurs when the bounds (actual size) of the control have changed. Inherited from Control. |
| SwipeGesture | Occurs when the user rapidly drags the pointer in a single direction across the control. Inherited from InputElement. |
| SwipeGestureEnded | Occurs when a swipe gesture ends on the control. Inherited from InputElement. |
| Tapped | Occurs when the user briefly contacts and releases a single point, without significant movement. Inherited from InputElement. |
| TemplateApplied | Raised when the control's template is applied. Inherited from TemplatedControl. |
| TextInput | Occurs when a user typed some text while the control has focus. Inherited from InputElement. |
| TextInputMethodClientRequested | Occurs when an input element gains input focus and input method is looking for the corresponding client Inherited from InputElement. |
| Unloaded | Occurs when the control is removed from the visual tree. Inherited from Control. |