Shapes

Форма

Вид PageElement , представляющий общую форму, не имеющую более конкретной классификации. Дополнительные сведения см. в разделе Размер и положение элементов страницы .

JSON-представление 
{
  "shapeType": enum (Type),
  "text": {
    object (TextContent)
  },
  "shapeProperties": {
    object (ShapeProperties)
  },
  "placeholder": {
    object (Placeholder)
  }
}
Поля
shapeType

enum ( Type )

Тип фигуры.

text

object ( TextContent )

Текстовое содержимое фигуры.

shapeProperties

object ( ShapeProperties )

Свойства формы.

placeholder

object ( Placeholder )

Заполнители — это элементы страницы, которые наследуются от соответствующих заполнителей в макетах и ​​шаблонах.

Если установлено, фигура является фигурой-заполнителем, и любые унаследованные свойства можно определить, просмотрев родительский заполнитель, определенный полем Placeholder.parent_object_id .

Тип

Типы фигур.

Многие из этих форм соответствуют заранее определенным формам стандарта ECMA-376. Дополнительные сведения см. в описании простого типа ST_ShapeType в разделе 20.1.10.56 документа «Форматы файлов Office Open XML — основы и справочник по языку разметки», часть 1 документа ECMA-376, 5-е издание .

Перечисления
TYPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
TEXT_BOX Форма текстового поля.
RECTANGLE Прямоугольная форма. Соответствует ECMA-376 ST_ShapeType «прямоугольный».
ROUND_RECTANGLE Форма прямоугольника с закругленными углами. Соответствует ECMA-376 ST_ShapeType 'roundRect'
ELLIPSE Форма эллипса. Соответствует ECMA-376 ST_ShapeType «эллипс».
ARC Изогнутая дугообразная форма. Соответствует ECMA-376 ST_ShapeType «дуга».
BENT_ARROW Изогнутая стреловидная форма. Соответствует ECMA-376 ST_ShapeType 'bentArrow'
BENT_UP_ARROW Изогнутая форма стрелки. Соответствует ECMA-376 ST_ShapeType 'bentUpArrow'
BEVEL Коническая форма. Соответствует ECMA-376 ST_ShapeType «фаска».
BLOCK_ARC Форма блока дуги. Соответствует ECMA-376 ST_ShapeType 'blockArc'
BRACE_PAIR Форма пары скоб. Соответствует ECMA-376 ST_ShapeType 'bracePair'
BRACKET_PAIR Форма пары кронштейнов. Соответствует ECMA-376 ST_ShapeType 'bracketPair'
CAN Может формировать. Соответствует ECMA-376 ST_ShapeType «может»
CHEVRON Форма шеврон. Соответствует ECMA-376 ST_ShapeType «шеврон».
CHORD Форма аккорда. Соответствует ECMA-376 ST_ShapeType «аккорд».
CLOUD Форма облака. Соответствует ECMA-376 ST_ShapeType «облако».
CORNER Угловая форма. Соответствует ECMA-376 ST_ShapeType «угол».
CUBE Форма куба. Соответствует ECMA-376 ST_ShapeType «куб».
CURVED_DOWN_ARROW Изогнутая вниз форма стрелки. Соответствует ECMA-376 ST_ShapeType 'curvedDownArrow'
CURVED_LEFT_ARROW Изогнутая форма стрелки влево. Соответствует ECMA-376 ST_ShapeType 'curvedLeftArrow'
CURVED_RIGHT_ARROW Изогнутая форма стрелки вправо. Соответствует ECMA-376 ST_ShapeType 'curvedRightArrow'
CURVED_UP_ARROW Изогнутая вверх форма стрелки. Соответствует ECMA-376 ST_ShapeType 'curvedUpArrow'
DECAGON Форма декагона. Соответствует ECMA-376 ST_ShapeType «десятиугольник».
DIAGONAL_STRIPE Форма диагональной полосы. Соответствует ECMA-376 ST_ShapeType 'diagStripe'.
DIAMOND Ромбовидная форма. Соответствует ECMA-376 ST_ShapeType «ромб».
DODECAGON Форма додекагона. Соответствует ECMA-376 ST_ShapeType «додекагон».
DONUT Форма пончика. Соответствует ECMA-376 ST_ShapeType «пончик».
DOUBLE_WAVE Двойная форма волны. Соответствует ECMA-376 ST_ShapeType 'doubleWave'
DOWN_ARROW Форма стрелки вниз. Соответствует ECMA-376 ST_ShapeType 'downArrow'
DOWN_ARROW_CALLOUT Выноска в форме стрелки вниз. Соответствует ECMA-376 ST_ShapeType 'downArrowCallout'
FOLDED_CORNER Форма сложенного угла. Соответствует ECMA-376 ST_ShapeType 'foldedCorner'.
FRAME Форма рамки. Соответствует ECMA-376 ST_ShapeType «кадр».
HALF_FRAME Полурамная форма. Соответствует ECMA-376 ST_ShapeType 'halfFrame'.
HEART Форма сердца. Соответствует ECMA-376 ST_ShapeType «сердце».
HEPTAGON Форма семиугольника. Соответствует ECMA-376 ST_ShapeType «семиугольник».
HEXAGON Шестиугольная форма. Соответствует ECMA-376 ST_ShapeType «шестиугольник».
HOME_PLATE Форма домашней тарелки. Соответствует ECMA-376 ST_ShapeType 'homePlate'
HORIZONTAL_SCROLL Горизонтальная форма прокрутки. Соответствует ECMA-376 ST_ShapeType 'horizontalScroll'
IRREGULAR_SEAL_1 Неправильная пломба 1 формы. Соответствует ECMA-376 ST_ShapeType 'irregularSeal1'.
IRREGULAR_SEAL_2 Неправильная форма уплотнителя 2. Соответствует ECMA-376 ST_ShapeType 'irregularSeal2'
LEFT_ARROW Форма стрелки влево. Соответствует ECMA-376 ST_ShapeType 'leftArrow'
LEFT_ARROW_CALLOUT Выноска в форме стрелки влево. Соответствует ECMA-376 ST_ShapeType 'leftArrowCallout'
LEFT_BRACE Форма левой скобки. Соответствует ECMA-376 ST_ShapeType 'leftBrace'
LEFT_BRACKET Форма левой скобки. Соответствует ECMA-376 ST_ShapeType 'leftBracket'.
LEFT_RIGHT_ARROW Форма стрелки влево и вправо. Соответствует ECMA-376 ST_ShapeType 'leftRightArrow'
LEFT_RIGHT_ARROW_CALLOUT Выноска в форме стрелки влево и вправо. Соответствует ECMA-376 ST_ShapeType 'leftRightArrowCallout'
LEFT_RIGHT_UP_ARROW Форма стрелки влево вправо вверх. Соответствует ECMA-376 ST_ShapeType 'leftRightUpArrow'
LEFT_UP_ARROW Форма стрелки вверх влево. Соответствует ECMA-376 ST_ShapeType 'leftUpArrow'
LIGHTNING_BOLT Форма молнии. Соответствует ECMA-376 ST_ShapeType «lightningBolt».
MATH_DIVIDE Разделите математическую фигуру. Соответствует ECMA-376 ST_ShapeType 'mathDivide'
MATH_EQUAL Равная математическая форма. Соответствует ECMA-376 ST_ShapeType 'mathEqual'
MATH_MINUS Минус математическая форма. Соответствует ECMA-376 ST_ShapeType 'mathMinus'.
MATH_MULTIPLY Умножьте математическую фигуру. Соответствует ECMA-376 ST_ShapeType 'mathMultiply'
MATH_NOT_EQUAL Не равная математическая форма. Соответствует ECMA-376 ST_ShapeType 'mathNotEqual'
MATH_PLUS Плюс математическая форма. Соответствует ECMA-376 ST_ShapeType 'mathPlus'
MOON Форма Луны. Соответствует ECMA-376 ST_ShapeType «луна».
NO_SMOKING Не курящая форма. Соответствует ECMA-376 ST_ShapeType «noSmoking».
NOTCHED_RIGHT_ARROW Зазубренная стрелка вправо. Соответствует ECMA-376 ST_ShapeType 'notchedRightArrow'
OCTAGON Форма восьмиугольника. Соответствует ECMA-376 ST_ShapeType «восьмиугольник».
PARALLELOGRAM Форма параллелограмма. Соответствует ECMA-376 ST_ShapeType «параллелограмм».
PENTAGON Пятиугольная форма. Соответствует ECMA-376 ST_ShapeType «пятиугольник».
PIE Форма пирога. Соответствует ECMA-376 ST_ShapeType «пирог».
PLAQUE Форма бляшки. Соответствует ECMA-376 ST_ShapeType «табличка».
PLUS Плюс форма. Соответствует ECMA-376 ST_ShapeType «плюс».
QUAD_ARROW Четырехстрелочная форма. Соответствует ECMA-376 ST_ShapeType 'quadArrow'
QUAD_ARROW_CALLOUT Выноска в форме четырех стрелок. Соответствует ECMA-376 ST_ShapeType 'quadArrowCallout'
RIBBON Форма ленты. Соответствует ECMA-376 ST_ShapeType «лента».
RIBBON_2 Лента 2 формы. Соответствует ECMA-376 ST_ShapeType 'ribbon2'.
RIGHT_ARROW Форма стрелки вправо. Соответствует ECMA-376 ST_ShapeType 'rightArrow'
RIGHT_ARROW_CALLOUT Выноска в форме стрелки вправо. Соответствует ECMA-376 ST_ShapeType 'rightArrowCallout'
RIGHT_BRACE Правильная форма брекета. Соответствует ECMA-376 ST_ShapeType 'rightBrace'
RIGHT_BRACKET Правая форма кронштейна. Соответствует ECMA-376 ST_ShapeType 'rightBracket'
ROUND_1_RECTANGLE Один прямоугольник с закругленными углами. Соответствует ECMA-376 ST_ShapeType 'round1Rect'
ROUND_2_DIAGONAL_RECTANGLE Прямоугольная форма с двумя диагональными круглыми углами. Соответствует ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE Два прямоугольника с круглыми углами с одинаковой стороной. Соответствует ECMA-376 ST_ShapeType 'round2SameRect'
RIGHT_TRIANGLE Прямоугольная форма треугольника. Соответствует ECMA-376 ST_ShapeType 'rtTriangle'
SMILEY_FACE Смайлик по форме лица. Соответствует ECMA-376 ST_ShapeType 'smileyFace'
SNIP_1_RECTANGLE Прямоугольная форма с одним отрезанным углом. Соответствует ECMA-376 ST_ShapeType 'snip1Rect'
SNIP_2_DIAGONAL_RECTANGLE Прямоугольная форма с двумя диагональными надрезами. Соответствует ECMA-376 ST_ShapeType 'snip2DiagRect'
SNIP_2_SAME_RECTANGLE Два прямоугольных угла с надрезами на одной стороне. Соответствует ECMA-376 ST_ShapeType 'snip2SameRect'
SNIP_ROUND_RECTANGLE Один надрез одного прямоугольника с закругленным углом. Соответствует ECMA-376 ST_ShapeType 'snipRoundRect'
STAR_10 Форма десятиконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star10'
STAR_12 Форма двенадцатиконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star12'
STAR_16 Форма шестнадцатиконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star16'
STAR_24 Форма двадцати четырехконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star24'
STAR_32 Форма тридцати двухконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star32'
STAR_4 Форма четырехконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star4'
STAR_5 Форма пятиконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star5'
STAR_6 Форма шестиконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star6'
STAR_7 Форма семиконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star7'
STAR_8 Форма восьмиконечной звезды. Соответствует ECMA-376 ST_ShapeType 'star8'
STRIPED_RIGHT_ARROW Полосатая стрелка вправо. Соответствует ECMA-376 ST_ShapeType 'stripedRightArrow'
SUN Форма Солнца. Соответствует ECMA-376 ST_ShapeType «солнце».
TRAPEZOID Трапециевидная форма. Соответствует ECMA-376 ST_ShapeType «трапеция».
TRIANGLE Треугольная форма. Соответствует ECMA-376 ST_ShapeType «треугольник».
UP_ARROW Форма стрелки вверх. Соответствует ECMA-376 ST_ShapeType 'upArrow'
UP_ARROW_CALLOUT Выноска в форме стрелки вверх. Соответствует ECMA-376 ST_ShapeType 'upArrowCallout'
UP_DOWN_ARROW Форма стрелки вверх вниз. Соответствует ECMA-376 ST_ShapeType 'upDownArrow'
UTURN_ARROW Форма стрелки разворота. Соответствует ECMA-376 ST_ShapeType 'uturnArrow'
VERTICAL_SCROLL Вертикальная форма прокрутки. Соответствует ECMA-376 ST_ShapeType 'verticalScroll'.
WAVE Форма волны. Соответствует ECMA-376 ST_ShapeType «волна».
WEDGE_ELLIPSE_CALLOUT Выноска клиновидной формы. Соответствует ECMA-376 ST_ShapeType 'wedgeEllipseCallout'.
WEDGE_RECTANGLE_CALLOUT Выноска клиновидной прямоугольной формы. Соответствует ECMA-376 ST_ShapeType 'wedgeRectCallout'
WEDGE_ROUND_RECTANGLE_CALLOUT Выноска клин круглой прямоугольной формы. Соответствует ECMA-376 ST_ShapeType 'wedgeRoundRectCallout'.
FLOW_CHART_ALTERNATE_PROCESS Альтернативная форма технологического потока. Соответствует ECMA-376 ST_ShapeType 'flowChartAlternateProcess'
FLOW_CHART_COLLATE Собрать форму потока. Соответствует ECMA-376 ST_ShapeType 'flowChartCollate'
FLOW_CHART_CONNECTOR Форма потока соединителя. Соответствует ECMA-376 ST_ShapeType 'flowChartConnector'
FLOW_CHART_DECISION Форма потока решений. Соответствует ECMA-376 ST_ShapeType 'flowChartDecision'
FLOW_CHART_DELAY Форма потока задержки. Соответствует ECMA-376 ST_ShapeType 'flowChartDelay'
FLOW_CHART_DISPLAY Отображение формы потока. Соответствует ECMA-376 ST_ShapeType «flowChartDisplay».
FLOW_CHART_DOCUMENT Форма документооборота. Соответствует ECMA-376 ST_ShapeType 'flowChartDocument'.
FLOW_CHART_EXTRACT Извлечь форму потока. Соответствует ECMA-376 ST_ShapeType 'flowChartExtract'
FLOW_CHART_INPUT_OUTPUT Форма входного выходного потока. Соответствует ECMA-376 ST_ShapeType 'flowChartInputOutput'
FLOW_CHART_INTERNAL_STORAGE Форма потока внутреннего хранилища. Соответствует ECMA-376 ST_ShapeType «flowChartInternalStorage»
FLOW_CHART_MAGNETIC_DISK Форма потока магнитного диска. Соответствует ECMA-376 ST_ShapeType 'flowChartMagneticDisk'.
FLOW_CHART_MAGNETIC_DRUM Форма потока магнитного барабана. Соответствует ECMA-376 ST_ShapeType 'flowChartMagneticDrum'
FLOW_CHART_MAGNETIC_TAPE Форма потока магнитной ленты. Соответствует ECMA-376 ST_ShapeType 'flowChartMagneticTape'
FLOW_CHART_MANUAL_INPUT Форма потока ручного ввода. Соответствует ECMA-376 ST_ShapeType 'flowChartManualInput'
FLOW_CHART_MANUAL_OPERATION Форма потока ручного управления. Соответствует ECMA-376 ST_ShapeType 'flowChartManualOperation'
FLOW_CHART_MERGE Объединить форму потока. Соответствует ECMA-376 ST_ShapeType 'flowChartMerge'
FLOW_CHART_MULTIDOCUMENT Форма многодокументного потока. Соответствует ECMA-376 ST_ShapeType 'flowChartMultidocument'.
FLOW_CHART_OFFLINE_STORAGE Форма потока автономного хранилища. Соответствует ECMA-376 ST_ShapeType 'flowChartOfflineStorage'
FLOW_CHART_OFFPAGE_CONNECTOR Форма потока соединителя вне страницы. Соответствует ECMA-376 ST_ShapeType 'flowChartOffpageConnector'
FLOW_CHART_ONLINE_STORAGE Форма потока онлайн-хранилища. Соответствует ECMA-376 ST_ShapeType «flowChartOnlineStorage».
FLOW_CHART_OR Или форма потока. Соответствует ECMA-376 ST_ShapeType 'flowChartOr'
FLOW_CHART_PREDEFINED_PROCESS Предопределенная форма потока процесса. Соответствует ECMA-376 ST_ShapeType 'flowChartPredefineProcess'
FLOW_CHART_PREPARATION Форма потока препарата. Соответствует ECMA-376 ST_ShapeType 'flowChartPreparation'
FLOW_CHART_PROCESS Форма технологического потока. Соответствует ECMA-376 ST_ShapeType «flowChartProcess»
FLOW_CHART_PUNCHED_CARD Форма потока перфокарт. Соответствует ECMA-376 ST_ShapeType 'flowChartPunchedCard'
FLOW_CHART_PUNCHED_TAPE Форма потока перфоленты. Соответствует ECMA-376 ST_ShapeType 'flowChartPunchedTape'
FLOW_CHART_SORT Сортировка формы потока. Соответствует ECMA-376 ST_ShapeType 'flowChartSort'
FLOW_CHART_SUMMING_JUNCTION Суммирующая форма потока в стыке. Соответствует ECMA-376 ST_ShapeType 'flowChartSummingJunction'
FLOW_CHART_TERMINATOR Форма потока Терминатора. Соответствует ECMA-376 ST_ShapeType «flowChartTerminator».
ARROW_EAST Форма восточной стрелки.
ARROW_NORTH_EAST Форма северо-восточной стрелки.
ARROW_NORTH Форма северной стрелки.
SPEECH Форма речи.
STARBURST Форма взрыва звезды.
TEARDROP Каплевидная форма. Соответствует ECMA-376 ST_ShapeType «капля».
ELLIPSE_RIBBON Лента эллиптической формы. Соответствует ECMA-376 ST_ShapeType 'ellipseRibbon'
ELLIPSE_RIBBON_2 Лента эллипс 2 формы. Соответствует ECMA-376 ST_ShapeType 'ellipseRibbon2'
CLOUD_CALLOUT Форма облака выноски. Соответствует ECMA-376 ST_ShapeType «cloudCallout».
CUSTOM Нестандартная форма.

