Поделиться через

Метод ITextStoreACP::GetTextExt (texttor.h)

  • Статья

Метод ITextStoreACP::GetTextExt возвращает ограничивающий прямоугольник текста в указанной позиции символа в координатах экрана. Перед вызовом этого метода вызывающий объект должен иметь блокировку только для чтения в документе.

Синтаксис

HRESULT GetTextExt(
  [in]  TsViewCookie vcView,
  [in]  LONG         acpStart,
  [in]  LONG         acpEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Параметры

[in] vcView

Указывает представление контекста.

[in] acpStart

Задает начальную позицию символа текста, который необходимо получить в документе.

[in] acpEnd

Указывает конечную позицию символа текста, который необходимо получить в документе.

[out] prc

Получает ограничивающее поле в экранных координатах текста в указанных положениях символов.

[out] pfClipped

Получает логическое значение, указывающее, был ли обрезан текст в ограничивающем прямоугольнике. Если этот параметр имеет значение TRUE, ограничивающий прямоугольник содержит обрезанный текст и не включает весь запрошенный диапазон текста. Ограничивающий прямоугольник обрезается, так как запрошенный диапазон не отображается.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение Описание
S_OK
 Метод выполнен успешно.
TS_E_INVALIDARG
 Указанные начальные и конечные позиции символов равны.
TS_E_INVALIDPOS
 Диапазон, заданный параметрами acpStart и acpEnd , распространяется за пределы начала или конца документа.
TS_E_NOLAYOUT
 Приложение не вычислило макет текста.
TS_E_NOLOCK
 Вызывающий объект не имеет блокировки только для чтения в документе.

Комментарии

Если окно документа свернуто или указанный текст в настоящее время не отображается, метод возвращает S_OK с параметром PRC , равным {0,0,0,0}.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header textstor.h
DLL Msctf.dll
Распространяемые компоненты TSF 1.0 в Windows 2000 Профессиональная

См. также раздел

ITextStoreACP

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt