Shapes

Forma

Um tipo PageElement que representa uma forma genérica sem uma classificação mais específica. Para mais informações, consulte Redimensionar e posicionar elementos da página.

Representação JSON
{
  "shapeType": enum (Type),
  "text": {
    object (TextContent)
  },
  "shapeProperties": {
    object (ShapeProperties)
  },
  "placeholder": {
    object (Placeholder)
  }
}
Campos
shapeType

enum (Type)

O tipo da forma.

text

object (TextContent)

O conteúdo de texto da forma.

shapeProperties

object (ShapeProperties)

As propriedades da forma.

placeholder

object (Placeholder)

Os marcadores de posição são elementos da página que herdam dos marcadores correspondentes em layouts e páginas master.

Se definido, a forma é um marcador de posição e todas as propriedades herdadas podem ser resolvidas consultando o marcador de posição principal identificado pelo campo Placeholder.parent_object_id.

Tipo

Os tipos de forma.

Muitas dessas formas correspondem a formas predefinidas do padrão ECMA-376. Para mais informações, consulte a descrição do tipo simples "ST_ShapeType" na seção 20.1.10.56 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", parte 1 da 5ª edição da ECMA-376.

Tipos enumerados
TYPE_UNSPECIFIED Valor padrão. Esse valor não é usado.
TEXT_BOX Forma da caixa de texto.
RECTANGLE Forma retangular. Corresponde a ECMA-376 ST_ShapeType "rect"
ROUND_RECTANGLE Forma retangular com cantos arredondados. Corresponde a ECMA-376 ST_ShapeType "roundRect"
ELLIPSE Forma de elipse. Corresponde a ECMA-376 ST_ShapeType "ellipse"
ARC Forma de arco curvo. Corresponde a ECMA-376 ST_ShapeType "arc"
BENT_ARROW Forma de seta dobrada. Corresponde a ECMA-376 ST_ShapeType "bentArrow"
BENT_UP_ARROW Forma de seta curvada para cima. Corresponde a ECMA-376 ST_ShapeType "bentUpArrow"
BEVEL Forma do bisel. Corresponde a ECMA-376 ST_ShapeType "bevel"
BLOCK_ARC Forma de arco de bloco. Corresponde a ECMA-376 ST_ShapeType "blockArc"
BRACE_PAIR Forma do par de chaves. Corresponde a ECMA-376 ST_ShapeType "bracePair"
BRACKET_PAIR Forma do par de colchetes. Corresponde a ECMA-376 ST_ShapeType "bracketPair"
CAN Pode moldar. Corresponde a ECMA-376 ST_ShapeType "can"
CHEVRON Formato de chevron. Corresponde a ECMA-376 ST_ShapeType "chevron"
CHORD Formato do acorde. Corresponde a ECMA-376 ST_ShapeType "chord"
CLOUD Forma da nuvem. Corresponde a ECMA-376 ST_ShapeType "cloud"
CORNER Forma do canto. Corresponde a ECMA-376 ST_ShapeType "corner"
CUBE Formato de cubo. Corresponde a ECMA-376 ST_ShapeType "cube"
CURVED_DOWN_ARROW Forma de seta curva para baixo. Corresponde a ECMA-376 ST_ShapeType "curvedDownArrow"
CURVED_LEFT_ARROW Forma de seta curvada para a esquerda. Corresponde a ECMA-376 ST_ShapeType "curvedLeftArrow"
CURVED_RIGHT_ARROW Forma de seta curvada para a direita. Corresponde a ECMA-376 ST_ShapeType "curvedRightArrow"
CURVED_UP_ARROW Forma de seta curva para cima. Corresponde a ECMA-376 ST_ShapeType "curvedUpArrow"
DECAGON Formato de decágono. Corresponde a ECMA-376 ST_ShapeType "decagon"
DIAGONAL_STRIPE Forma de faixa diagonal. Corresponde a ECMA-376 ST_ShapeType "diagStripe"
DIAMOND Forma de losango. Corresponde a ECMA-376 ST_ShapeType "diamond"
DODECAGON Formato de dodecágono. Corresponde a ECMA-376 ST_ShapeType "dodecagon"
DONUT Formato de rosca. Corresponde a ECMA-376 ST_ShapeType "donut"
DOUBLE_WAVE Forma de onda dupla. Corresponde a ECMA-376 ST_ShapeType "doubleWave"
DOWN_ARROW Forma de seta para baixo. Corresponde a ECMA-376 ST_ShapeType "downArrow"
DOWN_ARROW_CALLOUT Forma de seta para baixo de texto explicativo. Corresponde a ECMA-376 ST_ShapeType "downArrowCallout"
FOLDED_CORNER Forma de canto dobrado. Corresponde a ECMA-376 ST_ShapeType "foldedCorner"
FRAME Formato do frame. Corresponde a ECMA-376 ST_ShapeType "frame"
HALF_FRAME Forma de meio quadro. Corresponde a ECMA-376 ST_ShapeType "halfFrame"
HEART Formato de coração. Corresponde a ECMA-376 ST_ShapeType "heart"
HEPTAGON Forma de heptágono. Corresponde a ECMA-376 ST_ShapeType "heptagon"
HEXAGON Forma hexagonal. Corresponde a ECMA-376 ST_ShapeType "hexagon"
HOME_PLATE Formato da base inicial. Corresponde a ECMA-376 ST_ShapeType "homePlate"
HORIZONTAL_SCROLL Forma de rolagem horizontal. Corresponde a ECMA-376 ST_ShapeType "horizontalScroll"
IRREGULAR_SEAL_1 Formato irregular do lacre 1. Corresponde a ECMA-376 ST_ShapeType "irregularSeal1"
IRREGULAR_SEAL_2 Formato irregular do lacre 2. Corresponde a ECMA-376 ST_ShapeType "irregularSeal2"
LEFT_ARROW Forma de seta para a esquerda. Corresponde a ECMA-376 ST_ShapeType "leftArrow"
LEFT_ARROW_CALLOUT Forma de seta para a esquerda de texto explicativo. Corresponde a ECMA-376 ST_ShapeType "leftArrowCallout"
LEFT_BRACE Forma de chave esquerda. Corresponde a ECMA-376 ST_ShapeType "leftBrace"
LEFT_BRACKET Forma de colchete esquerdo. Corresponde a ECMA-376 ST_ShapeType "leftBracket"
LEFT_RIGHT_ARROW Forma de seta para a esquerda e a direita. Corresponde a ECMA-376 ST_ShapeType "leftRightArrow"
LEFT_RIGHT_ARROW_CALLOUT Forma de texto explicativo em seta para esquerda e para direita. Corresponde a ECMA-376 ST_ShapeType "leftRightArrowCallout"
LEFT_RIGHT_UP_ARROW Forma de seta para cima, esquerda e direita. Corresponde a ECMA-376 ST_ShapeType "leftRightUpArrow"
LEFT_UP_ARROW Forma de seta para cima à esquerda. Corresponde a ECMA-376 ST_ShapeType "leftUpArrow"
LIGHTNING_BOLT Formato de raio. Corresponde a ECMA-376 ST_ShapeType "lightningBolt"
MATH_DIVIDE Dividir forma matemática. Corresponde a ECMA-376 ST_ShapeType "mathDivide"
MATH_EQUAL Forma matemática igual. Corresponde a ECMA-376 ST_ShapeType "mathEqual"
MATH_MINUS Forma matemática de subtração. Corresponde a ECMA-376 ST_ShapeType "mathMinus"
MATH_MULTIPLY Multiplicar forma matemática. Corresponde a ECMA-376 ST_ShapeType "mathMultiply"
MATH_NOT_EQUAL Formas matemáticas diferentes. Corresponde a ECMA-376 ST_ShapeType "mathNotEqual"
MATH_PLUS Forma matemática de adição. Corresponde a ECMA-376 ST_ShapeType "mathPlus"
MOON Forma de lua. Corresponde a ECMA-376 ST_ShapeType "moon"
NO_SMOKING Forma de proibido fumar. Corresponde a ECMA-376 ST_ShapeType "noSmoking"
NOTCHED_RIGHT_ARROW Forma de seta entalhada para a direita. Corresponde a ECMA-376 ST_ShapeType "notchedRightArrow"
OCTAGON Formato octogonal. Corresponde a ECMA-376 ST_ShapeType "octagon"
PARALLELOGRAM Formato de paralelogramo. Corresponde a ECMA-376 ST_ShapeType "parallelogram"
PENTAGON Formato de pentágono. Corresponde a ECMA-376 ST_ShapeType "pentagon"
PIE Formato de pizza. Corresponde a ECMA-376 ST_ShapeType "pie"
PLAQUE Formato da placa. Corresponde a ECMA-376 ST_ShapeType "plaque"
PLUS Forma de mais. Corresponde a ECMA-376 ST_ShapeType "plus"
QUAD_ARROW Forma de seta quádrupla. Corresponde a ECMA-376 ST_ShapeType "quadArrow"
QUAD_ARROW_CALLOUT Forma de texto explicativo com quatro setas. Corresponde a ECMA-376 ST_ShapeType "quadArrowCallout"
RIBBON Forma de fita. Corresponde a ECMA-376 ST_ShapeType "ribbon"
RIBBON_2 Forma de fita 2. Corresponde a ECMA-376 ST_ShapeType "ribbon2"
RIGHT_ARROW Forma de seta para a direita. Corresponde a ECMA-376 ST_ShapeType "rightArrow"
RIGHT_ARROW_CALLOUT Forma de seta para a direita do texto explicativo. Corresponde a ECMA-376 ST_ShapeType "rightArrowCallout"
RIGHT_BRACE Forma de chave direita. Corresponde a ECMA-376 ST_ShapeType "rightBrace"
RIGHT_BRACKET Forma de colchete à direita. Corresponde a ECMA-376 ST_ShapeType "rightBracket"
ROUND_1_RECTANGLE Um retângulo com cantos arredondados. Corresponde a ECMA-376 ST_ShapeType "round1Rect"
ROUND_2_DIAGONAL_RECTANGLE Dois retângulos com cantos arredondados na diagonal. Corresponde a ECMA-376 ST_ShapeType "round2DiagRect"
ROUND_2_SAME_RECTANGLE Dois retângulos com cantos arredondados no mesmo lado. Corresponde a ECMA-376 ST_ShapeType "round2SameRect"
RIGHT_TRIANGLE Forma de triângulo retângulo. Corresponde a ECMA-376 ST_ShapeType "rtTriangle"
SMILEY_FACE Forma de rosto sorridente. Corresponde a ECMA-376 ST_ShapeType "smileyFace"
SNIP_1_RECTANGLE Um retângulo com um canto cortado. Corresponde a ECMA-376 ST_ShapeType "snip1Rect"
SNIP_2_DIAGONAL_RECTANGLE Dois retângulos com o canto cortado em diagonal. Corresponde a ECMA-376 ST_ShapeType "snip2DiagRect"
SNIP_2_SAME_RECTANGLE Dois retângulos com cantos cortados do mesmo lado. Corresponde a ECMA-376 ST_ShapeType "snip2SameRect"
SNIP_ROUND_RECTANGLE Um retângulo com um canto cortado e um arredondado. Corresponde a ECMA-376 ST_ShapeType "snipRoundRect"
STAR_10 Forma de estrela de dez pontas. Corresponde a ECMA-376 ST_ShapeType "star10"
STAR_12 Formato de estrela de 12 pontas. Corresponde a ECMA-376 ST_ShapeType "star12"
STAR_16 Forma de estrela de 16 pontas. Corresponde a ECMA-376 ST_ShapeType "star16"
STAR_24 Formato de estrela de 24 pontas. Corresponde a ECMA-376 ST_ShapeType "star24"
STAR_32 Forma de estrela de 32 pontas. Corresponde a ECMA-376 ST_ShapeType "star32"
STAR_4 Forma de estrela de quatro pontas. Corresponde a ECMA-376 ST_ShapeType "star4"
STAR_5 Forma de estrela de cinco pontas. Corresponde a ECMA-376 ST_ShapeType "star5"
STAR_6 Forma de estrela de seis pontas. Corresponde a ECMA-376 ST_ShapeType "star6"
STAR_7 Forma de estrela de sete pontas. Corresponde a ECMA-376 ST_ShapeType "star7"
STAR_8 Forma de estrela de oito pontas. Corresponde a ECMA-376 ST_ShapeType "star8"
STRIPED_RIGHT_ARROW Forma de seta listrada para a direita. Corresponde a ECMA-376 ST_ShapeType "stripedRightArrow"
SUN Forma de sol. Corresponde a ECMA-376 ST_ShapeType "sun"
TRAPEZOID Formato de trapézio. Corresponde a ECMA-376 ST_ShapeType "trapezoid"
TRIANGLE Formato de triângulo. Corresponde a ECMA-376 ST_ShapeType "triangle"
UP_ARROW Forma de seta para cima. Corresponde a ECMA-376 ST_ShapeType "upArrow"
UP_ARROW_CALLOUT Forma de texto explicativo em seta para cima. Corresponde a ECMA-376 ST_ShapeType "upArrowCallout"
UP_DOWN_ARROW Forma de seta para cima e para baixo. Corresponde a ECMA-376 ST_ShapeType "upDownArrow"
UTURN_ARROW Forma de seta em forma de U. Corresponde a ECMA-376 ST_ShapeType "uturnArrow"
VERTICAL_SCROLL Forma de rolagem vertical. Corresponde a ECMA-376 ST_ShapeType "verticalScroll"
WAVE Forma de onda. Corresponde a ECMA-376 ST_ShapeType "wave"
WEDGE_ELLIPSE_CALLOUT Forma de elipse em forma de cunha de destaque. Corresponde a ECMA-376 ST_ShapeType "wedgeEllipseCallout"
WEDGE_RECTANGLE_CALLOUT Forma de retângulo em forma de cunha de texto explicativo. Corresponde a ECMA-376 ST_ShapeType "wedgeRectCallout"
WEDGE_ROUND_RECTANGLE_CALLOUT Forma de retângulo arredondado em forma de cunha de texto explicativo. Corresponde a ECMA-376 ST_ShapeType "wedgeRoundRectCallout"
FLOW_CHART_ALTERNATE_PROCESS Forma alternativa de fluxo de processo. Corresponde a ECMA-376 ST_ShapeType "flowChartAlternateProcess"
FLOW_CHART_COLLATE Forma de fluxo de intercalação. Corresponde a ECMA-376 ST_ShapeType "flowChartCollate"
FLOW_CHART_CONNECTOR Forma do fluxo do conector. Corresponde a ECMA-376 ST_ShapeType "flowChartConnector"
FLOW_CHART_DECISION Forma de fluxo de decisão. Corresponde a ECMA-376 ST_ShapeType "flowChartDecision"
FLOW_CHART_DELAY Forma de fluxo de atraso. Corresponde a ECMA-376 ST_ShapeType "flowChartDelay"
FLOW_CHART_DISPLAY Mostrar forma de fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartDisplay"
FLOW_CHART_DOCUMENT Forma de fluxo de documentos. Corresponde a ECMA-376 ST_ShapeType "flowChartDocument"
FLOW_CHART_EXTRACT Extrair forma de fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartExtract"
FLOW_CHART_INPUT_OUTPUT Forma do fluxo de entrada e saída. Corresponde a ECMA-376 ST_ShapeType "flowChartInputOutput"
FLOW_CHART_INTERNAL_STORAGE Forma de fluxo de armazenamento interno. Corresponde a ECMA-376 ST_ShapeType "flowChartInternalStorage"
FLOW_CHART_MAGNETIC_DISK Forma de fluxo de disco magnético. Corresponde a ECMA-376 ST_ShapeType "flowChartMagneticDisk"
FLOW_CHART_MAGNETIC_DRUM Forma de fluxo de tambor magnético. Corresponde a ECMA-376 ST_ShapeType "flowChartMagneticDrum"
FLOW_CHART_MAGNETIC_TAPE Formato do fluxo da fita magnética. Corresponde a ECMA-376 ST_ShapeType "flowChartMagneticTape"
FLOW_CHART_MANUAL_INPUT Forma do fluxo de entrada manual. Corresponde a ECMA-376 ST_ShapeType "flowChartManualInput"
FLOW_CHART_MANUAL_OPERATION Forma de fluxo de operação manual. Corresponde a ECMA-376 ST_ShapeType "flowChartManualOperation"
FLOW_CHART_MERGE Mesclar forma de fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartMerge"
FLOW_CHART_MULTIDOCUMENT Forma de fluxo de vários documentos. Corresponde a ECMA-376 ST_ShapeType "flowChartMultidocument"
FLOW_CHART_OFFLINE_STORAGE Forma do fluxo de armazenamento off-line. Corresponde a ECMA-376 ST_ShapeType "flowChartOfflineStorage"
FLOW_CHART_OFFPAGE_CONNECTOR Forma de fluxo do conector fora da página. Corresponde a ECMA-376 ST_ShapeType "flowChartOffpageConnector"
FLOW_CHART_ONLINE_STORAGE Forma de fluxo de armazenamento on-line. Corresponde a ECMA-376 ST_ShapeType "flowChartOnlineStorage"
FLOW_CHART_OR ou forma de fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartOr"
FLOW_CHART_PREDEFINED_PROCESS Forma de fluxo de processo predefinida. Corresponde a ECMA-376 ST_ShapeType "flowChartPredefinedProcess"
FLOW_CHART_PREPARATION Forma do fluxo de preparação. Corresponde a ECMA-376 ST_ShapeType "flowChartPreparation"
FLOW_CHART_PROCESS Forma de fluxo de processo. Corresponde a ECMA-376 ST_ShapeType "flowChartProcess"
FLOW_CHART_PUNCHED_CARD Forma de fluxo de cartão perfurado. Corresponde a ECMA-376 ST_ShapeType "flowChartPunchedCard"
FLOW_CHART_PUNCHED_TAPE Forma de fluxo de fita de papel. Corresponde a ECMA-376 ST_ShapeType 'flowChartPunchedTape'
FLOW_CHART_SORT Forma do fluxo de classificação. Corresponde a ECMA-376 ST_ShapeType "flowChartSort"
FLOW_CHART_SUMMING_JUNCTION Forma do fluxo de junção de soma. Corresponde a ECMA-376 ST_ShapeType "flowChartSummingJunction"
FLOW_CHART_TERMINATOR Formato do fluxo de término. Corresponde a ECMA-376 ST_ShapeType "flowChartTerminator"
ARROW_EAST Forma de seta para o leste.
ARROW_NORTH_EAST Forma de seta para o nordeste.
ARROW_NORTH Forma da seta do norte.
SPEECH Forma da fala.
STARBURST Forma de explosão de estrela.
TEARDROP Formato de lágrima. Corresponde a ECMA-376 ST_ShapeType "teardrop"
ELLIPSE_RIBBON Forma de fita elíptica. Corresponde a ECMA-376 ST_ShapeType "ellipseRibbon"
ELLIPSE_RIBBON_2 Forma de fita elíptica 2. Corresponde a ECMA-376 ST_ShapeType "ellipseRibbon2"
CLOUD_CALLOUT Forma de nuvem de destaque. Corresponde a ECMA-376 ST_ShapeType "cloudCallout"
CUSTOM Formato personalizado.

