TextRange Object Members

Contains the text that's attached to a shape, as well as properties and methods for manipulating the text. This topic describes how to: Return the text range in any shape you specify. Return a text range from the selection. Return particular characters, words, lines, sentences, or paragraphs from a text range. Insert text, the date and time, or the page number into a text range.

Methods

	Name	Description
	Characters	Returns a TextRange object that represents the specified subset of text characters.
	Collapse	Collapses a range or selection to the starting or ending position. After a range or selection is collapsed, the starting and ending points are equal.
	Copy	Copies the specified object to the Clipboard.
	Cut	Deletes the specified object and places it on the Clipboard.
	Delete	Deletes the specified object.
	Expand	Expands the specified range or selection. Returns or sets a Long that represents the number of specified units added to the range or selection.
	InsertAfter	Returns a TextRange object that represents text appended to the end of a text range.
	InsertBarcode	Inserts a bar code field at the end of the text range represented by the parent TextRange object.
	InsertBefore	Appends a string to the beginning of the specified text range. Returns a TextRange object that represents the appended text. When used without an argument, this method returns a zero-length string at the end of the specified range.
	InsertDateTime	Returns a TextRange object that represents the date and time inserted into a specified text range.
	InsertMailMergeField	Returns a TextRange object that represents a text data field for a mail merge or catalog merge.
	InsertPageNumber	Returns a TextRange object that represents a page number field in a publication.
	InsertSymbol	Returns a TextRange object that represents a symbol inserted in place of the specified range or selection.
	Lines	Returns a TextRange object that represents the specified lines.
	Move	Collapses the specified range to its start position or end position and then moves the collapsed object by the specified number of units. This method returns a Long that represents the number of units by which the object was actually moved, or it returns 0 (zero) if the move was unsuccessful.
	MoveEnd	Moves the ending character position of a range. This method returns a Long that represents the number of units the range or selection actually moved or returns 0 (zero) if the move was unsuccessful.
	MoveStart	Moves the start position of the specified range. This method returns a Long that indicates the number of units by which the start position or the range or selection actually moved, or it returns 0 (zero) if the move was unsuccessful.
	Paragraphs	Returns a TextRange object that represents the specified paragraphs.
	Paste	Pastes the text on the Clipboard into the specified text range, and returns a TextRange object that represents the pasted text.
	Select	Selects the specified object.
	Words	Returns a TextRange object that represents the specified subset of text words.

Properties

	Name	Description
	Application	Used without an object qualifier, this property returns an Application object that represents the current instance of Publisher. Used with an object qualifier, this property returns an Application object that represents the creator of the specified object. When used with an OLE Automation object, it returns the object's application.
	BoundHeight	Returns a Single indicating the height, in points, of the bounding box for the specified text range. Read-only.
	BoundLeft	Returns a Single indicating the distance, in points, from the left edge of the leftmost page to the left edge of the bounding box for the specified text range. Read-only.
	BoundTop	Returns a Single indicating the distance, in points, from the top edge of the topmost page to the top edge of the bounding box for the specified text range. Read-only.
	BoundWidth	Returns a Single indicating the width, in points, of the bounding box for the specified text range. Read-only.
	ContainingObject	Returns an Object that represents the object that contains the text range. Read-only.
	DropCap	Returns a DropCap object that represents a dropped capital letter for the paragraphs in the specified text frame.
	Duplicate	Returns a TextRange object that represents a duplicate of the specified text range.
	End	Sets or returns a Long that represents the ending character position of a selection or text range. Read/write.
	Fields	Returns a Fields object that represents all the fields in the specified text range.
	Find	Returns a FindReplace object from the specified TextRange object. The FindReplace object is used to perform a text search and replace in the specified text range.
	Font	Sets or returns a Font object that represents character formatting attributes applied to the specified object. Read/write.
	Hyperlinks	Returns a Hyperlinks collection representing all the hyperlinks in the specified text range.
	InlineShapes	Returns an InlineShapes collection, which represents the inline shapes contained within a text range. Read-only.
	LanguageID	Returns or sets a MsoLanguageID constant that represents the language for the specified object. Read/write.
	Length	Returns a Long value indicating the length of the specified text range, in characters. Read-only.
	LinesCount	Returns the number of lines of text in the text range represented by the parent TextRange object. Read-only.
	MajorityFont	Returns a Font object that represents the font name most in use in a text range.
	MajorityParagraphFormat	Returns a ParagraphFormat object that represents the paragraph formatting applied to most of the paragraphs in a text range.
	ParagraphFormat	Returns a ParagraphFormat object that represents the paragraph formatting for the specified text range or text style.
	ParagraphsCount	Returns the number of paragraphs of text in the text range represented by the parent TextRange object. Read-only.
	Parent	Returns an object that represents the parent object of the specified object. For example, for a TextFrame object, returns a Shape object representing the parent shape of the text frame. Read-only.
	Script	Returns a PbFontScriptType constant that represents the font script for a text range. Read-only.
	Start	Returns or sets a Long that represents the starting character position of a text range. Read/write.
	Story	Returns a Story object that represents the story properties in a text range.
	Text	Returns or sets a String that represents the text in a text range or WordArt shape. Read/write.
	WordsCount	Returns the number of words in the text range represented by the parent TextRange object. Read-only.