TextBox

TextBox class

Encapsule l’objet qui représente une zone de texte dans une feuille de calcul.

public class TextBox : Shape

Propriétés

NomLa description
ActiveXControl { get; }Obtient le contrôle ActiveX.
ActualLowerRightRow { get; }Obtenir la ligne inférieure réelle.
AlternativeText { get; set; }Renvoie ou définit la chaîne de texte descriptive (alternative) duShape objet.
AnchorType { get; set; }Obtient et définit l’espace réservé de l’ancre de forme.
AutoShapeType { get; set; }Obtient et définit le type de forme automatique.
Bottom { get; set; }Représente la largeur du décalage vertical de la forme par rapport à sa ligne d’angle inférieure inférieure, en pixels.
ControlData { get; }Obtient les données du contrôle.
CreateId { get; set; }Obtient et définit l’identifiant de création pour cette forme.
Fill { get; }Renvoie unFillFormat objet qui contient les propriétés de formatage de remplissage pour la forme spécifiée.
Font { get; set; }Représente la police de la forme.
FormatPicture { get; }Obtient et définit les options du format d’image.
Geometry { get; }Obtient la géométrie
Glow { get; }Représente un objet qui spécifie l’effet de lueur pour l’élément ou la forme du graphique.
Group { get; }Obtient la forme de groupe qui contient cette forme.
HasLine { get; set; }Obtient et définit la ligne de bordure de la forme visible.
Height { get; set; }Représente la hauteur de la forme, en unité de pixel.
HeightCM { get; set; }Représente la hauteur de la forme, en centimètres.
HeightInch { get; set; }Représente la hauteur de la forme, en pouces.
HeightInShape { get; set; }Représente le décalage vertical de la forme par rapport à la bordure supérieure de la forme parent, en unité de 1/4000 de la hauteur de la forme parent..
HeightPt { get; set; }Représente la hauteur de la forme, en unité de points.
HeightScale { get; set; }Obtient et définit l’échelle de hauteur, en pourcentage de la hauteur de l’image d’origine. Si la forme n’est pas une image, la propriété HeightScale ne renvoie que 100 ;
HtmlText { get; set; }Obtient et définit la chaîne html qui contient des données et certains formats dans cette zone de texte.
Hyperlink { get; }Obtient le lien hypertexte de la forme.
Id { get; }Obtient l’identifiant de cette forme.
InputRange { get; set; }Obtient ou définit la plage de feuille de calcul utilisée pour remplir la zone de liste déroulante spécifiée.
IsEquation { get; }Indique si la forme ne contient qu’une équation.
IsFilled { get; set; }Indique si le format de remplissage est visible.
IsFlippedHorizontally { get; set; }Obtient et définit si la forme est inversée horizontalement .
IsFlippedVertically { get; set; }Obtient et définit si la forme est inversée verticalement .
IsGroup { get; }Indique si la forme est un groupe.
IsHidden { get; set; }Indique si l’objet est visible.
IsInGroup { get; }Indique si la forme est groupée.
IsLockAspectRatio { get; set; }True signifie qu’il n’est pas possible de modifier les proportions.
IsLocked { get; set; }Vrai si l’objet est verrouillé, Faux si l’objet peut être modifié lorsque la feuille est protégée.
IsPrintable { get; set; }Vrai si l’objet est imprimable
IsRichText { get; }Indique si le texte est un texte enrichi ou non.
IsSmartArt { get; }Indique si la forme est un art intelligent.
IsTextWrapped { get; set; }Obtient et définit le type de texte enveloppé de la forme qui contient du texte.
IsWordArt { get; }Indique si cette forme est un mot art.
Left { get; set; }Représente le décalage horizontal de la forme par rapport à sa colonne de gauche, en pixels.
LeftCM { get; set; }Représente le décalage horizontal de la forme par rapport à sa colonne de gauche, en centimètres.
LeftInch { get; set; }Représente le décalage horizontal de la forme par rapport à sa colonne de gauche, en pouces.
LeftInShape { get; set; }Représente le décalage horizontal de la forme par rapport à la bordure gauche de la forme parent, en unité de 1/4000 de largeur de la forme parent.
LeftToCorner { get; set; }Obtient et définit le décalage horizontal de la forme à partir de la bordure gauche de la feuille de calcul.
Line { get; }Obtient le style de ligne
LinkedCell { get; set; }Obtient ou définit la plage de feuille de calcul liée à la valeur du contrôle.
LowerDeltaX { get; set; }Obtient ou définit le décalage horizontal de la forme par rapport à sa colonne d’angle inférieur droit.
LowerDeltaY { get; set; }Obtient ou définit le décalage vertical de la forme par rapport à sa ligne dans le coin inférieur droit.
LowerRightColumn { get; set; }Représente l’index de la colonne du coin inférieur droit.
LowerRightRow { get; set; }Représente l’index de ligne du coin inférieur droit.
MacroName { get; set; }Obtient et définit le nom de la macro.
MsoDrawingType { get; }Obtient le type de dessin mso.
Name { get; set; }Obtient et définit le nom de la forme.
Paths { get; }Obtient les chemins d’une forme géométrique personnalisée.
Placement { get; set; }Représente la manière dont l’objet dessin est attaché aux cellules situées en dessous. La propriété contrôle le placement d’un objet sur une feuille de calcul.
Reflection { get; }Représente unobjet qui spécifie l’effet de réflexion pour l’élément ou la forme du graphique.
RelativeToOriginalPictureSize { get; set; }Indique si la forme est relative à la taille de l’image d’origine.
Right { get; set; }Représente la largeur du décalage horizontal de la forme par rapport à sa colonne d’angle inférieur droit, en pixels.
RotationAngle { get; set; }Obtient et définit la rotation de la forme.
ShadowEffect { get; }Représente un objet qui spécifie l’effet d’ombre pour l’élément ou la forme du graphique.
SoftEdges { get; set; }Obtient et définit le rayon de flou à appliquer aux bords, en unité de points.
Spid { get; }Spécifie une chaîne facultative qu’une application peut utiliser pour identifier la forme particulière.
Spt { get; }Spécifie un nombre facultatif qu’une application peut utiliser pour associer la forme particulière à un type de forme défini.
Text { get; set; }Représente la chaîne dans cet objet TextBox.
TextBody { get; }Obtient et définit le paramètre du texte de la forme.
TextDirection { get; set; }Obtient/Définit la direction du flux de texte pour cet objet.
TextEffect { get; }Renvoie un objet TextEffectFormat qui contient des propriétés de mise en forme d’effet de texte pour la forme spécifiée. S’applique aux objets Shape qui représentent WordArt.
TextHorizontalAlignment { get; set; }Obtient et définit le type d’alignement horizontal du texte de la forme.
TextHorizontalOverflow { get; set; }Obtient et définit le type de débordement horizontal du texte de la forme qui contient du texte.
TextOptions { get; set; }Représente les options de texte de la forme.
TextOrientationType { get; set; }Obtient et définit le type d’orientation du texte de la forme.
TextShapeType { get; set; }Obtient et définit le type de forme de texte prédéfini.
TextVerticalAlignment { get; set; }Obtient et définit le type d’alignement vertical du texte de la forme.
TextVerticalOverflow { get; set; }Obtient et définit le type de débordement vertical du texte de la forme qui contient du texte.
ThreeDFormat { get; }Obtient et définit le format 3D de la forme.
Title { get; set; }Spécifie le titre (légende) de l’objet forme actuel.
Top { get; set; }Représente le décalage vertical de la forme par rapport à sa rangée supérieure, en pixels.
TopCM { get; set; }Représente le décalage vertical de la forme par rapport à sa rangée supérieure, en centimètres.
TopInch { get; set; }Représente le décalage vertical de la forme par rapport à sa rangée supérieure, en pouces.
TopInShape { get; set; }Représente le décalage vertical de la forme par rapport à la bordure supérieure de la forme parent, en unité de 1/4000 de hauteur de la forme parent.
TopToCorner { get; set; }Obtient et définit le décalage vertical de la forme à partir de la bordure supérieure de la feuille de calcul, en pixels.
Type { get; }Obtient le type de forme automatique.
UpperDeltaX { get; set; }Obtient ou définit le décalage horizontal de la forme par rapport à sa colonne d’angle supérieur gauche.
UpperDeltaY { get; set; }Obtient ou définit le décalage vertical de la forme par rapport à sa ligne dans le coin supérieur gauche.
UpperLeftColumn { get; set; }Représente l’index de la colonne du coin supérieur gauche.
UpperLeftRow { get; set; }Représente l’index de ligne du coin supérieur gauche.
Width { get; set; }Représente la largeur de la forme, en pixels.
WidthCM { get; set; }Représente la largeur de la forme, en centimètres.
WidthInch { get; set; }Représente la largeur de la forme, en pouces.
WidthInShape { get; set; }Représente la largeur de la forme, en unité de 1/4000 de la forme parent.
WidthPt { get; set; }Représente la largeur de la forme, en unité de point.
WidthScale { get; set; }Obtient et définit l’échelle de largeur, en pourcentage de la largeur de l’image d’origine. Si la forme n’est pas une image, la propriété WidthScale ne renvoie que 100 ;
Worksheet { get; }Obtient leWorksheet objet qui contient cette forme.
X { get; set; }Obtient et définit le décalage horizontal de la forme à partir de la bordure gauche de la feuille de calcul, en pixels.
Y { get; set; }Obtient et définit le décalage vertical de la forme à partir de la bordure supérieure de la feuille de calcul, en pixels.
ZOrderPosition { get; set; }Renvoie la position d’une forme dans l’ordre z.

