Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ITextStoreAnchor::InsertTextAtSelection method

Syntax


HRESULT InsertTextAtSelection(
  [in]   DWORD dwFlags,
  [in]   const WCHAR *pchText,
  [in]   ULONG cch,
  [out]  IAnchor **ppaStart,
  [out]  IAnchor **ppaEnd
);

Parameters

dwFlags [in]

Specifies whether the paStart and paEnd parameters will contain the results of the text insertion.

The TF_IAS_NOQUERY and TF_IAS_QUERYONLY flags cannot be combined.

ValueMeaning
TF_IAS_NOQUERY

Text is inserted, and the values of the ppaStart and ppaEnd parameters can be NULL. Use this flag if the results of the text insertion are not required.

TF_IAS_QUERYONLY

Text is not inserted, and the ppaStart and ppaEnd anchors contain the results of the text insertion. The values of these parameters depend on how the application implements text insertion into a document. Use this flag to view the results of the text insertion without actually inserting the text. Zero-length text can be inserted.

 

pchText [in]

Pointer to the string to insert in the document. The string can be NULL terminated.

cch [in]

Specifies the text length.

ppaStart [out]

Pointer to the anchor object at the start of the text insertion.

ppaEnd [out]

Pointer to the anchor object at the end of the text insertion. For an insertion point, this parameter value will be the same as the value of the ppaStart parameter.

Return value

This method can return one of these values.

ValueDescription
S_OK

The method was successful.

E_FAIL

The method could not instantiate one of the anchors paStart or paEnd.

E_INVALIDARG

The pchText parameter is invalid.

TS_E_NOLOCK

The caller does not have a lock on the document.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Redistributable

TSF 1.0 on Windows 2000 Professional

Header

Textstor.h

IDL

Textstor.idl

DLL

Msctf.dll

See also

ITextStoreAnchor
ITextStoreAnchorSink::OnTextChange
TF_IAS_* Constants
TS_TEXTCHANGE
Compositions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.