Свойства формы

Свойства Shape .

Если фигура является фигурой-заполнителем, как определено полем placeholder , то эти свойства могут быть унаследованы от родительской фигуры-заполнителя. Определение отображаемого значения свойства зависит от соответствующего значения поля propertyState .

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

JSON-представление 
{
  "shapeBackgroundFill": {
    object (ShapeBackgroundFill)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  },
  "contentAlignment": enum (ContentAlignment),
  "autofit": {
    object (Autofit)
  }
}
Поля
shapeBackgroundFill

object ( ShapeBackgroundFill )

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

outline

object ( Outline )

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

shadow

object ( Shadow )

Теневые свойства фигуры. Если значение не установлено, тень наследуется от родительского заполнителя, если он существует. Если у фигуры нет родительского элемента, то тень по умолчанию соответствует настройкам по умолчанию для новых фигур, созданных в редакторе слайдов. Это свойство доступно только для чтения.

contentAlignment

enum ( ContentAlignment )

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

autofit

object ( Autofit )

Свойства автоподбора фигуры. Это свойство установлено только для фигур, допускающих текст.

ФормаФонЗаливка

Заливка фона фигуры.

JSON-представление 
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
Поля
propertyState

enum ( PropertyState )

Состояние свойства фоновой заливки.

Обновление заливки фигуры неявно обновит это поле до RENDERED , если в том же запросе не указано другое значение. Чтобы фигура не имела заливки, установите для этого поля значение NOT_RENDERED . В этом случае любые другие поля заполнения, заданные в том же запросе, будут игнорироваться.