Méthodes

NomLa description
AddHyperlink(string)Ajoute un lien hypertexte à la forme.
AlignTopRightCorner(int, int)Déplace l’image vers le coin supérieur droit.
CalculateTextSize()Recalculer la zone de texte
Characters(int, int)Renvoie un objet Characters qui représente une plage de caractères dans le texte.
FormatCharacters(int, int, Font, StyleFlag)Formate certains caractères avec le paramètre de police.
GetCharacters()Renvoie tous les objets Caractères qui représentent une plage de caractères dans le texte .
GetConnectionPoints()Obtenir les points de connexion
GetInputRange(bool, bool)Obtient la plage utilisée pour remplir le contrôle.
GetLinkedCell(bool, bool)Obtient la plage liée à la valeur du contrôle.
GetLockedProperty(ShapeLockType)Obtient la valeur de la propriété verrouillée.
virtual GetResultOfSmartArt()Conversion d’art intelligent en formes groupées.
virtual IsSameSetting(object)Renvoie si la forme est identique.
MoveToRange(int, int, int, int)Déplace la forme vers une plage spécifiée.
RemoveActiveXControl()Supprimer le contrôle ActiveX.
RemoveHyperlink()Supprimer le lien hypertexte de la forme.
SetInputRange(string, bool, bool)Définit la plage utilisée pour remplir le contrôle.
SetLinkedCell(string, bool, bool)Définit la plage liée à la valeur du contrôle.
SetLockedProperty(ShapeLockType, bool)Définir la propriété verrouillée.
ToFrontOrBack(int)Amène la forme à l’avant ou envoie la forme à l’arrière.
ToImage(ImageOrPrintOptions)Renvoie l’objet bitmap de la forme .
ToImage(Stream, ImageOrPrintOptions)Enregistre la forme dans un flux.
ToImage(Stream, ImageType)Crée l’image de la forme et l’enregistre dans un flux au format spécifié.
ToImage(string, ImageOrPrintOptions)Enregistre la forme dans un fichier.
UpdateSelectedValue()Mettre à jour la valeur sélectionnée par la valeur de la cellule liée.

