TextRange.SetDataObject Method

TOM Classes for .NET

TextObjectModel

TextRange Class

TextRange Methods

DeleteSubrange Method

GetEmbeddedObject Method

GetHashCode Method

GetIndex Method

GetMathFunctionType Method

MoveStartUntil Method

MoveStartWhile Method

MoveUntil Method

MoveWhile Method

Paste Method

ScrollIntoView Method

Select Method

SetActiveSubrange Method

SetDataObject Method

SetDropCap Method

SetFormattedText Method

TextRangeSetDataObject Method

Replaces the text in the range with the specified data object.

Namespace: TextObjectModel
Assembly: ManagedTOM2 (in ManagedTOM2.dll) Version: 1.0.5577.41188

Syntax

C++

Copy

public void SetDataObject(
	IDataObject o
)

Public Sub SetDataObject ( 
	o As IDataObject
)

public:
void SetDataObject(
	IDataObject^ o
)

Parameters

o: Type: System.Windows.FormsIDataObject
The data object containing the new text.

Exceptions

Exception	Condition
ArgumentNullException	o is null.

Remarks

The data object may contain:

Text
UnicodeText
Rtf
Bitmap (image)
Dib (image)
MetafilePict (image)
FileDrop (OLE object)
...as well as several other formats

Different implementations of the Text Object Model (TOM) may support different formats.

Examples

The following example demonstrates how to set the text in a range using an IDataObject:

Copy

void SetDataObjectExample(TextRange range) {
    DataObject data = new DataObject();
    data.SetText("Example text");

    range.SetDataObject(data);
}

Reference

TextRange Class

TextObjectModel Namespace