Shapes

Forme

Type PageElement représentant une forme générique sans classification plus spécifique.

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

enum (Type)

Type de 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 masques.

Si elle est définie, il s'agit d'une forme d'espace réservé. 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.

Un grand nombre de ces formes correspondent à des formes prédéfinies de la norme ECMA-376. Pour en savoir plus sur ces formes, consultez la description du type simple "ST_ShapeType" dans la section 20.1.10.55 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", partie 1 de la quatrième édition ECMA-376.

Enums
TYPE_UNSPECIFIED Type de forme non prédéfini.
TEXT_BOX Forme de la zone de texte.
RECTANGLE Forme rectangulaire. Correspond à ECMA-376 ST_ShapeType 'rect'.
ROUND_RECTANGLE Rectangle à coin arrondi Correspond à ECMA-376 ST_ShapeType 'roundRect'
ELLIPSE Forme Ellipse. Correspond à ECMA-376 ST_ShapeType "ellipse"
ARC Arc incurvé Correspond à ECMA-376 ST_ShapeType "arc"
BENT_ARROW Flèche courbe. Correspond à ECMA-376 ST_ShapeType "bentArrow"
BENT_UP_ARROW Flèche courbe vers le haut. Correspond à ECMA-376 ST_ShapeType "bentUpArrow"
BEVEL Forme biseautée. Correspond à ECMA-376 ST_ShapeType "bevel"
BLOCK_ARC Bloquer la forme d'un arc. Correspond à ECMA-376 ST_ShapeType 'blockArc'
BRACE_PAIR Forme d'accolade. Correspond à ECMA-376 ST_ShapeType 'bracePair'
BRACKET_PAIR Forme de paire de crochets. Correspond à ECMA-376 ST_ShapeType "bracketPair"
CAN Forme possible. Correspond à ECMA-376 ST_ShapeType 'can'
CHEVRON Forme Chevron. Correspond à ECMA-376 ST_ShapeType 'chevron'
CHORD Forme de la clique. Correspond à ECMA-376 ST_ShapeType "chord"
CLOUD Forme nuage Correspond à ECMA-376 ST_ShapeType "cloud"
CORNER Forme d'angle. Correspond à ECMA-376 ST_ShapeType "corner"
CUBE Forme cubique. Correspond à ECMA-376 ST_ShapeType "cube"
CURVED_DOWN_ARROW Flèche courbée vers le bas. Correspond à ECMA-376 ST_ShapeType 'curvedDownArrow"
CURVED_LEFT_ARROW Flèche courbée vers la gauche. Correspond à ECMA-376 ST_ShapeType "curvedLeftArrow"
CURVED_RIGHT_ARROW Flèche courbée vers la droite. Correspond à ECMA-376 ST_ShapeType "curvedRightArrow"
CURVED_UP_ARROW Flèche courbée vers le haut. Correspond à ECMA-376 ST_ShapeType 'curvedUpArrow"
DECAGON Forme décagone. Correspond à ECMA-376 ST_ShapeType "decagon"
DIAGONAL_STRIPE Forme en diagonale. Correspond à ECMA-376 ST_ShapeType "diagStripe"
DIAMOND Forme losange. Correspond au ECMA-376 ST_ShapeType "diamant"
DODECAGON Forme dodécagone. Correspond à ECMA-376 ST_ShapeType "dodecagon"
DONUT Forme en anneau. Correspond à ECMA-376 ST_ShapeType 'donut'
DOUBLE_WAVE Double forme de vague. Correspond à ECMA-376 ST_ShapeType "doubleWave"
DOWN_ARROW Forme vers le bas Correspond à ECMA-376 ST_ShapeType 'downArrow'
DOWN_ARROW_CALLOUT Forme de flèche vers le bas. Correspond à ECMA-376 ST_ShapeType 'downArrow callout'
FOLDED_CORNER Forme d'angle pliée. Correspond à ECMA-376 ST_ShapeType 'foldedCorner'
FRAME Forme du cadre. Correspond à ECMA-376 "ST_ShapeType"
HALF_FRAME Forme en demi-cadre. Correspond à ECMA-376 ST_ShapeType "halfFrame"
HEART Forme cardio. Correspond à ECMA-376 ST_ShapeType "heart"
HEPTAGON Forme heptagone. Correspond à ECMA-376 ST_ShapeType "heptagon"
HEXAGON Forme hexagonale. Correspond à ECMA-376 ST_ShapeType "hexagon"
HOME_PLATE Forme de la plaque d'accueil. Correspond à ECMA-376 ST_ShapeType "homePlate"
HORIZONTAL_SCROLL Forme de défilement horizontal. Correspond à ECMA-376 ST_ShapeType 'horizontalScroll'
IRREGULAR_SEAL_1 Scellement irrégulier 1 Correspond à ECMA-376 ST_ShapeType "irregularSeal1"
IRREGULAR_SEAL_2 Sceau d'étanchéité 2 irrégulier Correspond à ECMA-376 ST_ShapeType 'irregularSeal2'
LEFT_ARROW Forme de la flèche vers la gauche. Correspond à ECMA-376 ST_ShapeType "leftArrow"
LEFT_ARROW_CALLOUT Forme de flèche vers la gauche de l'accroche. Correspond à ECMA-376 ST_ShapeType 'leftArrow callout'
LEFT_BRACE Forme d'accolade gauche. Correspond à ECMA-376 ST_ShapeType 'leftBrace'
LEFT_BRACKET Support du crochet gauche. Correspond à ECMA-376 ST_ShapeType "leftBracket"
LEFT_RIGHT_ARROW Forme de la flèche vers la gauche Correspond à ECMA-376 ST_ShapeType "leftRightArrow"
LEFT_RIGHT_ARROW_CALLOUT Forme de flèche vers la gauche de l'accroche. Correspond à ECMA-376 ST_ShapeType "leftRightArrow callout"
LEFT_RIGHT_UP_ARROW Forme de flèche vers la droite et la gauche Correspond à ECMA-376 ST_ShapeType "leftRightUpArrow"
LEFT_UP_ARROW Forme vers la gauche et la flèche. Correspond à ECMA-376 ST_ShapeType "leftUpArrow"
LIGHTNING_BOLT En forme d'éclair. Correspond à ECMA-376 ST_ShapeType "lightningBolt"
MATH_DIVIDE Diviser la forme mathématique Correspond à ECMA-376 ST_ShapeType "mathDivide"
MATH_EQUAL Égal à la forme mathématique. Correspond à ECMA-376 ST_ShapeType "mathEqual"
MATH_MINUS Forme mathématique moins. Correspond à ECMA-376 ST_ShapeType "mathMinus"
MATH_MULTIPLY Multiplier la forme mathématique Correspond à ECMA-376 ST_ShapeType "mathMultiply"
MATH_NOT_EQUAL Sa forme mathématique est différente. Correspond à ECMA-376 ST_ShapeType "mathNotEqual"
MATH_PLUS Forme mathématique. Correspond à ECMA-376 ST_ShapeType "mathPlus"
MOON Forme lunaire. Correspond à ECMA-376 ST_ShapeType "moon"
NO_SMOKING Aucune forme fumeur n'est présente. Correspond à ECMA-376 ST_ShapeType "noSmoking"
NOTCHED_RIGHT_ARROW Forme à flèche vers la droite. Correspond à ECMA-376 ST_ShapeType 'notchedRightArrow'
OCTAGON Forme octogone. Correspond à ECMA-376 ST_ShapeType "octogone"
PARALLELOGRAM Forme en parallèle. Correspond à ECMA-376 ST_ShapeType "parallelogram"
PENTAGON Forme pentagone. Correspond à ECMA-376 ST_ShapeType "pentagon"
PIE Forme circulaire. Correspond à ECMA-376 ST_ShapeType "piece"
PLAQUE En forme de plaque. Correspond à ECMA-376 ST_ShapeType "plaque"
PLUS Forme plus. Correspond à ECMA-376 ST_ShapeType 'plus'
QUAD_ARROW Forme à quatre flèches. Correspond à ECMA-376 ST_ShapeType "quadArrow"
QUAD_ARROW_CALLOUT Forme de flèche vers une accroche. Correspond à ECMA-376 ST_ShapeType "quadArrow callout"
RIBBON Forme ruban. Correspond au ruban ECMA-376 ST_ShapeType
RIBBON_2 Forme ruban 2. Correspond à ECMA-376 ST_ShapeType " ruban2"
RIGHT_ARROW Forme à droite. Correspond à ECMA-376 ST_ShapeType "rightArrow"
RIGHT_ARROW_CALLOUT Forme de flèche vers la droite au niveau de l'accroche. Correspond à ECMA-376 ST_ShapeType "rightArrow callout"
RIGHT_BRACE Forme d'accolade droite. Correspond à ECMA-376 ST_ShapeType 'rightBrace'
RIGHT_BRACKET Support du crochet droit. 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 à ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE Rectangle à deux coins arrondis du même côté. Correspond à ECMA-376 ST_ShapeType 'round2SameRect'
RIGHT_TRIANGLE Forme triangulaire droite. Correspond à ECMA-376 ST_ShapeType "rtTriangle"
SMILEY_FACE Forme souriant. Correspond à ECMA-376 ST_ShapeType "smileyFace"
SNIP_1_RECTANGLE Un rectangle à 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 du 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 à 10 étoiles. Correspond à ECMA-376 ST_ShapeType "star10"
STAR_12 Douze formes pointues en forme d'étoile. Correspond à ECMA-376 ST_ShapeType "star12"
STAR_16 Forme à 16 étoiles. Correspond à ECMA-376 ST_ShapeType "star16"
STAR_24 Forme à vingt-quatre étoiles. Correspond à ECMA-376 ST_ShapeType "star24"
STAR_32 32 étoiles en forme d'étoile. Correspond à ECMA-376 ST_ShapeType "star32"
STAR_4 Forme en forme d'étoile à quatre branches. Correspond à ECMA-376 ST_ShapeType "star4"
STAR_5 Forme en étoile à cinq branches. Correspond à ECMA-376 ST_ShapeType "star5"
STAR_6 Forme en étoile à six branches. Correspond à ECMA-376 ST_ShapeType "star6"
STAR_7 Forme en étoile à sept branches. Correspond à ECMA-376 ST_ShapeType "star7"
STAR_8 Forme en étoile à huit branches. Correspond à ECMA-376 ST_ShapeType "star8"
STRIPED_RIGHT_ARROW Forme à flèche rayée vers la droite. Correspond à ECMA-376 ST_ShapeType "stripedRightArrow"
SUN Forme solaire. Correspond à ECMA-376 ST_ShapeType "sun"
TRAPEZOID Forme trapèze. Correspond à ECMA-376 ST_ShapeType "trapezoid"
TRIANGLE Forme triangulaire. Correspond au triangle ECMA-376 ST_ShapeType
UP_ARROW Forme vers le haut Correspond à ECMA-376 ST_ShapeType 'upArrow'
UP_ARROW_CALLOUT Forme de flèche vers le haut. Correspond à ECMA-376 ST_ShapeType 'upArrow callout
UP_DOWN_ARROW Flèche vers le haut Correspond à ECMA-376 ST_ShapeType 'upDownArrow'
UTURN_ARROW Forme en flèche en U. 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 en ellipse dans le coin de l'accroche. Correspond à ECMA-376 ST_ShapeType "wedgeEllipse callout"
WEDGE_RECTANGLE_CALLOUT Forme rectangulaire du support d'accroche. Correspond à ECMA-376 ST_ShapeType "wedgeRect callout"
WEDGE_ROUND_RECTANGLE_CALLOUT Le rectangle d'accroche a la forme d'un rectangle arrondi. Correspond à ECMA-376 ST_ShapeType "wedgeRoundRect callout"
FLOW_CHART_ALTERNATE_PROCESS Forme alternative du processus. Correspond à ECMA-376 ST_ShapeType 'flowChartAlternativeProcess'
FLOW_CHART_COLLATE Coller la forme du flux. Correspond à ECMA-376 ST_ShapeType 'flowChartCollate'
FLOW_CHART_CONNECTOR Forme du flux du connecteur. Correspond à ECMA-376 ST_ShapeType "flowChartConnector"
FLOW_CHART_DECISION Forme du flux de décision Correspond à ECMA-376 ST_ShapeType 'flowChartDecision'
FLOW_CHART_DELAY Forme de flux retardé. Correspond à ECMA-376 ST_ShapeType 'flowChartDelay'
FLOW_CHART_DISPLAY Affichez la forme du flux. Correspond à ECMA-376 ST_ShapeType 'flowChartDisplay'
FLOW_CHART_DOCUMENT Forme du flux du document. Correspond à ECMA-376 ST_ShapeType 'flowChartDocument'
FLOW_CHART_EXTRACT Extraire la forme du flux Correspond à ECMA-376 ST_ShapeType 'flowChartExtract'
FLOW_CHART_INPUT_OUTPUT Forme de flux de sortie en entrée. Correspond à ECMA-376 ST_ShapeType 'flowChartInputOutput'
FLOW_CHART_INTERNAL_STORAGE Forme de flux de stockage interne. Correspond à ECMA-376 ST_ShapeType '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 de tambour magnétique. Correspond à ECMA-376 ST_ShapeType 'flowChartMagneticDrum'
FLOW_CHART_MAGNETIC_TAPE Forme magnétique. Correspond à ECMA-376 ST_ShapeType "flowChartMagneticTape"
FLOW_CHART_MANUAL_INPUT Forme manuelle du flux de saisie. Correspond à ECMA-376 ST_ShapeType 'flowChartManualInput'
FLOW_CHART_MANUAL_OPERATION Forme de flux d'opération manuelle. Correspond à ECMA-376 ST_ShapeType 'flowChartManualOperation'
FLOW_CHART_MERGE Forme de flux de fusion. Correspond à ECMA-376 ST_ShapeType 'flowChartMerge'
FLOW_CHART_MULTIDOCUMENT Forme de flux pour plusieurs documents. Correspond à ECMA-376 ST_ShapeType 'flowChartMultidocument'
FLOW_CHART_OFFLINE_STORAGE Forme de flux du stockage hors connexion. Correspond à ECMA-376 ST_ShapeType 'flowChartOfflineStorage'
FLOW_CHART_OFFPAGE_CONNECTOR Forme du flux du connecteur hors page. Correspond à ECMA-376 ST_ShapeType "flowChartOffpageConnector"
FLOW_CHART_ONLINE_STORAGE Forme de flux de stockage en ligne. Correspond à ECMA-376 ST_ShapeType 'flowChartOnlineStorage'
FLOW_CHART_OR Ou forme de flux. Correspond à ECMA-376 ST_ShapeType 'flowChartOr'
FLOW_CHART_PREDEFINED_PROCESS Forme de flux de processus prédéfinie. Correspond à ECMA-376 ST_ShapeType 'flowChart prédéfinieProcess'
FLOW_CHART_PREPARATION Forme de flux de préparation. Correspond à ECMA-376 ST_ShapeType 'flowChartPreparation'
FLOW_CHART_PROCESS Forme de flux de processus. Correspond à ECMA-376 ST_ShapeType 'flowChartProcess'
FLOW_CHART_PUNCHED_CARD Forme perforée du flux de la carte. Correspond à ECMA-376 ST_ShapeType 'flowChartPunchedCard'
FLOW_CHART_PUNCHED_TAPE Forme à bande perforée. Correspond à ECMA-376 ST_ShapeType 'flowChartPunchedTape'
FLOW_CHART_SORT Triez la forme du flux. Correspond à ECMA-376 ST_ShapeType 'flowChartTrier'
FLOW_CHART_SUMMING_JUNCTION Somme des formes de jonction. Correspond à ECMA-376 ST_ShapeType 'flowChartSummingJunction'
FLOW_CHART_TERMINATOR Forme de flux du terminal. Correspond à ECMA-376 ST_ShapeType 'flowChartTerminator'
ARROW_EAST Forme de la flèche vers l'est.
ARROW_NORTH_EAST Forme de la flèche vers le nord-est.
ARROW_NORTH Forme de la flèche nord.
SPEECH Forme de discours.
STARBURST Forme d'étoile.
TEARDROP Forme en goutte. Correspond à ECMA-376 ST_ShapeType "teardrop"
ELLIPSE_RIBBON Forme du ruban Ellipse. Correspond à ECMA-376 ST_ShapeType "ellipseRibbon"
ELLIPSE_RIBBON_2 Forme du ruban Ellipse 2. Correspond à ECMA-376 ST_ShapeType "ellipseRibbon2"
CLOUD_CALLOUT Forme cloud accroche. Correspond à ECMA-376 ST_ShapeType "cloud callout"
CUSTOM Forme personnalisée.

