Shapes

Forme

Un type PageElement représentant une forme générique qui n'a pas de classification plus spécifique. Pour en savoir plus, consultez Redimensionner et positionner les é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 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 pages maîtres.

Si elle 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.

Nombre de ces 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 ECMA-376 5th edition.

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 Forme rectangulaire à coins arrondis. Correspond à ECMA-376 ST_ShapeType 'roundRect'
ELLIPSE Forme d'ellipse. Correspond à ECMA-376 ST_ShapeType "ellipse"
ARC Forme d'arc incurvée. Correspond à ECMA-376 ST_ShapeType 'arc'
BENT_ARROW Forme de flèche courbe. Correspond à ECMA-376 ST_ShapeType 'bentArrow'
BENT_UP_ARROW Forme de flèche courbée vers le haut. Correspond à ECMA-376 ST_ShapeType 'bentUpArrow'
BEVEL Forme du biseau. Correspond à ECMA-376 ST_ShapeType "bevel"
BLOCK_ARC Forme d'arc de bloc. Correspond à ECMA-376 ST_ShapeType 'blockArc'
BRACE_PAIR Forme de la paire d'accolades. Correspond à ECMA-376 ST_ShapeType 'bracePair'
BRACKET_PAIR Forme de la paire de crochets. Correspond à ECMA-376 ST_ShapeType "bracketPair"
CAN Can shape. Correspond à ECMA-376 ST_ShapeType "can"
CHEVRON Forme en chevron. Correspond à ECMA-376 ST_ShapeType "chevron"
CHORD Forme de l'accord. Correspond à ECMA-376 ST_ShapeType "chord"
CLOUD Forme de nuage. Correspond à ECMA-376 ST_ShapeType "cloud"
CORNER Forme de l'angle. 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 incurvé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 de décagone. Correspond à ECMA-376 ST_ShapeType "decagon"
DIAGONAL_STRIPE Forme de bande diagonale. Correspond à ECMA-376 ST_ShapeType 'diagStripe'
DIAMOND Forme en losange. Correspond à ECMA-376 ST_ShapeType "diamond"
DODECAGON Forme dodécagonale. Correspond à ECMA-376 ST_ShapeType "dodecagon"
DONUT Forme en anneau. Correspond à ECMA-376 ST_ShapeType 'donut'
DOUBLE_WAVE Forme d'onde double. Correspond à ECMA-376 ST_ShapeType '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. Correspond à ECMA-376 ST_ShapeType 'downArrowCallout'
FOLDED_CORNER Forme de coin plié. Correspond à ECMA-376 ST_ShapeType "foldedCorner"
FRAME Forme du cadre. Correspond à ECMA-376 ST_ShapeType "frame"
HALF_FRAME Forme demi-cadre. Correspond à ECMA-376 ST_ShapeType "halfFrame"
HEART Forme de cœur. Correspond à ECMA-376 ST_ShapeType "heart"
HEPTAGON Forme heptagonale. Correspond à ECMA-376 ST_ShapeType 'heptagon'
HEXAGON Forme hexagonale. Correspond à ECMA-376 ST_ShapeType "hexagon"
HOME_PLATE Forme de la plaque de base. 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 irrégulière 1. Correspond à ECMA-376 ST_ShapeType "irregularSeal1"
IRREGULAR_SEAL_2 Forme irrégulière du joint 2. Correspond à ECMA-376 ST_ShapeType "irregularSeal2"
LEFT_ARROW Forme de flèche vers la gauche. Correspond à ECMA-376 ST_ShapeType 'leftArrow'
LEFT_ARROW_CALLOUT Forme de flèche vers la gauche Correspond à ECMA-376 ST_ShapeType "leftArrowCallout"
LEFT_BRACE Forme d'accolade ouvrante. Correspond à ECMA-376 ST_ShapeType "leftBrace"
LEFT_BRACKET Forme de crochet ouvrant. Correspond à ECMA-376 ST_ShapeType 'leftBracket'
LEFT_RIGHT_ARROW Forme de flèche vers la gauche et la droite. Correspond à ECMA-376 ST_ShapeType 'leftRightArrow'
LEFT_RIGHT_ARROW_CALLOUT Forme de bulle de dialogue avec flèche vers la gauche et la droite. Correspond à ECMA-376 ST_ShapeType "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 et vers la gauche. Correspond à ECMA-376 ST_ShapeType 'leftUpArrow'
LIGHTNING_BOLT Forme d'éclair. Correspond à ECMA-376 ST_ShapeType "lightningBolt"
MATH_DIVIDE Diviser une forme mathématique. Correspond à ECMA-376 ST_ShapeType 'mathDivide'
MATH_EQUAL Forme mathématique égale. Correspond à ECMA-376 ST_ShapeType '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 "différent de". Correspond à ECMA-376 ST_ShapeType 'mathNotEqual'
MATH_PLUS Forme mathématique Plus. Correspond à ECMA-376 ST_ShapeType 'mathPlus'
MOON Forme de lune. Correspond à ECMA-376 ST_ShapeType "moon"
NO_SMOKING Forme "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 "parallelogram"
PENTAGON Forme pentagonale. Correspond à ECMA-376 ST_ShapeType 'pentagon'
PIE Forme de secteur. 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 de flèche à quatre pointes. Correspond à ECMA-376 ST_ShapeType 'quadArrow'
QUAD_ARROW_CALLOUT Forme de rectangle à quatre flèches. Correspond à ECMA-376 ST_ShapeType 'quadArrowCallout'
RIBBON Forme de ruban. Correspond à ECMA-376 ST_ShapeType "ribbon"
RIBBON_2 Forme du ruban 2. Correspond à ECMA-376 ST_ShapeType 'ribbon2'
RIGHT_ARROW Forme de flèche vers la droite. Correspond à ECMA-376 ST_ShapeType 'rightArrow'
RIGHT_ARROW_CALLOUT Forme de flèche vers la droite. 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 Forme rectangulaire à un coin arrondi. Correspond à ECMA-376 ST_ShapeType "round1Rect"
ROUND_2_DIAGONAL_RECTANGLE Forme rectangulaire à deux coins arrondis en diagonale. Correspond à ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE Forme rectangulaire à deux coins arrondis du même côté. Correspond à ECMA-376 ST_ShapeType 'round2SameRect'
RIGHT_TRIANGLE Forme de triangle rectangle. Correspond à ECMA-376 ST_ShapeType 'rtTriangle'
SMILEY_FACE Forme de visage souriant. Correspond à ECMA-376 ST_ShapeType "smileyFace"
SNIP_1_RECTANGLE Forme rectangulaire à un coin coupé. Correspond à ECMA-376 ST_ShapeType "snip1Rect"
SNIP_2_DIAGONAL_RECTANGLE Forme rectangulaire à deux coins coupés en diagonale. Correspond à ECMA-376 ST_ShapeType "snip2DiagRect"
SNIP_2_SAME_RECTANGLE Forme rectangulaire à deux coins coupés du même côté. Correspond à ECMA-376 ST_ShapeType 'snip2SameRect'
SNIP_ROUND_RECTANGLE Forme rectangulaire à un coin coupé et un coin 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 à seize 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 à ECMA-376 ST_ShapeType 'stripedRightArrow'
SUN Forme de soleil. Correspond à ECMA-376 ST_ShapeType "sun"
TRAPEZOID Forme trapézoïdale. Correspond à ECMA-376 ST_ShapeType "trapezoid"
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 flèche vers le haut. 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 en demi-cercle. Correspond à ECMA-376 ST_ShapeType 'uturnArrow'
VERTICAL_SCROLL Forme de défilement vertical. Correspond à ECMA-376 ST_ShapeType 'verticalScroll'
WAVE Forme de l'onde. Correspond à ECMA-376 ST_ShapeType "wave"
WEDGE_ELLIPSE_CALLOUT Forme d'ellipse en forme de coin. Correspond à ECMA-376 ST_ShapeType 'wedgeEllipseCallout'
WEDGE_RECTANGLE_CALLOUT Forme rectangulaire en forme de coin. Correspond à ECMA-376 ST_ShapeType "wedgeRectCallout"
WEDGE_ROUND_RECTANGLE_CALLOUT Forme rectangulaire arrondie en forme de coin. Correspond à ECMA-376 ST_ShapeType 'wedgeRoundRectCallout'
FLOW_CHART_ALTERNATE_PROCESS Forme de flux de processus alternatif. Correspond à ECMA-376 ST_ShapeType "flowChartAlternateProcess"
FLOW_CHART_COLLATE Forme de flux "Rassembler". 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 du flux de délai. Correspond à ECMA-376 ST_ShapeType "flowChartDelay"
FLOW_CHART_DISPLAY Afficher la forme du flux. Correspond à ECMA-376 ST_ShapeType 'flowChartDisplay'
FLOW_CHART_DOCUMENT Forme du flux de documents. Correspond à ECMA-376 ST_ShapeType "flowChartDocument"
FLOW_CHART_EXTRACT Extrayez la forme du flux. Correspond à ECMA-376 ST_ShapeType 'flowChartExtract'
FLOW_CHART_INPUT_OUTPUT Forme du flux d'entrée/sortie. 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 du flux du tambour magnétique. Correspond à ECMA-376 ST_ShapeType 'flowChartMagneticDrum'
FLOW_CHART_MAGNETIC_TAPE Forme du flux de bande magnétique. Correspond à ECMA-376 ST_ShapeType 'flowChartMagneticTape'
FLOW_CHART_MANUAL_INPUT Forme du flux de saisie manuelle. Correspond à ECMA-376 ST_ShapeType 'flowChartManualInput'
FLOW_CHART_MANUAL_OPERATION Forme du 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 multidocument. Correspond à ECMA-376 ST_ShapeType "flowChartMultidocument"
FLOW_CHART_OFFLINE_STORAGE Forme du flux de stockage hors connexion. Correspond à ECMA-376 ST_ShapeType 'flowChartOfflineStorage'
FLOW_CHART_OFFPAGE_CONNECTOR Forme de flux du connecteur hors page. Correspond à ECMA-376 ST_ShapeType 'flowChartOffpageConnector'
FLOW_CHART_ONLINE_STORAGE Forme du flux de stockage en ligne. Correspond à ECMA-376 ST_ShapeType 'flowChartOnlineStorage'
FLOW_CHART_OR ou une 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 "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 à ECMA-376 ST_ShapeType "flowChartProcess"
FLOW_CHART_PUNCHED_CARD Forme de flux de carte perforée. Correspond à ECMA-376 ST_ShapeType 'flowChartPunchedCard'
FLOW_CHART_PUNCHED_TAPE Forme de flux de bande perforée. Correspond à ECMA-376 ST_ShapeType 'flowChartPunchedTape'
FLOW_CHART_SORT Trier la forme du flux. Correspond à ECMA-376 ST_ShapeType "flowChartSort"
FLOW_CHART_SUMMING_JUNCTION Forme du flux de la jonction de sommation. Correspond à ECMA-376 ST_ShapeType 'flowChartSummingJunction'
FLOW_CHART_TERMINATOR Forme du flux du terminateur. Correspond à ECMA-376 ST_ShapeType 'flowChartTerminator'
ARROW_EAST Forme de flèche vers l'est.
ARROW_NORTH_EAST Forme de flèche nord-est.
ARROW_NORTH Forme de la flèche indiquant le nord.
SPEECH Forme de la parole.
STARBURST Forme d'étoile.
TEARDROP Forme en goutte d'eau. Correspond à ECMA-376 ST_ShapeType "teardrop"
ELLIPSE_RIBBON Forme de ruban en ellipse. Correspond à ECMA-376 ST_ShapeType 'ellipseRibbon'
ELLIPSE_RIBBON_2 Forme en ruban ellipse 2. Correspond à ECMA-376 ST_ShapeType "ellipseRibbon2"
CLOUD_CALLOUT Forme de nuage pour les bulles. Correspond à ECMA-376 ST_ShapeType "cloudCallout"
CUSTOM Forme personnalisée.

