Selection Интерфейс

Определение

Представляет текущий выделенный фрагмент в окне или области.

public interface class Selection
[System.Runtime.InteropServices.Guid("00020975-0000-0000-C000-000000000046")]
public interface Selection
type Selection = interface
Public Interface Selection
Атрибуты

Комментарии

Выделенный фрагмент представляет выбранную (или выделенную) область в документе или представляет точку вставки, если в документе ничего не выбрано. В области окна документа может быть только один Selection объект, а Selection активным может быть только один объект в приложении.

Используйте Selection свойство, чтобы возвратить Selection объект. Если со свойством не используется квалификатор объекта Selection , Microsoft Word возвращает выделение из активной области окна активного документа.

Документ не обязательно должен быть активным для доступа к выделенному фрагменту.

Используйте Text свойство, чтобы задать или вернуть текст в текущем выделенном фрагменте.

У Selection объекта есть различные методы и свойства, с которыми можно выполнять следующие действия:

Используйте свойства, такие как, Flags Information[WdInformation] и, Type чтобы получить сведения о текущем выделении.

Даже если выделенный фрагмент свертывается в точку вставки, он не обязательно должен быть пустым. Например, Text свойство по-прежнему будет возвращать символ справа от точки вставки; этот символ также отображается в Characters коллекции Selection объекта. Тем не менее, вызов методов, таких как Cut() или Copy() из свернутого выделения, приведет к ошибке.

Пользователь может выбрать область в документе, не представляющую смежный текст (например, при использовании клавиши ALT с кнопкой мыши). Так как поведение такого выделения может быть непредсказуемым, можно включить в код шаг, который проверяет Type свойство выделенного фрагмента перед выполнением каких-либо действий над ним. Аналогично, выделенный фрагмент, включающий ячейки таблицы, также может привести к непредсказуемому поведению. Information[WdInformation]Свойство сообщит, находится ли выделенный фрагмент в таблице.

Так как Range объекты совместно используют множество одинаковых методов и свойств в виде Selection объектов, использование Range объектов предпочтительнее для управления документом, если нет причин физически изменить текущее выделение.

Свойства

Active

Определяет, активен ли выделенный фрагмент в указанном окне или области.

Application

Возвращает _Application объект, представляющий приложение Microsoft Word.

BookmarkID

Возвращает номер закладки, которая заключает начало указанного фрагмента или 0 (ноль), если нет соответствующей закладки.

Bookmarks

Возвращает Bookmarks коллекцию, которая представляет все закладки в выделенном фрагменте.

Borders

Возвращает Borders коллекцию, которая представляет все границы для указанного объекта.

Cells

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

Characters

Возвращает Characters коллекцию, представляющую символы в выделенном фрагменте.

ChildShapeRange

Возвращает ShapeRange объект, представляющий дочерние фигуры выделенного фрагмента.

Columns

Возвращает Columns коллекцию, которая представляет все столбцы таблицы в выделенном фрагменте.

ColumnSelectMode

Определяет, активен ли режим выбора столбцов.

Comments

Возвращает Comments коллекцию, которая представляет все комментарии в заданном выделенном фрагменте.

ContentControls

Возвращает ContentControls коллекцию, представляющую элементы управления содержимым, содержащиеся в диапазоне. Только для чтения.

Creator

Возвращает 32 — разрядное целое число, которое указывает приложение, в котором был создан указанный объект.

Document

Возвращает Document объект, связанный с заданным выделением.

Editors

Возвращает Editors объект, который представляет всех пользователей, имеющих право на изменение выделенного фрагмента в документе.

End

Возвращает или задает позицию конечного знака для выделенного фрагмента.

EndnoteOptions

Возвращает EndnoteOptions объект, представляющий концевые сноски в выделенном фрагменте.

Endnotes

Возвращает Endnotes коллекцию, которая представляет все концевые сноски в выделенном фрагменте.

EnhMetaFileBits

Возвращает объект , представляющий графическое представление того, как отображается выделенный текст.

ExtendMode

Определяет, активен ли режим расширения.

Fields

Возвращает коллекцию, доступную только для чтения Fields , которая представляет все поля в выделенном фрагменте.

Find

Возвращает Find объект, который содержит критерии для операции поиска.

FitTextWidth

Возвращает или задает ширину (в текущих единицах измерения), в которой Microsoft Word соответствует тексту в текущем выделенном фрагменте.

Flags

Возвращает или задает свойства выделенного фрагмента.

Font

