Метод ITextStoreACP2::GetText (texttor.h)
Возвращает сведения о тексте в указанной позиции символа. Этот метод возвращает видимый и скрытый текст и указывает, присоединены ли внедренные данные к тексту.
Синтаксис
HRESULT GetText(
[in] LONG acpStart,
[in] LONG acpEnd,
[out] WCHAR *pchPlain,
[in] ULONG cchPlainReq,
[out] ULONG *pcchPlainRet,
[out] TS_RUNINFO *prgRunInfo,
[in] ULONG cRunInfoReq,
[out] ULONG *pcRunInfoRet,
[out] LONG *pacpNext
);
Параметры
[in] acpStart
Задает начальную позицию символа.
[in] acpEnd
Указывает конечную позицию символа. Если этот параметр имеет значение -1, возвращается весь текст в текстовом хранилище.
[out] pchPlain
Указывает буфер для получения данных в виде обычного текста. Если этот параметр имеет значение NULL, то параметр cchPlainReq должен иметь значение 0.
[in] cchPlainReq
Указывает количество символов в виде обычного текста, переданных методу .
[out] pcchPlainRet
Получает количество символов, скопированных в буфер обычного текста. Этот параметр не может иметь значение NULL. Используйте параметр , если значения не требуются.
[out] prgRunInfo
Получает массив структур TS_RUNINFO . Может иметь значение NULL , только если cRunInfoReq = 0.
[in] cRunInfoReq
Указывает размер (в символах) буфера выполнения текста.
[out] pcRunInfoRet
Получает количество TS_RUNINFO структур, записанных в буфер выполнения текста. Этот параметр не может иметь значение NULL.
[out] pacpNext
Получает позицию следующего непрочитанного символа. Не может иметь значение NULL.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Параметры acpStart или acpEnd находятся за пределами текста документа. |
|
Вызывающий объект не имеет блокировки только для чтения в документе. |
Комментарии
Вызывающие стороны, использующие этот метод, должны иметь блокировку только для чтения для документа путем вызова метода RequestLock . Без блокировки только для чтения метод завершается сбоем и возвращает TF_E_NOLOCK.
Приложения также могут усечь возвращаемые значения метода по внутренним причинам. Вызывающие стороны должны тщательно изучить возвращаемые символы и число выполнений текста, чтобы получить необходимые возвращаемые значения. Если возвращаемые значения неполны, повторно вызывайте метод до тех пор, пока возвращаемые значения не будут завершены.
Вызывающий объект может запрашивать только обычный текст, задав для параметра cRunInfoReq значение 0, а для параметра prgRunInfo — значение NULL. Вызывающий объект может запрашивать только данные выполнения текста, задав для параметра cchPlainReq значение 0, а для параметра pchPlain значение NULL. Однако вызывающий объект должен по-прежнему предоставлять допустимые значения, отличные от NULL , для pcchPlainRet, даже если этот параметр не используется.
Если acpEnd имеет значение -1, то он должен обрабатываться так, как если бы задано в конце потока. В противном случае значение будет больше или равно нулю.
При выходе pacpNext следует задать позицию символа следующего символа в потоке, на который не ссылаются возвращаемые значения. Вызывающий объект будет использовать его для быстрого сканирования текста с помощью нескольких вызовов GetText .
Требования
| Минимальная версия клиента | Windows 8 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | textstor.h |
| DLL | Msctf.dll |