Title Class

.NET Framework (current version)

Represents a title for the entire chart image.

Namespace: System.Web.UI.DataVisualization.Charting
Assembly: System.Web.DataVisualization (in System.Web.DataVisualization.dll)

Inheritance Hierarchy

System::Object
System.Web.UI.DataVisualization.Charting::ChartElement
System.Web.UI.DataVisualization.Charting::ChartNamedElement
System.Web.UI.DataVisualization.Charting::Title

Syntax

C++

public ref class Title : ChartNamedElement, IDisposable, IChartMapArea

Constructors

	Name	Description
	Title()	Initializes a new instance of the Title class.
	Title(String^)	Initializes a new instance of the Title class with the specified title text.
	Title(String^, Docking)	Initializes a new instance of the Title class with the specified title text and docking value.
	Title(String^, Docking, Font^, Color)	Initializes a new instance of the Title class with the specified title text, docking value, font and color.

Properties

	Name	Description
	Alignment	Gets or sets the alignment of the title.
	BackColor	Gets or sets the background color of the title.
	BackGradientStyle	Gets or sets the orientation for the background gradient of a title. Also determines whether a gradient is used.
	BackHatchStyle	Gets or sets the hatching style for the title.
	BackImage	Gets or sets the background image of the title.
	BackImageAlignment	Gets or sets the alignment of the title background image.
	BackImageTransparentColor	Gets or sets a color that will be drawn as transparent when the background image is drawn.
	BackImageWrapMode	Gets or sets the drawing mode for the background image of the title.
	BackSecondaryColor	Gets or sets the secondary color of the title background.
	BorderColor	Gets or sets the border color of the title.
	BorderDashStyle	Gets or sets the border style of the title.
	BorderWidth	Gets or sets the border width of the title.
	DockedToChartArea	Gets or sets the name of the ChartArea where the title will be docked.
	Docking	Gets or sets a value that determines where the title is docked.
	DockingOffset	Gets or sets the positive or negative offset of the docked title position.
	Font	Gets or sets the font for the title.
	ForeColor	Gets or sets the color of the title text.
	IsDockedInsideChartArea	Gets or sets a flag that specifies whether the title should be docked within a ChartArea object.
	MapAreaAttributes	Gets or sets the map area attributes of the title.
	Name	Gets or sets the unique name of a Title object.(Overrides ChartNamedElement::Name.)
	Position	Gets or sets an ElementPosition object, which can be used to get or set the position of the title.
	PostBackValue	Gets or sets the postback value that can be processed on a Click event.
	ShadowColor	Gets or sets the shadow color for the title.
	ShadowOffset	Gets or sets the shadow offset, in pixels, of the title.
	Tag	Gets or sets an object associated with this chart element.(Inherited from ChartElement.)
	Text	Gets or sets the text for the title.
	TextOrientation	Gets or sets the orientation of the text in the title.
	TextStyle	Gets or sets the style of the text for the title.
	ToolTip	Gets or sets the tooltip for the title.
	Url	Gets or sets the target URL of the hyperlink for the title.
	Visible	Gets or sets a value that indicates whether the title is visible.

Methods

	Name	Description
	Dispose()	Releases the resources used by the ChartElement.(Inherited from ChartElement.)
	Dispose(Boolean)	Releases the unmanaged resources used by the Title and optionally releases the managed resources.(Overrides ChartElement::Dispose(Boolean).)
	Equals(Object^)	Determines whether the specified Object is equal to the current ChartElement.(Inherited from ChartElement.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Returns a hash function for a particular type.(Inherited from ChartElement.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	ToString()	Returns a string that represents the current Object.(Inherited from ChartElement.)

Remarks

The Title class encapsulates all the functionality of a title for the Chart control. This class is exposed using the Titles collection property of the root Chart object.

There can be any number of titles for an entire chart image.

Titles are able to:

Be docked and aligned or custom-positioned.
Be displayed inside or outside the plotted chart areas.
Use a predefined TextStyle such as Embed or Shadow.
Use hatching, gradient colors and background images.
Be sized and positioned anywhere within the chart image.

Version Information

.NET Framework
Available since 4.0

Thread Safety

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