Shapes

Forma

Um PageElement tipo 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)

Os marcadores de posição são elementos de página que herdam os marcadores correspondentes em layouts e mestres.

Se definido, a forma será uma forma de marcador de posição e todas as propriedades herdadas poderão ser resolvidas analisando o marcador de posição pai identificado pelo Placeholder.parent_object_id .

Tipo

Os tipos de formas.

Muitas dessas formas correspondem a formas predefinidas do padrão ECMA-376. Mais informações sobre essas formas podem ser encontradas na descrição do "ST_ShapeType" tipo simples na seção 20.1.10.55 de "Formatos de arquivos XML abertos do Office – Fundamentos e referência de linguagem de marcação", parte 1 de ECMA-376 4a edição.

Enums
TYPE_UNSPECIFIED O tipo de forma não predefinido.
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 à "elipse" ECMA-376 ST_ShapeType
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 dobrada para cima. Corresponde a ECMA-376 ST_ShapeType "bentUpArrow"
BEVEL Forma do bisel. Corresponde ao "chanfro" ECMA-376 ST_ShapeType
BLOCK_ARC Forma do arco do 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 "supportPair"
CAN Pode ajustar. Corresponde a ECMA-376 ST_ShapeType "can"
CHEVRON Forma de xadrez. Corresponde a ECMA-376 ST_ShapeType "chevron"
CHORD Formato do acorde. Corresponde ao "chord" ECMA-376 ST_ShapeType
CLOUD forma de nuvem. Corresponde a ECMA-376 ST_ShapeType "cloud"
CORNER Forma dos cantos. Corresponde ao 'corner' 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 'curvedDownArrow' ECMA-376 ST_ShapeType
CURVED_LEFT_ARROW Forma de seta curvada para a esquerda. Corresponde a ECMA-376 ST_ShapeType "curvedLeftArrow"
CURVED_RIGHT_ARROW Forma da seta curvada para a direita. Corresponde a ECMA-376 ST_ShapeType "curvedRightArrow"
CURVED_UP_ARROW Forma de seta curvada para cima. Corresponde a "curvedUpArrow" de ECMA-376 ST_ShapeType
DECAGON Forma do decágono. Corresponde a ECMA-376 ST_ShapeType 'decagon'
DIAGONAL_STRIPE Forma de listra 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 Forma 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 da seta para baixo. Corresponde a ECMA-376 ST_ShapeType 'Seta para baixo'
DOWN_ARROW_CALLOUT Forma de seta para baixo da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'downArrow callout'
FOLDED_CORNER Forma do canto dobrado. Corresponde a ECMA-376 ST_ShapeType 'foldedCorner'
FRAME Forma da moldura. Corresponde ao 'frame' ECMA-376 ST_ShapeType
HALF_FRAME Forma do meio frame. Corresponde ao 'halfFrame' ECMA-376 ST_ShapeType
HEART Formato de coração. Corresponde ao "heart" de ECMA-376 ST_ShapeType
HEPTAGON Forma de heptágono. Corresponde a ECMA-376 ST_ShapeType "heptagon"
HEXAGON Forma hexagonal. Corresponde ao "hexágono" ECMA-376 ST_ShapeType
HOME_PLATE Forma da placa de início. Corresponde a ECMA-376 ST_ShapeType 'homePlate'
HORIZONTAL_SCROLL Forma de rolagem horizontal. Corresponde a ECMA-376 ST_ShapeType "horizontal vídeos"
IRREGULAR_SEAL_1 Forma de vedação irregular 1. Corresponde a ECMA-376 ST_ShapeType 'irregularSeal1'
IRREGULAR_SEAL_2 Forma de vedação irregular 2. Corresponde a ECMA-376 ST_ShapeType 'irregularSeal2'
LEFT_ARROW Forma da seta para a esquerda. Corresponde a ECMA-376 ST_ShapeType "leftArrow"
LEFT_ARROW_CALLOUT Forma da seta para a esquerda da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'leftArrow callout'
LEFT_BRACE Forma da chave esquerda. Corresponde a ECMA-376 ST_ShapeType "leftBrace"
LEFT_BRACKET Forma do colchete esquerdo. Corresponde a ECMA-376 ST_ShapeType 'leftBracket'
LEFT_RIGHT_ARROW Forma da 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 da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'leftRightArrow callout'
LEFT_RIGHT_UP_ARROW Forma de seta para a esquerda, para a direita. Corresponde a ECMA-376 ST_ShapeType "leftRightUpArrow"
LEFT_UP_ARROW Forma da seta para a esquerda e para cima. Corresponde a ECMA-376 ST_ShapeType "leftUpArrow"
LIGHTNING_BOLT Forma de um raio. Corresponde a ECMA-376 ST_ShapeType "lightningBolt"
MATH_DIVIDE Divida a forma matemática. Corresponde a ECMA-376 ST_ShapeType 'mathDivide'
MATH_EQUAL Forma matemática de igual. Corresponde a ECMA-376 ST_ShapeType 'mathEqual'
MATH_MINUS Menos forma matemática. Corresponde a ECMA-376 ST_ShapeType 'mathMinus'
MATH_MULTIPLY Multiplique a forma matemática. Corresponde a ECMA-376 ST_ShapeType 'mathMultiply'
MATH_NOT_EQUAL Forma matemática diferente. Corresponde a ECMA-376 ST_ShapeType "mathNotEqual"
MATH_PLUS Mais forma matemática. Corresponde a ECMA-376 ST_ShapeType "mathPlus"
MOON Forma da lua. Corresponde a ECMA-376 ST_ShapeType "moon"
NO_SMOKING Forma para não fumantes. Corresponde a ECMA-376 ST_ShapeType "noSmoking"
NOTCHED_RIGHT_ARROW Forma de seta para a direita entalhada. Corresponde a ECMA-376 ST_ShapeType "notchedRightRight"
OCTAGON Forma de octógono. Corresponde a ECMA-376 ST_ShapeType "octagon"
PARALLELOGRAM Forma de paralelogramo. Corresponde ao "parallelogram" do ECMA-376 ST_ShapeType
PENTAGON Formato de pentágono. Corresponde a ECMA-376 ST_ShapeType "pentagon"
PIE Forma da pizza. Corresponde a ECMA-376 ST_ShapeType "pie"
PLAQUE Formato da placa. Corresponde à "placa" ECMA-376 ST_ShapeType
PLUS Mais. Corresponde ao "plus" ECMA-376 ST_ShapeType
QUAD_ARROW Forma de uma seta quádrupla. Corresponde a ECMA-376 ST_ShapeType "quadArrow"
QUAD_ARROW_CALLOUT Forma de seta quádrupla da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'quadArrow callout'
RIBBON Forma da fita. Corresponde à "faixa" ECMA-376 ST_ShapeType
RIBBON_2 Forma da fita 2. Corresponde a ECMA-376 ST_ShapeType "ribbon2"
RIGHT_ARROW Forma da seta para a direita. Corresponde a ECMA-376 ST_ShapeType "rightArrow"
RIGHT_ARROW_CALLOUT Forma da seta para a direita da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'rightArrow callout'
RIGHT_BRACE Forma da chave direita. Corresponde a ECMA-376 ST_ShapeType "rightBrace"
RIGHT_BRACKET Forma do 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 Forma retangular com dois cantos diagonais arredondados. Corresponde a ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE Duas formas retangulares com cantos arredondados do mesmo lado. Corresponde a ECMA-376 ST_ShapeType 'round2SameRect'
RIGHT_TRIANGLE Forma de triângulo reta. Corresponde a ECMA-376 ST_ShapeType "rtTriangle"
SMILEY_FACE Formato 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 Forma retangular de dois cantos diagonais recortados. Corresponde a ECMA-376 ST_ShapeType 'snip2DiagRect'
SNIP_2_SAME_RECTANGLE Duas forma retangular de canto cortado do mesmo lado. Corresponde a ECMA-376 ST_ShapeType 'snip2SameRect'
SNIP_ROUND_RECTANGLE Forma retangular com um canto arredondado. Corresponde a ECMA-376 ST_ShapeType 'snipRoundRect'
STAR_10 Forma de uma 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 uma estrela de 16 pontas. Corresponde a ECMA-376 ST_ShapeType "star16"
STAR_24 Forma de 24 estrelas com pontas. Corresponde a ECMA-376 ST_ShapeType "star24"
STAR_32 Formato de estrela de 32 pontas. Corresponde a ECMA-376 ST_ShapeType "star32"
STAR_4 Forma de estrela com quatro pontas. Corresponde a ECMA-376 ST_ShapeType "star4"
STAR_5 Formato de estrela de cinco pontas. Corresponde a ECMA-376 ST_ShapeType "star5"
STAR_6 Forma de uma estrela de seis pontas. Corresponde a ECMA-376 ST_ShapeType "star6"
STAR_7 Forma de estrela com 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 para a direita listrada. Corresponde a ECMA-376 ST_ShapeType "stripedRightArrow"
SUN Forma do sol. Corresponde a ECMA-376 ST_ShapeType "s"
TRAPEZOID Forma de trapézio. Corresponde ao 'trapezoid' do ECMA-376 ST_ShapeType
TRIANGLE Forma de triângulo. Corresponde ao "triangle" de ECMA-376 ST_ShapeType
UP_ARROW Forma de seta para cima. Corresponde a ECMA-376 ST_ShapeType 'seta para cima'
UP_ARROW_CALLOUT Forma de seta para cima da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'upArrow callout'
UP_DOWN_ARROW Forma da 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 "vertical vídeos"
WAVE Forma de onda. Corresponde a "wave" ECMA-376 ST_ShapeType
WEDGE_ELLIPSE_CALLOUT Forma de elipse em cunha da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'wedgeEllipse callout'
WEDGE_RECTANGLE_CALLOUT Forma retangular de cunha para a frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'wedgeRect callout'
WEDGE_ROUND_RECTANGLE_CALLOUT Forma de retângulo arredondada com encaixe para frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'wedgeRoundRect callout'
FLOW_CHART_ALTERNATE_PROCESS Forma de fluxo de processo alternativa. Corresponde a ECMA-376 ST_ShapeType 'flowChartAlternateProcess'
FLOW_CHART_COLLATE Agrupar forma de fluxo. 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 do fluxo de decisão. Corresponde a ECMA-376 ST_ShapeType 'flowChartDecision'
FLOW_CHART_DELAY Formato do fluxo de atraso. Corresponde a ECMA-376 ST_ShapeType 'flowChartDelay'
FLOW_CHART_DISPLAY Mostra a forma do fluxo. Corresponde a ECMA-376 ST_ShapeType "flowChartDisplay"
FLOW_CHART_DOCUMENT Forma do fluxo do documento. Corresponde a ECMA-376 ST_ShapeType 'flowChartDocument'
FLOW_CHART_EXTRACT Extrair 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 do disco magnético. Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticDisk'
FLOW_CHART_MAGNETIC_DRUM Forma de fluxo de um tambor magnético. Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticDrum'
FLOW_CHART_MAGNETIC_TAPE Forma 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 do fluxo da 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 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 do 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 formato de fluxo. Corresponde a ECMA-376 ST_ShapeType 'flowChartOr'
FLOW_CHART_PREDEFINED_PROCESS Formato predefinido do fluxo do processo. Corresponde a ECMA-376 ST_ShapeType 'flowChartDefaultProcess'
FLOW_CHART_PREPARATION Forma do fluxo de preparação. Corresponde a ECMA-376 ST_ShapeType 'flowChartPreparation'
FLOW_CHART_PROCESS Forma do fluxo do 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 perfurada. Corresponde a ECMA-376 ST_ShapeType 'flowChartPunchedTape'
FLOW_CHART_SORT Classificar forma do fluxo. Corresponde a ECMA-376 ST_ShapeType 'flowChartSort'
FLOW_CHART_SUMMING_JUNCTION Forma do fluxo de junção. Corresponde a ECMA-376 ST_ShapeType 'flowChartSummingJunction'
FLOW_CHART_TERMINATOR Forma do fluxo do terminador. Corresponde a ECMA-376 ST_ShapeType 'flowChartTerminator'
ARROW_EAST Forma da seta para o leste.
ARROW_NORTH_EAST Forma de seta para o nordeste.
ARROW_NORTH Forma da seta para o norte.
SPEECH Forma da fala.
STARBURST Forma de explosão de estrela.
TEARDROP Forma de gota de lágrima. Corresponde a ECMA-376 ST_ShapeType "teardrop"
ELLIPSE_RIBBON Forma da faixa em elipse. Corresponde a ECMA-376 ST_ShapeType "ellipseRibbon"
ELLIPSE_RIBBON_2 Forma da faixa em elipse 2. Corresponde a ECMA-376 ST_ShapeType "ellipseRibbon2"
CLOUD_CALLOUT Formato da nuvem da frase de destaque. Corresponde a ECMA-376 ST_ShapeType 'cloud callout'
CUSTOM Formato personalizado.