Propriétés des formes

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 de champ propertyState correspondante.

Tous les paramètres d'ajustement automatique du texte sur la forme sont automatiquement désactivés pour les demandes 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 cette règle n'est pas configurée, le remplissage d'arrière-plan est hérité d'un espace réservé parent s'il existe. Si la forme n'a pas de parent, le remplissage d'arrière-plan par défaut dépend du type de forme, correspondant aux valeurs par défaut pour les nouvelles formes créées dans l'éditeur Slides.

outline

object (Outline)

Contour de la forme. Si cette règle n'est pas configurée, 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, correspondant aux valeurs par défaut pour les nouvelles formes créées dans l'éditeur Slides.

shadow

object (Shadow)

Propriétés d'ombre de la forme. Si cette règle n'est pas configurée, 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 Slides. 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 Slides.

autofit

object (Autofit)

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

Arrière-planForme

Le 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 mettez à jour le remplissage d'une forme, ce champ sera implicitement mis à jour vers RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour qu'aucune forme ne soit remplie, définissez ce champ sur NOT_RENDERED. Dans ce cas, tous les autres champs de saisie définis dans la même requête sont ignorés.

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

object (SolidFill)

Remplissage des couleurs unies.

Ajustement automatique

Propriétés d'ajustement automatique d'une Shape.

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, le type d'ajustement automatique est hérité, le cas échéant, d'un espace réservé parent. Le champ est automatiquement défini sur NONE si une requête est susceptible d'affecter l'ajustement du texte dans sa zone de texte de délimitation. Dans ce cas, fontScale est appliqué au fontSize et lineSpacingReduction est appliqué au lineSpacing. Les deux propriétés sont également réinitialisées sur leurs valeurs par défaut.

fontScale

number

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

Cette propriété est en lecture seule.

lineSpacingReduction

number

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

Cette propriété est en lecture seule.

Type d'ajustement automatique

Types d'ajustement automatique d'une Shape.

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.