Configuring Performance Bar

Purpose

This topic explains, with code examples, how to configure the performance bar of the UltraBulletGraph™ control. This includes the value indicated by the bar, its width, position, and formatting.

Required background

The following topics are prerequisites to understanding this topic:

Topic	Purpose
UltraBulletGraph Overview	This topic provides conceptual information about the UltraBulletGraph control including its main features, minimum requirements, and user functionality.
Adding UltraBulletGraph	This topic explains how to add the UltraBulletGraph control to a Windows Forms application.

In this topic

This topic contains the following sections:

Configuring the Performance Bar
Related Content

Configuring the Performance Bar

Performance bar appearance configuration summary

The performance bar always starts at the beginning of the scale range. Only this ending position is configurable, which effectively configures the length of the bar. The ending position is managed by the Value property.

Its position in the across-the-scale dimension is configurable relative to the edges of the Graph area through the ValueInnerExtent and ValueOuterExtent properties. Configuring the position of the performance bar also defines its width.

BulletGraph Configuring the Performance Bar 1.png

The look-and-feel of the bar can be customized in terms of fill color, border color, and border thickness using the respective properties ( ValueBrush, ValueOutline, and ValueStrokeThickness).

Performance bar appearance configuration summary chart

The following table explains briefly the configurable aspects of UltraBulletGraph control’s bar and maps them to properties that configure them.

Configurable aspects	Property	Default value
Name	ValueName	Not set
Value to indicate	Value	Not set
Width and position (across the scale)	ValueInnerExtent	0.5
Width and position(across the scale)	ValueOuterExtent	0.65
Fill color	ValueBrush	Defined in the default theme
Border thickness	ValueStrokeThickness	1.0
Border color	ValueOutline	Defined in the default theme

Property settings

The following table maps the desired behavior to its respective property settings.

In order to configure:	Details	Use this property:	And set it to:
Name	A name for the performance bar	ValueName	A string expressing the name of the performance bar
Value to indicate	The value indicated by the performance bar	Value	The desired value in the measures of the scale
Bottom / right edge position	The position of the lower edge of the performance bar at horizontal orientation or the right edge at vertical orientation.	ValueInnerExtent	The desired value as a relative part of the height/width of the Graph area (depending on the orientation) presented as a fraction of 1 (e.g. _0.2 )
Top / left edge position	The position of the top edge of the performance bar at horizontal orientation or the left edge at vertical orientation. (The difference between the starting and the ending points forms the length of the marks’ line segments.)	ValueOuterExtent	The desired value as a relative part of the height/width of the Graph area (depending on the orientation) presented as a fraction of 1 (e.g. 0.2 )
Fill color	Fill color of the bar	ValueBrush	The desired color
Border thickness	Thickness of the performance bar’s border	ValueStrokeThickness	The desired value in pixels
Border color	Color of the performance bar’s border	ValueOutline	The desired color

Example

The screenshot below demonstrates how the UltraBulletGraph looks as a result of the following settings:

Property	Value
Value	“85”
ValueBrush	“#ffffa500”
ValueOutline	“#ffa52a2a”
ValueInnerExtent	“0.3”
ValueOuterExtent	“0.8”
ValueStrokeThickness	“3”

BulletGraph Configuring the Performance Bar 2.png

Following is the code that implements this example.

In C#:

bulletGraph.Value = 85;
bulletGraph.ValueBrush = new SolidColorBrush(Color.FromArgb(255, 165, 0));
bulletGraph.ValueInnerExtent = .3;
bulletGraph.ValueOuterExtent = .8;
bulletGraph.ValueOutline = new SolidColorBrush(Color.FromArgb(165, 42, 42));
bulletGraph.ValueStrokeThickness = 3;

In VB:

bulletGraph.Value = 85
bulletGraph.ValueBrush = New SolidColorBrush(Color.FromArgb(255, 165, 0))
bulletGraph.ValueInnerExtent = .3
bulletGraph.ValueOuterExtent = .8
bulletGraph.ValueOutline = New SolidColorBrush(Color.FromArgb(165, 42, 42))
bulletGraph.ValueStrokeThickness = 3

[[Highlight Value Example]] == Configuring the Highlight Value

Highlight Example

The following screenshot demonstrates how the UltraBulletGraph control with the highlight needle enabled looks as a result of the following settings:

Property	Property Type
HighlightValue	Double
HighlightValueOpacity	double

Topic	Purpose
Configuring the Scale ( UltraBulletGraph )	This topic explains, with examples, how to configure the scale of the UltraBulletGraph control. This includes positioning the scale inside the control and configuring the scale tick marks and labels.
Configuring the Comparative Marker ( UltraBulletGraph )	This topic explains, with code examples, how to configure the comparative measure marker of the UltraBulletGraph control. This includes the marker’s value, width, and formatting.
Configuring Comparative Ranges ( UltraBulletGraph )	This topic explains, with code examples, how to configure ranges in the UltraBulletGraph control. This includes the number of ranges and their positions, lengths, widths, and formatting.
Configuring the Background ( UltraBulletGraph )	This topic explains, with code examples, how to configure a background for the bullet graph. This includes setting the background’s size, position, color, and border.

Windows Forms | Help Topics