GroupBox

GroupBox class

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

public class GroupBox : 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.
Shadow { get; set; }Indique si la zone de groupe a shadow.
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 excelbook = new Workbook();
 
//Ajouter une zone de groupe à la première feuille de calcul.
Aspose.Cells.GroupBox box = excelbook.Worksheets[0].Shapes.AddGroupBox(1, 0, 1, 0, 300, 250);
 
// Définissez la légende de la zone de groupe.
box.Text = "Age Groups";
box.Placement = PlacementType.FreeFloating;
 
// Faites-en une boîte 2-D.
box.Shadow = false;
 
//Ajouter un bouton radio.
Aspose.Cells.RadioButton radio1 = excelbook.Worksheets[0].Shapes.AddRadioButton(3, 0, 2, 0, 30, 110);
 
// Définit sa chaîne de texte.
radio1.Text = "20-29";
 
// Définissez la cellule A1 comme cellule liée pour le bouton radio.
radio1.LinkedCell = "A1";
 
// Rendre le bouton radio 3-D.
radio1.Shadow = true;
 
// Définit la couleur de premier plan du bouton radio.
radio1.FillFormat.ForeColor = Color.LightGreen;
 
// Définit le style de ligne du bouton radio.
radio1.LineFormat.Style = MsoLineStyle.ThickThin;
 
// Définit le poids du bouton radio.
radio1.LineFormat.Weight = 4;
 
// Définit la couleur de la ligne du bouton radio.
radio1.LineFormat.ForeColor = Color.Blue;
 
// Définit le style de tiret du bouton radio.
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Rend le format de ligne visible.
radio1.LineFormat.IsVisible = true;
 
//Rend le format de remplissage visible.
radio1.FillFormat.IsVisible = true;
 
//Ajouter un autre bouton radio.
Aspose.Cells.RadioButton radio2 = excelbook.Worksheets[0].Shapes.AddRadioButton(6, 0, 2, 0, 30, 110);
 
// Définit sa chaîne de texte.
radio2.Text = "30-39";
 
// Définissez la cellule A1 comme cellule liée pour le bouton radio.
radio2.LinkedCell = "A1";
 
// Rendre le bouton radio 3-D.
radio2.Shadow = true;
 
// Définit la couleur de premier plan du bouton radio.
radio2.FillFormat.ForeColor = Color.LightGreen;
 
// Définit le style de ligne du bouton radio.
radio2.LineFormat.Style = MsoLineStyle.ThickThin;
 
// Définit le poids du bouton radio.
radio2.LineFormat.Weight = 4;
 
// Définit la couleur de la ligne du bouton radio.
radio2.LineFormat.ForeColor = Color.Blue;
 
// Définit le style de tiret du bouton radio.
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Rend le format de ligne visible.
radio2.LineFormat.IsVisible = true;
 
//Rend le format de remplissage visible.
radio2.FillFormat.IsVisible = true;
 
//Ajouter un autre bouton radio.
Aspose.Cells.RadioButton radio3 = excelbook.Worksheets[0].Shapes.AddRadioButton(9, 0, 2, 0, 30, 110);
 
// Définit sa chaîne de texte.
radio3.Text = "40-49";
 
// Définissez la cellule A1 comme cellule liée pour le bouton radio.
radio3.LinkedCell = "A1";
 
// Rendre le bouton radio 3-D.
radio3.Shadow = true;
 
// Définit la couleur de premier plan du bouton radio.
radio3.FillFormat.ForeColor = Color.LightGreen;
 
// Définit le style de ligne du bouton radio.
radio3.LineFormat.Style = MsoLineStyle.ThickThin;
 
// Définit le poids du bouton radio.
radio3.LineFormat.Weight = 4;
 
// Définit la couleur de la ligne du bouton radio.
radio3.LineFormat.ForeColor = Color.Blue;
 
// Définit le style de tiret du bouton radio.
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Rend le format de ligne visible.
radio3.LineFormat.IsVisible = true;
 
//Rend le format de remplissage visible.
radio3.FillFormat.IsVisible = true;
 
// Récupère les formes.
Aspose.Cells.Shape[] shapeobjects = new Aspose.Cells.Shape[] { box, radio1, radio2, radio3 };
 
// Regrouper les formes.
Aspose.Cells.GroupShape group = excelbook.Worksheets[0].Shapes.Group(shapeobjects);
 
