Shapes

Forma

Un tipo PageElement que representa una forma genérica que no tiene una clasificación más específica.

Representación JSON 
{
  "shapeType": enum (Type),
  "text": {
    object (TextContent)
  },
  "shapeProperties": {
    object (ShapeProperties)
  },
  "placeholder": {
    object (Placeholder)
  }
}
Campos
shapeType

enum (Type)

Es el tipo de forma.

text

object (TextContent)

El contenido de texto de la forma

shapeProperties

object (ShapeProperties)

Las propiedades de la forma.

placeholder

object (Placeholder)

Los marcadores de posición son elementos de página que se heredan de marcadores de posición correspondientes en los diseños y los diseños maestros.

Si se configura, la forma es un marcador de posición, y cualquier propiedad heredada se puede resolver observando el marcador de posición superior identificado en el campo Placeholder.parent_object_id.

Tipo

Los tipos de formas.

Muchas de estas formas corresponden a formas predefinidas del estándar ECMA-376. Puede encontrar más información sobre estas formas en la descripción del tipo simple "ST_ShapeType" en la sección 20.1.10.55 de "Formatos abiertos de XML de Office: referencia de lenguaje de marcado y aspectos básicos", parte 1 de la cuarta edición 3MA6 de ECMA-376.

Enumeradores
TYPE_UNSPECIFIED El tipo de forma no predefinido.
TEXT_BOX Forma del cuadro de texto.
RECTANGLE Forma rectangular. Corresponde a ECMA-376 ST_ShapeType 'rect'.
ROUND_RECTANGLE Forma rectangular de esquina redonda. Corresponde a ECMA-376 ST_ShapeType 'roundRect'
ELLIPSE Forma de elipse. Corresponde a ECMA-376 ST_ShapeType "elipse"
ARC Forma de arco curvo Corresponde a "arc" del ECMA-376 ST_ShapeType
BENT_ARROW Forma de flecha doblada. Corresponde a ECMA-376 ST_ShapeType 'bentArrow'
BENT_UP_ARROW Forma de flecha doblada hacia arriba. Corresponde a ECMA-376 ST_ShapeType 'bentUpArrow'
BEVEL Forma de bisel. Corresponde a ECMA-376 ST_ShapeType "bisel"
BLOCK_ARC Bloquear forma de arco Corresponde a ECMA-376 ST_ShapeType 'blockArc'
BRACE_PAIR Forma de par de llaves. Corresponde a ECMA-376 ST_ShapeType 'bracePair'
BRACKET_PAIR Forma de par de soportes. Corresponde a ECA-376 ST_ShapeType 'pairPair'.
CAN Se puede dar forma. Corresponde a ECMA-376 ST_ShapeType "puede"
CHEVRON Forma de chevrón. Corresponde a ECMA-376 ST_ShapeType 'chevron'
CHORD Forma de la cuerda. Corresponde a la columna ECMA-376 ST_ShapeType.
CLOUD Forma de la nube Corresponde a ECMA-376 ST_ShapeType 'nube'
CORNER Forma de la esquina. Corresponde a ECMA-376 ST_ShapeType 'corner'
CUBE Forma de cubo. Corresponde a ECMA-376 ST_ShapeType 'cube'
CURVED_DOWN_ARROW Forma curva de la flecha hacia abajo. Corresponde a ECMA-376 ST_ShapeType 'curvedDownArrow'
CURVED_LEFT_ARROW Forma curva de la flecha hacia la izquierda. Corresponde a ECMA-376 ST_ShapeType 'curvedLeftArrow'
CURVED_RIGHT_ARROW Forma curva de la flecha hacia la derecha. Corresponde a ECMA-376 ST_ShapeType 'curvedRightArrow'
CURVED_UP_ARROW Forma curva de la flecha. Corresponde a ECMA-376 ST_ShapeType 'curvedUpArrow'
DECAGON Forma de decanto. Corresponde a ECMA-376 ST_ShapeType "decagon"
DIAGONAL_STRIPE Forma de rayas diagonales. Corresponde a ECMA-376 ST_ShapeType 'diagStripe'
DIAMOND Forma de diamante. Corresponde a ECMA-376 ST_ShapeType "diamante"
DODECAGON Forma de dodecágono. Corresponde a ECMA-376 ST_ShapeType 'dodecagon'
DONUT Forma de rosquilla Corresponde a ECMA-376 ST_ShapeType 'donut'
DOUBLE_WAVE Forma de doble onda. Corresponde a ECMA-376 ST_ShapeType 'DoubleWave'
DOWN_ARROW Forma de flecha hacia abajo. Corresponde a ECMA-376 ST_ShapeType 'downArrow'
DOWN_ARROW_CALLOUT Forma de flecha hacia abajo del texto destacado. Corresponde a ECMA-376 ST_ShapeType 'downArrowCaption'
FOLDED_CORNER Forma de esquina plegada. Corresponde a ECMA-376 ST_ShapeType 'foldedCorner'
FRAME Forma del marco Corresponde al “marco” ECMA-376 ST_ShapeType
HALF_FRAME Forma de medio marco. Corresponde a ECMA-376 ST_ShapeType 'halfFrame'
HEART Forma de corazón Corresponde a ECMA-376 ST_ShapeType "corazón"
HEPTAGON Forma del heptágono. Corresponde a ECMA-376 ST_ShapeType 'heptagon'
HEXAGON Forma hexagonal. Corresponde a ECMA-376 ST_ShapeType 'hexágono'
HOME_PLATE Forma de la placa principal. Corresponde a ECMA-376 ST_ShapeType 'homePlate'
HORIZONTAL_SCROLL Forma de desplazamiento horizontal. Corresponde a ECMA-376 ST_ShapeType 'horizontalScroll'
IRREGULAR_SEAL_1 Forma de sello irregular 1. Corresponde a ECMA-376 ST_ShapeType 'irregularSeal1'
IRREGULAR_SEAL_2 Forma de sello irregular 2. Corresponde a ECMA-376 ST_ShapeType 'irregularSeal2'
LEFT_ARROW Forma de flecha hacia la izquierda. Corresponde a ECMA-376 ST_ShapeType 'leftArrow'
LEFT_ARROW_CALLOUT Forma de flecha hacia la izquierda de texto destacado. Corresponde a ECMA-376 ST_ShapeType 'leftArrowCallback'
LEFT_BRACE Forma de refuerzo a la izquierda. Corresponde a ECMA-376 ST_ShapeType 'leftBrace'
LEFT_BRACKET Forma de corchete izquierdo. Corresponde a ECMA-376 ST_ShapeType 'leftBracket'
LEFT_RIGHT_ARROW Forma de flecha hacia la izquierda y derecha. Corresponde a ECMA-376 ST_ShapeType 'leftRightArrow'
LEFT_RIGHT_ARROW_CALLOUT Leyenda con forma de flecha hacia la izquierda y la derecha. Corresponde a ECMA-376 ST_ShapeType 'leftRightArrowCaption'.
LEFT_RIGHT_UP_ARROW Forma de flecha hacia la izquierda y derecha. Corresponde a ECMA-376 ST_ShapeType 'leftRightUpArrow'
LEFT_UP_ARROW Forma de flecha hacia la izquierda. Corresponde a ECMA-376 ST_ShapeType 'leftUpArrow'
LIGHTNING_BOLT Forma del rayo. Corresponde a ECMA-376 ST_ShapeType 'lightningBolt'
MATH_DIVIDE Dividir formas matemáticas. Corresponde a ECMA-376 ST_ShapeType 'mathDivide'
MATH_EQUAL Igual forma matemática. Corresponde a ECMA-376 ST_ShapeType 'mathEqual'
MATH_MINUS Forma de matemática menos Corresponde a ECMA-376 ST_ShapeType 'mathMinus'
MATH_MULTIPLY Multiplica la forma matemática. Corresponde a ECMA-376 ST_ShapeType 'mathMultiply'
MATH_NOT_EQUAL La forma matemática no es igual. Corresponde a ECMA-376 ST_ShapeType 'mathNotEqual'
MATH_PLUS Forma de números más Corresponde a ECMA-376 ST_ShapeType 'mathPlus'
MOON Forma de luna. Corresponde a ECA-376 ST_ShapeType 'luna'
NO_SMOKING No tiene forma de fumar. Corresponde a ECMA-376 ST_ShapeType 'noSmoking'
NOTCHED_RIGHT_ARROW Forma de flecha hacia la derecha con muesca. Corresponde a ECMA-376 ST_ShapeType 'notchedRightArrow'
OCTAGON Forma octogonal. Corresponde a ECOC-376 ST_ShapeType 'octagon'
PARALLELOGRAM Forma de paralelogramo. Corresponde a ECMA-376 ST_ShapeType 'parallelogram'
PENTAGON Forma del pentágono. Corresponde a ECMA-376 ST_ShapeType "pentágono"
PIE Forma de tarta. Corresponde a ECMA-376 ST_ShapeType 'pie'
PLAQUE Forma de la placa. Corresponde a "placa" ECMA-376 ST_ShapeType
PLUS Forma Plus. Corresponde a ECMA-376 ST_ShapeType 'plus'
QUAD_ARROW Forma de cuatro flechas. Corresponde a ECMA-376 ST_ShapeType 'quadArrow'
QUAD_ARROW_CALLOUT Forma cuádruple del texto destacado. Corresponde a ECMA-376 ST_ShapeType 'quadArrowCall'
RIBBON Forma de la cinta. Corresponde a "cinta" ECMA-376 ST_ShapeType
RIBBON_2 Forma de la cinta 2. Corresponde a ECMA-376 ST_ShapeType 'ribbon2'
RIGHT_ARROW Forma de flecha hacia la derecha. Corresponde a ECMA-376 ST_ShapeType 'rightArrow'
RIGHT_ARROW_CALLOUT Forma de flecha hacia la derecha del texto destacado. Corresponde a ECMA-376 ST_ShapeType 'rightArrowCaption'.
RIGHT_BRACE Forma de refuerzo. Corresponde a ECMA-376 ST_ShapeType 'rightBrace'
RIGHT_BRACKET Forma de corchete derecho. Corresponde a ECMA-376 ST_ShapeType 'rightBracket'
ROUND_1_RECTANGLE Forma rectangular de una esquina redonda. Corresponde a ECMA-376 ST_ShapeType 'round1Rect'
ROUND_2_DIAGONAL_RECTANGLE Forma rectangular de dos esquinas diagonales. Corresponde a ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE Forma rectangular de dos esquinas del mismo lado. Corresponde a ECMA-376 ST_ShapeType 'round2SameRect'
RIGHT_TRIANGLE Forma de triángulo hacia la derecha. Corresponde a ECMA-376 ST_ShapeType 'rtTriangle'
SMILEY_FACE Forma de una cara sonriente. Corresponde a ECMI-376 ST_ShapeType 'smileyFace'
SNIP_1_RECTANGLE Forma rectangular de una esquina recortada. Corresponde a ECMA-376 ST_ShapeType 'snip1Rect'
SNIP_2_DIAGONAL_RECTANGLE Forma rectangular de dos esquinas recortadas diagonales. Corresponde a ECMA-376 ST_ShapeType 'snip2DiagRect'
SNIP_2_SAME_RECTANGLE Forma rectangular de dos esquinas recortadas en el mismo lado. Corresponde a ECMA-376 ST_ShapeType 'snip2SameRect'
SNIP_ROUND_RECTANGLE Forma rectangular de una esquina recortada. Corresponde a ECMA-376 ST_ShapeType 'snipRoundRect'
STAR_10 Forma de estrella en punta. Corresponde a ECMA-376 ST_ShapeType "star10"
STAR_12 Forma de estrella de doce puntas. Corresponde a ECMA-376 ST_ShapeType "star12"
STAR_16 Forma de estrella de 16 puntas. Corresponde a ECMA-376 ST_ShapeType "star16"
STAR_24 Forma de estrella de cuatro puntas. Corresponde a ECMA-376 ST_ShapeType "star24"
STAR_32 Forma de estrella de dos puntas. Corresponde a ECMA-376 ST_ShapeType "star32"
STAR_4 Forma de estrella de cuatro puntas. Corresponde a ECMA-376 ST_ShapeType "star4"
STAR_5 Forma de estrella de cinco puntas. Corresponde a ECMA-376 ST_ShapeType "star5"
STAR_6 Forma de estrella de seis puntas. Corresponde a ECMA-376 ST_ShapeType "star6"
STAR_7 Forma de estrella de siete puntas. Corresponde a ECMA-376 ST_ShapeType "star7"
STAR_8 Forma de estrella de ocho puntas. Corresponde a ECMA-376 ST_ShapeType "star8"
STRIPED_RIGHT_ARROW Forma de flecha a rayas. Corresponde a ECMA-376 ST_ShapeType 'stripedRightArrow'
SUN Forma del sol. Corresponde a ECMA-376 ST_ShapeType 'sun'
TRAPEZOID Forma del trapezoide. Corresponde a ECMA-376 ST_ShapeType 'trapezoide'
TRIANGLE Forma de triángulo. Corresponde a "triángulo" de ECMA-376 ST_ShapeType
UP_ARROW Forma de flecha hacia arriba. Corresponde a ECMA-376 ST_ShapeType 'upArrow'
UP_ARROW_CALLOUT Llamada de flecha hacia arriba. Corresponde a ECMA-376 ST_ShapeType 'upArrowCallback'
UP_DOWN_ARROW Forma de flecha hacia abajo. Corresponde a ECMA-376 ST_ShapeType 'upDownArrow'
UTURN_ARROW Forma de flecha de giro en U. Corresponde a ECMA-376 ST_ShapeType 'uturnArrow'
VERTICAL_SCROLL Forma de desplazamiento vertical. Corresponde a ECMA-376 ST_ShapeType 'verticalScroll'
WAVE Forma de onda. Corresponde a la “onda” ECMA-376 ST_ShapeType.
WEDGE_ELLIPSE_CALLOUT Forma de elipse con cuña. Corresponde a ECMA-376 ST_ShapeType 'wedgeEllipseCall'
WEDGE_RECTANGLE_CALLOUT Forma rectangular de cuña de texto destacado. Corresponde a ECMA-376 ST_ShapeType 'wedgeRectCall'
WEDGE_ROUND_RECTANGLE_CALLOUT Forma rectangular de cuña de texto destacado. Corresponde a ECMA-376 ST_ShapeType 'wedgeRoundRectCallback'
FLOW_CHART_ALTERNATE_PROCESS Forma de flujo del proceso alternativo Corresponde a ECFA-376 ST_ShapeType 'flowChartAlternativeProcess'
FLOW_CHART_COLLATE Forma del flujo de intercalación. Corresponde a ECMA-376 ST_ShapeType 'flowChartCollate'
FLOW_CHART_CONNECTOR Forma del flujo del conector. Corresponde a ECMA-376 ST_ShapeType 'flowChartConnector'
FLOW_CHART_DECISION Forma del flujo de decisión Corresponde a “flowChartDecision” de ECMA-376 ST_ShapeType.
FLOW_CHART_DELAY Demora en la forma de flujo. Corresponde a “flowChartDelay” de ECMA-376 ST_ShapeType.
FLOW_CHART_DISPLAY Muestra la forma de flujo. Corresponde a ECMA-376 ST_ShapeType 'flowChartDisplay'
FLOW_CHART_DOCUMENT Forma de flujo del documento. Corresponde a ECMA-376 ST_ShapeType 'flowChartDocument'
FLOW_CHART_EXTRACT Extraer forma de flujo. Corresponde a ECMA-376 ST_ShapeType 'flowChartExtract'
FLOW_CHART_INPUT_OUTPUT Forma del flujo de salida de entrada. Corresponde a ECFA-376 ST_ShapeType 'flowChartInputOutput'
FLOW_CHART_INTERNAL_STORAGE Forma del flujo de almacenamiento interno Corresponde a ECFA-376 ST_ShapeType 'flowChartInternalStorage'
FLOW_CHART_MAGNETIC_DISK Forma del flujo del disco magnético Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticDisk'
FLOW_CHART_MAGNETIC_DRUM Forma del flujo del tambor magnético. Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticDrum'
FLOW_CHART_MAGNETIC_TAPE Forma del flujo de la cinta magnética. Corresponde a ECMA-376 ST_ShapeType 'flowChartMagneticTape'
FLOW_CHART_MANUAL_INPUT Forma del flujo de entrada manual. Corresponde a ECMA-376 ST_ShapeType 'flowChartManualInput'
FLOW_CHART_MANUAL_OPERATION Forma del flujo de operación manual. Corresponde a ECFA-376 ST_ShapeType 'flowChartManualOperation'
FLOW_CHART_MERGE Combinar forma de flujo Corresponde a ECMA-376 ST_ShapeType 'flowChartMerge'
FLOW_CHART_MULTIDOCUMENT Forma de flujo de varios documentos. Corresponde a ECMA-376 ST_ShapeType 'flowChartMultidocument'
FLOW_CHART_OFFLINE_STORAGE Forma del flujo de almacenamiento sin conexión. Corresponde a ECMA-376 ST_ShapeType 'flowChartOfflineStorage'
FLOW_CHART_OFFPAGE_CONNECTOR Forma del flujo del conector fuera de página. Corresponde a ECMA-376 ST_ShapeType 'flowChartOffpageConnector'
FLOW_CHART_ONLINE_STORAGE Forma del flujo de almacenamiento en línea Corresponde a ECMA-376 ST_ShapeType 'flowChartOnlineStorage'
FLOW_CHART_OR o forma de flujo. Corresponde a ECMA-376 ST_ShapeType 'flowChartOr'
FLOW_CHART_PREDEFINED_PROCESS Forma de flujo de proceso predefinida. Corresponde a ECFA-376 ST_ShapeType 'flowChart predefinidaProcess'
FLOW_CHART_PREPARATION Forma del flujo de preparación. Corresponde a ECA-376 ST_ShapeType 'flowChartPreparation'
FLOW_CHART_PROCESS Forma del flujo del proceso. Corresponde a "flowChartProcess" de ECMA-376 ST_ShapeType.
FLOW_CHART_PUNCHED_CARD Forma del flujo de la tarjeta perforada. Corresponde a ECMA-376 ST_ShapeType 'flowChartPunchedCard'
FLOW_CHART_PUNCHED_TAPE Forma de flujo de cinta perforada. Corresponde a ECMA-376 ST_ShapeType 'flowChartPunchedTape'
FLOW_CHART_SORT Ordena la forma de flujo. Corresponde a ECMA-376 ST_ShapeType 'flowChartSort'
FLOW_CHART_SUMMING_JUNCTION Suma la forma del flujo de unión. Corresponde a ECMA-376 ST_ShapeType 'flowChartSummingJunction'
FLOW_CHART_TERMINATOR Forma del flujo del terminador Corresponde a ECMA-376 ST_ShapeType 'flowChartTerminator'
ARROW_EAST Forma de flecha hacia el este
ARROW_NORTH_EAST Forma de flecha hacia el noreste.
ARROW_NORTH Forma de flecha hacia el norte.
SPEECH Forma de voz.
STARBURST Forma de ráfaga de estrella.
TEARDROP Forma de lágrima. Corresponde a ECMA-376 ST_ShapeType "lágrima"
ELLIPSE_RIBBON Forma de cinta de elipse. Corresponde a ECMA-376 ST_ShapeType 'ellipseRibbon'
ELLIPSE_RIBBON_2 Forma de cinta de elipse 2. Corresponde a ECMA-376 ST_ShapeType 'ellipseRibbon2'
CLOUD_CALLOUT Forma de nube de texto destacado. Corresponde a ECMA-376 ST_ShapeType 'cloudCall'
CUSTOM Forma personalizada.

