ParameterFieldDefinition.ApplyMinMaxValues Method
Applies the maximum and minimum values to a specified parameter in a report.
Namespace CrystalDecisions.CrystalReports.Engine Assembly CrystalDecisions.CrystalReports.Engine (CrystalDecisions.CrystalReports.Engine.dll)
Syntax
'Declaration
Public Overrideable Sub ApplyMinMaxValues ( _
ByVal minValue As Object, _
ByVal maxValue As Object _
)
public virtual void ApplyMinMaxValues (
object minValue,
object maxValue
)
Parameters
- minValue
Indicates the minimum allowable value for the parameter.
- maxValue
Indicates the maximum allowable value for the parameter.
Remarks
The following rules apply with regards to minimum and maximum values:
- String parameter fields: The parameters provide the maximum and minimum lengths of the string, not a value range.
- Boolean parameter fields: The properties do not apply.
- The minimum value set should fall within the scope of the EditMask, MaximumValue, and MinimumValue properties, if set. For more information on edit masks see Limiting Entry Type and Format in Parameters.
Example
The following example sets the current values for a ranged parameter, sets the default value for a discrete parameter, and sets the minimum and maximum values for a discrete parameter.
'Declaration
Private Sub SetParameters( _
ByVal startValue As Double, ByVal endValue As Double, _
ByVal discreteValue1 As Integer, _
ByVal discreteValue2 As Integer, _
ByVal minValue As Integer, ByVal maxValue As Integer)
Dim discreteParam As New ParameterDiscreteValue()
Dim rangeParam As New ParameterRangeValue()
Dim paramField As ParameterFieldDefinition
Dim currentValues As ParameterValues
Dim defaultValues As ParameterValues
paramField = _
Report.DataDefinition.ParameterFields.Item("RangedParam")
rangeParam.StartValue = startValue
rangeParam.EndValue = endValue
currentValues = paramField.CurrentValues
currentValues.Add(rangeParam)
paramField.ApplyCurrentValues(currentValues)
paramField = _
Report.DataDefinition.ParameterFields.Item("DiscreteParam", "sub1")
paramField.ApplyMinMaxValues(minValue, maxValue)
discreteParam.Value = discreteValue1
defaultValues = paramField.DefaultValues
defaultValues.Add(discreteParam)
paramField.ApplyDefaultValues(defaultValues)
discreteParam = New ParameterDiscreteValue()
discreteParam.Value = discreteValue2
defaultValues = paramField.DefaultValues
defaultValues.Add(discreteParam)
paramField.ApplyDefaultValues(defaultValues)
End Sub
void SetParameters(float startValue, float endValue,
int discreteValue1, int discreteValue2, int minValue,
int maxValue)
{
ParameterDiscreteValue* discreteParam = new
ParameterDiscreteValue();
ParameterRangeValue* rangeParam = new ParameterRangeValue();
ParameterFieldDefinition* paramField;
ParameterValues* currentValues;
ParameterValues* defaultValues;
paramField =
Report->DataDefinition->ParameterFields->Item["RangedParam"];
rangeParam->StartValue = __box(startValue);
rangeParam->EndValue = __box(endValue);
currentValues = paramField->CurrentValues;
currentValues->Add(rangeParam);
paramField->ApplyCurrentValues(currentValues);
paramField = Report->DataDefinition->ParameterFields->Item
["DiscreteParam", "sub1"];
paramField->ApplyMinMaxValues(__box(minValue), __box(maxValue));
discreteParam->Value = __box(discreteValue1);
defaultValues = paramField->DefaultValues;
defaultValues->Add(discreteParam);
paramField->ApplyDefaultValues(defaultValues);
discreteParam = new ParameterDiscreteValue();
discreteParam->Value = __box(discreteValue2);
defaultValues = paramField->DefaultValues;
defaultValues->Add(discreteParam);
paramField->ApplyDefaultValues(defaultValues);
};
private void SetParameters(float startValue, float endValue,
int discreteValue1, int discreteValue2, int minValue,
int maxValue)
{
ParameterDiscreteValue discreteParam = new
ParameterDiscreteValue();
ParameterRangeValue rangeParam = new ParameterRangeValue();
ParameterFieldDefinition paramField;
ParameterValues currentValues;
ParameterValues defaultValues;
paramField =
Report.DataDefinition.ParameterFields["RangedParam"];
rangeParam.StartValue = startValue;
rangeParam.EndValue = endValue;
currentValues = paramField.CurrentValues;
currentValues.Add(rangeParam);
paramField.ApplyCurrentValues(currentValues);
paramField = Report.DataDefinition.ParameterFields
["DiscreteParam", "sub1"];
paramField.ApplyMinMaxValues(minValue, maxValue);
discreteParam.Value = discreteValue1;
defaultValues = paramField.DefaultValues;
defaultValues.Add(discreteParam);
paramField.ApplyDefaultValues(defaultValues);
discreteParam = new ParameterDiscreteValue();
discreteParam.Value = discreteValue2;
defaultValues = paramField.DefaultValues;
defaultValues.Add(discreteParam);
paramField.ApplyDefaultValues(defaultValues);
}
Version Information
Crystal Reports Basic for Visual Studio 2008
Supported since: Crystal Reports for Visual Studio .NET 2002
See Also
Reference
ParameterFieldDefinition Class
ParameterFieldDefinition Members
CrystalDecisions.CrystalReports.Engine Namespace