Partager via

ExcelScript.TextFrame interface

Colis:
ExcelScript

Représente le cadre de texte d’un objet de forme.

Remarques

Exemples

/**
 * This script creates a star shape with the value from cell A1.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the value of A1 from the worksheet named Sheet1.
  const sheet = workbook.getWorksheet("Sheet1");
  const value = sheet.getRange("A1").getValue();

  // Create a Shape object that looks like a 5-pointed star.
  const star = sheet.addGeometricShape(ExcelScript.GeometricShapeType.star5);

  // Set the text of star and make sure the shape fits the text.
  const textFrame: ExcelScript.TextFrame = star.getTextFrame();
  textFrame.getTextRange().setText(value.toString());
  textFrame.setAutoSizeSetting(ExcelScript.ShapeAutoSize.autoSizeShapeToFitText);
}

Méthode

deleteText()

Supprime tout le texte dans la textframe.
getAutoSizeSetting()

Paramètres de dimensionnement automatique pour le cadre de texte. Un bloc de texte peut être configuré pour ajuster automatiquement le texte pour le cadre du texte, pour ajuster automatiquement le bloc de texte au texte ou de ne pas effectuer tout problème de dimensionnement automatique.
getBottomMargin()

Représente la marge bas, en points du cadre du texte.
getHasText()

Spécifie si le cadre de texte contient du texte.
getHorizontalAlignment()

Représente l’alignement horizontal pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalAlignment .
getHorizontalOverflow()

Représente le type de débordement horizontal du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalOverflow .
getLeftMargin()

Représente la marge gauche, en points du cadre du texte.
getOrientation()

Représente l’angle vers lequel le texte est orienté pour le cadre de texte. Pour plus d’informations, consultez ExcelScript.ShapeTextOrientation .
getReadingOrder()

Représente l’ordre de lecture du cadre texte gauche à droite ou de droite à gauche. Pour plus d’informations, consultez ExcelScript.ShapeTextReadingOrder .
getRightMargin()

Représente la marge droite, en points du cadre du texte.
getTextRange()

Représente le texte lié à une forme, en plus des propriétés et des méthodes de manipulation du texte. Pour plus d’informations, consultez ExcelScript.TextRange .
getTopMargin()

Représente la marge du haut, en points du cadre du texte.
getVerticalAlignment()

Représente l’alignement vertical pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalAlignment .
getVerticalOverflow()

Représente le type de débordement vertical du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalOverflow .
setAutoSizeSetting(autoSizeSetting)

Paramètres de dimensionnement automatique pour le cadre de texte. Un bloc de texte peut être configuré pour ajuster automatiquement le texte pour le cadre du texte, pour ajuster automatiquement le bloc de texte au texte ou de ne pas effectuer tout problème de dimensionnement automatique.
setBottomMargin(bottomMargin)

Représente la marge bas, en points du cadre du texte.
setHorizontalAlignment(horizontalAlignment)

Représente l’alignement horizontal pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalAlignment .
setHorizontalOverflow(horizontalOverflow)

Représente le type de débordement horizontal du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalOverflow .
setLeftMargin(leftMargin)

Représente la marge gauche, en points du cadre du texte.
setOrientation(orientation)

Représente l’angle vers lequel le texte est orienté pour le cadre de texte. Pour plus d’informations, consultez ExcelScript.ShapeTextOrientation .
setReadingOrder(readingOrder)

Représente l’ordre de lecture du cadre texte gauche à droite ou de droite à gauche. Pour plus d’informations, consultez ExcelScript.ShapeTextReadingOrder .
setRightMargin(rightMargin)

Représente la marge droite, en points du cadre du texte.
setTopMargin(topMargin)

Représente la marge du haut, en points du cadre du texte.
setVerticalAlignment(verticalAlignment)

Représente l’alignement vertical pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalAlignment .
setVerticalOverflow(verticalOverflow)

Représente le type de débordement vertical du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalOverflow .

Détails de la méthode

deleteText()

Supprime tout le texte dans la textframe.

deleteText(): void;

Retourne

void

getAutoSizeSetting()

Paramètres de dimensionnement automatique pour le cadre de texte. Un bloc de texte peut être configuré pour ajuster automatiquement le texte pour le cadre du texte, pour ajuster automatiquement le bloc de texte au texte ou de ne pas effectuer tout problème de dimensionnement automatique.

getAutoSizeSetting(): ShapeAutoSize;

Retourne

ExcelScript.ShapeAutoSize

getBottomMargin()

Représente la marge bas, en points du cadre du texte.

getBottomMargin(): number;

Retourne

number

getHasText()

Spécifie si le cadre de texte contient du texte.

getHasText(): boolean;

Retourne

boolean

getHorizontalAlignment()

Représente l’alignement horizontal pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalAlignment .

getHorizontalAlignment(): ShapeTextHorizontalAlignment;

Retourne

ExcelScript.ShapeTextHorizontalAlignment

getHorizontalOverflow()

Représente le type de débordement horizontal du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalOverflow .

getHorizontalOverflow(): ShapeTextHorizontalOverflow;

Retourne

ExcelScript.ShapeTextHorizontalOverflow

getLeftMargin()

Représente la marge gauche, en points du cadre du texte.

getLeftMargin(): number;

Retourne

number

getOrientation()

Représente l’angle vers lequel le texte est orienté pour le cadre de texte. Pour plus d’informations, consultez ExcelScript.ShapeTextOrientation .

getOrientation(): ShapeTextOrientation;

Retourne

ExcelScript.ShapeTextOrientation

getReadingOrder()

Représente l’ordre de lecture du cadre texte gauche à droite ou de droite à gauche. Pour plus d’informations, consultez ExcelScript.ShapeTextReadingOrder .

getReadingOrder(): ShapeTextReadingOrder;

Retourne

ExcelScript.ShapeTextReadingOrder

getRightMargin()

Représente la marge droite, en points du cadre du texte.

getRightMargin(): number;

Retourne

number

getTextRange()

Représente le texte lié à une forme, en plus des propriétés et des méthodes de manipulation du texte. Pour plus d’informations, consultez ExcelScript.TextRange .

getTextRange(): TextRange;

Retourne

ExcelScript.TextRange

getTopMargin()

Représente la marge du haut, en points du cadre du texte.

getTopMargin(): number;

Retourne

number

getVerticalAlignment()

Représente l’alignement vertical pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalAlignment .

getVerticalAlignment(): ShapeTextVerticalAlignment;

Retourne

ExcelScript.ShapeTextVerticalAlignment

getVerticalOverflow()

Représente le type de débordement vertical du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalOverflow .

getVerticalOverflow(): ShapeTextVerticalOverflow;

Retourne

ExcelScript.ShapeTextVerticalOverflow

setAutoSizeSetting(autoSizeSetting)

Paramètres de dimensionnement automatique pour le cadre de texte. Un bloc de texte peut être configuré pour ajuster automatiquement le texte pour le cadre du texte, pour ajuster automatiquement le bloc de texte au texte ou de ne pas effectuer tout problème de dimensionnement automatique.

setAutoSizeSetting(autoSizeSetting: ShapeAutoSize): void;

Paramètres

autoSizeSetting
ExcelScript.ShapeAutoSize

Retourne

void

setBottomMargin(bottomMargin)

Représente la marge bas, en points du cadre du texte.

setBottomMargin(bottomMargin: number): void;

Paramètres

bottomMargin

number

Retourne

void

setHorizontalAlignment(horizontalAlignment)

Représente l’alignement horizontal pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalAlignment .

setHorizontalAlignment(
            horizontalAlignment: ShapeTextHorizontalAlignment
        ): void;

Paramètres

horizontalAlignment
ExcelScript.ShapeTextHorizontalAlignment

Retourne

void

setHorizontalOverflow(horizontalOverflow)

Représente le type de débordement horizontal du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextHorizontalOverflow .

setHorizontalOverflow(
            horizontalOverflow: ShapeTextHorizontalOverflow
        ): void;

Paramètres

horizontalOverflow
ExcelScript.ShapeTextHorizontalOverflow

Retourne

void

setLeftMargin(leftMargin)

Représente la marge gauche, en points du cadre du texte.

setLeftMargin(leftMargin: number): void;

Paramètres

leftMargin

number

Retourne

void

setOrientation(orientation)

Représente l’angle vers lequel le texte est orienté pour le cadre de texte. Pour plus d’informations, consultez ExcelScript.ShapeTextOrientation .

setOrientation(orientation: ShapeTextOrientation): void;

Paramètres

orientation
ExcelScript.ShapeTextOrientation

Retourne

void

setReadingOrder(readingOrder)

Représente l’ordre de lecture du cadre texte gauche à droite ou de droite à gauche. Pour plus d’informations, consultez ExcelScript.ShapeTextReadingOrder .

setReadingOrder(readingOrder: ShapeTextReadingOrder): void;

Paramètres

readingOrder
ExcelScript.ShapeTextReadingOrder

Retourne

void

setRightMargin(rightMargin)

Représente la marge droite, en points du cadre du texte.

setRightMargin(rightMargin: number): void;

Paramètres

rightMargin

number

Retourne

void

setTopMargin(topMargin)

Représente la marge du haut, en points du cadre du texte.

setTopMargin(topMargin: number): void;

Paramètres

topMargin

number

Retourne

void

setVerticalAlignment(verticalAlignment)

Représente l’alignement vertical pour le style. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalAlignment .

setVerticalAlignment(
            verticalAlignment: ShapeTextVerticalAlignment
        ): void;

Paramètres

verticalAlignment
ExcelScript.ShapeTextVerticalAlignment

Retourne

void

setVerticalOverflow(verticalOverflow)

Représente le type de débordement vertical du cadre du texte. Pour plus d’informations, consultez ExcelScript.ShapeTextVerticalOverflow .

setVerticalOverflow(verticalOverflow: ShapeTextVerticalOverflow): void;

Paramètres

verticalOverflow
ExcelScript.ShapeTextVerticalOverflow

Retourne

void