Exemples


[C#]

// Instancier un nouveau classeur.
Workbook workbook = new Workbook();
// Récupère la première feuille de calcul du livre.
Worksheet worksheet = workbook.Worksheets[0];
//Ajouter une nouvelle zone de texte à la collection.
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200);
// Récupère l'objet textbox.
Aspose.Cells.Drawing.TextBox textbox0 = worksheet.TextBoxes[textboxIndex];
//Remplit le texte.
textbox0.Text = "ASPOSE______The .NET and JAVA Component Publisher!";
// Définissez la zone de texte pour l'ajuster en fonction de son contenu.
textbox0.TextBody.TextAlignment.AutoSize = true;
// Définissez l'emplacement.
textbox0.Placement = PlacementType.FreeFloating;
// Définit la couleur de la police.
textbox0.Font.Color = Color.Blue;
// Définissez la police en gras.
textbox0.Font.IsBold = true;
// Définissez la taille de la police.
textbox0.Font.Size = 14;
// Définissez l'attribut de police sur italique.
textbox0.Font.IsItalic = true;
//Ajouter un lien hypertexte à la zone de texte.
textbox0.AddHyperlink("http://www.aspose.com/");
// Récupère le format de fil de la zone de texte.
FillFormat fillformat = textbox0.Fill;
// Définit la couleur de remplissage.
fillformat.SolidFill.Color = Color.Silver;
// Récupère le type de format de ligne de la zone de texte.
LineFormat lineformat = textbox0.Line;
// Définit le style de ligne.
lineformat.CompoundType = MsoLineStyle.ThinThick;
// Définissez l'épaisseur de la ligne.
lineformat.Weight = 6;
// Définissez le style de tiret sur squaredot.
lineformat.DashStyle = MsoLineDashStyle.SquareDot;
//Ajouter une autre zone de texte.
textboxIndex = worksheet.TextBoxes.Add(15, 4, 85, 120);
// Récupère la deuxième zone de texte.
Aspose.Cells.Drawing.TextBox textbox1 = worksheet.TextBoxes[textboxIndex];
// Saisissez du texte dessus.
textbox1.Text = "This is another simple text box";
// Définissez le type de placement lorsque la zone de texte se déplacera et
// redimensionne avec les cellules.
textbox1.Placement = PlacementType.MoveAndSize;
// Enregistrez le fichier excel.
workbook.Save("tsttextboxes.xlsx");

