Shapes

Forma

Um tipo PageElement que representa uma forma genérica que não tem uma classificação mais específica.

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)

Marcadores são elementos de página herdados de marcadores de posição correspondentes em layouts e mestres.

Se definido, o formato será um marcador e qualquer propriedade herdada poderá ser resolvida observando o marcador pai identificado pelo campo Placeholder.parent_object_id.

Tipo

Os tipos de forma.

Muitas dessas formas correspondem às formas predefinidas do padrão ECMA-376. Mais informações sobre esses formatos podem ser encontradas na descrição do tipo simples "ST_ShapeType" na seção 20.1.10.55 de "Formatos de arquivos XML abertos do Office: referência da linguagem de marcação e fundamentos", parte 1 da 4a edição ECMA-376 (em inglês).

Enums
TYPE_UNSPECIFIED O tipo de forma que não é predefinida.
TEXT_BOX Forma da caixa de texto.
RECTANGLE Forma retangular. Corresponde a ECMA-376 ST_ShapeType "rect".
ROUND_RECTANGLE Retângulo com canto arredondado. Corresponde a ECMA-376 ST_ShapeType 'roundRect'
ELLIPSE Forma da elipse. Corresponde a ECMA-376 ST_ShapeType "ellipse"
ARC Forma de arco curvado. Corresponde a "arc" de ECMA-376 ST_ShapeType
BENT_ARROW Formato da seta dobrada. Corresponde a 'bentArrow' do ECST-376 ST_ShapeType
BENT_UP_ARROW Formato da seta dobrada para cima. Corresponde a ECMA-376 ST_ShapeType "bentUpArrow"
BEVEL Moldura. Corresponde a ECMA-376 ST_ShapeType "bevel"
BLOCK_ARC Forma do 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 ST_ShapeType de ECMA-376
CAN Pode moldar. Corresponde a ECMA-376 ST_ShapeType "can"
CHEVRON Forma do divisor. Corresponde a ECST-376 ST_ShapeType "chevron"
CHORD Acorde em forma. Corresponde a ECMA-376 ST_ShapeType "chord"
CLOUD Formato do Cloud. Corresponde a "ST_ShapeType" de ECMA-376
CORNER Forma do canto. Corresponde ao "canner" de ECMA-376 ST_ShapeType
CUBE Forma do cubo. Corresponde a ECMA-376 ST_ShapeType "cube"
CURVED_DOWN_ARROW Formato de seta para baixo em curva. Corresponde a ECMA-376 ST_ShapeType "curvedDownArrow"
CURVED_LEFT_ARROW Formato de seta para a esquerda em curva. Corresponde a ECMA-376 ST_ShapeType "curvedLeftArrow"
CURVED_RIGHT_ARROW Forma de seta para a direita curvada. 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 do decágono. Corresponde a ECMA-376 ST_ShapeType "decagon"
DIAGONAL_STRIPE Formato de listra diagonal. Corresponde a ECMA-376 ST_ShapeType "diagStripe"
DIAMOND Forma de diamante. Corresponde a ECMA-376 ST_ShapeType "diamond"
DODECAGON Forma do dedecágono. Corresponde a ECMA-376 ST_ShapeType "dodecagon"
DONUT Formato da rosca. Corresponde a ECMA-376 ST_ShapeType "donut"
DOUBLE_WAVE Forma de onda dupla. Corresponde a ECMA-376 ST_ShapeType "doubleWave"
DOWN_ARROW Formato de seta para baixo. Corresponde a ECST-376 ST_ShapeType "seta para baixo"
DOWN_ARROW_CALLOUT Formato da seta para baixo da frase de destaque. Corresponde a ST_ShapeType ECMA-376 "downArrowCallout"
FOLDED_CORNER Formato do canto dobrado. Corresponde a ECMA-376 ST_ShapeType "foldedCorner"
FRAME Forma do frame. Corresponde a "frame" de ECMA-376 ST_ShapeType
HALF_FRAME Formato de meio quadro. Corresponde a "MAFFrame" de ECMA-376 ST_ShapeType
HEART Formato do coração. Corresponde a 'heart' de ECMA-376 ST_ShapeType
HEPTAGON Forma do heptágono. Corresponde a ECMA-376 ST_ShapeType "heptagon"
HEXAGON Forma hexagonal. Corresponde a ECMA-376 ST_ShapeType "hexagon"
HOME_PLATE Formato da placa da casa. Corresponde a ECMA-376 ST_ShapeType "homePlate"
HORIZONTAL_SCROLL Forma de rolagem horizontal. Corresponde a ECMA-376 ST_ShapeType "horizontalScroll"
IRREGULAR_SEAL_1 Foca irregular 1. Corresponde a ECMA-376 ST_ShapeType "irregularSeal1"
IRREGULAR_SEAL_2 Formato de vedação irregular 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 Formato da seta para a esquerda da frase de destaque. Corresponde a ECMA-376 ST_ShapeType "leftArrowCallout"
LEFT_BRACE Forma da chave esquerda. Corresponde a ECMA-376 ST_ShapeType "leftBrace"
LEFT_BRACKET Colchete esquerdo. Corresponde a ECMA-376 ST_ShapeType "leftBracket"
LEFT_RIGHT_ARROW Formato de seta para a esquerda e para a direita. Corresponde a ECMA-376 ST_ShapeType "leftRightArrow"
LEFT_RIGHT_ARROW_CALLOUT Texto da seta para a esquerda ao lado direito da frase de destaque. Corresponde a ECMA-376 ST_ShapeType "leftRightArrowCallout"
LEFT_RIGHT_UP_ARROW Formato de seta para a esquerda e para a direita. Corresponde a ECMA-376 ST_ShapeType "leftRightUpArrow"
LEFT_UP_ARROW Formato de seta para cima e para a esquerda. Corresponde a ECMA-376 ST_ShapeType "leftUpArrow"
LIGHTNING_BOLT Forma 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 menor. Corresponde a ECMA-376 ST_ShapeType "mathMinus"
MATH_MULTIPLY Multiplicar a forma matemática. Corresponde a ST_ShapeType do ECMA-376
MATH_NOT_EQUAL Diferente da forma matemática. Corresponde a ECMA-376 ST_ShapeType 'mathNotEqual'
MATH_PLUS Além de forma matemática. Corresponde a ECMA-376 ST_ShapeType "mathPlus"
MOON Forma da lua. Corresponde a ECMA-376 ST_ShapeType "moon"
NO_SMOKING Sem forma de fumo. Corresponde a ECMA-376 ST_ShapeType "noSmoking"
NOTCHED_RIGHT_ARROW Formato de seta para a direita com entalhe. Corresponde a ECMA-376 ST_ShapeType "notchedRightArrow"
OCTAGON Forma octogonal. Corresponde a "STtag" de ST_ShapeType do ECMA-376
PARALLELOGRAM Forma de paralelismo. Corresponde a ECST-376 ST_ShapeType "parallelogram"
PENTAGON Forma de pentágono. Corresponde a ECMA-376 ST_ShapeType "pentagon"
PIE Forma da pizza. Corresponde a "ST" de ECMA-376 ST_ShapeType
PLAQUE Formato da placa. Corresponde a "plaque" de ECMA-376 ST_ShapeType
PLUS Mais forma. Corresponde a ECMA-376 ST_ShapeType "plus"
QUAD_ARROW Forma de quatro setas. Corresponde a ECST-376 ST_ShapeType "quadArrow"
QUAD_ARROW_CALLOUT Forma de quatro setas da frase de destaque. Corresponde a ECMA-376 ST_ShapeType "quadArrowCallout"
RIBBON Forma de fita. Corresponde a "STBShapeType" de ECMA-376
RIBBON_2 Forma da faixa 2. Corresponde a ECMA-376 ST_ShapeType "ribbon2"
RIGHT_ARROW Formato de seta para a direita. Corresponde a ECST-376 ST_ShapeType "rightArrow"
RIGHT_ARROW_CALLOUT Formato da seta para a direita da frase de destaque. Corresponde a ECMA-376 ST_ShapeType "rightArrowCallout"
RIGHT_BRACE Chave direita. Corresponde a "STBShapeType" de ECMA-376 "rightBrace"
RIGHT_BRACKET Forma do colchete direito. Corresponde a "MABracket" de ECMA-376 ST_ShapeType
ROUND_1_RECTANGLE Um retângulo com um canto arredondado. Corresponde a ECMA-376 ST_ShapeType 'round1Rect'
ROUND_2_DIAGONAL_RECTANGLE Retângulo com dois cantos diagonais arredondados. Corresponde a ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE Retângulo com dois cantos arredondados no mesmo lado. Corresponde a ECMA-376 ST_ShapeType 'round2SameRect'
RIGHT_TRIANGLE Forma de triângulo à direita. Corresponde a ECMA-376 ST_ShapeType "rtTriangle"
SMILEY_FACE Formato facial 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 Formato do retângulo com dois cantos diagonais cortados. Corresponde a ECMA-376 ST_ShapeType "snip2DiagRect"
SNIP_2_SAME_RECTANGLE Formato do retângulo com dois cantos cortados. Corresponde a ECMA-376 ST_ShapeType "snip2SameRect"
SNIP_ROUND_RECTANGLE Um retângulo com um canto arredondado. Corresponde a ECMA-376 ST_ShapeType "snipRoundRect"
STAR_10 Forma de estrela de 10 pontas. Corresponde a ECMA-376 ST_ShapeType "star10"
STAR_12 Formato de 12 estrelas. Corresponde a ECMA-376 ST_ShapeType "star12"
STAR_16 Forma de 16 estrelas. Corresponde a ECMA-376 ST_ShapeType "star16"
STAR_24 24 formas em forma de estrela. Corresponde a ECMA-376 ST_ShapeType "star24"
STAR_32 Trinta e duas formas de estrela apontando. 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 Formato de seta para a direita listrado. Corresponde a ECMA-376 ST_ShapeType "stripedRightArrow"
SUN Formato do sol. Corresponde a "Sun" de ECMA-376 ST_ShapeType
TRAPEZOID Forma do trapézio. Corresponde a ECMA-376 ST_ShapeType "trapezoid"
TRIANGLE Forma triangular. Corresponde a "triangle" de ECMA-376 ST_ShapeType
UP_ARROW Formato de seta para cima. Corresponde a ECMA-376 ST_ShapeType "upArrow"
UP_ARROW_CALLOUT Formato da seta para cima da frase de destaque. Corresponde a ECMA-376 ST_ShapeType "upArrowCallout"
UP_DOWN_ARROW Seta para cima. Corresponde a ECMA-376 ST_ShapeType "upDownArrow"
UTURN_ARROW Forma de seta em retorno. Corresponde a ECMA-376 ST_ShapeType "uturnArrow"
VERTICAL_SCROLL Forma de rolagem vertical. Corresponde a ECST-Shape 376 ECMA "verticalScroll"
WAVE Forma de onda. Corresponde a "ST" Shape_376 "ST_ShapeType"
WEDGE_ELLIPSE_CALLOUT Formato da elipse do encaixe da frase de destaque. Corresponde a ECMA-376 ST_ShapeType "wedgeEllipseCallout"
WEDGE_RECTANGLE_CALLOUT Forma do retângulo do encaixe da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'wedgeRectCallout'
WEDGE_ROUND_RECTANGLE_CALLOUT Formato do retângulo arredondado do encaixe da frase de destaque. Corresponde a ECMA-376 ST_ShapeType "wedgeRoundRectCallout"
FLOW_CHART_ALTERNATE_PROCESS Alternar forma de fluxo do processo. Corresponde a ECMA-376 ST_ShapeType "flowChartAlternateProcess"
FLOW_CHART_COLLATE Agrupar forma de fluxo. Corresponde a "ST_ShapeType" ECMA-376 "flowChartCollate"
FLOW_CHART_CONNECTOR Forma do fluxo do conector. Corresponde a ECMA-376 ST_ShapeType "flowChartConnector"
FLOW_CHART_DECISION Formato do fluxo de decisão. Corresponde a ECMA-376 ST_ShapeType "flowChartDecision"
FLOW_CHART_DELAY Atrasar a forma do fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartDelay"
FLOW_CHART_DISPLAY Exibir forma de fluxo. Corresponde a ECST-376 "ST_ShapeType" "flowChartDisplay"
FLOW_CHART_DOCUMENT Forma do fluxo do documento. Corresponde a ECST-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 saída de entrada. 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 do 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 ECMA-376 ST_ShapeType "flowChartManualInput"
FLOW_CHART_MANUAL_OPERATION Forma do fluxo de operação manual. Corresponde a ECMA-376 ST_ShapeType "flowChartManualOperation"
FLOW_CHART_MERGE Mesclar forma do fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartMerge"
FLOW_CHART_MULTIDOCUMENT Forma de fluxo de vários documentos. Corresponde a ECST-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 predefinida de fluxo de processo. Corresponde a ECMA-376 ST_ShapeType "flowChartBooleanProcess"
FLOW_CHART_PREPARATION Forma do fluxo de preparação. Corresponde a ECMA-376 ST_ShapeType "flowChartPreparation"
FLOW_CHART_PROCESS Processe a forma do fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartProcess"
FLOW_CHART_PUNCHED_CARD Forma do fluxo do cartão perfurado. Corresponde a ECMA-376 ST_ShapeType "flowChartPunchedCard"
FLOW_CHART_PUNCHED_TAPE Forma do fluxo de fita perfurada. Corresponde a ECMA-376 ST_ShapeType "flowChartPunchedTape"
FLOW_CHART_SORT Classificar forma de fluxo. Corresponde a ECMA-376 ST_ShapeType 'flowChartSort'
FLOW_CHART_SUMMING_JUNCTION Somando a forma do fluxo de junção. Corresponde a ECMA-376 ST_ShapeType "flowChartSummingJunction"
FLOW_CHART_TERMINATOR Forma do fluxo do terminal. Corresponde a ECMA-376 ST_ShapeType "flowChartTerminator"
ARROW_EAST Formato de seta para o leste.
ARROW_NORTH_EAST Formato da seta nordeste.
ARROW_NORTH Forma de seta para o norte.
SPEECH Formato da fala.
STARBURST Forma de burst de estrela.
TEARDROP Formato de lágrima. Corresponde a "STarShape" de ECMA-376 ST_ShapeType
ELLIPSE_RIBBON Forma da faixa de elipse. Corresponde a "MASPseRibbon" de ECMA-376 ST_ShapeType
ELLIPSE_RIBBON_2 Forma da faixa elíptica 2. Corresponde a ECMA-376 ST_ShapeType 'ellipseRibbon2'
CLOUD_CALLOUT Formato da nuvem de frase de destaque. Corresponde a ECMA-376 ST_ShapeType "cloudCallout"
CUSTOM Forma personalizada.

