Dundas Chart for ASP.NET
FindMaxValue(String,Int32) Method
See Also  Example Send comments on this topic.
Dundas.Charting.WebControl Namespace > DataPointCollection Class > FindMaxValue Method : FindMaxValue(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 maximum value, and can be used in a loop to locate ALL data points in the collection with this maximum value. The search starts at the specified index.  
Find first point with Max value from specified index.

Syntax

Visual Basic (Declaration)  
Public Overloads Function FindMaxValue( _
   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.FindMaxValue(useValue, startFromIndex)
C#  
public DataPoint FindMaxValue( 
   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 maximum 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 maximum second Y-value. We then change the color of all returned data points.

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

    ' Declare data point index
    Dim index As Integer = 0

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

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

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

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

Remarks

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

There may be more than one data point in the collection with a maximum value, and it is this maximum 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 maximum 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

Copyright © 2001 - 2009 Dundas Data Visualization, Inc. and others.