Shapes

Forme

Type PageElement représentant une forme générique qui n'a pas de classification plus spécifique. Pour en savoir plus, consultez la section Taille et position des éléments de page.

Représentation JSON 
{
  "shapeType": enum (Type),
  "text": {
    object (TextContent)
  },
  "shapeProperties": {
    object (ShapeProperties)
  },
  "placeholder": {
    object (Placeholder)
  }
}
Champs
shapeType

enum (Type)

Type de la forme.

text

object (TextContent)

Contenu textuel de la forme.

shapeProperties

object (ShapeProperties)

Propriétés de la forme.

placeholder

object (Placeholder)

Les espaces réservés sont des éléments de page qui héritent des espaces réservés correspondants dans les mises en page et les maîtres.

Si cette valeur est définie, la forme est une forme d'espace réservé, et toutes les propriétés héritées peuvent être résolues en examinant l'espace réservé parent identifié par le champ Placeholder.parent_object_id.

Type

Types de formes.

De nombreuses formes correspondent à des formes prédéfinies de la norme ECMA-376. Pour en savoir plus, consultez la description du type simple "ST_ShapeType" dans la section 20.1.10.56 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", partie 1 de la 5e édition de la norme ECMA-376.

Enums
TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
TEXT_BOX Forme de la zone de texte.
RECTANGLE Forme rectangulaire. Correspond à ECMA-376 ST_ShapeType "rect"
ROUND_RECTANGLE Rectangle à coins arrondis. Correspond à ECMA-376 ST_ShapeType "roundRect"
ELLIPSE Forme d'ellipse. Correspond à ECMA-376 ST_ShapeType "ellipse"
ARC Forme d'arc incurvé. Correspond à ECMA-376 ST_ShapeType "arc"
BENT_ARROW Forme de flèche incurvée. Correspond à ST_ShapeType ECMA-376 "bentArrow"
BENT_UP_ARROW Forme de flèche incurvée vers le haut. Correspond à ECMA-376 ST_ShapeType "bentUpArrow"
BEVEL Forme biseautée. Correspond à ECMA-376 ST_ShapeType "bevel"
BLOCK_ARC Forme d'arc de bloc. Correspond à ST_ShapeType ECMA-376 "blockArc"
BRACE_PAIR Forme de la paire d'accolades. Correspond à "bracePair" de ST_ShapeType ECMA-376
BRACKET_PAIR Forme de la paire de crochets. Correspond à la valeur "bracketPair" de ST_ShapeType ECMA-376
CAN Peut façonner. Correspond à ECMA-376 ST_ShapeType "can"
CHEVRON Forme en chevron. Correspond à ECMA-376 ST_ShapeType "chevron"
CHORD Forme d'accord. Correspond à ECMA-376 ST_ShapeType "chord"
CLOUD Forme de nuage. Correspond à ECMA-376 ST_ShapeType "cloud"
CORNER Forme des angles. Correspond à ECMA-376 ST_ShapeType "corner"
CUBE Forme cubique. Correspond à ECMA-376 ST_ShapeType "cube"
CURVED_DOWN_ARROW Forme de flèche courbée vers le bas. Correspond à ECMA-376 ST_ShapeType "curvedDownArrow"
CURVED_LEFT_ARROW Forme de flèche courbée vers la gauche. Correspond à ECMA-376 ST_ShapeType "curvedLeftArrow"
CURVED_RIGHT_ARROW Forme de flèche courbée vers la droite. Correspond à ECMA-376 ST_ShapeType "curvedRightArrow"
CURVED_UP_ARROW Forme de flèche courbée vers le haut. Correspond à ECMA-376 ST_ShapeType "curvedUpArrow"
DECAGON Forme décagonale. Correspond à ECMA-376 ST_ShapeType "décagone"
DIAGONAL_STRIPE Forme de bandes en diagonale. Correspond à ST_ShapeType ECMA-376 "diagStripe"
DIAMOND Forme de losange. Correspond à ECMA-376 ST_ShapeType "diamond"
DODECAGON Forme de dodécagone. Correspond à ST_ShapeType ECMA-376 "dodecagon"
DONUT Forme en anneau. Correspond à ECMA-376 ST_ShapeType "donut"
DOUBLE_WAVE Forme en double vague. Correspond à ST_ShapeType ECMA-376 "doubleWave"
DOWN_ARROW Forme de flèche vers le bas. Correspond à ECMA-376 ST_ShapeType "downArrow"
DOWN_ARROW_CALLOUT Forme de flèche vers le bas pour le callout. Correspond à ECMA-376 ST_ShapeType "downArrowCallout"
FOLDED_CORNER Forme d'angle corné. Correspond à ST_ShapeType ECMA-376 "foldedCorner"
FRAME Forme du cadre. Correspond à "frame" (cadre) dans ST_ShapeType ECMA-376
HALF_FRAME Forme demi-cadre. Correspond à ECMA-376 ST_ShapeType "halfFrame"
HEART Forme de cœur. Correspond à ECMA-376 ST_ShapeType "heart"
HEPTAGON Forme de heptagone. Correspond à "heptagone" dans ST_ShapeType ECMA-376
HEXAGON Forme hexagonale. Correspond à ECMA-376 ST_ShapeType "hexagone"
HOME_PLATE Forme de la plaque de but. Correspond à ECMA-376 ST_ShapeType "homePlate"
HORIZONTAL_SCROLL Forme de défilement horizontal. Correspond à ECMA-376 ST_ShapeType "horizontalScroll"
IRREGULAR_SEAL_1 Forme de joint 1 irrégulière. Correspond à ECMA-376 ST_ShapeType "irregularSeal1"
IRREGULAR_SEAL_2 Forme irrégulière du joint 2. Correspond à ST_ShapeType ECMA-376 "irregularSeal2"
LEFT_ARROW Forme de flèche vers la gauche. Correspond à ST_ShapeType ECMA-376 "leftArrow"
LEFT_ARROW_CALLOUT Forme de la flèche vers la gauche du callout. Correspond à ECMA-376 ST_ShapeType "leftArrowCallout"
LEFT_BRACE Forme de la parenthèse gauche. Correspond à ST_ShapeType ECMA-376 "leftBrace"
LEFT_BRACKET Forme de crochet ouvrant. Correspond à ECMA-376 ST_ShapeType "leftBracket"
LEFT_RIGHT_ARROW Forme de flèche bidirectionnelle gauche-droite. Correspond à ST_ShapeType ECMA-376 "leftRightArrow"
LEFT_RIGHT_ARROW_CALLOUT Rectangle à deux flèches horizontales Correspond à ST_ShapeType ECMA-376 "leftRightArrowCallout"
LEFT_RIGHT_UP_ARROW Forme de flèche vers la gauche, la droite et le haut. Correspond à ECMA-376 ST_ShapeType "leftRightUpArrow"
LEFT_UP_ARROW Forme de flèche vers le haut à gauche. Correspond à ST_ShapeType ECMA-376 "leftUpArrow"
LIGHTNING_BOLT Forme d'éclair. Correspond à ECMA-376 ST_ShapeType "lightningBolt"
MATH_DIVIDE Diviser une forme mathématique. Correspond à ST_ShapeType ECMA-376 "mathDivide"
MATH_EQUAL Forme mathématique égale. Correspond à ST_ShapeType ECMA-376 "mathEqual"
MATH_MINUS Forme mathématique moins. Correspond à ECMA-376 ST_ShapeType "mathMinus"
MATH_MULTIPLY Forme mathématique de multiplication. Correspond à ECMA-376 ST_ShapeType "mathMultiply"
MATH_NOT_EQUAL Forme mathématique "Non égal". Correspond à ECMA-376 ST_ShapeType "mathNotEqual"
MATH_PLUS Forme mathématique Plus. Correspond à ST_ShapeType ECMA-376 "mathPlus"
MOON Forme de lune. Correspond à ECMA-376 ST_ShapeType "moon"
NO_SMOKING Forme d'interdiction de fumer. Correspond à ECMA-376 ST_ShapeType "noSmoking"
NOTCHED_RIGHT_ARROW Forme de flèche droite à entaille. Correspond à ECMA-376 ST_ShapeType "notchedRightArrow"
OCTAGON Forme octogonale. Correspond à ECMA-376 ST_ShapeType "octagon"
PARALLELOGRAM Forme de parallélogramme. Correspond à ECMA-376 ST_ShapeType "parallélogramme"
PENTAGON Forme de pentagone. Correspond à ECMA-376 ST_ShapeType "pentagon"
PIE Forme de secteurs. Correspond à ECMA-376 ST_ShapeType "pie"
PLAQUE Forme de la plaque. Correspond à ECMA-376 ST_ShapeType "plaque"
PLUS Forme Plus. Correspond à ECMA-376 ST_ShapeType "plus"
QUAD_ARROW Forme en flèche à quatre pointes. Correspond à ECMA-376 ST_ShapeType "quadArrow"
QUAD_ARROW_CALLOUT Forme de callout avec quatre flèches. Correspond à ECMA-376 ST_ShapeType "quadArrowCallout"
RIBBON Forme de ruban. Correspond à "ruban" ST_ShapeType ECMA-376
RIBBON_2 Forme du ruban 2. Correspond à ECMA-376 ST_ShapeType "ruban2"
RIGHT_ARROW Forme de flèche vers la droite. Correspond à ECMA-376 ST_ShapeType "rightArrow"
RIGHT_ARROW_CALLOUT Forme de la flèche vers la droite du callout. Correspond à ECMA-376 ST_ShapeType "rightArrowCallout"
RIGHT_BRACE Forme d'accolade fermante. Correspond à ECMA-376 ST_ShapeType "rightBrace"
RIGHT_BRACKET Forme de crochet fermant. Correspond à ECMA-376 ST_ShapeType "rightBracket"
ROUND_1_RECTANGLE Rectangle à coin arrondi. Correspond à ECMA-376 ST_ShapeType "round1Rect"
ROUND_2_DIAGONAL_RECTANGLE Rectangle à deux coins arrondis en diagonale. Correspond à ST_ShapeType ECMA-376 "round2DiagRect"
ROUND_2_SAME_RECTANGLE Deux rectangles à deux coins arrondis même côté. Correspond à ECMA-376 ST_ShapeType "round2SameRect"
RIGHT_TRIANGLE Forme de triangle rectangle. Correspond à ST_ShapeType ECMA-376 "rtTriangle"
SMILEY_FACE Forme de visage souriant. Correspond à ECMA-376 ST_ShapeType "smileyFace"
SNIP_1_RECTANGLE Rectangle à un coin coupé. Correspond à ECMA-376 ST_ShapeType "snip1Rect"
SNIP_2_DIAGONAL_RECTANGLE Rectangle à deux coins coupés en diagonale. Correspond à ECMA-376 ST_ShapeType "snip2DiagRect"
SNIP_2_SAME_RECTANGLE Rectangle à deux coins coupés même côté. Correspond à ECMA-376 ST_ShapeType "snip2SameRect"
SNIP_ROUND_RECTANGLE Rectangle à coin coupé et arrondi Correspond à ECMA-376 ST_ShapeType "snipRoundRect"
STAR_10 Forme d'étoile à dix branches. Correspond à ECMA-376 ST_ShapeType "star10"
STAR_12 Forme d'étoile à douze branches. Correspond à ECMA-376 ST_ShapeType "star12"
STAR_16 Forme d'étoile à 16 branches. Correspond à ECMA-376 ST_ShapeType "star16"
STAR_24 Forme d'étoile à 24 branches. Correspond à ECMA-376 ST_ShapeType "star24"
STAR_32 Forme d'étoile à 32 branches. Correspond à ECMA-376 ST_ShapeType "star32"
STAR_4 Forme d'étoile à quatre branches. Correspond à ECMA-376 ST_ShapeType "star4"
STAR_5 Forme d'étoile à cinq branches. Correspond à ECMA-376 ST_ShapeType "star5"
STAR_6 Forme d'étoile à six branches. Correspond à ECMA-376 ST_ShapeType "star6"
STAR_7 Forme d'étoile à sept branches. Correspond à ECMA-376 ST_ShapeType "star7"
STAR_8 Forme d'étoile à huit branches. Correspond à ECMA-376 ST_ShapeType "star8"
STRIPED_RIGHT_ARROW Forme de flèche droite rayée. Correspond à ST_ShapeType ECMA-376 "stripedRightArrow"
SUN Forme de soleil. Correspond à ECMA-376 ST_ShapeType "sun"
TRAPEZOID Forme trapézoïdale. Correspond à ECMA-376 ST_ShapeType "trapèze"
TRIANGLE Forme triangulaire. Correspond à ECMA-376 ST_ShapeType "triangle"
UP_ARROW Forme de flèche vers le haut. Correspond à ECMA-376 ST_ShapeType "upArrow"
UP_ARROW_CALLOUT Forme de la flèche vers le haut du callout. Correspond à ECMA-376 ST_ShapeType "upArrowCallout"
UP_DOWN_ARROW Forme de flèche vers le haut et le bas. Correspond à ECMA-376 ST_ShapeType "upDownArrow"
UTURN_ARROW Forme de flèche faisant un demi-tour. Correspond à ECMA-376 ST_ShapeType "uturnArrow"
VERTICAL_SCROLL Forme de défilement vertical. Correspond à ECMA-376 ST_ShapeType "verticalScroll"
WAVE Forme d'onde. Correspond à ECMA-376 ST_ShapeType "wave"
WEDGE_ELLIPSE_CALLOUT Forme d'ellipse en forme de coin de recadrage. Correspond à ST_ShapeType ECMA-376 "wedgeEllipseCallout"
WEDGE_RECTANGLE_CALLOUT Forme rectangulaire en forme de coin pour le callout. Correspond à ST_ShapeType ECMA-376 "wedgeRectCallout"
WEDGE_ROUND_RECTANGLE_CALLOUT Forme de rectangle arrondi en forme de coin Correspond à ST_ShapeType ECMA-376 "wedgeRoundRectCallout"
FLOW_CHART_ALTERNATE_PROCESS Forme alternative du flux de processus. Correspond à ST_ShapeType ECMA-376 "flowChartAlternateProcess"
FLOW_CHART_COLLATE Forme du parcours de compilation. Correspond à ST_ShapeType ECMA-376 "flowChartCollate"
FLOW_CHART_CONNECTOR Forme du flux du connecteur. Correspond à ST_ShapeType ECMA-376 "flowChartConnector"
FLOW_CHART_DECISION Forme du flux de décision. Correspond à ST_ShapeType ECMA-376 "flowChartDecision"
FLOW_CHART_DELAY Forme du flux de retard. Correspond à ST_ShapeType ECMA-376 "flowChartDelay"
FLOW_CHART_DISPLAY Afficher la forme du parcours Correspond à ECMA-376 ST_ShapeType "flowChartDisplay"
FLOW_CHART_DOCUMENT Forme du parcours du document. Correspond à ECMA-376 ST_ShapeType "flowChartDocument"
FLOW_CHART_EXTRACT Extrayez la forme du flux. Correspond à ST_ShapeType ECMA-376 "flowChartExtract"
FLOW_CHART_INPUT_OUTPUT Forme du flux d'entrée/sortie. Correspond à ST_ShapeType ECMA-376 "flowChartInputOutput"
FLOW_CHART_INTERNAL_STORAGE Forme du flux de stockage interne. Correspond à ST_ShapeType ECMA-376 "flowChartInternalStorage"
FLOW_CHART_MAGNETIC_DISK Forme de flux de disque magnétique. Correspond à ECMA-376 ST_ShapeType "flowChartMagneticDisk"
FLOW_CHART_MAGNETIC_DRUM Forme de flux du tambour magnétique. Correspond à ECMA-376 ST_ShapeType "flowChartMagneticDrum"
FLOW_CHART_MAGNETIC_TAPE Forme de flux de bande magnétique. Correspond à ECMA-376 ST_ShapeType "flowChartMagneticTape"
FLOW_CHART_MANUAL_INPUT Forme du flux de saisie manuelle. Correspond à ST_ShapeType ECMA-376 "flowChartManualInput"
FLOW_CHART_MANUAL_OPERATION Forme du flux d'opération manuelle. Correspond à ST_ShapeType ECMA-376 "flowChartManualOperation"
FLOW_CHART_MERGE Forme de flux de fusion. Correspond à ST_ShapeType ECMA-376 "flowChartMerge"
FLOW_CHART_MULTIDOCUMENT Forme de flux multi-documents. Correspond à ST_ShapeType ECMA-376 "flowChartMultidocument"
FLOW_CHART_OFFLINE_STORAGE Forme du flux de stockage hors connexion. Correspond à ST_ShapeType ECMA-376 "flowChartOfflineStorage"
FLOW_CHART_OFFPAGE_CONNECTOR Forme du flux du connecteur hors page. Correspond à ECMA-376 ST_ShapeType "flowChartOffpageConnector"
FLOW_CHART_ONLINE_STORAGE Forme du flux de stockage en ligne. Correspond à ST_ShapeType ECMA-376 "flowChartOnlineStorage"
FLOW_CHART_OR ou de la forme du flux. Correspond à ST_ShapeType ECMA-376 "flowChartOr"
FLOW_CHART_PREDEFINED_PROCESS Forme de flux de processus prédéfini. Correspond à ST_ShapeType ECMA-376 "flowChartPredefinedProcess"
FLOW_CHART_PREPARATION Forme du flux de préparation. Correspond à ECMA-376 ST_ShapeType "flowChartPreparation"
FLOW_CHART_PROCESS Forme du flux de processus. Correspond à ST_ShapeType ECMA-376 "flowChartProcess"
FLOW_CHART_PUNCHED_CARD Forme de flux de carte perforée. Correspond à ST_ShapeType ECMA-376 "flowChartPunchedCard"
FLOW_CHART_PUNCHED_TAPE Forme de flux de bande perforée. Correspond à ST_ShapeType ECMA-376 "flowChartPunchedTape"
FLOW_CHART_SORT Forme du flux de tri. Correspond à ECMA-376 ST_ShapeType "flowChartSort"
FLOW_CHART_SUMMING_JUNCTION Forme de flux de jonction de somme. Correspond à ECMA-376 ST_ShapeType "flowChartSummingJunction"
FLOW_CHART_TERMINATOR Forme du flux de terminaison. Correspond à ECMA-376 ST_ShapeType "flowChartTerminator"
ARROW_EAST Forme de flèche vers l'est.
ARROW_NORTH_EAST Forme de flèche en direction du nord-est.
ARROW_NORTH Forme de la flèche nord.
SPEECH Forme de la parole.
STARBURST Forme d'étoile.
TEARDROP Forme en larme. Correspond à ECMA-376 ST_ShapeType "teardrop"
ELLIPSE_RIBBON Forme de ruban en ellipse. Correspond à ECMA-376 ST_ShapeType "ellipseRibbon"
ELLIPSE_RIBBON_2 Forme de ruban d'ellipse 2. Correspond à ECMA-376 ST_ShapeType "ellipseRibbon2"
CLOUD_CALLOUT Forme de nuage pour les accroches. Correspond à ECMA-376 ST_ShapeType "cloudCallout"
CUSTOM Forme personnalisée.

