AddTextFrame

AutoShape.AddTextFrame méthode

Ajoute un nouveau TextFrame à une forme. Si la forme a déjà un TextFrame, elle change simplement son texte.

public ITextFrame AddTextFrame(string text)
ParamètreTypeDescription
textStringTexte par défaut pour un nouveau TextFrame.

Exemples

Le code d’exemple suivant montre comment ajouter un texte de filigrane dans une présentation PowerPoint.

[C#]
	using (var presentation = new Presentation())
	{
		ISlide slide = presentation.Slides[0];
		IAutoShape watermarkShape = slide.Shapes.AddAutoShape(ShapeType.Triangle, 0, 0, 150, 50);
		ITextFrame watermarkTextFrame = watermarkShape.AddTextFrame("Watermark");
	}

L’exemple suivant montre comment créer une zone de texte sur une diapositive.

[C#]
// Instancie la présentation
using (Presentation pres = new Presentation())
{
    // Obtient la première diapositive de la présentation
    ISlide sld = pres.Slides[0];
    // Ajoute une AutoShape avec le type défini comme Rectangle
    IAutoShape ashp = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 75, 150, 50);
    // Ajoute un TextFrame au Rectangle
    ashp.AddTextFrame(" ");
    // Accède au cadre de texte
    ITextFrame txtFrame = ashp.TextFrame;
    // Crée l'objet Paragraph pour le cadre de texte
    IParagraph para = txtFrame.Paragraphs[0];
    // Crée un objet Portion pour le paragraphe
    IPortion portion = para.Portions[0];
    // Définit le texte
    portion.Text = "Aspose TextBox";
    // Sauvegarde la présentation sur disque
    pres.Save("TextBox_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

L’exemple suivant montre comment ajouter une colonne dans une zone de texte.

[C#]
using (Presentation presentation = new Presentation())
{
	// Obtient la première diapositive de la présentation
	ISlide slide = presentation.Slides[0];
	// Ajoute une AutoShape avec le type défini comme Rectangle
	IAutoShape aShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);
	// Ajoute un TextFrame au Rectangle
	aShape.AddTextFrame("Toutes ces colonnes sont limitées à rester dans un seul conteneur de texte -- " +
	"vous pouvez ajouter ou supprimer du texte et le nouveau ou le texte restant s'ajuste automatiquement " +
	"pour s'écouler à l'intérieur du conteneur. Vous ne pouvez pas faire couler le texte d'un conteneur " +
	"à un autre cependant -- nous vous avons dit que les options de colonne de PowerPoint pour le texte sont limitées !");
	// Obtient le format de texte du TextFrame
	ITextFrameFormat format = aShape.TextFrame.TextFrameFormat;
	// Spécifie le nombre de colonnes dans le TextFrame
	format.ColumnCount = 3;
	// Spécifie l'espacement entre les colonnes
	format.ColumnSpacing = 10;
	// Sauvegarde la présentation
	presentation.Save("ColumnCount.pptx", SaveFormat.Pptx);
}

Voir aussi