Shapes

Форма

Элемент PageElement типа 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 File Formats - Fundamentals and Markup Language Reference", часть 1 5-го издания ECMA-376 .

Перечисления
TYPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
TEXT_BOX Форма текстового поля.
RECTANGLE Прямоугольная форма. Соответствует типу формы ECMA-376 ST_ShapeType 'rect'.
ROUND_RECTANGLE Прямоугольная форма со скругленными углами. Соответствует ECMA-376 ST_ShapeType 'roundRect'.
ELLIPSE Эллиптическая форма. Соответствует ECMA-376 ST_ShapeType 'ellipse'.
ARC Изогнутая дугообразная форма. Соответствует ECMA-376 ST_ShapeType 'arc'.
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 'can'.
CHEVRON Форма шеврона. Соответствует ECMA-376 ST_ShapeType 'chevron'.
CHORD Форма аккорда. Соответствует ECMA-376 ST_ShapeType 'chord'.
CLOUD Форма облака. Соответствует ECMA-376 ST_ShapeType 'cloud'.
CORNER Форма угла. Соответствует типу формы ECMA-376 ST_ShapeType 'corner'.
CUBE Кубическая форма. Соответствует ECMA-376 ST_ShapeType 'cube'.
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 'decagon'.
DIAGONAL_STRIPE Диагональная полоса. Соответствует ECMA-376 ST_ShapeType 'diagStripe'.
DIAMOND Форма ромба. Соответствует ECMA-376 ST_ShapeType 'diamond'.
DODECAGON Форма двенадцатиугольника. Соответствует ECMA-376 ST_ShapeType 'dodecagon'.
DONUT Форма пончика. Соответствует ECMA-376 ST_ShapeType 'donut'.
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 'frame'.
HALF_FRAME Форма половины рамки. Соответствует ECMA-376 ST_ShapeType 'halfFrame'.
HEART Форма сердца. Соответствует ECMA-376 ST_ShapeType 'heart'.
HEPTAGON Форма семиугольника. Соответствует ECMA-376 ST_ShapeType 'heptagon'.
HEXAGON Шестиугольная форма. Соответствует ECMA-376 ST_ShapeType 'hexagon'.
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 'moon'.
NO_SMOKING Форма, исключающая курение. Соответствует ECMA-376 ST_ShapeType 'noSmoking'.
NOTCHED_RIGHT_ARROW Зазубренная форма стрелки вправо. Соответствует ECMA-376 ST_ShapeType 'notchedRightArrow'.
OCTAGON Восьмиугольная форма. Соответствует ECMA-376 ST_ShapeType 'octagon'.
PARALLELOGRAM Форма параллелограмма. Соответствует ECMA-376 ST_ShapeType 'parallelogram'.
PENTAGON Пятиугольная форма. Соответствует ECMA-376 ST_ShapeType 'pentagon'.
PIE Форма пирога. Соответствует ECMA-376 ST_ShapeType 'pie'.
PLAQUE Форма бляшки. Соответствует ECMA-376 ST_ShapeType 'plaque'.
PLUS Форма «плюс». Соответствует ECMA-376 ST_ShapeType 'plus'.
QUAD_ARROW Форма четырех стрелок. Соответствует ECMA-376 ST_ShapeType 'quadArrow'.
QUAD_ARROW_CALLOUT Обозначение в виде четырех стрелок. Соответствует ECMA-376 ST_ShapeType 'quadArrowCallout'.
RIBBON Форма ленты. Соответствует ECMA-376 ST_ShapeType 'ribbon'.
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 'sun'.
TRAPEZOID Трапециевидная форма. Соответствует ECMA-376 ST_ShapeType 'trapezoid'.
TRIANGLE Форма треугольника. Соответствует типу формы ECMA-376 ST_ShapeType 'triangle'.
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 'wave'.
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 'teardrop'.
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 )

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

ShapeBackgroundFill

Фоновая заливка фигуры.

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 если выполняется запрос, который может повлиять на подгонку текста внутри ограничивающего текстового поля. В этом случае к fontSize применяется fontScale , а к параметру 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 Измените размер фигуры, чтобы она соответствовала тексту.