Propriedades da forma

As propriedades de um Shape.

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

Todas as configurações de ajuste automático de texto na forma são desativadas automaticamente pelas solicitações que podem afetar o modo 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 do plano de fundo da forma. Se não definido, o preenchimento do plano de fundo será herdado de um marcador pai, se houver. Se o polígono não tiver pai, o preenchimento padrão do plano de fundo dependerá do tipo de polígono, correspondendo aos padrões para novos polígonos criados no editor do Apresentações Google.

outline

object (Outline)

O contorno da forma. Se não for definida, a estrutura de tópicos será herdada de um marcador de posição pai, se houver. Se a forma não tiver pai, o contorno padrão dependerá do tipo de forma, correspondendo aos padrões para novas formas criadas no editor do Apresentações.

shadow

object (Shadow)

As propriedades de sombra da forma. Se ela não for definida, a sombra será herdada de um marcador pai, se houver. Se a forma não tiver pai, a sombra padrão corresponderá aos novos formatos criados no editor do Apresentações. Esta propriedade é somente leitura.

contentAlignment

enum (ContentAlignment)

O alinhamento do conteúdo na forma. Se for unspecified, o alinhamento será herdado de um marcador pai, se houver. Se a forma não tiver pai, o alinhamento padrão corresponderá às novas formas criadas no editor do Apresentações.

autofit

object (Autofit)

As propriedades de ajuste automático da forma. Esta propriedade é definida apenas para formas que permitem texto.

ShapeBackgroundFill

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

Atualizar o preenchimento de uma forma atualizará esse campo implicitamente para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para que não haja preenchimento em uma forma, defina esse 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 do plano de fundo. kind pode ser apenas uma das seguintes opções:
solidFill

object (SolidFill)

Preenchimento de cor sólida.

Ajuste automático

As propriedades de ajuste automático de um Shape.

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 existir. O campo será definido automaticamente como NONE se for feita uma solicitação que possa afetar o ajuste de texto dentro da 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 de 1. Para TEXT_AUTOFIT, esse valor multiplicado por fontSize fornece o tamanho da fonte que é 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 valor padrão de 0. Para TEXT_AUTOFIT, esse valor subtraído de lineSpacing fornece o espaçamento entre linhas renderizado no editor.

Esta propriedade é somente leitura.

Tipo de ajuste automático

Os tipos de ajuste automático de um Shape.

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