Creating Your Own Cube

Similar to creating a cube from a diagram, you can create your own cube based on C# code. Such a cube will be more functional than a cube from a diagram.

To create a cube from code, it needs to be created in the Own elements folder:

Designer_Source_Code_Elem_00

In the example provided below, the cube inherits from the DiagramExternalElement class, and looks as follows:

/// <summary>
/// Sample diagram element demonstrates input and output sockets usage.
/// 
/// https://doc.stocksharp.com/topics/Designer_Combine_Source_code_and_standard_elements.html
/// </summary>
public class EmptyDiagramElement : DiagramExternalElement
{
	private readonly DiagramElementParam<int> _minValue;

	public EmptyDiagramElement()
	{
		// example property to show how to make parameters
	
		_minValue = AddParam("MinValue", 10)
			.SetBasic(true) // make parameter visible in basic mode
			.SetDisplay("Parameters", "Min value", "Min value parameter description", 10);
	}

	// output sockets are events marked with DiagramExternal attribute

	[DiagramExternal]
	public event Action<Unit> Output1;

	[DiagramExternal]
	public event Action<Unit> Output2;

	// input sockets are method parameters marked with DiagramExternal attribute

	// uncomment to get Process method called every time when new arg received
	// (no need wait when all input args received)
	//public override bool WaitAllInput => false;

	[DiagramExternal]
	public void Process(CandleMessage candle, Unit diff)
	{
		var res = candle.ClosePrice + diff;

		if (diff >= _minValue.Value)
			Output1?.Invoke(res);
		else
			Output2?.Invoke(res);
	}

	public override void Start()
	{
		base.Start();

		// add logic before start
	}

	public override void Stop()
	{
		base.Stop();

		// add logic after stop
	}

	public override void Reset()
	{
		base.Reset();

		// add logic for reset internal state
	}
}

In this code, the cube has two incoming sockets and two outgoing sockets. Incoming sockets are defined by applying the DiagramExternalAttribute attribute to the method:

[DiagramExternal]
public void Process(CandleMessage candle, Unit diff)

Outgoing sockets are defined by applying the attribute to an event. In the example of the cube, there are two such events:

[DiagramExternal]
public event Action<Unit> Output1;

[DiagramExternal]
public event Action<Unit> Output2;

Therefore, there will also be two outgoing sockets.

Additionally, it shows how to make a property for the cube:

_minValue = AddParam("MinValue", 10)
	.SetBasic(true) // make parameter visible in basic mode
	.SetDisplay("Parameters", "Min value", "Min value parameter description", 10);

Using the DiagramElementParam class automatically employs the approach to save and restore settings.

The MinValue property is marked as basic, and it will be visible in the Basic properties mode.

The commented WaitAllInput property is responsible for the timing of the method call with incoming sockets:

//public override bool WaitAllInput => false;

If uncommented, the Process method will always be called as soon as at least one value arrives (in the example case, this is either a candle or a numerical value).

To add the resulting cube to the diagram, you need to select the created cube in the palette in the Own elements section:

Designer_Source_Code_Elem_01

Warning

Cubes from C# code cannot be used in strategies created in C# code. They can only be used in strategies created from cubes.

Table of Contents

Creating Your Own Cube

Warning

See Also