ShapeProperties

Propriétés d'un Shape.

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

Tous les paramètres d'ajustement automatique du texte dans la forme sont automatiquement désactivés par les requêtes qui peuvent avoir un impact sur la façon dont le texte s'insère 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 elle n'est pas définie, la couleur de remplissage de l'arrière-plan est héritée d'un espace réservé parent, s'il existe. 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 Slides.

outline

object (Outline)

Contour de la forme. Si elle n'est pas définie, le contour est hérité d'un espace réservé parent, s'il existe. Si la forme n'a pas de parent, le contour par défaut dépend du type de forme et correspond à celui des nouvelles formes créées dans l'éditeur Slides.

shadow

object (Shadow)

Propriétés de l'ombre de la forme. Si elle n'est pas définie, l'ombre est héritée d'un espace réservé parent, s'il existe. Si la forme n'a pas de parent, l'ombre par défaut correspond à celle des nouvelles formes créées dans l'éditeur Slides. Cette propriété est en lecture seule.

contentAlignment

enum (ContentAlignment)

L'alignement du contenu dans la forme. Si la valeur est unspecified, l'alignement est hérité d'un espace réservé parent, s'il existe. 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.

ShapeBackgroundFill

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.

La mise à jour du remplissage d'une forme mettra implicitement à jour ce champ sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour qu'une forme ne comporte aucun 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 autorisent 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, s'il existe. Le champ est automatiquement défini sur NONE si une requête est effectuée et qu'elle est susceptible d'affecter l'ajustement du texte dans son cadre de texte. Dans ce cas, le fontScale est appliqué au fontSize et le 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 la 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 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'interligne 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 demandes de lecture, seules AUTOFIT_TYPE_UNSPECIFIED et NONE sont valides pour les demandes d'écriture.

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