Setting this property to a unique value is not required; it is merely provided as a facility for those who wish to reference an object by its key.
If this property is set to False, the Annotation will not be rendered.
This method takes into account the measurement of the text. If the Bounds property is set to Rectangle.Empty, then the text will be measured and the bounds will expand to fit the displayed label.
Classes derived from GaugeCollectionBase should call this method whenever adding an object to the collection.
Classes derived from GaugeCollectionBase should call this method whenever inserting an object to the collection.
Classes derived from GaugeCollectionBase should call this method whenever getting an object from the collection.
Classes derived from GaugeCollectionBase should call this method whenever getting an object from the collection.
CornerExtent is expressed as a percent of the length of each side; the corner will begin at this percentage length. For example, a value of 100 will result in no corner, whereas a value of 50 will appear circular. Values outside the range of 50-100 will produce unusual shapes.
This property is set when rendering is initialized. It should generally not be set from application code.
The actual text displayed is subject to limitations in the gauge class. For example, a 7-segment digital gauge can only display the digits 0-9.
When the gauge is rendered, n spaces of equal width will be allocated for displaying digits, where n is the value of this property.
Not to be confused with GaugeCollectionBase.
Use the Response property to enable damping for a gauge marker, for smooth transitions which simulate a fluid-filled gauge.
The Type of this property varies based on the Scale of the parent gauge and its sections. On gauges with numeric scales, this property should be set to a System.Double. On gauges with time scales, this property should be set to a System.DateTime.
The functionality provided through this property is that of a gauge which only measures in distinct increments. This reduces ambiguity in reading the gauge, and also prevents the marker from "twitching" when the input value is changing rapidly in very small increments.
For example, if a gauge is set to display the CPU usage every 100 milliseconds (WinGauge), the marker will appear to shake rapidly around one value when the computer is idle. Set the Precision property to .5 so changes of less than .5 will not be displayed.
More examples: If this property is set to .5, a Value of 23.3 will be rounded to 20.5. If this property is set to 2.0, a Value of 23.3 will be rounded to 24.0.
Example: if StaticGain is set to 2.0, an input value of 10.0 will be displayed as 20.0 on the gauge. If StaticGain is set to 0.5, an input value of 10.0 will be displayed as 5.0 on the gauge.
This property can be set to any object which derives from the Scale class. Most typically, this property will be set to a NumericScale object.
For radial gauges, this value is expressed a percentage of the dial radius. For linear gauges, this value is expressed as a percentage of the width (for vertically oriented gauges) or the height (for horizontally oriented gauges).
This method takes into account the gauge's Response settings.
This method is overridden so that the Scale property of each marker will be set to the gauge in context.
Any object deriving from LinearGaugeMarker can be added to this collection. LinearGaugeNeedle and LinearGaugeBarMarker are two examples of such objects.
This method is overridden so that the Gauge property of each scale will be set to the gauge in context.
If the scale of the current section goes from 0 to 100 and has a TickmarkInterval of 10, then a TickmarkAppearance with a Frequency of 1 will render at multiples of 10; a TickmarkAppearance with a Frequency of .5 will render at multiples of 5; and a TickmarkAppearance with a Frequency of 2 will render at multiples of 20.
Note that if StartWidth and EndWidth are 1, the BrushElement will not be used, since there is no area to fill/paint. In this scenario, use the StrokeElement to define tickmark color.
This method is overridden so that the Scale property of each range will be set to the gauge in context.
This method is overridden so that the Scale property of each marker will be set to the gauge in context.
For horizontally oriented gauges, this is expressed as a percentage of the gauge height. For vertically oriented gauges, this is expressed as a percentage of the gauge's width.
For horizontally oriented gauges, this is expressed as a percentage of the gauge height. For vertically oriented gauges, this is expressed as a percentage of the gauge's width.
For horizontally oriented gauges, this is expressed as a percentage of the gauge height. For vertically oriented gauges, this is expressed as a percentage of the gauge's width.
This method is overridden so that the Scale property of each range will be set to the gauge in context.
This method is overridden so that the Gauge property of each scale will be set to the gauge in context.
These bounds are relative to the top-left of the BrushElement's target rectangle. Dimensions can be specified in pixels or as a percentage of the target rectangle. Use the RelativeClipBoundsMeasure property to set the coordinate system being used.
The top and left coordinates of fills, as well as their sizes can be offset using this property. Dimensions can be specified in pixels or as a percentage of the target rectangle. Use the RelativeBoundsMeasure property to set the coordinate system being used.
For this BrushElement to be valid, there must be at least two ColorStops in the collection, with values of 0.0 and 1.0. Not having a ColorStop at either of these positions will result in no brush.
The majority of Primitives will be geometric shapes or text; but a Primitive can also be other rendering instructions, such as a GraphicsContext primitive, which can set clip bounds, among other graphics instructions.
This property will be set during rendering to the appropriate element from the object model. For example, for a Wedge primitive which represents the dial on a radial gauge, the Element property will be set to the DialAppearance object in context.
This property value is expressed as a percentage of the radius of a circle inscribed in the arc's Bounds.
This property value is expressed as a percentage of the radius of a circle inscribed in the arc's Bounds.
For best results, use a partially transparent BrushElement, e.g. new SolidFillBrushElement(Color.FromArgb(150, Color.DimGray)).
If this property is set to a non-zero value, labels will be scaled down if they exceed this size. This is useful for creating gauges which can be resized at runtime.
CornerExtent is expressed as a percent of the length of each side, or as a percent of the sweep angle before each corner. The corner will begin at this percentage length. Sensible values are between 50 and 100.
This property wil have a different effects under different circumstances in rendering the dial. For rectangular dials, the CornerExtent simply applies to the four corners of the rectangle. For elliptical dials, no corners will be rendered if the dial sweeps 360 degrees or more.
For elliptical dials, a positive value for this property will result in a doughnut shape for the dial; a negative value for this property will also create a "seashell" shape if the dial sweeps less than 360 degrees.
A Scale is the part of a radial gauge which contains the marker and displays labels and tickmarks.
Any object deriving from RadialGaugeMarker can be added to this collection. RadialGaugeNeedle and RadialGaugeBarMarker are two examples of such objects.
This interface is implemented by WebGauge and WinGauge, and is used by the gauge core to refer to both components interchangeably.
In a ColorStopCollection, there must be at least two ColorStops, with a Stop value of 0 and 1. These represent the start and end colors of the gradient.
In a ColorStopCollection, there must be at least two ColorStops, with a Stop value of 0 and 1. These represent the start and end colors of the gradient.
This method ensures that if there are 2 or more ColorStops in this collection, the first one will have a stop value of 0, and the last will have a stop value of 1. It then sorts the collection so that the ColorStops found between are ordered correctly.
This method is used for binding the ColorStopCollection to a grid so that it can be viewed and edited in a tabular form.
For this BrushElement to be valid, there must be at least two ColorStops in the collection, with values of 0.0 and 1.0. Not having a ColorStop at either of these positions will result in no brush.
If the StrokeElement.BrushElement property is set to a non-null value, this property will be ignored in favor of that Brush.
This property corresponds directly with the System.Drawing.Pen.Alignment property. Thus, the limitations of the System.Drawing.Pen.Alignment property are also seen here; only Inset and Center values are respected. For more information, please refer to the MSDN documentation for that property.
This property is not required. To create a simple solid-color stroke, just set the StrokeElement.Color property.
Custom DashStyles are not currently supported.
CornerExtent is expressed as a percent of the length of each side; the corner will begin at this percentage length. For example, a value of 100 will result in no corner, whereas a value of 50 will appear circular. Values outside the range of 50-100 will produce unusual shapes.
The mapMinimum and mapMaximum parameters are typically pixel or degree values. For example, when mapping on a horizontal linear gauge, mapMinimum would be the leftmost pixel X-coordinate on the axis, whereas mapMaximum would be the rightmost pixel X-coordinate. Or, on a radial gauge, mapMinimum would be the start angle of the gauge, whereas mapMaximum would be the end angle of the same gauge.
Alternate formula is Geometry.PointOnEllipse. This function returns angular values which are not necessarily evenly distributed along the circumference of the ellipse.
Alternate formula is Geometry.PointOnEllipse. This function returns angular values which are not necessarily evenly distributed along the circumference of the ellipse.
This property is used by the UltraGauge during serialization and is not intended for use at the application level.