ShapeProperties

Propriétés d'un Shape.

Si la forme est une forme d'espace réservé, comme déterminé par le champ placeholder, ces propriétés peuvent être héritées d'une forme d'espace réservé parent. La valeur affichée de la propriété dépend de la valeur du champ propertyState correspondant.

Les paramètres d'ajustement automatique du texte sur la forme sont automatiquement désactivés par les requêtes susceptibles d'affecter l'ajustement du texte dans la forme.

Représentation JSON 
{
  "shapeBackgroundFill": {
    object (ShapeBackgroundFill)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  },
  "contentAlignment": enum (ContentAlignment),
  "autofit": {
    object (Autofit)
  }
}
Champs
shapeBackgroundFill

object (ShapeBackgroundFill)

Remplissage de l'arrière-plan de la forme. Si ce paramètre n'est pas défini, la couleur de remplissage de l'arrière-plan est héritée d'un espace réservé parent, le cas échéant. Si la forme n'a pas de parent, la couleur de remplissage de l'arrière-plan par défaut dépend du type de forme, et correspond aux valeurs par défaut des nouvelles formes créées dans l'éditeur de diapositives.

outline

object (Outline)

Contour de la forme. Si cette valeur n'est pas définie, le contour est hérité d'un espace réservé parent, le cas échéant. Si la forme n'a pas de parent, le contour par défaut dépend du type de forme et correspond aux valeurs par défaut des nouvelles formes créées dans l'éditeur de diapositives.

