Shapes

Forma

Um tipo PageElement que representa uma forma genérica que não tem uma classificação mais específica. Para mais informações, consulte Dimensionar 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 marcadores de posição correspondentes em layouts e modelos.

Se definido, a forma é um marcador de posição, e todas as propriedades herdadas podem ser resolvidas analisando o marcador de posição pai 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 ECMA-376 5ª edição.

Enums
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 curvado. 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 dobrada para cima. Corresponde a ECMA-376 ST_ShapeType 'bentUpArrow'
BEVEL Forma chanfrada. Corresponde a "bevel" do ECMA-376 ST_ShapeType
BLOCK_ARC Forma de arco de bloco. Corresponde a "blockArc" do ECMA-376 ST_ShapeType
BRACE_PAIR Forma do par de chaves. Corresponde a "bracePair" do ECMA-376 ST_ShapeType
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 Forma de seta. Corresponde a ECMA-376 ST_ShapeType "chevron"
CHORD Forma de acorde. Corresponde a ECMA-376 ST_ShapeType 'chord'
CLOUD Forma de nuvem. Corresponde a ECMA-376 ST_ShapeType 'cloud'
CORNER Forma de canto. Corresponde a "corner" de ECMA-376 ST_ShapeType
CUBE Forma de cubo. Corresponde a ECMA-376 ST_ShapeType 'cube'
CURVED_DOWN_ARROW Forma de seta curvada 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 curvada para cima. Corresponde a ECMA-376 ST_ShapeType 'curvedUpArrow'
DECAGON Forma 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 Forma de dodecágono. Corresponde a ECMA-376 ST_ShapeType 'dodecagon'
DONUT Em forma de rosquinha. 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 'seta para baixo'
DOWN_ARROW_CALLOUT Forma de seta para baixo do texto explicativo. Corresponde a ECMA-376 ST_ShapeType "downArrowCallout"
FOLDED_CORNER Forma de canto dobrado. Corresponde a ECMA-376 ST_ShapeType 'foldedCorner'
FRAME Forma do frame. Corresponde a "frame" do ECMA-376 ST_ShapeType
HALF_FRAME Forma de meio quadro. Corresponde a "halfFrame" do ECMA-376 ST_ShapeType
HEART Forma 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 Forma de placa de casa. Corresponde a ECMA-376 ST_ShapeType 'homePlate'
HORIZONTAL_SCROLL Forma de rolagem horizontal. Corresponde a ECMA-376 ST_ShapeType "horizontalScroll"
IRREGULAR_SEAL_1 Forma irregular de 1 selo. Corresponde a ECMA-376 ST_ShapeType 'irregularSeal1'
IRREGULAR_SEAL_2 Forma de lacre 2 irregular. Corresponde a ECMA-376 ST_ShapeType 'irregularSeal2'
LEFT_ARROW Forma de seta para a esquerda. Corresponde a ECMA-376 ST_ShapeType 'seta para a esquerda'
LEFT_ARROW_CALLOUT Forma da seta para a esquerda do texto explicativo. Corresponde a "leftArrowCallout" do ECMA-376 ST_ShapeType
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 para a direita. Corresponde a ECMA-376 ST_ShapeType 'leftRightArrow'
LEFT_RIGHT_ARROW_CALLOUT Forma de seta para a esquerda e para a direita. Corresponde a ECMA-376 ST_ShapeType "leftRightArrowCallout"
LEFT_RIGHT_UP_ARROW Forma de seta para a esquerda, direita e cima. Corresponde a ECMA-376 ST_ShapeType 'seta para cima à esquerda e à direita'
LEFT_UP_ARROW Forma de seta para cima e para a esquerda. Corresponde a ECMA-376 ST_ShapeType 'seta para cima à esquerda'
LIGHTNING_BOLT Forma de raio. Corresponde a ECMA-376 ST_ShapeType 'lightningBolt'
MATH_DIVIDE Dividir a 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 menos. Corresponde a ECMA-376 ST_ShapeType 'mathMinus'
MATH_MULTIPLY Forma matemática de multiplicação. Corresponde a "mathMultiply" do ECMA-376 ST_ShapeType
MATH_NOT_EQUAL Forma matemática diferente. 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 proibição de 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 Forma de octógono. Corresponde a ECMA-376 ST_ShapeType "octagon"
PARALLELOGRAM Forma de paralelogramo. Corresponde a "parallelogram" do ECMA-376 ST_ShapeType
PENTAGON Forma de pentágono. Corresponde a ECMA-376 ST_ShapeType 'pentagon'
PIE Forma de pizza. Corresponde a ECMA-376 ST_ShapeType 'pie'
PLAQUE Forma da placa. Corresponde a ECMA-376 ST_ShapeType "plaque"
PLUS Forma de adição. Corresponde a ECMA-376 ST_ShapeType 'plus'
QUAD_ARROW Forma de seta cruzada. Corresponde a ECMA-376 ST_ShapeType 'quadArrow'
QUAD_ARROW_CALLOUT Forma de seta cruzada do texto explicativo. Corresponde a "quadArrowCallout" do ECMA-376 ST_ShapeType
RIBBON Forma de fita. Corresponde a "ribbon" do ECMA-376 ST_ShapeType
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 'seta para a direita'
RIGHT_ARROW_CALLOUT Forma de seta para a direita. 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 direito. Corresponde a ECMA-376 ST_ShapeType "rightBracket"
ROUND_1_RECTANGLE Forma retangular com um canto arredondado. Corresponde a ECMA-376 ST_ShapeType 'round1Rect'
ROUND_2_DIAGONAL_RECTANGLE Duas formas retangulares com cantos arredondados em diagonal. Corresponde a ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE Duas formas retangulares 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 Uma forma retangular com um canto cortado. Corresponde a ECMA-376 ST_ShapeType 'snip1Rect'
SNIP_2_DIAGONAL_RECTANGLE Duas formas retangulares com cortes diagonais. Corresponde a ECMA-376 ST_ShapeType 'snip2DiagRect'
SNIP_2_SAME_RECTANGLE Duas formas retangulares com cantos cortados no mesmo lado. Corresponde a ECMA-376 ST_ShapeType 'snip2SameRect'
SNIP_ROUND_RECTANGLE Uma forma retangular com um canto arredondado. Corresponde a ECMA-376 ST_ShapeType 'snipRoundRect'
STAR_10 Estrela de dez pontas. Corresponde a ECMA-376 ST_ShapeType 'star10'
STAR_12 Estrela de 12 pontas. Corresponde a ECMA-376 ST_ShapeType 'star12'
STAR_16 Estrela de 16 pontas. Corresponde a ECMA-376 ST_ShapeType 'star16'
STAR_24 Forma 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 Estrela de cinco pontas. Corresponde a ECMA-376 ST_ShapeType 'star5'
STAR_6 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 Estrela de oito pontas. Corresponde a ECMA-376 ST_ShapeType 'star8'
STRIPED_RIGHT_ARROW Forma de seta para a direita listrada. Corresponde a ECMA-376 ST_ShapeType 'stripedRightArrow'
SUN Forma de sol. Corresponde a ECMA-376 ST_ShapeType 'sun'
TRAPEZOID Forma trapezoidal. Corresponde a ECMA-376 ST_ShapeType 'trapezoid'
TRIANGLE Forma triangular. Corresponde a ECMA-376 ST_ShapeType 'triangle'
UP_ARROW Forma de seta para cima. Corresponde a ECMA-376 ST_ShapeType 'seta para cima'
UP_ARROW_CALLOUT Forma de seta para cima. Corresponde a "upArrowCallout" do ECMA-376 ST_ShapeType
UP_DOWN_ARROW Forma de seta para cima e para baixo. Corresponde a ECMA-376 ST_ShapeType "upDownArrow"
UTURN_ARROW Forma de seta em 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 losango para indicação. Corresponde a "wedgeEllipseCallout" do ECMA-376 ST_ShapeType
WEDGE_RECTANGLE_CALLOUT Forma retangular do texto explicativo. Corresponde a "wedgeRectCallout" do ECMA-376 ST_ShapeType
WEDGE_ROUND_RECTANGLE_CALLOUT Forma de retângulo redondo com texto explicativo. Corresponde a ECMA-376 ST_ShapeType 'wedgeRoundRectCallout'
FLOW_CHART_ALTERNATE_PROCESS Forma de fluxo de processo alternativo. Corresponde a ECMA-376 ST_ShapeType "flowChartAlternateProcess"
FLOW_CHART_COLLATE Forma do fluxo de agrupamento. Corresponde a "flowChartCollate" do ECMA-376 ST_ShapeType
FLOW_CHART_CONNECTOR Forma do fluxo do conector. Corresponde a "flowChartConnector" do ECMA-376 ST_ShapeType
FLOW_CHART_DECISION Forma do fluxo de decisão. Corresponde a "flowChartDecision" do ECMA-376 ST_ShapeType
FLOW_CHART_DELAY Forma do fluxo de atraso. Corresponde a "flowChartDelay" do ECMA-376 ST_ShapeType
FLOW_CHART_DISPLAY Forma do fluxo de exibição. Corresponde a "flowChartDisplay" do ECMA-376 ST_ShapeType
FLOW_CHART_DOCUMENT Forma do fluxo do documento. Corresponde a ECMA-376 ST_ShapeType "flowChartDocument"
FLOW_CHART_EXTRACT Extrair a forma do 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 do fluxo de armazenamento interno. Corresponde a ECMA-376 ST_ShapeType 'flowChartInternalStorage'
FLOW_CHART_MAGNETIC_DISK Forma do fluxo de disco magnético. Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticDisk'
FLOW_CHART_MAGNETIC_DRUM Forma do fluxo do tambor magnético. Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticDrum'
FLOW_CHART_MAGNETIC_TAPE Forma do fluxo de fita magnética. Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticTape'
FLOW_CHART_MANUAL_INPUT Forma do fluxo de entrada manual. Corresponde a "flowChartManualInput" do ECMA-376 ST_ShapeType
FLOW_CHART_MANUAL_OPERATION Forma do fluxo de operação manual. Corresponde a "flowChartManualOperation" do ECMA-376 ST_ShapeType
FLOW_CHART_MERGE Forma de fluxo de mesclagem. 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 do 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 predefinido. 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 do fluxo de processo. Corresponde a "flowChartProcess" do ECMA-376 ST_ShapeType
FLOW_CHART_PUNCHED_CARD Forma do fluxo de cartão perfurado. Corresponde a ECMA-376 ST_ShapeType 'flowChartPunchedCard'
FLOW_CHART_PUNCHED_TAPE Forma do fluxo da fita perfurada. 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 Forma do fluxo do Terminator. 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 de seta para o norte.
SPEECH Forma de fala.
STARBURST Forma de estrela.
TEARDROP Forma 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 callout. Corresponde a ECMA-376 ST_ShapeType 'cloudCallout'
CUSTOM Forma personalizada.

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 uma forma de 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 na forma.

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 de plano de fundo da forma. Se não for definido, o preenchimento de plano de fundo será herdado de um marcador de posição pai, se houver. Se a forma não tiver um 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 slides.

