Clippings
The filled shapes can also be used for clipping. The Clippings collection property is available in the following elements: C1GaugeBaseShape, C1GaugePointer, C1GaugeDecorator, and C1GaugeCap. To specify the clipping region for some element you may follow this:
- Assign a string to the C1GaugeBaseShape.Name property of the shape or shapes that will be used for clipping.
- Open the collection editor for the Clippings property of an element that is being clipped.
- Add one or several items to the Clippings collection and set their C1GaugeClipping.ShapeName properties in accordance with names assigned at the first step. Also, assign the C1GaugeClipping.Operation property to some non-default value (Intersect, for example).
The C1GaugeClipping.ScaleFactor property allows scaling of the clipping region. You may leave the C1GaugeClipping.ShapeName property empty for a filled shape. Then it will be clipped by itself. So if you set the C1GaugeClipping.ScaleFactor to 0.9, for example, you will see a thick border instead of the filled shape.
The name of the clipping shape is searched in the C1GaugeBase.FaceShapes and C1GaugeBase.CoverShapes collection of this gauge. If it is not found in the current gauge it is then searched in the owner C1Gauge control.