ShapeRange Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет диапазон фигур, представляющий собой набор фигур в документе.
public interface class ShapeRange : System::Collections::IEnumerable
[System.Runtime.InteropServices.Guid("000209B5-0000-0000-C000-000000000046")]
public interface ShapeRange : System.Collections.IEnumerable
type ShapeRange = interface
interface IEnumerable
Public Interface ShapeRange
Implements IEnumerable
- Атрибуты
- Реализации
Комментарии
Диапазон фигур может содержать только одну фигуру или все фигуры в документе. Для создания диапазона фигур можно указать любые фигуры, выбранные из всех фигур в документе или всех фигур в выделенном фрагменте. Например, можно создать коллекцию ShapeRange , содержащую первые три фигуры в документе, все выбранные фигуры в документе или все фигуры свободной формы в документе.
Примечание Большинство операций, которые можно выполнить с Shape объектом, можно также выполнить с помощью объекта ShapeRange , содержащего только одну фигуру. Некоторые операции, выполняемые с объектом ShapeRange , содержащим несколько фигур, приводят к ошибке.
Используйте Shapes.Range(index
), где index
— это имя или номер индекса фигуры или массив, содержащий имена или число индексов фигур, чтобы вернуть коллекцию ShapeRange , представляющую набор фигур в документе. Массив можно программно использовать для создания массива имен или номеров индексов.
Хотя метод можно использовать для Range(Object) возврата любого количества фигур, использовать метод проще Item[Object] , если вы хотите вернуть только один член коллекции. Например, shapes(1) проще, чем Shapes.Range(1).
Используйте selection.ShapeRange(index
), где index
— это имя или номер индекса, чтобы вернуть объект Shape , представляющий фигуру в выделенном фрагменте.
Align(MsoAlignCmd, Int32)Используйте метод , Distribute(MsoDistributeCmd, Int32)или ZOrder(MsoZOrderCmd) для размещения набора фигур относительно друг друга или относительно документа.
Group()Используйте метод , Regroup()или Ungroup() для создания и работы с одной фигурой, сформированной из диапазона фигур. Свойство GroupItems объекта Shape возвращает GroupShapes объект , который представляет все фигуры, которые были сгруппированы в одну фигуру.
Средство записи всегда использует ShapeRange свойство при записи фигур.
Объект ShapeRange не включает InlineShape объекты.
Свойства
Adjustments |
Adjustments Возвращает объект , содержащий значения корректировки для всех корректировок в указанном ShapeRange объекте, представляющего автофигуру или Объект WordArt. |
AlternativeText |
Возвращает или задает альтернативный текст, связанный с фигурой на веб-странице. |
Anchor |
Range Возвращает объект , представляющий диапазон привязки для указанного диапазона фигур. |
Application |
Application Возвращает объект , представляющий приложение Microsoft Word. |
AutoShapeType |
Возвращает или задает тип фигуры для указанного ShapeRange объекта, который должен представлять автофигуру, отличный от линии или рисунка свободной формы. |
BackgroundStyle |
Возвращает или задает стиль фона фигур в указанном диапазоне фигур. |
Callout |
CalloutFormat Возвращает объект , содержащий свойства форматирования выноски для указанного ShapeRange объекта, представляющего выноски. |
CanvasItems |
CanvasShapes Возвращает объект , представляющий коллекцию фигур на холсте рисования. |
Child |
Значение true, если все фигуры в диапазоне фигур являются дочерними фигурами одного родительского элемента. |
ConnectionSiteCount |
Зарезервировано для внутреннего использования. |
Connector |
Зарезервировано для внутреннего использования. |
ConnectorFormat |
Зарезервировано для внутреннего использования. |
Count |
Возвращает количество элементов в указанной коллекции. |
Creator |
Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан указанный объект. |
Diagram |
Возвращает объект Diagram, к которому принадлежит узел схемы. |
DiagramNode |
DiagramNode Возвращает объект , представляющий узел на схеме. |
Fill |
FillFormat Возвращает объект , содержащий свойства форматирования заливки для указанной фигуры. |
Glow |
GlowFormat Возвращает объект , представляющий форматирование свечения для диапазона фигур. Только для чтения. |
GroupItems |
GroupShapes Возвращает объект , представляющий отдельные фигуры в указанном ShapeRange объекте, который представляет сгруппированные фигуры. |
HasDiagram |
MsoTrue, если фигура является схемой. |
HasDiagramNode |
MsoTrue, если фигура является узлом схемы. |
Height |
Возвращает или задает высоту указанного объекта в точках. |
HeightRelative |
Возвращает или задает значение Single , представляющее процент целевой фигуры, до которой имеется размер диапазона фигур. Для чтения и записи. |
HorizontalFlip |
Указывает, что фигура была перевернута по горизонтали. |
Hyperlink |
WdShapePosition Возвращает объект , представляющий гиперссылку, связанную с указанным ShapeRange объектом. |
ID |
Возвращает тип для указанного объекта. |
Item[Object] |
Возвращает отдельный объект в коллекции. |
LayoutInCell |
Возвращает целое число , представляющее, отображается ли фигура в таблице или за ее пределами. Значение True указывает, что в таблице отображается указанное изображение. Значение False указывает, что указанное изображение отображается за пределами таблицы. |
Left |
Возвращает или задает объект Single , представляющий горизонтальное положение заданного диапазона фигур, измеряемое в точках. Может также быть любой допустимой WdShapePosition константой. |
LeftRelative |
Возвращает или задает значение Single , представляющее относительное левое положение диапазона фигур. Для чтения и записи. |
Line |
LineFormat Возвращает объект , содержащий свойства форматирования линий для указанной фигуры. |
LockAnchor |
Значение true , если привязка указанного ShapeRange объекта заблокирована в диапазоне привязки. |
LockAspectRatio |
MsoTrue, если указанная фигура сохраняет исходные пропорции при ее изменении. MsoFalse, если вы можете изменить высоту и ширину фигуры независимо друг от друга при ее изменении. |
Name |
Возвращает или задает имя указанного объекта. |
Nodes |
Возвращает коллекцию ShapeNodes , представляющую геометрическое описание указанной фигуры. |
Parent |
Возвращает объект , представляющий родительский объект указанного объекта. |
ParentGroup |
Shape Возвращает объект , представляющий общую родительскую фигуру диапазона дочерних фигур. |
PictureFormat |
PictureFormat Возвращает объект , содержащий свойства форматирования рисунка для указанного ShapeRange объекта, представляющего рисунок или объект OLE. |
Reflection |
ReflectionFormat Возвращает объект , представляющий форматирование отражения для диапазона фигур. Только для чтения. |
RelativeHorizontalPosition |
Указывает, к чему относится горизонтальное положение диапазона фигур. |
RelativeHorizontalSize |
Возвращает или задает константу WdRelativeHorizontalSize , представляющую объект, к которому относится диапазон фигур. Для чтения и записи. |
RelativeVerticalPosition |
Указывает, что вертикальное положение диапазона фигур является относительным. |
RelativeVerticalSize |
Возвращает или задает константу WdRelativeVerticalSize , представляющую объект, к которому относится диапазон фигур. Для чтения и записи. |
Rotation |
Возвращает или задает количество градусов, в которых указанная фигура повернута вокруг оси Z. Положительное значение указывает на поворот по часовой стрелке; отрицательное значение указывает на вращение против часовой стрелки. |
RTF |
Зарезервировано для внутреннего использования. |
Shadow |
ShadowFormat Возвращает объект , представляющий форматирование тени для указанной фигуры. |
ShapeStyle |
Возвращает или задает стиль фигур для фигур в указанном диапазоне фигур. |
SoftEdge |
SoftEdgeFormat Возвращает объект , представляющий форматирование мягких ребер для диапазона фигур. Только для чтения. |
TextEffect |
TextEffectFormat Возвращает объект , содержащий свойства форматирования текстовых эффектов для указанного ShapeRange объекта, представляющего Объект WordArt. |
TextFrame |
TextFrame Возвращает объект , содержащий текст для указанной фигуры. |
TextFrame2 |
TextFrame2 Возвращает объект , содержащий текст для указанного диапазона фигур. Только для чтения. |
ThreeD |
ThreeDFormat Возвращает объект, содержащий трехмерные свойства форматирования эффекта для указанной фигуры. |
Title |
Возвращает или задает строку, содержащую заголовок для фигур в указанном диапазоне фигур. |
Top |
Возвращает или задает вертикальное положение заданного диапазона фигур в точках. |
TopRelative |
Возвращает или задает значение Single , представляющее относительное верхнее положение диапазона фигур. Для чтения и записи. |
Type |
Возвращает тип фигуры. |
VerticalFlip |
Значение true , если указанная фигура перевернута вокруг вертикальной оси. |
Vertices |
Возвращает координаты вершин указанного рисунка свободной формы (и контрольных точек для кривых Безье) в виде ряда пар координат. |
Visible |
Значение true, если указанный объект или примененное к нему форматирование видимы. |
Width |
Возвращает или задает ширину указанного объекта в точках. |
WidthRelative |
Возвращает или задает значение Single , представляющее относительную ширину диапазона фигур. Для чтения и записи. |
WrapFormat |
WrapFormat Возвращает объект , содержащий свойства для упаковки текста вокруг указанного диапазона фигур. |
ZOrderPosition |
Возвращает положение указанной фигуры в порядке z. |
Методы
Activate() |
Активирует указанный объект. |
Align(MsoAlignCmd, Int32) |
Выравнивает фигуры в указанном диапазоне фигур. |
Apply() |
Применяется к указанному форматированию фигуры, скопированной с помощью PickUp() метода . |
CanvasCropBottom(Single) |
Обрезает процент от высоты холста от нижней части холста. |
CanvasCropLeft(Single) |
Обрезает процент ширины холста с левой стороны холста. |
CanvasCropRight(Single) |
Обрезает процент ширины холста с правой стороны холста. |
CanvasCropTop(Single) |
Обрезает процент ширины холста в верхней части холста. |
ConvertToFrame() |
Преобразует указанную фигуру в рамку. Frame Возвращает объект , представляющий новый кадр. |
ConvertToInlineShape() |
Преобразует указанную фигуру на слое документа в встроенную фигуру в текстовом слое. InlineShape Возвращает объект, представляющий рисунок или объект OLE. |
Delete() |
Удаляет указанный объект. |
Distribute(MsoDistributeCmd, Int32) |
Равномерно распределяет фигуры в указанном диапазоне фигур. |
Duplicate() |
Создает дубликат указанного ShapeRange объекта, добавляет новый диапазон фигур в коллекцию Shapes со стандартным смещением от исходных фигур, а затем возвращает новый Shape объект. |
Flip(MsoFlipCmd) |
Переворачивает фигуру по горизонтали или вертикали. |
GetEnumerator() |
Представляет диапазон фигур, представляющий собой набор фигур в документе. |
Group() |
Группирует фигуры в указанном диапазоне. Возвращает сгруппированные фигуры в виде одного Shape объекта. |
IncrementLeft(Single) |
Перемещает указанную фигуру по горизонтали на указанное количество точек. |
IncrementRotation(Single) |
Изменяет поворот указанной фигуры вокруг оси Z на указанное количество градусов. |
IncrementTop(Single) |
Перемещает указанную фигуру по вертикали на указанное количество точек. |
PickUp() |
Копирует форматирование указанной фигуры. |
Regroup() |
Перегруппирует группу, к которой ранее принадлежал указанный диапазон фигур. Возвращает перегруппированные фигуры в виде одного Shape объекта. |
RerouteConnections() |
Зарезервировано для внутреннего использования. |
ScaleHeight(Single, MsoTriState, MsoScaleFrom) |
Масштабирует высоту фигуры с применением указанного коэффициента. |
ScaleWidth(Single, MsoTriState, MsoScaleFrom) |
Масштабирует ширину фигуры с применением указанного коэффициента. |
Select(Object) |
Выбирает указанный объект. |
SetShapesDefaultProperties() |
Применяет форматирование указанной фигуры к фигуре по умолчанию для этого документа. Новые фигуры наследуют многие из своих атрибутов от фигуры по умолчанию. |
Ungroup() |
Разгруппирует все сгруппированные фигуры в указанной фигуре или диапазоне фигур. Дизассемблирует изображения и объекты OLE в пределах указанной фигуры или диапазона фигур. Возвращает негруппированные фигуры в виде одного ShapeRange объекта. |
ZOrder(MsoZOrderCmd) |
Помещает указанную фигуру перед или за другими фигурами в коллекции (то есть изменяет положение фигуры по оси Z). |