Parameter.Value Property

Specifies the current value of the parameter.

Namespace: DevExpress.Diagram.Core.Shapes

Assembly: DevExpress.Diagram.v19.2.Core.dll

Declaration

C#

public CriteriaOperator Value { get; set; }

VB.NET

Public Property Value As CriteriaOperator

Property Value

Type	Description
CriteriaOperator	A numerical value that is the current value of the parameter.

Remarks

Each parameter is characterized by its Value property. The Parameter.DefaultValue property returns the initial value.

To pass the current Parameter.Point to the Parameter.Value definition, use the P.X and P.Y variables that correspond to the point’s X and Y coordinates.

XML

Value="P.Y / H" 

The code snippet below illustrates how to define a parameter that changes its value from 0 to 1 depending on its current Y coordinate. An end-user cannot change the X coordinate.

XML

<Parameter DefaultValue="0" 
                       Point="CreatePoint(W / 2, P * H)" 
                       Value="P.Y / H" 
                       Min="0" Max="1" />

You can pass the parameter’s value to the CreateSize method. The P0 variable corresponds to the first parameter within the ShapeTemplate.Parameters collection, the P1 corresponds to the second parameter and so on. The code snippet below illustrates how to use this parameter to allow an end-user to transform the shape by changing the Arc segment’s size.

XML

<ShapeTemplate x:Key="{ShapeKey CustomizableArc}" DefaultSize="60, 120">
        <Start X="0" Y="0" FillColor="Green"/>
        <Arc X="1" Y="0" Size="CreateSize(W/2, P0 * H)" Direction="Counterclockwise" />
        <Line X="1" Y="1"/>
        <Line X="0" Y="1"/>
        <Line X="0" Y="0"/>
        <ShapeTemplate.Parameters>
            <Parameter DefaultValue="0" 
                       Point="CreatePoint(W / 2, P * H)" 
                       Value="P.Y / H" 
                       Min="0" Max="1" />
        </ShapeTemplate.Parameters>
    </ShapeTemplate>

The following image shows the result:

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Value property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-custom-shapes-with-custom-connection-points-for-diagramdesignercontrol-t320892/CS/DXDiagram.CreateCustomShapes/CustomShapes.xaml#L52

Point="CreatePoint(W / 2, P * H)"
Value="P.Y / H"
Min="0" Max="1" />

diagramcontrol-how-to-create-custom-shapes-with-connection-points-using-xaml-markup-t381372/CS/XtraDiagram.CreateCustomShapesXaml/DiagramResources.xaml#L53

Point="CreatePoint(W / 2, P * H)"
Value="P.Y / H"
Min="0" Max="1" />