Возвращает или задает Font объект, представляющий форматирование символов указанного объекта.

FootnoteOptions

Возвращает FootnoteOptions объект, представляющий свойства сносок в выделенном фрагменте.

Footnotes

Возвращает Footnotes коллекцию, которая представляет все сноски в выделенном фрагменте.

FormattedText

Возвращает или задает Range объект, который включает форматированный текст в заданном выделенном фрагменте.

FormFields

Возвращает FormFields коллекцию, которая представляет все поля формы в выделенном фрагменте.

Frames

Возвращает Frames коллекцию, которая представляет все кадры в выделенном фрагменте.

HasChildShapeRange

Определяет, содержит ли выделенный фрагмент дочерние фигуры.

HeaderFooter

Возвращает HeaderFooter объект для указанного выделения.

HTMLDivisions

Возвращает HTMLDivisions объект, представляющий подразделение HTML в веб-документе.

Hyperlinks

Возвращает Hyperlinks коллекцию, которая представляет все гиперссылки в заданном выделенном фрагменте.

Information[WdInformation]

Возвращает сведения об указанном выделении или диапазоне.

InlineShapes

Возвращает InlineShapes коллекцию, которая представляет все InlineShape объекты в выделенном фрагменте.

IPAtEndOfLine

Определяет, находится ли точка вставки в конце строки, которая переносится на следующую строку.

IsEndOfRowMark

Определяет, свертывается ли заданный выделенный фрагмент и находится ли его в конце метки строки в таблице.

LanguageDetected

Возвращает или задает значение, указывающее, был ли Microsoft Word обнаружил язык указанного текста.

LanguageID

Возвращает или задает язык для указанного объекта.

LanguageIDFarEast

Возвращает или задает восточно-азиатский язык для указанного объекта.

LanguageIDOther

Возвращает или задает язык для указанного объекта.

NoProofing

Определяет, будет ли средство проверки орфографии и грамматики игнорировать указанный текст.

OMaths

Возвращает OMaths коллекцию, представляющую OMath объекты в текущем выделенном фрагменте. Только для чтения.

Orientation

Возвращает или задает ориентацию текста в выделенном фрагменте при включенной функции направления текста.

PageSetup

Возвращает PageSetup объект, связанный с заданным выделением.

ParagraphFormat

Возвращает или задает ParagraphFormat объект, представляющий параметры абзаца для указанного выделения.

Paragraphs

Возвращает Paragraphs коллекцию, которая представляет все абзацы в заданном выделенном фрагменте.

Parent

Возвращает объект, представляющий родительский объект указанного объекта.

ParentContentControl

Возвращает ContentControl объект, представляющий родительский элемент управления содержимым для указанного диапазона. Только для чтения.

PreviousBookmarkID

Возвращает номер последней закладки, начинающейся до или в том же месте, что и заданное выделение, или значение 0 (ноль), если отсутствует соответствующая закладка.

Range

Возвращает Range объект, представляющий часть документа, содержащуюся в указанном объекте.

Rows

Возвращает Rows коллекцию, которая представляет все строки таблицы в выделенном фрагменте.

Sections

Возвращает Sections коллекцию, представляющую разделы в заданном выделенном фрагменте.

Sentences

Возвращает Sentences коллекцию, которая представляет все предложения в выделенном фрагменте.

Shading

Возвращает Shading объект, который ссылается на форматирование заливки для указанного объекта.

ShapeRange

Возвращает ShapeRange коллекцию, которая представляет все Shape объекты в указанном диапазоне или выделенном фрагменте.

SmartTags

Возвращает SmartTags объект, представляющий смарт-тег в документе.

Start

Возвращает или задает позицию начального знака для выделенного фрагмента.

StartIsActive

Определяет, является ли начало выделенного фрагмента активным.

StoryLength

Возвращает количество символов в статье, которое содержит заданный выбор.

StoryType

Возвращает тип статьи для указанного выделения.

Style

Возвращает или задает стиль указанного объекта.

Tables

Возвращает Tables коллекцию, которая представляет все таблицы в указанном выделенном фрагменте.

Text

Возвращает или задает текст в заданном выделенном фрагменте.

TopLevelTables

Возвращает Tables коллекцию, которая представляет таблицы на внешнем уровне вложенности в текущем выделенном фрагменте.

Type

Возвращает тип выделения.

WordOpenXML

Возвращает строку , которая представляет XML-код, содержащийся в выделенном фрагменте в формате Microsoft Office Word Open XML. Только для чтения.