Propiedades de forma

Las propiedades de un Shape

Si la forma es un marcador de posición, como lo determina el campo placeholder, estas propiedades pueden heredarse de una forma de marcador de posición superior. Determinar el valor renderizado de la propiedad depende del valor del campo propertyState correspondiente.

Cualquier configuración de ajuste automático de texto en la forma se desactiva automáticamente mediante solicitudes que pueden afectar la forma en que el texto se ajusta a la forma.

Representación JSON 
{
  "shapeBackgroundFill": {
    object (ShapeBackgroundFill)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  },
  "contentAlignment": enum (ContentAlignment),
  "autofit": {
    object (Autofit)
  }
}
Campos
shapeBackgroundFill

object (ShapeBackgroundFill)

El relleno de fondo de la forma Si no la estableces, el relleno de fondo se heredará de un marcador de posición primario, si existe. Si la forma no tiene un elemento superior, el relleno predeterminado del fondo depende del tipo de forma, que coincide con los valores predeterminados de las formas nuevas creadas en el editor de Presentaciones.

outline

object (Outline)

El contorno de la forma Si no la estableces, el esquema se heredará de un marcador de posición superior, si existe. Si la forma no tiene un elemento superior, el contorno predeterminado depende del tipo de forma, que coincide con los valores predeterminados de las formas nuevas creadas en el editor de Presentaciones.

