Changes

Redefines the values for the indicated symbol. The values in the [['''$]] ''' box if the [[Strategy Properties|Absolute Max Potential Loss]] option is selected or the values in the % box if the [[Strategy Properties|Max Potential Loss]] is selected.  The newly set value is valid during the strategy calculation or until the [['''Portfolio_SetMaxPotentialLossPerContract]] ''' is requested again assigning assigned a new value.

==== Usage ====

==== Parameters ====

[[:'''NewValue]] is ''' - a numerical value that can be: ::* an An absolute value in the range [-100, -0.001]; defines percentage of the maximum potential loss per contract. (Max Potential Loss: %) ::* a value in the range [0.001, 1e+29]; defines the maximum potential loss per contract in dollars. (Absolute Max Potential Loss: $) ::* equal 0; in this case the value entered in the [['''Format Settings]] ''' dialog window under the [[Portfolio Settings]] tab is used.

[['''Portfolio_SetMaxPotentialLossPerContract]] ''' returns: * True if the value is in one of the ranges indicated above. Redefining is considered to be succesfullsuccessful. * False if the if the value is out of the ranges indicated above. Redefining is considered unsuccessful and the '''Max Potential Loss value ''' is unchanged.

==== Notes ==== * This function can only be used in signals intended to be used with the [[:Category:Portfolio_Backtesting|Portfolio Backtester]].

==== Example ==Examples ==<syntaxhighlight>If "MSFT"=SymbolName then Portfolio_SetMaxPotentialLossPerContract (-10); the </syntaxhighlight>The new value of -10 is assigned for the symbol "MSFT" only if such symbol is exist in the portfolio.

<syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract (-5); redefines </syntaxhighlight>Redefines the percentage value of the maximumpotential loss per contract for 5%.

<syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract (200); redefines </syntaxhighlight>Redefines the maximum potential loss per contractfor $200.</syntaxhighlight>