Excel.Interfaces.ShapeLoadOptions interface
Представляет универсальный объект фигуры на листе. Фигура может быть геометрической фигурой, линией, группой фигур и т. д. Дополнительные сведения о объектной модели фигур см. в статье Работа с фигурами с помощью API JavaScript для Excel.
Комментарии
Свойства
$all | Указание |
alt |
Задает замещающий текст описания объекта |
alt |
Задает замещающий текст заголовка |
connection |
Возвращает количество точек соединения на фигуре. |
display |
Возвращает отображаемое имя фигуры. Только что созданная фигура имеет созданное имя, локализованное и не соответствующее ей |
fill | Возвращает формат заливки фигуры. |
geometric |
Возвращает геометрическую фигуру, связанную с линией. Если тип фигуры отличается от GeometricShape, возникает ошибка. |
geometric |
Указывает тип геометрической фигуры этой геометрической фигуры. Дополнительные сведения см. в этой |
group | Возвращает группу фигур, связанную с фигурой. Если тип фигуры отличается от GroupShape, возникает ошибка. |
height | Задает высоту фигуры (в точках).
|
id | Указывает идентификатор фигуры. |
image | Возвращает изображение, связанное с фигурой. Если тип фигуры отличается от Image, возникает ошибка. |
left | Расстояние в пунктах от левого края фигуры до левого края листа.
|
level | Задает уровень указанной фигуры. Например, уровень 0 означает, что фигура не является частью групп; уровень 1 означает, что фигура является частью группы верхнего уровня; уровень 2 означает, что фигура является частью подгруппы верхнего уровня. |
line | Возвращает линию, связанную с фигурой. Если тип фигуры отличается от Line, возникает ошибка. |
line |
Возвращает формат линии для фигуры. |
lock |
Указывает, заблокировано ли пропорции этой фигуры. |
name | Указывает имя фигуры. |
parent |
Указывает родительскую группу этой фигуры. |
placement | Представляет способ прикрепления объекта к ячейкам под ним. |
rotation | Задает поворот фигуры в градусах. |
text |
Возвращает объект рамки с текстом для фигуры. |
top | Расстояние в пунктах от верхнего края фигуры до верхнего края листа.
|
type | Возвращает тип фигуры. Дополнительные сведения см. в этой |
visible | Указывает, видна ли фигура. |
width | Задает ширину фигуры (в точках).
|
z |
Возвращает положение указанной фигуры по оси Z. Значение 0 представляет нижнее положение по оси. |
Сведения о свойстве
$all
Указание $all
для параметров загрузки загружает все скалярные свойства (например,Range.address
), но не свойства навигации (например, Range.format.fill.color
).
$all?: boolean;
Значение свойства
boolean
altTextDescription
Задает замещающий текст описания объекта Shape
.
altTextDescription?: boolean;
Значение свойства
boolean
Комментарии
altTextTitle
Задает замещающий текст заголовка Shape
для объекта.
altTextTitle?: boolean;
Значение свойства
boolean
Комментарии
connectionSiteCount
Возвращает количество точек соединения на фигуре.
connectionSiteCount?: boolean;
Значение свойства
boolean
Комментарии
displayName
Возвращает отображаемое имя фигуры. Только что созданная фигура имеет созданное имя, локализованное и не соответствующее ей name
. В этом сценарии этот API можно использовать для получения имени, отображаемого в пользовательском интерфейсе.
displayName?: boolean;
Значение свойства
boolean
Комментарии
fill
Возвращает формат заливки фигуры.
fill?: Excel.Interfaces.ShapeFillLoadOptions;
Значение свойства
Комментарии
geometricShape
Возвращает геометрическую фигуру, связанную с линией. Если тип фигуры отличается от GeometricShape, возникает ошибка.
geometricShape?: Excel.Interfaces.GeometricShapeLoadOptions;
Значение свойства
Комментарии
geometricShapeType
Указывает тип геометрической фигуры этой геометрической фигуры. Дополнительные сведения см. в этой Excel.GeometricShapeType
статье. Возвращает значение null
, если тип фигуры не является "GeometryShape".
geometricShapeType?: boolean;
Значение свойства
boolean
Комментарии
group
Возвращает группу фигур, связанную с фигурой. Если тип фигуры отличается от GroupShape, возникает ошибка.
group?: Excel.Interfaces.ShapeGroupLoadOptions;
Значение свойства
Комментарии
height
Задает высоту фигуры (в точках).
InvalidArgument
Создает исключение, если задано отрицательное значение или ноль в качестве входных данных.
height?: boolean;
Значение свойства
boolean
Комментарии
id
Указывает идентификатор фигуры.
id?: boolean;
Значение свойства
boolean
Комментарии
image
Возвращает изображение, связанное с фигурой. Если тип фигуры отличается от Image, возникает ошибка.
image?: Excel.Interfaces.ImageLoadOptions;
Значение свойства
Комментарии
left
Расстояние в пунктах от левого края фигуры до левого края листа.
InvalidArgument
Создает исключение, если задано отрицательное значение в качестве входных данных.
left?: boolean;
Значение свойства
boolean
Комментарии
level
Задает уровень указанной фигуры. Например, уровень 0 означает, что фигура не является частью групп; уровень 1 означает, что фигура является частью группы верхнего уровня; уровень 2 означает, что фигура является частью подгруппы верхнего уровня.
level?: boolean;
Значение свойства
boolean
Комментарии
line
Возвращает линию, связанную с фигурой. Если тип фигуры отличается от Line, возникает ошибка.
line?: Excel.Interfaces.LineLoadOptions;
Значение свойства
Комментарии
lineFormat
Возвращает формат линии для фигуры.
lineFormat?: Excel.Interfaces.ShapeLineFormatLoadOptions;
Значение свойства
Комментарии
lockAspectRatio
Указывает, заблокировано ли пропорции этой фигуры.
lockAspectRatio?: boolean;
Значение свойства
boolean
Комментарии
name
Указывает имя фигуры.
name?: boolean;
Значение свойства
boolean
Комментарии
parentGroup
Указывает родительскую группу этой фигуры.
parentGroup?: Excel.Interfaces.ShapeLoadOptions;
Значение свойства
Комментарии
placement
Представляет способ прикрепления объекта к ячейкам под ним.
placement?: boolean;
Значение свойства
boolean
Комментарии
rotation
Задает поворот фигуры в градусах.
rotation?: boolean;
Значение свойства
boolean
Комментарии
textFrame
Возвращает объект рамки с текстом для фигуры.
textFrame?: Excel.Interfaces.TextFrameLoadOptions;
Значение свойства
Комментарии
top
Расстояние в пунктах от верхнего края фигуры до верхнего края листа.
InvalidArgument
Создает исключение, если задано отрицательное значение в качестве входных данных.
top?: boolean;
Значение свойства
boolean
Комментарии
type
Возвращает тип фигуры. Дополнительные сведения см. в этой Excel.ShapeType
статье.
type?: boolean;
Значение свойства
boolean
Комментарии
visible
Указывает, видна ли фигура.
visible?: boolean;
Значение свойства
boolean
Комментарии
width
Задает ширину фигуры (в точках).
InvalidArgument
Создает исключение, если задано отрицательное значение или ноль в качестве входных данных.
width?: boolean;
Значение свойства
boolean
Комментарии
zOrderPosition
Возвращает положение указанной фигуры по оси Z. Значение 0 представляет нижнее положение по оси.
zOrderPosition?: boolean;
Значение свойства
boolean
Комментарии
Office Add-ins