kind поля Союза. Вид заливки фона. kind может быть только одним из следующих:
solidFill

object ( SolidFill )

Сплошная цветная заливка.

Автоподбор

Свойства автоподбора Shape . Это свойство установлено только для фигур, допускающих текст.

JSON-представление 
{
  "autofitType": enum (AutofitType),
  "fontScale": number,
  "lineSpacingReduction": number
}
Поля
autofitType

enum ( AutofitType )

Тип автоподбора фигуры. Если тип автоподбора — AUTOFIT_TYPE_UNSPECIFIED , тип автоподбора наследуется от родительского заполнителя, если он существует. Полю автоматически присваивается значение NONE если сделан запрос, который может повлиять на размещение текста в ограничивающем текстовом поле. В этом случае fontScale применяется к fontSize , а lineSpacingReduction применяется к lineSpacing . Оба свойства также сбрасываются до значений по умолчанию.

fontScale

number

Масштаб шрифта, примененный к фигуре. Для фигур с autofitType NONE или SHAPE_AUTOFIT это значение является значением по умолчанию, равным 1. Для TEXT_AUTOFIT это значение, умноженное на fontSize , дает размер шрифта, отображаемый в редакторе.

Это свойство доступно только для чтения.

lineSpacingReduction

number

К фигуре применено уменьшение межстрочного интервала. Для фигур с autofitType NONE или SHAPE_AUTOFIT это значение является значением по умолчанию, равным 0. Для TEXT_AUTOFIT это значение, вычтенное из lineSpacing , дает межстрочный интервал, отображаемый в редакторе.

Это свойство доступно только для чтения.

Тип автоподбора

Типы автоподбора Shape .

Обратите внимание: хотя для запросов на чтение действительны все значения, для запросов на запись допустимы только AUTOFIT_TYPE_UNSPECIFIED и NONE .

Перечисления
AUTOFIT_TYPE_UNSPECIFIED Тип автоподбора не указан.
NONE Не выполнять автоподбор.
TEXT_AUTOFIT Сократите текст при переполнении, чтобы он соответствовал форме.
SHAPE_AUTOFIT Измените размер фигуры, чтобы она соответствовала тексту.