outline

object (Outline)

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

shadow

object (Shadow)

As propriedades de sombra da forma. Se não for definido, a sombra será herdada de um marcador pai, se houver. Se a forma não tiver um pai, a sombra padrão vai corresponder aos padrões das novas formas criadas no editor de slides. Esta propriedade é somente leitura.

contentAlignment

enum (ContentAlignment)

O alinhamento do conteúdo na forma. Se unspecified, o alinhamento é herdado de um marcador de posição pai, se houver. Se a forma não tiver um pai, o alinhamento padrão será igual ao de novas formas criadas no editor de slides.

autofit

object (Autofit)

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

ShapeBackgroundFill

O preenchimento de segundo plano 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 de plano de fundo.

Atualizar o preenchimento de uma forma vai atualizar implicitamente esse campo para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para que uma forma não tenha preenchimento, 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 de 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 pai, se houver. O campo é definido automaticamente como NONE se uma solicitação for feita que possa 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 da 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 fornece o tamanho da fonte renderizado no editor.

Esta 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 fornece o espaçamento entre linhas renderizado no editor.

Esta propriedade é somente leitura.

AutofitType

Os tipos de ajuste automático de uma 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.

Enums
AUTOFIT_TYPE_UNSPECIFIED O tipo de ajuste automático não foi especificado.
NONE Não ajustar automaticamente.
TEXT_AUTOFIT Reduzir o texto no estouro para ajustar à forma.
SHAPE_AUTOFIT Redimensione a forma para ajustar o texto.