shadow

object (Shadow)

Propriétés de l'ombre de la forme. Si cette valeur n'est pas définie, l'ombre est héritée d'un espace réservé parent, le cas échéant. Si la forme n'a pas de parent, l'ombre par défaut correspond aux valeurs par défaut des nouvelles formes créées dans l'éditeur de diapositives. Cette propriété est en lecture seule.

contentAlignment

enum (ContentAlignment)

Alignement du contenu dans la forme. Si la valeur est unspecified, l'alignement est hérité d'un espace réservé parent, le cas échéant. Si la forme n'a pas de parent, l'alignement par défaut correspond à celui des nouvelles formes créées dans l'éditeur de diapositives.

autofit

object (Autofit)

Propriétés d'ajustement automatique de la forme. Cette propriété n'est définie que pour les formes qui acceptent le texte.

ShapeBackgroundFill

La couleur de remplissage de l'arrière-plan de la forme.

Représentation 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.
}
Champs
propertyState

enum (PropertyState)

État de la propriété de remplissage de l'arrière-plan.

Si vous modifiez le remplissage d'une forme, ce champ sera mis à jour de manière implicite sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour qu'une forme n'ait pas de remplissage, définissez ce champ sur NOT_RENDERED. Dans ce cas, tous les autres champs de remplissage définis dans la même requête seront ignorés.

