ContourPoint Structure


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Represents changes in pitch for the speech content of a TextFragment.

Namespace:   System.Speech.Synthesis.TtsEngine
Assembly:  System.Speech (in System.Speech.dll)

public struct ContourPoint : IEquatable<ContourPoint>

System_CAPS_pubmethodContourPoint(Single, Single, ContourPointChangeType)

Creates a new instance of the ContourPoint class.


Gets the value that represents the amount to raise or lower the pitch at a point in a TextFragment.


Gets a member of ChangeType that specifies the unit to use for the number specified in the change parameter of a ContourPoint object.


Gets a Single that specifies the point at which to apply the pitch change in a TextFragment. This is expressed as the elapsed percentage of the duration of the TextFragment at that point.


Determines if a given instance of ContourPoint is equal to the current instance of ContourPoint.


Determines if a given object is an instance of ContourPoint and equal to the current instance of ContourPoint.(Overrides ValueType.Equals(Object).)


Returns a hash code for this instance.(Overrides ValueType.GetHashCode().)


Gets the Type of the current instance.(Inherited from Object.)


Returns the fully qualified type name of this instance.(Inherited from ValueType.)

System_CAPS_puboperatorSystem_CAPS_staticEquality(ContourPoint, ContourPoint)

Determines if two instances of ContourPoint are equal.

System_CAPS_puboperatorSystem_CAPS_staticInequality(ContourPoint, ContourPoint)

Determines if two instances of ContourPoint are NOT equal.

The pitch contour is defined as an array of targets at specified time positions in the speech output. Each target is defined by three parameters. The first value is a percentage of the period of the contained text (a number followed by "%"). The second value specifies the amount to raise or lower the pitch. The third value designates the unit to use for the number specified in the second value; either percentage or hertz (Hz).

ContourPoint objects are obtained by the GetContourPoints method, or used to set the pitch contour for a TextFragment by the SetContourPoints method.

.NET Framework
Available since 3.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top