ShapeProperties

As propriedades de um Shape:

Se a forma for uma forma de marcador de posição, conforme determinado pelo placeholder campo, essas propriedades poderão ser herdadas de uma forma de marcador de posição principal. A determinação do valor renderizado da propriedade depende do método propertyState .

As configurações de ajuste automático de texto na forma são desativadas automaticamente por solicitações que podem afetar o ajuste do texto.

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 for definido, o preenchimento do plano de fundo será herdado de um marcador de posição pai, se houver. Se a forma não tiver um pai, o preenchimento padrão do plano de fundo dependerá do tipo de forma, correspondendo aos padrões das novas formas criadas no editor do Apresentações.

outline

object (Outline)

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

shadow

object (Shadow)

As propriedades de sombra da forma. Se não for definida, a sombra será herdada de um marcador de posição 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 do Apresentações. Esta 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 pai, se houver. Se a forma não tiver pai, o alinhamento padrão corresponderá ao alinhamento das novas formas criadas no editor do Apresentações.

autofit

object (Autofit)

As propriedades de ajuste automático da forma. Essa propriedade é definida apenas 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 esse campo implicitamente 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 do plano de fundo. kind pode ser apenas uma das seguintes opções:
solidFill

object (SolidFill)

Preenchimento com 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, o tipo de ajuste automático será herdado de um marcador de posição pai, se houver. O campo é definido automaticamente como NONE se for feita uma solicitação que pode afetar o ajuste do texto dentro da caixa de texto delimitadora. Nesse caso, o fontScale é aplicada ao fontSize e o lineSpacingReduction é aplicada 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, que é o valor padrão 1. Para TEXT_AUTOFIT, este valor multiplicado pelo fontSize informa o tamanho da fonte que é renderizada no editor.

Esta propriedade é somente leitura.

lineSpacingReduction

number

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

Esta propriedade é somente leitura.

AutofitType

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 o texto quando houver excedente para ajustar a forma.
SHAPE_AUTOFIT Redimensione a forma para ajustá-la ao texto.