Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ITfRange::IsEmpty method

The ITfRange::IsEmpty method verifies that the range of text is empty because the start and end anchors occupy the same position.

Syntax


HRESULT IsEmpty(
  [in]   TfEditCookie ec,
  [out]  BOOL *pfEmpty
);

Parameters

ec [in]

Edit cookie that identifies the edit context. It is obtained from ITfDocumentMgr::CreateContext or ITfEditSession::DoEditSession.

pfEmpty [out]

Pointer to a Boolean value. TRUE indicates the range is empty; FALSE indicates the range is not empty.

Return value

This method can return one of these values.

ValueDescription
S_OK

The method was successful.

E_FAIL

An unspecified error occurred.

E_INVALIDARG

One or more parameters are invalid.

TF_E_NOLOCK

The value of the ec parameter is an invalid cookie.

 

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

Msctf.h

IDL

Msctf.idl

DLL

Msctf.dll

See also

ITfRange
ITfDocumentMgr::CreateContext
ITfEditSession::DoEditSession

 

 

Community Additions

Show:
© 2014 Microsoft. All rights reserved.