Dundas Chart for Windows Forms
FindMinValue(String,Int32) Method
See Also  Example Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > DataPointCollection Class > FindMinValue Method : FindMinValue(String,Int32) Method


useValue

The point value to be examined (e.g. X, Y, Y2, etc.).


Which point value to use (X, Y1, Y2,...).
startFromIndex

The location within the collection to start the search at (0-based). If a data point is found this parameter will be populated with the index of the returned data point, otherwise it will be set to negative one (-1).


Index of the point to start looking from. Returns index of found point or -1.

Returns the first data point with a minimum value, and can be used in a loop to locate ALL data points in the collection with this minimum value. The search starts at the specified index.


Find first point with Min value from specified index.

Syntax

Visual Basic (Declaration)  
Public Overloads Function FindMinValue( _
   ByVal useValue As String, _
   ByRef startFromIndex As Integer _
) As DataPoint
Visual Basic (Usage) Copy Code
Dim instance As DataPointCollection
Dim useValue As String
Dim startFromIndex As Integer
Dim value As DataPoint
 
value = instance.FindMinValue(useValue, startFromIndex)
C#  
public DataPoint FindMinValue( 
   string useValue,
   ref int startFromIndex
)

Parameters

useValue

The point value to be examined (e.g. X, Y, Y2, etc.).


Which point value to use (X, Y1, Y2,...).
startFromIndex

The location within the collection to start the search at (0-based). If a data point is found this parameter will be populated with the index of the returned data point, otherwise it will be set to negative one (-1).


Index of the point to start looking from. Returns index of found point or -1.

Return Value

A DataPoint object in the DataPointCollection with the minimum specified value. If no data point is found then null will be returned.


Found point or null.

Example

The following sample returns ALL data points with the minimum second Y-value. We then change the color of all returned data points.

Visual Basic Copy Code
Imports Dundas.Charting.WinControl
...

    ' Declare data point index
    Dim index As Integer = 0

    ' Find all points that have a minimum second Y value, and change their color
    Dim dataPoint As DataPoint = chart1.Series(0).Points.FindMinValue("Y2",ref index)

    ' Find any other points that have minimum value
    While Not dataPoint Is Nothing
        dataPoint.Color = Color.FromArgb(255, 128, 128)
        index = index + 1
        dataPoint = chart1.Series(0).Points.FindMinValue("Y2", index)
    End While

...
C# Copy Code
using Dundas.Charting.WinControl
...
   
   
// Declare data point index
   
int index = 0;
   
   
// Find all points that have a minimum second Y value, and change their color
   
DataPoint dataPoint = chart1.Series[0].Points.FindMinValue("Y2", ref index);

   
// Find any other points that have minimum value
   
while (dataPoint != null)
   {
       dataPoint.Color = Color.FromArgb(255, 128, 128);
       index = index + 1;
       dataPoint = chart1.Series[0].Points.FindMinValue(
"Y2", ref index);
   }
   
...

Remarks

This method starts the search at the specified index, and will return the first data point with the minimum value.

There may be more than one data point in the collection with a minimum value, and it is this minimum value that determines if a data point is returned. This definition can be used in a loop to locate ALL points in the collection that have a maximum value, and is accomplished by incrementing the startFromIndex parameter in the loop that is performing the search (see sample code below).

Note that a point will only be returned if its value is the minimum for all points in the collection.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2009 All Rights Reserved.