Routines (alphabetical) > Object Classes > Graphics Object Classes > IDLgrTextEdit::Insert

# IDLgrTextEdit::Insert

Syntax | Arguments | Keywords | Examples | Version History

The IDLgrTextEdit::Insert procedure method inserts text at the current cursor position. If text is selected, it overwrites the selected text and sets the selection length to zero. (See the SELECTION_LENGTH property of the IDLgrText object for more information.)

## Syntax

Obj->[IDLgrTextEdit::]Insert, Text

## Arguments

### Text

A string containing the text to be inserted.

## Keywords

None

## Examples

### Example 1

oWindow = OBJ_NEW('IDLgrWindow', RETAIN=2)
oView = Obj_new('idlgrview')
oModel = OBJ_NEW('IDLgrModel')
oView->Add, oModel
oText = obj_new('idlgrtextedit', 'This is a string', $
FONT=oFont, LOCATIONS=[-0.9,0])
oModel->Add, oText
oWindow->Draw, oView
oText->SetProperty, SELECTION_START=10, /DRAW_CURSOR
oWindow->Draw, oView

To add another string at this position, use:

oText->Insert, 'longer '
oWindow->Draw, oView

Which results in the following sting:

Destroy the IDLgrWindow and IDLgrView objects before we proceed:

OBJ_DESTROY, [oWindow, oView, oFont]

### Example 2

The next example shows selected text in a string that will be replaced using INSERT:

oWindow = OBJ_NEW('IDLgrWindow')
oView = Obj_new('idlgrview')
oModel = OBJ_NEW('IDLgrModel')
oView->Add, oModel
oText = obj_new('idlgrtextedit', 'A cute dog', $
FONT=oFont, LOCATIONS=[-0.9,0])
oModel->Add, oText
oText->SetProperty, SELECTION_START=2, SELECTION_LENGTH=4, $
/DRAW_CURSOR
oWindow->Draw, oView

To replace the selected string with the word “brown,” use:

oText->Insert, 'brown'
oWindow->Draw, oView

Which results in the following string:

Destroy the IDLgrWindow and IDLgrView objects.

OBJ_DESTROY, [oWindow, oView, oFont]

## Version History

7.0.6 | Introduced