shadow

object (Shadow)

Las propiedades de sombra de la forma Si no la estableces, la sombra se heredará de un marcador de posición superior, si existe. Si la forma no tiene un elemento superior, la sombra predeterminada coincidirá con los valores predeterminados de las nuevas formas creadas en el editor de Presentaciones. Esta propiedad es de solo lectura.

contentAlignment

enum (ContentAlignment)

Alineación del contenido de la forma Si es unspecified, la alineación se hereda de un marcador de posición superior, si existe. Si la forma no tiene un elemento superior, la alineación predeterminada coincide con la de las formas nuevas creadas en el editor de Presentaciones.

autofit

object (Autofit)

Las propiedades de ajuste automático de la forma. Esta propiedad solo está configurada para formas que permiten texto.

Relleno de fondo de la forma

El relleno de fondo de la forma.

Representación 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)

Es el estado de propiedad de relleno en segundo plano.

Si actualizas el relleno de una forma, se actualizará de forma implícita este campo a RENDERED, a menos que se especifique otro valor en la misma solicitud. Para no llenar una forma, establece este campo en NOT_RENDERED. En este caso, se ignorará cualquier otro campo de relleno que se haya configurado en la misma solicitud.

Campo de unión kind. El tipo de relleno de fondo. kind puede ser solo una de las siguientes opciones:
solidFill