Champ d'union kind. Type de remplissage de l'arrière-plan. kind ne peut être qu'un des éléments suivants:
solidFill

object (SolidFill)

Remplissage de couleur unie.

Ajustement automatique

Propriétés d'ajustement automatique d'un Shape. Cette propriété n'est définie que pour les formes qui acceptent le texte.

Représentation JSON 
{
  "autofitType": enum (AutofitType),
  "fontScale": number,
  "lineSpacingReduction": number
}
Champs
autofitType

enum (AutofitType)

Type d'ajustement automatique de la forme. Si le type d'ajustement automatique est AUTOFIT_TYPE_UNSPECIFIED, il est hérité d'un espace réservé parent, le cas échéant. Le champ est automatiquement défini sur NONE si une requête est effectuée qui pourrait affecter l'ajustement du texte dans sa zone de texte de délimitation. Dans ce cas, fontScale est appliqué à fontSize et lineSpacingReduction est appliqué à lineSpacing. Les deux propriétés sont également réinitialisées sur les valeurs par défaut.

fontScale

number

Échelle de la police appliquée à la forme. Pour les formes avec autofitType, NONE ou SHAPE_AUTOFIT, cette valeur est 1 par défaut. Pour TEXT_AUTOFIT, cette valeur multipliée par fontSize donne la taille de police affichée dans l'éditeur.

Cette propriété est en lecture seule.

lineSpacingReduction

number

Réduction de l'espacement entre les lignes appliquée à la forme. Pour les formes avec autofitType, NONE ou SHAPE_AUTOFIT, cette valeur est 0 par défaut. Pour TEXT_AUTOFIT, cette valeur soustraite de lineSpacing donne l'espacement des lignes affiché dans l'éditeur.

Cette propriété est en lecture seule.

AutofitType

Types d'ajustement automatique d'un Shape.

Notez que, si toutes les valeurs sont valides pour les requêtes de lecture, seules AUTOFIT_TYPE_UNSPECIFIED et NONE sont valides pour les requêtes d'écriture.

Enums
AUTOFIT_TYPE_UNSPECIFIED Le type d'ajustement automatique n'est pas spécifié.
NONE Ne pas ajuster automatiquement
TEXT_AUTOFIT Réduire le texte en cas de dépassement pour l'adapter à la forme.
SHAPE_AUTOFIT Redimensionnez la forme pour l'adapter au texte.