Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

SymbolLengthType Enum

Contains the values used to specify the symbol length (either width or height) for the current symbol view appearance on a digital gauge control.

Namespace: DevExpress.Xpf.Gauges

Assembly: DevExpress.Xpf.Gauges.v24.2.dll

NuGet Package: DevExpress.Wpf.Gauges

#Declaration

public enum SymbolLengthType

#Members

Name Description
Auto

A symbol has a predefined length (width and height) according to the view type of the current symbols panel.

Stretch

A symbol is stretched to fill the entire symbols panel. Note that the height to width proportion will not be preserved in this case.

Fixed

A symbol length is specified in absolute values.

Proportional

A symbol is zoomed proportionally to fill the entire symbols panel.

#Related API Members

The following properties accept/return SymbolLengthType values:

#Remarks

The values listed by the SymbolLengthType enumerator are used to set the SymbolLength.Type property.

#Example

This example demonstrates how to specify the width and height of digital gauge symbols in fixed and proportional values.

For this, it is necessary to create an instance of the SymbolLength structure with required values and then assign it to the SymbolViewBase.Height and SymbolViewBase.Width properties.

In this example, the symbol length can be set either in fixed or proportional values depending on which of the buttons has been clicked.

View Example: Set the Width and Height of Symbols in the Digital Gauge Control

private void button1_Click(object sender, RoutedEventArgs e) {
    // Specify fixed values for symbol height and width.
    matrixView.Width = new SymbolLength(SymbolLengthType.Fixed, 44);
    matrixView.Height = new SymbolLength(SymbolLengthType.Fixed, 50);
}

private void button2_Click(object sender, RoutedEventArgs e) {
    // Specify proportional values for symbol height and width.
    matrixView.Width = new SymbolLength(SymbolLengthType.Proportional, 2);
    matrixView.Height = new SymbolLength(SymbolLengthType.Proportional, 5);
}
See Also