ShapeProperties

As propriedades de um Shape.

Se a forma for um marcador de posição, conforme determinado pelo campo placeholder, essas propriedades poderão ser herdadas de um marcador de posição pai. A determinação do valor renderizado da propriedade depende do valor do campo propertyState correspondente.

Todas as configurações de ajuste automático de texto na forma são desativadas automaticamente por solicitações que podem afetar a forma como o texto se encaixa nela.

Representação JSON
{
  "shapeBackgroundFill": {
    object (ShapeBackgroundFill)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  },
  "contentAlignment": enum (ContentAlignment),
  "autofit": {
    object (Autofit)
  }
}
Campos
shapeBackgroundFill

object (ShapeBackgroundFill)

O preenchimento do plano de fundo da forma. Se não estiver definido, o preenchimento do plano de fundo será herdado de um marcador de posição principal, se houver. Se a forma não tiver um elemento pai, o preenchimento de plano de fundo padrão vai depender do tipo de forma, correspondendo aos padrões de novas formas criadas no editor de apresentações.

outline

object (Outline)

O contorno da forma. Se não estiver definido, o contorno será herdado de um marcador de posição principal, se houver. Se a forma não tiver um elemento pai, o contorno padrão vai depender do tipo de forma, correspondendo aos padrões de novas formas criadas no editor de Apresentações.

