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


Интерфейс ITextSelection (tom.h)

Выделение текста — это текстовый диапазон с выделением выделенного фрагмента.

Наследование

Интерфейс ITextSelection наследуется от ITextRange. ITextSelection также содержит следующие типы элементов:

Методы

Интерфейс ITextSelection содержит следующие методы.

 
ITextSelection::EndKey

Имитирует функциональные возможности клавиши End.
ITextSelection::GetFlags

Возвращает флаги выделения текста.
ITextSelection::GetType

Возвращает тип выделения текста.
ITextSelection::HomeKey

Обобщает функциональные возможности ключа Home.
ITextSelection::MoveDown

Имитирует функциональные возможности клавиш СТРЕЛКА ВНИЗ и PAGE DOWN.
ITextSelection::MoveLeft

Обобщает функциональные возможности клавиши СТРЕЛКА ВЛЕВО.
ITextSelection::MoveRight

Обобщает функциональные возможности клавиши СТРЕЛКА ВПРАВО.
ITextSelection::MoveUp

Имитирует функциональные возможности клавиш СТРЕЛКА ВВЕРХ и PAGE UP.
ITextSelection::SetFlags

Задает флаги выделения текста.
ITextSelection::TypeText

Вводит строку, заданную bstr при этом выборе, как если бы кто-то ввел ее. Этот метод аналогичен базовому методу SetText, но учитывает состояние ключа вставки и замены и параметры пользовательского интерфейса, такие как автозамена и смарт-кавычки.

Комментарии

Выбор связан с каким-либо представлением и имеет некоторые методы, ориентированные на пользовательский интерфейс, которые позволяют эмулировать ввод с клавиатуры. Таким образом, приложение может использовать методы ITextRange для выделения текста, а также методы ITextSelection .

Для эмуляции ввода с клавиатуры диапазоны, используемые при выборе, используют концепцию активного конца, который обычно является концом, который был перемещен в последний раз. Например, если метод ITextRange::Move* работает с диапазоном, который фактически является выделенным текстом, последний перемещенный конец является активным. Наиболее знакомыми примерами активного конца являются те, которые используют обработку клавиш SHIFT+СТРЕЛКА, где активный конец — это тот, который перемещается. Соответственно, методы ITextSelection включают методы перемещения для активного конца, такие как MoveLeft или MoveRight, а также методы для получения и задания состояния активного конца. Эти методы управляют выбором так же, как и стандартные операции курсора с клавиатуры. Это позволяет реализовать, например, средство записи макросов.

Сведения о том, как работают методы курсора и клавиатуры, см. в следующей таблице. Заданный метод соответствует клавишам клавиатуры с курсором и клавишами CTRL и SHIFT. Параметр Unit выбирается нажатием или без нажатия клавиши CTRL, а параметр Extend выбирается нажатием или без нажатия клавиши SHIFT. Обратите внимание, что MoveUp и MoveDown соответствуют нескольким клавишам клавиатуры. Дополнительные сведения см. в описании методов .

Метод Клавиша клавиатуры с курсором Единица измерения, заданная нажатием ctrl (без нажатия) Расширение, заданное нажатием SHIFT (без нажатия)
EndKey Конец tomStory (tomLine) tomExtend (tomMove)
HomeKey Домашняя страница tomStory (tomLine) tomExtend (tomMove)
MoveLeft СТРЕЛКА ВЛЕВО tomWord (tomCharacter) tomExtend (tomMove)
MoveRight Стрелка вправо tomWord (tomCharacter) tomExtend (tomMove)
Перемещение вверх Стрелка вверх tomParagraph (tomLine) tomExtend (tomMove)
MoveDown Стрелка вниз tomParagraph (tomLine) tomExtend (tomMove)
Перемещение вверх PAGE UP tomWindow (tomScreen) tomExtend (tomMove)
MoveDown PAGE DOWN tomWindow (tomScreen) tomExtend (tomMove)
 

Приложения обычно не реализуют интерфейс ITextSelection . Вместо этого текстовые решения Майкрософт, такие как элементы управления полнофункционированным редактированием, реализуют ITextSelection как часть реализации текстовой объектной модели (TOM).

Приложения могут получить указатель ITextSelection , вызвав метод GetSelection .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header tom.h