Интерфейс 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