Selection Интерфейс

Определение

Пространство имен:

Microsoft.Office.Interop.Word

Сборка:

Microsoft.Office.Interop.Word.dll

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

public interface class Selection

[System.Runtime.InteropServices.Guid("00020975-0000-0000-C000-000000000046")]
public interface Selection

type Selection = interface

Public Interface Selection

Атрибуты

GuidAttribute

Комментарии

Выделенный фрагмент представляет выбранную (или выделенную) область в документе или представляет точку вставки, если в документе ничего не выбрано. В каждой области окна документа может быть только один 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	Возвращает объект Object , представляющий представление рисунка о том, как отображается выделенный фрагмент текста.
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	Возвращает объект String, представляющий XML-код, содержащийся в выделенном фрагменте в формате Microsoft Office Word Open XML. Только для чтения.
Words	Возвращает коллекцию Words , представляющую все слова в выделенном фрагменте.
XML[Boolean]	Возвращает объект String , представляющий 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_2002(Object, WdReferenceKind, Object, Object, Object)	Зарезервировано для внутреннего использования.
InsertCrossReference(Object, WdReferenceKind, Object, Object, Object, Object, Object)	Вставляет перекрестную ссылку на заголовок, закладку, сноску или концевую сноску или на элемент, для которого определена подпись метка (например, уравнение, рисунок или таблица).
InsertDateTime(Object, Object, Object, Object, Object)	Вставляет текущую дату или время либо как текст, либо как поле TIME.
InsertDateTimeOld(Object, Object, Object)	Зарезервировано для внутреннего использования.
InsertFile(String, Object, Object, Object, Object)	Вставляет все или часть указанного файла.
InsertFormula(Object, Object)	Вставляет поле = (формула), содержащее формулу в выделенном фрагменте.
InsertNewPage()	Вставляет новую страницу в положение точки вставки.
InsertParagraph()	Заменяет указанный выделенный фрагмент новым абзацем.
InsertParagraphAfter()	Вставляет знак абзаца после выделения.
InsertParagraphBefore()	Вставляет новый абзац перед указанным выделенным фрагментом.
InsertRows(Object)	Вставляет указанное количество новых строк над строкой, содержащей выделенный фрагмент.
InsertRowsAbove(Object)	Вставляет строки над текущим выделенным фрагментом.
InsertRowsBelow(Object)	Вставляет строки под текущим выделенным фрагментом.
InsertStyleSeparator()	Вставляет специальный скрытый знак абзаца, который позволяет 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()	Расширяет выбор, чтобы включить всю историю.