LineSegment Class
Assembly: PresentationCore (in presentationcore.dll)
XML Namespace: http://schemas.microsoft.com/winfx/2006/xaml/presentation
Use a PathFigure object to store LineSegment objects and other segments.
The LineSegment class does not contain a property for the starting point of the line. The starting point of the line is the current point of the PathFigure object where the line is added.
Freezable Features: Because LineSegment objects inherit from the Freezable class, they provide several special features: they can be declared as resources, shared among multiple objects, made read-only to improve performance, cloned, and made thread-safe. For more information about the different features that are provided by Freezable objects, see the Freezable Objects Overview.
This example shows how to create a line segment. To create a line segment, use the PathGeometry, PathFigure, and LineSegment classes.
The following examples draw a LineSegment from (10, 50) to (200, 70). The following illustration shows the resulting LineSegment; a grid background was added to show the coordinate system.
A LineSegment drawn from (10,50) to (200,700)
In Extensible Application Markup Language (XAML), you may use attribute syntax to describe a path.
<Path Stroke="Black" StrokeThickness="1" Data="M 10,50 L 200,70" />
(Note that this attribute syntax actually creates a StreamGeometry, a lighter-weight version of a PathGeometry. For more information, see the Path Markup Syntax page.)
In XAML, you may also draw a line segment by using object element syntax. The following is equivalent to the previous XAML example.
PathFigure myPathFigure = new PathFigure(); myPathFigure.StartPoint = new Point(10, 50); LineSegment myLineSegment = new LineSegment(); myLineSegment.Point = new Point(200, 70); PathSegmentCollection myPathSegmentCollection = new PathSegmentCollection(); myPathSegmentCollection.Add(myLineSegment); myPathFigure.Segments = myPathSegmentCollection; PathFigureCollection myPathFigureCollection = new PathFigureCollection(); myPathFigureCollection.Add(myPathFigure); PathGeometry myPathGeometry = new PathGeometry(); myPathGeometry.Figures = myPathFigureCollection; Path myPath = new Path(); myPath.Stroke = Brushes.Black; myPath.StrokeThickness = 1; myPath.Data = myPathGeometry;
<Path Stroke="Black" StrokeThickness="1"> <Path.Data> <PathGeometry> <PathFigure StartPoint="10,50"> <LineSegment Point="200,70" /> </PathFigure> </PathGeometry> </Path.Data> </Path>
This example is part of larger sample; for the complete sample, see the Geometries Sample.
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.