Plug-in Reference — Inline Functions — Editor_InsertClip

# Editor_InsertClip

Inserts text at the specified position in the Clipboard history. You can use this inline function or explicitly send the EE_CLIP_HISTORY message.

Editor_InsertClip( HWND hwnd, LPCWSTR pszText, UINT iPos, UINT nFlags );

## Parameters

hwnd

Specifies the window handle of the view or frame of EmEditor.

pszText

Specifies the text to be inserted.

iPos

Specifies the old position in the Clipboard history.

nFlags

Specifies the format of the Clipboard to be inserted or removed.

SEL_TYPE_CHAR | The Clipboard format is normal text.
SEL_TYPE_LINE | The Clipboard format is lines of text.
SEL_TYPE_BOX | The Clipboard format is vertical selection of text.

## Return Values

The return value is the position in the Clipboard history where the new text is inserted. If the message fails, the return value is -1.

## Version

Supported on EmEditor Version 9.00 or later.