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.55 документа «Форматы файлов Office Open XML — основы и справочник по языку разметки», часть 1 ECMA-376, 4-е издание .

перечисления
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 'bevel'
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 'лента2'
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 'стрелка вверх'
UP_ARROW_CALLOUT Выноска со стрелкой вверх. Соответствует ECMA-376 ST_ShapeType 'upArrowCallout'
UP_DOWN_ARROW Форма стрелки вверх вниз. Соответствует ECMA-376 ST_ShapeType 'upDownArrow'
UTURN_ARROW U-образная форма стрелки. Соответствует 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 'flowChartPredefinedProcess'
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 , дает межстрочный интервал, отображаемый в редакторе.

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

AutofitType

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

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