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

SymbolLength Struct

Contains the values used to specify the length (width or height) of a symbol on the symbols panel.

Namespace: DevExpress.Xpf.Gauges

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

NuGet Package: DevExpress.Wpf.Gauges

#Declaration

public struct SymbolLength

The following members return SymbolLength objects:

#Remarks

Use the SymbolLength structure to specify the length (either width or height) of a digital symbol. Note that this length can be set using either proportional or fixed values.

An instance of a SymbolLength class can be accessed via the SymbolViewBase.Height and SymbolViewBase.Width properties.

#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