shadow

object (Shadow)

As propriedades de sombra da forma. Se não estiver definido, a sombra será herdada de um marcador de posição principal, se houver. Se a forma não tiver um elemento pai, a sombra padrão vai corresponder aos padrões de novas formas criadas no editor de apresentações. Essa propriedade é somente leitura.

contentAlignment

enum (ContentAlignment)

O alinhamento do conteúdo na forma. Se unspecified, o alinhamento será herdado de um marcador de posição principal, se houver. Se a forma não tiver um elemento pai, o alinhamento padrão vai corresponder ao alinhamento de novas formas criadas no editor de apresentações.

autofit

object (Autofit)

As propriedades de ajuste automático da forma. Essa propriedade só é definida para formas que permitem texto.

ShapeBackgroundFill

O preenchimento do plano de fundo da forma.

Representação 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.
}
Campos
propertyState

enum (PropertyState)

O estado da propriedade de preenchimento do plano de fundo.

Atualizar o preenchimento de uma forma atualiza implicitamente esse campo para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para não ter preenchimento em uma forma, defina este campo como NOT_RENDERED. Nesse caso, todos os outros campos de preenchimento definidos na mesma solicitação serão ignorados.

Campo de união kind. O tipo de preenchimento de plano de fundo. kind pode ser apenas um dos seguintes:
solidFill

