Метод ITfContext::SetSelection (msctf.h)

  • Статья

Задает выделение в документе.

Синтаксис

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

Параметры

[in] ec

Содержит файл cookie редактирования, определяющий сеанс редактирования. Это значение, переданное в ITfEditSession::D oEditSession.

[in] ulCount

Указывает количество выделенных элементов в массиве pSelection .

[in] pSelection

Массив TF_SELECTION структур, содержащих сведения для каждого выбора.

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

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

Значение Описание
S_OK
 Метод выполнен успешно.
TF_E_NOSELECTION
 Документ не имеет выбора.
TF_E_NOLOCK
 Недопустимый файл cookie в ec .

Комментарии

Выделение — это диапазон выделенного текста или точка вставки, если диапазон пуст, идентифицирующие область фокуса пользователя в документе. Некоторые документы могут иметь несколько вариантов выбора. В pSelection может быть выбран только один вариант нулевой длины, так как он представляет положение курсора документа.

Если приложение должно изменить текст, покрываемый выделенным фрагментом, оно должно дождаться, пока вызывающий объект не снимет блокировку. Однако приложения могут настраивать любые элементы стиляструктур TF_SELECTION , возвращая при этом S_OK.

Вызывающий объект может установить флаг fInterimChar , только если задано одно выделение. В этом случае выделение должно охватывать только один символ, а для элемента aseструктуры TF_SELECTION задано значение TFAE_NONE.

Требования

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

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

Интерфейс ITfContext, ITfEditSession::D oEditSession, TF_SELECTION структура, ITfContext::GetSelection