Words

Возвращает Words коллекцию, которая представляет все слова в выделенном фрагменте.

XML[Boolean]

Возвращает строку , ПРЕДСТАВЛЯЮЩУЮ XML-текст в указанном объекте.

XMLNodes

Этот объект, элемент или перечисление устарели и не предназначены для использования в коде.

XMLParentNode

Этот объект, элемент или перечисление устарели и не предназначены для использования в коде.

Методы

BoldRun()

Добавляет или удаляет полужирный шрифт для текущего запуска.

Calculate()

Вычисляет математическое выражение в выделенном фрагменте.

ClearCharacterAllFormatting()

Удаляет все форматирование символов (форматирование, примененное с помощью стилей символов или форматирования, примененного вручную) из выбранного текста.

ClearCharacterDirectFormatting()

Удаляет форматирование символов (форматирование, которое было применено вручную с помощью кнопок на ленте или из диалоговых окон) из выбранного текста.

ClearCharacterStyle()

Удаляет форматирование символов, примененное с помощью стилей символов из выбранного текста.

ClearFormatting()

Удаляет форматирование текста и абзацев из выделенного фрагмента.

ClearParagraphAllFormatting()

Удаляет все форматирование абзаца (форматирование, применяемое с помощью стилей абзацев или вручную примененное форматирование) из выбранного текста.

ClearParagraphDirectFormatting()

Удаляет форматирование абзаца, которое было применено вручную (с помощью кнопок на ленте или с помощью диалоговых окон) из выбранного текста.

ClearParagraphStyle()

Удаляет форматирование абзаца, примененное с помощью стилей абзацев из выбранного текста.

Collapse(Object)

Сворачивает выделенный фрагмент к начальному или конечному положению.