object (SolidFill)

Relleno de color sólido.

Ajuste automático

Las propiedades de ajuste automático de un Shape.

Representación JSON 
{
  "autofitType": enum (AutofitType),
  "fontScale": number,
  "lineSpacingReduction": number
}
Campos
autofitType

enum (AutofitType)

Es el tipo de ajuste automático de la forma. Si el tipo de ajuste automático es AUTOFIT_TYPE_UNSPECIFIED, el tipo de ajuste automático se hereda de un marcador de posición superior, si existe. El campo se establece automáticamente en NONE si se realiza una solicitud que podría afectar el ajuste del texto dentro de su cuadro de texto de límite. En este caso, fontScale se aplica a fontSize, y lineSpacingReduction se aplica a lineSpacing. Ambas propiedades también se restablecen a los valores predeterminados.

fontScale

number

La escala de fuente que se aplica a la forma. Para las formas con autofitType NONE o SHAPE_AUTOFIT, este valor es el valor predeterminado de 1. Para TEXT_AUTOFIT, este valor multiplicado por fontSize proporciona el tamaño de fuente que se renderiza en el editor.

Esta propiedad es de solo lectura.

lineSpacingReduction

number

Es la reducción de interlineado aplicada a la forma. Para las formas con autofitType NONE o SHAPE_AUTOFIT, este valor es el valor predeterminado de 0. Para TEXT_AUTOFIT, este valor se resta del lineSpacing y proporciona el interlineado que se renderiza en el editor.

Esta propiedad es de solo lectura.

Tipo de ajuste automático

Los tipos de ajuste automático de un Shape

Enumeradores
AUTOFIT_TYPE_UNSPECIFIED El tipo de ajuste automático no está especificado.
NONE No ajustar automáticamente.
TEXT_AUTOFIT Reducir texto en el menú ampliado para que se adapte a la forma.
SHAPE_AUTOFIT Cambia el tamaño de la forma para que se ajuste al texto.