// Enregistrez le fichier excel.
excelbook.Save("groupshapes.xls");

[VB.NET]

'Instanciez un nouveau classeur.
Dim excelbook As Workbook = New Workbook()
 
'Ajoutez une zone de groupe à la première feuille de calcul.
Dim box As Aspose.Cells.GroupBox = excelbook.Worksheets(0).Shapes.AddGroupBox(1, 0, 1, 0, 300, 250)
 
'Définissez la légende de la zone de groupe.
box.Text = "Age Groups"
box.Placement = PlacementType.FreeFloating
 
'Faites-en une boîte 2D.
box.Shadow = False
 
'Ajouter un bouton radio.
Dim radio1 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(3, 0, 2, 0, 30, 110)
 
'Définissez sa chaîne de texte.
radio1.Text = "20-29"
 
'Définissez la cellule A1 comme cellule liée pour le bouton radio.
radio1.LinkedCell = "A1"
 
'Faire le bouton radio 3-D.
radio1.Shadow = True
 
'Définissez la couleur de premier plan du bouton radio.
radio1.FillFormat.ForeColor = Color.LightGreen
 
'Définissez le style de ligne du bouton radio.
radio1.LineFormat.Style = MsoLineStyle.ThickThin
 
'Définissez le poids du bouton radio.
radio1.LineFormat.Weight = 4
 
'Définissez la couleur de la ligne du bouton radio.
radio1.LineFormat.ForeColor = Color.Blue
 
'Définissez le style de tiret du bouton radio.
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Rendre le format de ligne visible.
radio1.LineFormat.IsVisible = True
 
'Rendre visible le format de remplissage.
radio1.FillFormat.IsVisible = True
 
'Ajouter un autre bouton radio.
Dim radio2 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(6, 0, 2, 0, 30, 110)
 
'Définissez sa chaîne de texte.
radio2.Text = "30-39"
 
'Définissez la cellule A1 comme cellule liée pour le bouton radio.
radio2.LinkedCell = "A1"
 
'Faire le bouton radio 3-D.
radio2.Shadow = True
 
'Définissez la couleur de premier plan du bouton radio.
radio2.FillFormat.ForeColor = Color.LightGreen
 
'Définissez le style de ligne du bouton radio.
radio2.LineFormat.Style = MsoLineStyle.ThickThin
 
'Définissez le poids du bouton radio.
radio2.LineFormat.Weight = 4
 
'Définissez la couleur de la ligne du bouton radio.
radio2.LineFormat.ForeColor = Color.Blue
 
'Définissez le style de tiret du bouton radio.
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Rendre le format de ligne visible.
radio2.LineFormat.IsVisible = True
 
'Rendre visible le format de remplissage.
radio2.FillFormat.IsVisible = True
 
'Ajouter un autre bouton radio.
Dim radio3 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(9, 0, 2, 0, 30, 110)
 
'Définissez sa chaîne de texte.
radio3.Text = "40-49"
 
'Définissez la cellule A1 comme cellule liée pour le bouton radio.
radio3.LinkedCell = "A1"
 
'Faire le bouton radio 3-D.
radio3.Shadow = True
 
'Définissez la couleur de premier plan du bouton radio.
radio3.FillFormat.ForeColor = Color.LightGreen
 
'Définissez le style de ligne du bouton radio.
radio3.LineFormat.Style = MsoLineStyle.ThickThin
 
'Définissez le poids du bouton radio.
radio3.LineFormat.Weight = 4
 
'Définissez la couleur de la ligne du bouton radio.
radio3.LineFormat.ForeColor = Color.Blue
 
'Définissez le style de tiret du bouton radio.
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Rendre le format de ligne visible.
radio3.LineFormat.IsVisible = True
 
'Rendre visible le format de remplissage.
radio3.FillFormat.IsVisible = True
 
'Obtenez les formes.
Dim shapeobjects() As Aspose.Cells.Shape = New Aspose.Cells.Shape() {box, radio1, radio2, radio3}
 
'Regroupez les formes.
Dim group As Aspose.Cells.GroupShape = excelbook.Worksheets(0).Shapes.Group(shapeobjects)
 
'Enregistrez le fichier excel.
excelbook.Save("groupshapes.xls")

Voir également

GradientStyleType GroupFill