[Visual Basic]

'Instanciez un nouveau classeur.
Dim workbook As Workbook = New Workbook()
'Obtenez la première feuille de calcul du livre.
Dim worksheet As Worksheet = workbook.Worksheets(0)
'Ajoutez une nouvelle zone de texte à la collection.
Dim textboxIndex As Integer = worksheet.TextBoxes.Add(2, 1, 160, 200)
'Obtenez l'objet textbox.
Dim textbox0 As Aspose.Cells.Drawing.TextBox = worksheet.TextBoxes(textboxIndex)
'Remplissez le texte.
textbox0.Text = "ASPOSE______The .NET and JAVA Component Publisher!"
'Définissez la zone de texte pour l'ajuster en fonction de son contenu.
textbox0.TextBody.TextAlignment.AutoSize = True
'Définissez l'emplacement.
textbox0.Placement = PlacementType.FreeFloating
'Définissez la couleur de la police.
textbox0.Font.Color = Color.Blue
'Définissez la police sur gras.
textbox0.Font.IsBold = True
'Définissez la taille de la police.
textbox0.Font.Size = 14
'Définissez l'attribut de police sur italique.
textbox0.Font.IsItalic = True
'Ajoutez un lien hypertexte à la zone de texte.
textbox0.AddHyperlink("http://www.aspose.com/")
'Récupère le format de fil de la zone de texte.
Dim fillformat As FillFormat = textbox0.Fill
'Définissez la couleur de remplissage.
fillformat.SolidFill.Color = Color.Silver
'Obtenez le type de format de ligne de la zone de texte.
Dim lineformat As LineFormat = textbox0.Line
'Définissez le style de ligne.
lineformat.CompoundType = MsoLineStyle.ThinThick
'Définissez l'épaisseur de la ligne.
lineformat.Weight = 6
'Définissez le style de tiret sur squaredot.
lineformat.DashStyle = MsoLineDashStyle.SquareDot
'Ajoutez une autre zone de texte.
textboxIndex = worksheet.TextBoxes.Add(15, 4, 85, 120)
'Obtenez la deuxième zone de texte.
Dim textbox1 As Aspose.Cells.Drawing.TextBox = worksheet.TextBoxes(textboxIndex)
'Entrez du texte dessus.
textbox1.Text = "This is another simple text box"
'Définissez le type de placement lorsque la zone de texte se déplacera et
'redimensionner avec des cellules.
textbox1.Placement = PlacementType.MoveAndSize
'Enregistrez le fichier excel.
workbook.Save("tsttextboxes.xlsx")

Voir également

Spinner TextBoxCollection