NewTextNote Method (View, XYZ, XYZ, XYZ, Double, TextAlignFlags, String)
Creates a new TextNote object without a leader.

Namespace: Autodesk.Revit.Creation
Assembly: RevitAPI (in RevitAPI.dll) Version: 2015.0.0.0 (2015.0.0.0)

Syntax

C#
public TextNote NewTextNote(
	View pView,
	XYZ origin,
	XYZ baseVec,
	XYZ upVec,
	double lineWidth,
	TextAlignFlags textAlign,
	string strText
)
Visual Basic
Public Function NewTextNote ( _
	pView As View, _
	origin As XYZ, _
	baseVec As XYZ, _
	upVec As XYZ, _
	lineWidth As Double, _
	textAlign As TextAlignFlags, _
	strText As String _
) As TextNote
Visual C++
public:
TextNote^ NewTextNote(
	View^ pView, 
	XYZ^ origin, 
	XYZ^ baseVec, 
	XYZ^ upVec, 
	double lineWidth, 
	TextAlignFlags textAlign, 
	String^ strText
)

Parameters

pView
Type: Autodesk.Revit.DB..::..View
The view where the text note object will be visible.
origin
Type: Autodesk.Revit.DB..::..XYZ
The origin of the text note.
baseVec
Type: Autodesk.Revit.DB..::..XYZ
The horizontal direction for text in the text note.
upVec
Type: Autodesk.Revit.DB..::..XYZ
The vertical direction for text in the text note.
lineWidth
Type: System..::..Double
The width of the rectangle bounding the note text.
textAlign
Type: Autodesk.Revit.DB..::..TextAlignFlags
Flags indicating the alignment of the note. This should be a bitwise OR including one of TEF_ALIGN_TOP, TEF_ALIGN_MIDDLE and TEF_ALIGN_BOTTOM and one of TEF_ALIGN_LEFT, TEF_ALIGN_CENTER and TEF_ALIGN_RIGHT. The defaults for this flag are TEF_ALIGN_TOP | TEF_ALIGN_LEFT.
strText
Type: System..::..String
Text to display in the text note. Include new line characters to force a multiple line note to be created. Notes may also wrap automatically based on the width of the note rectangle.

Return Value

If successful, a TextNote object is returned.

Exceptions

ExceptionCondition
Autodesk.Revit.Exceptions..::..ArgumentNullException Thrown when any one of pView, origin, baseVec, upVec, strText is nullNothingnullptra null reference (Nothing in Visual Basic).
Autodesk.Revit.Exceptions..::..ArgumentException Thrown when the input lineWidth is not a finite number.
Autodesk.Revit.Exceptions..::..ArgumentOutOfRangeException Thrown when the input textAlign is not a valid TextAlignFlags or it is not a valid bitwise OR of the align flags.
Autodesk.Revit.Exceptions..::..InvalidOperationExceptionIf the regeneration fails when creating the text note.

See Also

M:Autodesk.Revit.Creation.ItemFactoryBase.NewTextNote(Autodesk.Revit.DB.View,Autodesk.Revit.DB.XYZ,Autodesk.Revit.DB.XYZ,Autodesk.Revit.DB.XYZ,System.Double,Autodesk.Revit.DB.TextAlignFlags,System.String)