Creates a new grid line.
Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 26.1.0.0 (26.1.0.34)
Syntax
C#
public static Grid Create( Document document, Line line )
Parameters
- document Document
- The document in which the new instance is created.
- line Line
- A line which represents the location of the grid line.
Return Value
GridThe newly created grid.
Exceptions
Exception | Condition |
---|---|
ArgumentException | document is not a project document. -or- The input line is not on a horizontal plane. |
ArgumentNullException | A non-optional argument was null |
Remarks
The line should be on a horizontal plane.Example
C#
// Create the geometry line which the grid locates XYZ start = new XYZ(0, 0, 0); XYZ end = new XYZ(30, 30, 0); Line geomLine = Line.CreateBound(start, end); // Create a grid using the geometry line Grid lineGrid = Grid.Create(document, geomLine); if (null == lineGrid) { throw new Exception("Create a new straight grid failed."); } // Modify the name of the created grid lineGrid.Name = "New Name1";
VB
' Create the geometry line which the grid locates Dim start As New XYZ(0, 0, 0) Dim [end] As New XYZ(30, 30, 0) Dim geomLine As Line = Line.CreateBound(start, [end]) ' Create a grid using the geometry line Dim lineGrid As Grid = Grid.Create(document, geomLine) If lineGrid Is Nothing Then Throw New Exception("Create a new straight grid failed.") End If ' Modify the name of the created grid lineGrid.Name = "New Name1"