ConvertToTable(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Преобразует текст в выделенной области в таблицу.

ConvertToTableOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Зарезервировано для внутреннего использования.

Copy()

Копирует указанный объект в буфер обмена.

CopyAsPicture()

Копирует указанный объект в буфер обмена.

CopyFormat()

Копирует форматирование символов первого символа в выбранном тексте.

CreateAutoTextEntry(String, String)

Добавляет новый AutoTextEntry объект в AutoTextEntries коллекцию на основе текущего выделенного фрагмента.

CreateTextbox()

Добавляет текстовое поле по умолчанию размера вокруг выделенного фрагмента.

Cut()

Удаляет указанный объект из документа и помещает его в буфер обмена.

Delete(Object, Object)

Удаляет указанное число символов или слов.

DetectLanguage()

Анализирует указанный текст, чтобы определить язык, на котором написана запись.

EndKey(Object, Object)

Перемещение или расширение выделенного фрагмента до конца указанной единицы.

EndOf(Object, Object)

Перемещение или расширение позиции конечного знака выделения до конца ближайшей указанной единицы текста.

EscapeKey()

Отменяет режим, такой как расширение или выделение столбца (эквивалент нажатия клавиши ESC).

Expand(Object)

Разворачивает указанный фрагмент.

ExportAsFixedFormat(String, WdExportFormat, Boolean, WdExportOptimizeFor, Boolean, WdExportItem, Boolean, Boolean, WdExportCreateBookmarks, Boolean, Boolean, Boolean, Object)

Сохраняет текущий выделенный фрагмент в формате PDF или XPS. .

Extend(Object)

Включает режим расширения или расширяет выделение до следующей крупной единицы текста, если режим расширения уже включен.

GoTo(Object, Object, Object, Object)

Перемещает точку вставки на позицию символа, непосредственно предшествующую указанному элементу.

GoToEditableRange(Object)

Возвращает Range объект, представляющий область документа, которую может изменить указанный пользователь или группа пользователей.

GoToNext(WdGoToItem)

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

GoToPrevious(WdGoToItem)

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

HomeKey(Object, Object)

Перемещение или расширение выделенного фрагмента до начала указанного элемента.

InRange(Range)

Определяет, находится ли выделенный фрагмент, к которому применяется метод, в указанном диапазоне.

InsertAfter(String)

Вставляет указанный текст в конец выделенного фрагмента.

InsertBefore(String)

Вставляет указанный текст перед указанным выделением.

InsertBreak(Object)

Вставляет страницу, столбец или разрыв раздела.

InsertCaption(Object, Object, Object, Object, Object)

Вставляет заголовок, который предшествует или после указанного фрагмента.

InsertCaptionXP(Object, Object, Object, Object)

Зарезервировано для внутреннего использования.

InsertCells(Object)

Добавляет ячейки в существующую таблицу.

InsertColumns()

Вставляет столбцы слева от столбца, содержащего выделенный фрагмент.

InsertColumnsRight()

Вставляет столбцы справа от текущего выделенного фрагмента.

InsertCrossReference(Object, WdReferenceKind, Object, Object, Object, Object, Object)

Вставляет перекрестную ссылку на заголовок, закладку, сноску или концевую сноску или на элемент, для которого определена подпись заголовка (например, формула, рисунок или таблица).

InsertCrossReference_2002(Object, WdReferenceKind, Object, Object, Object)

Зарезервировано для внутреннего использования.

InsertDateTime(Object, Object, Object, Object, Object)

Вставляет текущую дату или время либо как текст, либо как поле времени.

InsertDateTimeOld(Object, Object, Object)

Зарезервировано для внутреннего использования.

InsertFile(String, Object, Object, Object, Object)

Вставляет весь указанный файл или его часть.

InsertFormula(Object, Object)

Вставляет поле = (формула), которое содержит формулу в выделенном фрагменте.

InsertNewPage()

Вставляет новую страницу в позицию курсора.

InsertParagraph()

Заменяет заданное выделение новым абзацем.

InsertParagraphAfter()

Вставляет знак абзаца после выделенного фрагмента.

InsertParagraphBefore()

Вставляет новый абзац перед указанным выделением.

InsertRows(Object)

Вставляет указанное число новых строк над строкой, содержащей выделенный фрагмент.

InsertRowsAbove(Object)

Вставляет строки над текущим выделением.

InsertRowsBelow(Object)

Вставляет строки под выделенным фрагментом.

InsertStyleSeparator()

Вставляет Специальный знак скрытого абзаца, который позволяет Microsoft Word присоединять абзацы, отформатированные с использованием разных стилей абзацев.

InsertSymbol(Int32, Object, Object, Object)

Вставляет символ вместо указанного фрагмента.

InsertXML(String, Object)

Вставляет указанный текст XML в указанный фрагмент.

InStory(Range)

Определяет, находится ли выделенный фрагмент, к которому применяется этот метод, в той же статье, что и указанный диапазон.

IsEqual(Range)

Определяет, совпадает ли выделение, к которому применяется этот метод, диапазон, указанный Range аргументом.

ItalicRun()

Добавляет или удаляет курсивный шрифт в текущем фрагменте.

LtrPara()

Задает порядок чтения и выравнивание указанных абзацев слева направо.

LtrRun()

Задает порядок чтения и выравнивание для указанного запуска слева направо.

Move(Object, Object)

Сворачивает указанный выделенный фрагмент в его начальное или конечное положение, а затем перемещает Свернутый объект на указанное число единиц.

MoveDown(Object, Object, Object)

Перемещает выделение вниз и возвращает число перемещенных единиц.

MoveEnd(Object, Object)

Перемещает позицию конечного знака выделенного фрагмента.

MoveEndUntil(Object, Object)

Перемещает конечное положение указанного выделения, пока в документе не будет найден ни один из указанных символов.

MoveEndWhile(Object, Object)

Перемещает позицию конечного знака выделенного фрагмента, в то время как любой из указанных символов будет найден в документе.

MoveLeft(Object, Object, Object)

Перемещает выделение влево и возвращает число перемещенных единиц.

MoveRight(Object, Object, Object)

Перемещает выделение вправо и возвращает число перемещенных единиц.

MoveStart(Object, Object)

Перемещает начальную позицию указанного фрагмента.

MoveStartUntil(Object, Object)

Перемещает начальную позицию указанного выделения, пока в документе не будет найден один из указанных символов.

MoveStartWhile(Object, Object)

Перемещает начальную позицию указанного выделения, когда в документе обнаруживается любой из заданных символов.

MoveUntil(Object, Object)

Перемещает указанное выделение, пока в документе не будет найден один из указанных символов.

MoveUp(Object, Object, Object)

Перемещает выделенный фрагмент вверх и возвращает число перемещенных единиц.

MoveWhile(Object, Object)

Перемещает указанный фрагмент, когда в документе обнаруживается любой из заданных символов.

Next(Object, Object)

Возвращает Range объект, представляющий заданную единицу измерения относительно указанного выделения.

NextField()

Выбирает следующее поле.

NextRevision(Object)

Определяет расположение и возврат следующего отслеживаемого изменения в виде Revision объекта.

NextSubdocument()

Перемещает выделенный фрагмент в следующий вложенный документ.

Paste()

Вставляет содержимое буфера обмена в заданном выделенном фрагменте.

PasteAndFormat(WdRecoveryType)

Добавляет выбранные ячейки таблицы и форматирует их указанным образом.

PasteAppendTable()

Объединение вставленных ячеек в существующую таблицу путем вставки вставленных строк между выбранными строками.

PasteAsNestedTable()

Вставляет ячейку или группу ячеек в виде вложенной таблицы в выбранный диапазон.

PasteExcelTable(Boolean, Boolean, Boolean)

Прошлое и форматирует таблицу Microsoft Excel.

PasteFormat()

Применяет форматирование, скопированное с CopyFormat() методом, в выделение.

PasteSpecial(Object, Object, Object, Object, Object, Object, Object)

Вставляет содержимое буфера обмена.

Previous(Object, Object)

Возвращает Range объект, соответствующий заданному выделенному фрагменту.

PreviousField()

Выбирает предыдущее поле.

PreviousRevision(Object)

Определяет расположение и возврат предыдущего отслеженного изменения в виде Revision объекта.

PreviousSubdocument()

Перемещает выделенный фрагмент в предыдущий вложенный документ.

ReadingModeGrowFont()

Увеличение размера отображаемого текста на один размер при отображении документа в режиме чтения.

ReadingModeShrinkFont()

При отображении документа в режиме чтения уменьшается размер отображаемого текста на один кегль.

RtlPara()

Задает порядок чтения и выравнивание заданных абзацев справа налево.

RtlRun()

Задает порядок чтения и выравнивание для указанного запуска по правому и левому краю.

Select()

Выбирает указанный объект.

SelectCell()

Выделяет всю ячейку, содержащую выделенный фрагмент.

SelectColumn()

Выбирает столбец, который содержит точку вставки, или выбирает все столбцы, содержащие выделенный фрагмент.

SelectCurrentAlignment()

Расширение выделенного фрагмента вперед до тех пор, пока не встретится текст с другим выравниванием абзаца.

SelectCurrentColor()

Расширение выделенного фрагмента вперед до тех пор, пока не встретится текст с другим цветом.

SelectCurrentFont()

Расширение выделенного фрагмента вперед до тех пор, пока не встретится текст на другом шрифте или его размере.

SelectCurrentIndent()

Расширение выделенного фрагмента вперед до тех пор, пока встречается текст с другими отступами слева или справа.

SelectCurrentSpacing()

Расширение выделенного фрагмента вперед до тех пор, пока не встретится абзац с разным интервалом.

SelectCurrentTabs()

Расширение выделенного фрагмента вперед до тех пор, пока не встретится абзац с другими позициями табуляции.

SelectRow()

Выбирает строку, содержащую точку вставки, или выделяет все строки, содержащие выделенный фрагмент.

SetRange(Int32, Int32)

Задает позиции начального и конечного символов для выделенного фрагмента.

Shrink()

Сжимает выделенный фрагмент до следующей меньшей единицы текста.

ShrinkDiscontiguousSelection()

Отменяет выделение всего текста, кроме последнего выделенного, если выделенный фрагмент содержит несколько неподключенных элементов.

Sort(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Сортирует абзацы в указанном фрагменте.

Sort2000(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Зарезервировано для внутреннего использования.

SortAscending()

Сортирует абзацы или строки таблицы в порядке возрастания буквенно-цифрового алфавита.

SortByHeadings(Object, Object, Object, Object, Object, Object, Object, Object, Object)

Сортирует заголовки в указанном фрагменте.

SortDescending()

Сортирует абзацы или строки таблицы в убывающем алфавитном порядке.

SortOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Зарезервировано для внутреннего использования.

SplitTable()

Вставляет пустой абзац над первой строкой в выделенном фрагменте.

StartOf(Object, Object)

Перемещает или расширяет начальную позицию указанного выделения до начала ближайшей указанной единицы текста.

ToggleCharacterCode()

Переключает выделенный фрагмент между символами Юникода и соответствующим ему шестнадцатеричным значением.

TypeBackspace()

Удаляет символ, предшествующий свернутому выделенному фрагменту (точка вставки).

TypeParagraph()

Вставляет новый пустой абзац.

TypeText(String)

Вставляет указанный текст.

WholeStory()

Разворачивает выделенный фрагмент, чтобы включить всю статью.

Применяется к