Метод ITfContextOwner::GetTextExt (msctf.h)
Метод ITfContextOwner::GetTextExt возвращает ограничивающее поле в координатах экрана текста в указанной позиции символа. Перед вызовом этого метода у вызывающего объекта должна быть блокировка документа только для чтения.
Синтаксис
HRESULT GetTextExt(
[in] LONG acpStart,
[in] LONG acpEnd,
[out] RECT *prc,
[out] BOOL *pfClipped
);
Параметры
[in] acpStart
Задает начальную позицию символа текста, который нужно получить в документе.
[in] acpEnd
Указывает конечную позицию символа текста, который необходимо получить в документе.
[out] prc
Получает ограничивающий прямоугольник в координатах экрана для текста в указанных положениях символов.
[out] pfClipped
Получает логическое значение, указывающее, был ли обрезан текст в ограничивающем поле. Если этот параметр имеет значение TRUE, ограничивающее поле содержит обрезанный текст и не включает весь запрошенный диапазон текста. Ограничивающий прямоугольник обрезается, так как запрошенный диапазон не отображается.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Указанные начальные и конечные позиции символов равны. |
|
Диапазон, заданный параметрами acpStart и acpEnd , распространяется за пределы конца документа или его верхней части. |
|
Приложение не вычислило макет текста. |
|
Вызывающий объект не имеет блокировки только для чтения в документе. |
Комментарии
Если окно документа свернуто или указанный текст в настоящее время не отображается, метод возвращает S_OK с параметром prc , равным {0,0,0,0}.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | msctf.h |
| DLL | Msimtf.dll |
| Распространяемые компоненты | TSF 1.0 в Windows 2000 Professional |