PowerPoint.ShapeFont class

Spécifie si le texte du TextRange est défini pour utiliser l’attribut All Caps , qui fait apparaître les lettres minuscules sous forme de lettres majuscules. Les valeurs possibles sont les suivantes :

• true : tout le texte a l’attribut Toutes les majuscules .

• false : aucun du texte n’a l’attribut Toutes les majuscules .

• null : retourné si une partie, mais pas la totalité, du texte a l’attribut Toutes les majuscules .

allCaps: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie si le texte du est TextRange défini en gras. Les valeurs possibles sont les suivantes :

• true : tout le texte est en gras.

• false : aucun texte n’est en gras.

• null : retourné si une partie, mais pas la totalité, du texte est en gras.

bold: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

Spécifie la représentation par code de couleur HTML de la couleur du texte (par exemple, « #FF0000 » représente le rouge). Retourne null si contient TextRange des fragments de texte de couleurs différentes.

color: string | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/text/get-set-textrange.yaml

// Sets the color of the selected text range to green.
await PowerPoint.run(async (context) => {
  const textRange: PowerPoint.TextRange = context.presentation.getSelectedTextRange();
  textRange.font.color = "green";
  await context.sync();
});

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

context: RequestContext;

Valeur de propriété

Spécifie si le texte du TextRange est défini pour utiliser l’attribut Double barré . Les valeurs possibles sont les suivantes :

• true : tout le texte a l’attribut Double barré .

• false : aucun texte n’a l’attribut Double barré .

• null : retourné si une partie, mais pas la totalité, du texte a l’attribut Double barré .

doubleStrikethrough: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie si le texte du est TextRange défini en italique. Les valeurs possibles sont les suivantes :

• true : tout le texte est en italique.

• false : aucun texte n’est en italique.

• null : retourné si une partie, mais pas la totalité, du texte est en italique.

italic: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

Spécifie le nom de la police (par exemple, « Calibri »). Si le texte est un script complexe ou une langue d’Asie de l’Est, il s’agit du nom de police correspondant ; sinon, il s’agit du nom de la police latine. Retourne null si contient des fragments de TextRange texte avec des noms de police différents.

name: string | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

Spécifie la taille de police en points (par exemple, 11). Retourne null si contient TextRange des fragments de texte avec des tailles de police différentes.

size: number | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

Spécifie si le texte du TextRange est défini pour utiliser l’attribut Petites majuscules qui fait apparaître les lettres minuscules en minuscules majuscules. Les valeurs possibles sont les suivantes :

• true : tout le texte a l’attribut Petites majuscules .

• false : aucun texte n’a l’attribut Petites majuscules .

• null : retourné si une partie, mais pas la totalité, du texte a l’attribut Petites majuscules .

smallCaps: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie si le texte du est TextRange défini pour utiliser l’attribut Strikethrough . Les valeurs possibles sont les suivantes :

• true : tout le texte a l’attribut Strikethrough .

• false : aucun texte n’a l’attribut Strikethrough .

• null : retourné si une partie, mais pas la totalité, du texte a l’attribut Strikethrough .

strikethrough: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie si le texte du TextRange est défini pour utiliser l’attribut Indice . Les valeurs possibles sont les suivantes :

• true : tout le texte a l’attribut Indice .

• false : aucun texte n’a l’attribut Indice .

• null : retourné si une partie, mais pas la totalité, du texte a l’attribut Indice .

subscript: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie si le texte du est TextRange défini pour utiliser l’attribut Superscript . Les valeurs possibles sont les suivantes :

• true : tout le texte a l’attribut Superscript .

• false : aucun du texte n’a l’attribut Superscript .

• null : retourné si une partie, mais pas la totalité, du texte a l’attribut Superscript .

superscript: boolean | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

Spécifie le type de soulignement appliqué à la police. Retourne null si contient des fragments de TextRange texte avec différents styles de soulignement. Pour plus d’informations , voir PowerPoint.ShapeFontUnderlineStyle .

underline: PowerPoint.ShapeFontUnderlineStyle | "None" | "Single" | "Double" | "Heavy" | "Dotted" | "DottedHeavy" | "Dash" | "DashHeavy" | "DashLong" | "DashLongHeavy" | "DotDash" | "DotDashHeavy" | "DotDotDash" | "DotDotDashHeavy" | "Wavy" | "WavyHeavy" | "WavyDouble" | null;

Valeur de propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/shapes.yaml

// This function gets the collection of shapes on the first slide,
// and adds a brace pair, {}, to the collection, while specifying its
// location and size. Then it names the shape, sets its text and font
// color, and centers it inside the braces.
await PowerPoint.run(async (context) => {
  const shapes: PowerPoint.ShapeCollection = context.presentation.slides.getItemAt(0).shapes;
  const braces: PowerPoint.Shape = shapes.addGeometricShape(PowerPoint.GeometricShapeType.bracePair, {
    left: 100,
    top: 400,
    height: 50,
    width: 150,
  });
  braces.name = "Braces";
  braces.textFrame.textRange.text = "Shape text";
  braces.textFrame.textRange.font.color = "purple";
  braces.textFrame.textRange.font.underline = PowerPoint.ShapeFontUnderlineStyle.heavy;
  braces.textFrame.verticalAlignment = PowerPoint.TextVerticalAlignment.middleCentered;
  braces.textFrame.autoSizeSetting = PowerPoint.ShapeAutoSize.autoSizeShapeToFitText;

  return context.sync();
});

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(options?: PowerPoint.Interfaces.ShapeFontLoadOptions): PowerPoint.ShapeFont;

Paramètres

Retours

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNames?: string | string[]): PowerPoint.ShapeFont;

Paramètres

Retours

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.ShapeFont;

Paramètres

Retours

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringify, à son tour, appelle la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine PowerPoint.ShapeFont est un objet API, la toJSON méthode renvoie un objet JavaScript brut (typé en tant PowerPoint.Interfaces.ShapeFontDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

toJSON(): PowerPoint.Interfaces.ShapeFontData;

Retours