object (SolidFill)

Preenchimento com cor sólida.

Ajuste automático

As propriedades de ajuste automático de um Shape. Essa propriedade só é definida para formas que permitem texto.

Representação JSON
{
  "autofitType": enum (AutofitType),
  "fontScale": number,
  "lineSpacingReduction": number
}
Campos
autofitType

enum (AutofitType)

O tipo de ajuste automático da forma. Se o tipo de ajuste automático for AUTOFIT_TYPE_UNSPECIFIED, ele será herdado de um marcador de posição principal, se houver. O campo é definido automaticamente como NONE se uma solicitação for feita e puder afetar o ajuste do texto na caixa de texto delimitadora. Nesse caso, o fontScale é aplicado ao fontSize e o lineSpacingReduction é aplicado ao lineSpacing. As duas propriedades também são redefinidas para os valores padrão.

fontScale

number

A escala de fonte aplicada à forma. Para formas com autofitType NONE ou SHAPE_AUTOFIT, esse valor é o padrão 1. Para TEXT_AUTOFIT, esse valor multiplicado pelo fontSize resulta no tamanho da fonte renderizada no editor.

Essa propriedade é somente leitura.

lineSpacingReduction

number

A redução do espaçamento entre linhas aplicada à forma. Para formas com autofitType, NONE ou SHAPE_AUTOFIT, esse valor é o padrão 0. Para TEXT_AUTOFIT, esse valor subtraído do lineSpacing resulta no espaçamento entre linhas renderizado no editor.

Essa propriedade é somente leitura.

AutofitType

Os tipos de ajuste automático de um Shape.

Embora todos os valores sejam válidos para solicitações de leitura, apenas AUTOFIT_TYPE_UNSPECIFIED e NONE são válidos para solicitações de gravação.

Tipos enumerados
AUTOFIT_TYPE_UNSPECIFIED O tipo de ajuste automático não foi especificado.
NONE Não ajustar automaticamente
TEXT_AUTOFIT Reduzir o texto quando houver excedente para ajustar-se à forma.
SHAPE_AUTOFIT Redimensione a forma para ajustar o texto.