/// <summary>
/// Initialize a new instance of the class.
/// </summary>
/// <param name="enumeratorControl">The <c>WatchControl</c> derived user control that called this form.</param>
public FormChangeEnumerator(WatchEnumeratorControl enumeratorControl) : base(enumeratorControl)
{
InitializeComponent();
Debug.Assert(m_WatchVariable != null, "FormChangeEnumerator.Ctor() - [m_WatchVariable != null]");
Debug.Assert(m_WatchVariable.VariableType == VariableType.Enumerator, "FormChangeEnumerator.Ctor() - [m_WatchVariable.VariableType == VariableType.Enumerator]");
// ------------------------
// Initialize the ComboBox.
// ------------------------
// Get the list of enumerator/bitmask (EnumBit) description/value pairs associated with the enumerator watch identifier.
List<IEnumBit> enumBitList = Lookup.WatchVariableTableByOldIdentifier.EnumBitLists[m_WatchVariable.EnumBitIdentifier];
for (int enumBitListIndex = 0; enumBitListIndex < enumBitList.Count; enumBitListIndex++)
{
// Add the description/value pairs to the combo box control.
m_ComboBoxNewValue.Items.Add(enumBitList[enumBitListIndex]);
}
// Initialize the Value property.
m_ComboBoxNewValue.Text = m_WatchControl.ValueFieldText;
#region - [Allowable Range] -
// Check that the ComboBox control contains at least 2 entries.
if (m_ComboBoxNewValue.Items.Count > 1)
{
m_LabelAllowableRangeLowerValue.Text = m_ComboBoxNewValue.Items[0].ToString();
m_LabelAllowableRangeUpperValue.Text = m_ComboBoxNewValue.Items[m_ComboBoxNewValue.Items.Count - 1].ToString();
}
#endregion - [Allowable Range] -
// Now that the display has been initialized, disable the apply button. This will only be re-enabled when the user has specified a new watch value.
m_ButtonApply.Enabled = false;
}
/// <summary>
/// Initialize a new instance of the class.
/// </summary>
/// <param name="enumeratorControl">The <c>WatchControl</c> derived user control that called this form.</param>
public FormChangeEnumerator(WatchEnumeratorControl enumeratorControl) : base(enumeratorControl)
{
InitializeComponent();
Debug.Assert(m_WatchVariable != null, "FormChangeEnumerator.Ctor() - [m_WatchVariable != null]");
Debug.Assert(m_WatchVariable.VariableType == VariableType.Enumerator, "FormChangeEnumerator.Ctor() - [m_WatchVariable.VariableType == VariableType.Enumerator]");
// ------------------------
// Initialize the ComboBox.
// ------------------------
// Get the list of enumerator/bitmask (EnumBit) description/value pairs associated with the enumerator watch identifier.
List <IEnumBit> enumBitList = Lookup.WatchVariableTableByOldIdentifier.EnumBitLists[m_WatchVariable.EnumBitIdentifier];
for (int enumBitListIndex = 0; enumBitListIndex < enumBitList.Count; enumBitListIndex++)
{
// Add the description/value pairs to the combo box control.
m_ComboBoxNewValue.Items.Add(enumBitList[enumBitListIndex]);
}
// Initialize the Value property.
m_ComboBoxNewValue.Text = m_WatchControl.ValueFieldText;
#region - [Allowable Range] -
// Check that the ComboBox control contains at least 2 entries.
if (m_ComboBoxNewValue.Items.Count > 1)
{
m_LabelAllowableRangeLowerValue.Text = m_ComboBoxNewValue.Items[0].ToString();
m_LabelAllowableRangeUpperValue.Text = m_ComboBoxNewValue.Items[m_ComboBoxNewValue.Items.Count - 1].ToString();
}
#endregion - [Allowable Range] -
// Now that the display has been initialized, disable the apply button. This will only be re-enabled when the user has specified a new watch value.
m_ButtonApply.Enabled = false;
}
/// <summary>
/// Instantiates a new <c>WatchControl</c> derived user control and configures the properties for each element of <paramref name="watchControls"/> based upon the
/// watch variables specified by <paramref name="oldIdentifierList"/>. Each user control is then added to the <c>Controls</c> property of <paramref name="panel"/>.
/// </summary>
/// <remarks>The length of the array should be equal to the count value associated with the list.</remarks>
/// <param name="watchControls">The array of watch variable user controls that are to be configured.</param>
/// <param name="panel">Reference to the <c>Panel</c> to which the user controls are to be added.</param>
/// <param name="watchControlSize">The structure defining the size related parameters of the user control, <see cref="VariableControlSize_t"/>.</param>
/// <param name="oldIdentifierList">The list of watch variable old identifiers.</param>
/// <exception cref="ArgumentException">Thrown if the number of watch identifier entries in the list is incompatible with the length of the user control array.</exception>
public void ConfigureWatchControls(WatchControl[] watchControls, Panel panel, VariableControlSize_t watchControlSize, List<short> oldIdentifierList)
{
// Skip, if the Dispose() method has been called.
if (m_IsDisposed)
{
return;
}
Debug.Assert(oldIdentifierList.Count == watchControls.Length);
// Work out the spacing between consecutive lines.
int rowSpacing = watchControlSize.Size.Height + watchControlSize.Margin.Vertical;
// Initialize the user controls.
short oldIdentifier;
WatchVariable watchVariable;
for (int rowIndex = 0; rowIndex < oldIdentifierList.Count; rowIndex++)
{
oldIdentifier = oldIdentifierList[rowIndex];
try
{
watchVariable = Lookup.WatchVariableTableByOldIdentifier.Items[oldIdentifier];
if (watchVariable == null)
{
// The specified watch variable is not defined in the current data dictionary therefore display an empty user control showing the 'not-defined' text.
watchControls[rowIndex] = new WatchControl();
}
else
{
switch (watchVariable.VariableType)
{
case VariableType.Scalar:
watchControls[rowIndex] = new WatchScalarControl();
break;
case VariableType.Enumerator:
watchControls[rowIndex] = new WatchEnumeratorControl();
break;
case VariableType.Bitmask:
watchControls[rowIndex] = new WatchBitmaskControl();
break;
default:
break;
}
}
}
catch (Exception)
{
watchVariable = null;
// The specified watch variable is not defined in the current data dictionary therefore display an empty user control showing the 'not-defined' text.
watchControls[rowIndex] = new WatchControl();
}
watchControls[rowIndex].WidthVariableNameField = watchControlSize.WidthVariableNameField;
watchControls[rowIndex].WidthValueField = watchControlSize.WidthValueField;
watchControls[rowIndex].WidthUnitsField = watchControlSize.WidthUnitsField;
watchControls[rowIndex].ClientForm = m_Form;
watchControls[rowIndex].TabIndex = m_TabIndex;
watchControls[rowIndex].Location = new System.Drawing.Point(watchControlSize.Margin.Left, (rowIndex + 1) * rowSpacing);
watchControls[rowIndex].ForeColorValueFieldZero = Color.ForestGreen;
watchControls[rowIndex].ForeColorValueFieldNonZero = Color.ForestGreen;
watchControls[rowIndex].Identifier = oldIdentifier;
if (watchVariable == null)
{
watchControls[rowIndex].AttributeFlags = AttributeFlags.PTUD_NOTUSED;
}
else
{
watchControls[rowIndex].AttributeFlags = (AttributeFlags)watchVariable.AttributeFlags;
}
watchControls[rowIndex].Value = 0;
// Add the user control to the specified panel.
panel.Controls.Add(watchControls[rowIndex]);
}
}