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