GroupBox

GroupBox class

Incapsula l’oggetto che rappresenta una casella di gruppo in un foglio di calcolo.

public class GroupBox : Shape

Proprietà

NomeDescrizione
ActiveXControl { get; }Ottiene il controllo ActiveX.
ActualLowerRightRow { get; }Ottieni la riga inferiore effettiva.
AlternativeText { get; set; }Restituisce o imposta la stringa di testo descrittiva (alternativa) del fileShape oggetto.
AnchorType { get; set; }Ottiene e imposta il segnaposto di ancoraggio della forma.
AutoShapeType { get; set; }Ottiene e imposta il tipo di forma automatica.
Bottom { get; set; }Rappresenta la larghezza dell’offset verticale della forma dalla riga dell’angolo inferiore inferiore, in unità di pixel.
ControlData { get; }Ottiene i dati di controllo.
CreateId { get; set; }Ottiene e imposta l’ID di creazione per questa forma.
Fill { get; }Restituisce aFillFormat oggetto che contiene le proprietà di formattazione del riempimento per la forma specificata.
Font { get; set; }Rappresenta il carattere della forma.
FormatPicture { get; }Ottiene e imposta le opzioni del formato immagine.
Geometry { get; }Ottiene la geometria
Glow { get; }Rappresenta a oggetto che specifica l’effetto bagliore per l’elemento o la forma del grafico.
Group { get; }Ottiene la forma del gruppo che contiene questa forma.
HasLine { get; set; }Ottiene e imposta il bordo della linea della forma è visibile.
Height { get; set; }Rappresenta l’altezza della forma, in unità di pixel.
HeightCM { get; set; }Rappresenta l’altezza della forma, in unità di centimetri.
HeightInch { get; set; }Rappresenta l’altezza della forma, in unità di pollici.
HeightInShape { get; set; }Rappresenta l’offset verticale della forma dal bordo superiore della forma principale, in unità di 1/4000 di altezza della forma principale..
HeightPt { get; set; }Rappresenta l’altezza della forma, in unità di punti.
HeightScale { get; set; }Ottiene e imposta la scala dell’altezza, in unità di percentuale dell’altezza dell’immagine originale. Se la forma non è un’immagine, la proprietà HeightScale restituisce solo 100;
HtmlText { get; set; }Ottiene e imposta la stringa html che contiene i dati e alcuni formati in questa casella di testo.
Hyperlink { get; }Ottiene il collegamento ipertestuale della forma.
Id { get; }Ottiene l’identificatore di questa forma.
InputRange { get; set; }Ottiene o imposta l’intervallo del foglio di lavoro utilizzato per riempire la casella combinata specificata.
IsEquation { get; }Indica se la forma contiene solo un’equazione.
IsFilled { get; set; }Indica se il formato di riempimento è visibile.
IsFlippedHorizontally { get; set; }Ottiene e imposta se la forma viene capovolta orizzontalmente .
IsFlippedVertically { get; set; }Ottiene e imposta se la forma viene capovolta verticalmente .
IsGroup { get; }Indica se la forma è un gruppo.
IsHidden { get; set; }Indica se l’oggetto è visibile.
IsInGroup { get; }Indica se la forma è raggruppata.
IsLockAspectRatio { get; set; }True significa che non consente modifiche alle proporzioni.
IsLocked { get; set; }Vero se l’oggetto è bloccato, Falso se l’oggetto può essere modificato quando il foglio è protetto.
IsPrintable { get; set; }Vero se l’oggetto è stampabile
IsRichText { get; }Se il testo è RTF o meno.
IsSmartArt { get; }Indica se la forma è smart art.
IsTextWrapped { get; set; }Ottiene e imposta il tipo di testo a capo della forma che contiene testo.
IsWordArt { get; }Indica se questa forma è una parola art.
Left { get; set; }Rappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di pixel.
LeftCM { get; set; }Rappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di centimetri.
LeftInch { get; set; }Rappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di pollici.
LeftInShape { get; set; }Rappresenta l’offset orizzontale della forma dal bordo sinistro della forma principale, in unità di 1/4000 di larghezza della forma principale.
LeftToCorner { get; set; }Ottiene e imposta l’offset orizzontale della forma dal bordo sinistro del foglio di lavoro.
Line { get; }Ottiene lo stile della linea
LinkedCell { get; set; }Ottiene o imposta l’intervallo del foglio di lavoro collegato al valore del controllo.
LowerDeltaX { get; set; }Ottiene o imposta l’offset orizzontale della forma dalla colonna dell’angolo inferiore destro.
LowerDeltaY { get; set; }Ottiene o imposta l’offset verticale della forma dalla riga dell’angolo inferiore destro.
LowerRightColumn { get; set; }Rappresenta l’indice della colonna nell’angolo inferiore destro.
LowerRightRow { get; set; }Rappresenta l’indice della riga nell’angolo inferiore destro.
MacroName { get; set; }Ottiene e imposta il nome della macro.
MsoDrawingType { get; }Ottiene il tipo di disegno mso.
Name { get; set; }Ottiene e imposta il nome della forma.
Paths { get; }Ottiene i percorsi di una forma geometrica personalizzata.
Placement { get; set; }Rappresenta il modo in cui l’oggetto di disegno è collegato alle celle sottostanti. La proprietà controlla il posizionamento di un oggetto su un foglio di lavoro.
Reflection { get; }Rappresenta aoggetto che specifica l’effetto di riflessione per l’elemento o la forma del grafico.
RelativeToOriginalPictureSize { get; set; }Indica se la forma è relativa alla dimensione dell’immagine originale.
Right { get; set; }Rappresenta la larghezza dell’offset orizzontale della forma rispetto alla colonna dell’angolo inferiore destro, in unità di pixel.
RotationAngle { get; set; }Ottiene e imposta la rotazione della forma.
Shadow { get; set; }Indica se la casella di gruppo ha ombra.
ShadowEffect { get; }Rappresenta a oggetto che specifica l’effetto ombra per l’elemento o la forma del grafico.
SoftEdges { get; set; }Ottiene e imposta il raggio di sfocatura da applicare ai bordi, in unità di punti.
Spid { get; }Specifica una stringa facoltativa che un’applicazione può utilizzare per identificare la forma particolare.
Spt { get; }Specifica un numero facoltativo che un’applicazione può utilizzare per associare la forma particolare a un tipo di forma definito.
Text { get; set; }Rappresenta la stringa in questo oggetto TextBox.
TextBody { get; }Ottiene e imposta l’impostazione del testo della forma.
TextDirection { get; set; }Ottiene/imposta la direzione del flusso di testo per questo oggetto.
TextEffect { get; }Restituisce un oggetto TextEffectFormat che contiene le proprietà di formattazione dell’effetto testo per la forma specificata. Si applica a oggetti Shape che rappresentano WordArt.
TextHorizontalAlignment { get; set; }Ottiene e imposta il tipo di allineamento orizzontale del testo della forma.
TextHorizontalOverflow { get; set; }Ottiene e imposta il tipo di overflow orizzontale del testo della forma che contiene testo.
TextOptions { get; set; }Rappresenta le opzioni di testo della forma.
TextOrientationType { get; set; }Ottiene e imposta il tipo di orientamento del testo della forma.
TextShapeType { get; set; }Ottiene e imposta il tipo di forma del testo preimpostato.
TextVerticalAlignment { get; set; }Ottiene e imposta il tipo di allineamento verticale del testo della forma.
TextVerticalOverflow { get; set; }Ottiene e imposta il tipo di overflow verticale del testo della forma che contiene testo.
ThreeDFormat { get; }Ottiene e imposta il formato 3d della forma.
Title { get; set; }Specifica il titolo (didascalia) dell’oggetto forma corrente.
Top { get; set; }Rappresenta l’offset verticale della forma dalla riga superiore, in unità di pixel.
TopCM { get; set; }Rappresenta l’offset verticale della forma dalla riga superiore, in unità di centimetri.
TopInch { get; set; }Rappresenta l’offset verticale della forma dalla riga superiore, in unità di pollici.
TopInShape { get; set; }Rappresenta l’offset verticale della forma dal bordo superiore della forma principale, in unità di 1/4000 di altezza della forma principale.
TopToCorner { get; set; }Ottiene e imposta l’offset verticale della forma dal bordo superiore del foglio di lavoro, in unità di pixel.
Type { get; }Ottiene il tipo di forma automatica.
UpperDeltaX { get; set; }Ottiene o imposta l’offset orizzontale della forma dalla colonna dell’angolo superiore sinistro.
UpperDeltaY { get; set; }Ottiene o imposta l’offset verticale della forma dalla riga dell’angolo superiore sinistro.
UpperLeftColumn { get; set; }Rappresenta l’indice della colonna nell’angolo superiore sinistro.
UpperLeftRow { get; set; }Rappresenta l’indice della riga nell’angolo superiore sinistro.
Width { get; set; }Rappresenta la larghezza della forma, in unità di pixel.
WidthCM { get; set; }Rappresenta la larghezza della forma, in unità di centimetri.
WidthInch { get; set; }Rappresenta la larghezza della forma, in unità di pollici.
WidthInShape { get; set; }Rappresenta la larghezza della forma, in unità di 1/4000 della forma principale.
WidthPt { get; set; }Rappresenta la larghezza della forma, in unità di punto.
WidthScale { get; set; }Ottiene e imposta la scala della larghezza, in unità di percentuale della larghezza dell’immagine originale. Se la forma non è un’immagine, la proprietà WidthScale restituisce solo 100;
Worksheet { get; }Ottiene ilWorksheet oggetto che contiene questa forma.
X { get; set; }Ottiene e imposta l’offset orizzontale della forma dal bordo sinistro del foglio di lavoro, in unità di pixel.
Y { get; set; }Ottiene e imposta l’offset verticale della forma dal bordo superiore del foglio di lavoro, in unità di pixel.
ZOrderPosition { get; set; }Restituisce la posizione di una forma nell’ordine z.

Metodi

NomeDescrizione
AddHyperlink(string)Aggiunge un collegamento ipertestuale alla forma.
AlignTopRightCorner(int, int)Sposta l’immagine nell’angolo in alto a destra.
CalculateTextSize()Ricalcola l’area di testo
Characters(int, int)Restituisce un oggetto Caratteri che rappresenta un intervallo di caratteri all’interno del testo.
FormatCharacters(int, int, Font, StyleFlag)Formatta alcuni caratteri con l’impostazione del carattere.
GetCharacters()Restituisce tutti gli oggetti Characters che rappresentano un intervallo di caratteri all’interno del testo .
GetConnectionPoints()Ottieni i punti di connessione
GetInputRange(bool, bool)Ottiene l’intervallo utilizzato per riempire il controllo.
GetLinkedCell(bool, bool)Ottiene l’intervallo collegato al valore del controllo.
GetLockedProperty(ShapeLockType)Ottiene il valore della proprietà bloccata.
virtual GetResultOfSmartArt()Conversione di Smart Art in forme raggruppate.
virtual IsSameSetting(object)Restituisce se la forma è la stessa.
MoveToRange(int, int, int, int)Sposta la forma in un intervallo specificato.
RemoveActiveXControl()Rimuovi controllo activeX.
RemoveHyperlink()Rimuovi il collegamento ipertestuale della forma.
SetInputRange(string, bool, bool)Imposta l’intervallo utilizzato per riempire il controllo.
SetLinkedCell(string, bool, bool)Imposta l’intervallo collegato al valore del controllo.
SetLockedProperty(ShapeLockType, bool)Imposta la proprietà bloccata.
ToFrontOrBack(int)Porta la forma in primo piano o rimanda la forma in secondo piano.
ToImage(ImageOrPrintOptions)Restituisce l’oggetto bitmap della forma .
ToImage(Stream, ImageOrPrintOptions)Salva la forma in un flusso.
ToImage(Stream, ImageType)Crea l’immagine della forma e la salva in un flusso nel formato specificato.
ToImage(string, ImageOrPrintOptions)Salva la forma in un file.
UpdateSelectedValue()Aggiorna il valore selezionato in base al valore della cella collegata.

Esempi


[C#]

//Crea un'istanza di una nuova cartella di lavoro.
Workbook excelbook = new Workbook();
 
//Aggiunge una casella di gruppo al primo foglio di lavoro.
Aspose.Cells.GroupBox box = excelbook.Worksheets[0].Shapes.AddGroupBox(1, 0, 1, 0, 300, 250);
 
//Imposta la didascalia della casella di gruppo.
box.Text = "Age Groups";
box.Placement = PlacementType.FreeFloating;
 
//Rendilo riquadro 2D.
box.Shadow = false;
 
//Aggiungi un pulsante di opzione.
Aspose.Cells.RadioButton radio1 = excelbook.Worksheets[0].Shapes.AddRadioButton(3, 0, 2, 0, 30, 110);
 
//Imposta la stringa di testo.
radio1.Text = "20-29";
 
//Imposta la cella A1 come cella collegata per il pulsante di opzione.
radio1.LinkedCell = "A1";
 
//Rendi il pulsante di opzione 3D.
radio1.Shadow = true;
 
//Imposta il colore di primo piano del pulsante di opzione.
radio1.FillFormat.ForeColor = Color.LightGreen;
 
//Imposta lo stile della linea del pulsante di opzione.
radio1.LineFormat.Style = MsoLineStyle.ThickThin;
 
//Imposta il peso del pulsante di opzione.
radio1.LineFormat.Weight = 4;
 
//Imposta il colore della linea del pulsante di opzione.
radio1.LineFormat.ForeColor = Color.Blue;
 
//Imposta lo stile del trattino del pulsante di opzione.
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Rendi visibile il formato della linea.
radio1.LineFormat.IsVisible = true;
 
//Rendi visibile il formato di riempimento.
radio1.FillFormat.IsVisible = true;
 
//Aggiungi un altro pulsante di opzione.
Aspose.Cells.RadioButton radio2 = excelbook.Worksheets[0].Shapes.AddRadioButton(6, 0, 2, 0, 30, 110);
 
//Imposta la stringa di testo.
radio2.Text = "30-39";
 
//Imposta la cella A1 come cella collegata per il pulsante di opzione.
radio2.LinkedCell = "A1";
 
//Rendi il pulsante di opzione 3D.
radio2.Shadow = true;
 
//Imposta il colore di primo piano del pulsante di opzione.
radio2.FillFormat.ForeColor = Color.LightGreen;
 
//Imposta lo stile della linea del pulsante di opzione.
radio2.LineFormat.Style = MsoLineStyle.ThickThin;
 
//Imposta il peso del pulsante di opzione.
radio2.LineFormat.Weight = 4;
 
//Imposta il colore della linea del pulsante di opzione.
radio2.LineFormat.ForeColor = Color.Blue;
 
//Imposta lo stile del trattino del pulsante di opzione.
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Rendi visibile il formato della linea.
radio2.LineFormat.IsVisible = true;
 
//Rendi visibile il formato di riempimento.
radio2.FillFormat.IsVisible = true;
 
//Aggiungi un altro pulsante di opzione.
Aspose.Cells.RadioButton radio3 = excelbook.Worksheets[0].Shapes.AddRadioButton(9, 0, 2, 0, 30, 110);
 
//Imposta la stringa di testo.
radio3.Text = "40-49";
 
//Imposta la cella A1 come cella collegata per il pulsante di opzione.
radio3.LinkedCell = "A1";
 
//Rendi il pulsante di opzione 3D.
radio3.Shadow = true;
 
//Imposta il colore di primo piano del pulsante di opzione.
radio3.FillFormat.ForeColor = Color.LightGreen;
 
//Imposta lo stile della linea del pulsante di opzione.
radio3.LineFormat.Style = MsoLineStyle.ThickThin;
 
//Imposta il peso del pulsante di opzione.
radio3.LineFormat.Weight = 4;
 
//Imposta il colore della linea del pulsante di opzione.
radio3.LineFormat.ForeColor = Color.Blue;
 
//Imposta lo stile del trattino del pulsante di opzione.
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Rendi visibile il formato della linea.
radio3.LineFormat.IsVisible = true;
 
//Rendi visibile il formato di riempimento.
radio3.FillFormat.IsVisible = true;
 
//Ottieni le forme.
Aspose.Cells.Shape[] shapeobjects = new Aspose.Cells.Shape[] { box, radio1, radio2, radio3 };
 
//Raggruppa le forme.
Aspose.Cells.GroupShape group = excelbook.Worksheets[0].Shapes.Group(shapeobjects);
 
//Salva il file excel.
excelbook.Save("groupshapes.xls");

[VB.NET]

'Crea un'istanza di una nuova cartella di lavoro.
Dim excelbook As Workbook = New Workbook()
 
'Aggiungi una casella di gruppo al primo foglio di lavoro.
Dim box As Aspose.Cells.GroupBox = excelbook.Worksheets(0).Shapes.AddGroupBox(1, 0, 1, 0, 300, 250)
 
'Imposta la didascalia della casella di gruppo.
box.Text = "Age Groups"
box.Placement = PlacementType.FreeFloating
 
'Crea una scatola 2D.
box.Shadow = False
 
'Aggiungi un pulsante di opzione.
Dim radio1 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(3, 0, 2, 0, 30, 110)
 
'Imposta la sua stringa di testo.
radio1.Text = "20-29"
 
'Imposta la cella A1 come cella collegata per il pulsante di opzione.
radio1.LinkedCell = "A1"
 
'Rendi il pulsante di opzione 3-D.
radio1.Shadow = True
 
'Imposta il colore di primo piano del pulsante di opzione.
radio1.FillFormat.ForeColor = Color.LightGreen
 
'Imposta lo stile della linea del pulsante di opzione.
radio1.LineFormat.Style = MsoLineStyle.ThickThin
 
'Imposta il peso del pulsante di opzione.
radio1.LineFormat.Weight = 4
 
'Imposta il colore della linea del pulsante di opzione.
radio1.LineFormat.ForeColor = Color.Blue
 
'Imposta lo stile del trattino del pulsante di opzione.
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Rendi visibile il formato della linea.
radio1.LineFormat.IsVisible = True
 
'Rendi visibile il formato di riempimento.
radio1.FillFormat.IsVisible = True
 
'Aggiungi un altro pulsante di opzione.
Dim radio2 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(6, 0, 2, 0, 30, 110)
 
'Imposta la sua stringa di testo.
radio2.Text = "30-39"
 
'Imposta la cella A1 come cella collegata per il pulsante di opzione.
radio2.LinkedCell = "A1"
 
'Rendi il pulsante di opzione 3-D.
radio2.Shadow = True
 
'Imposta il colore di primo piano del pulsante di opzione.
radio2.FillFormat.ForeColor = Color.LightGreen
 
'Imposta lo stile della linea del pulsante di opzione.
radio2.LineFormat.Style = MsoLineStyle.ThickThin
 
'Imposta il peso del pulsante di opzione.
radio2.LineFormat.Weight = 4
 
'Imposta il colore della linea del pulsante di opzione.
radio2.LineFormat.ForeColor = Color.Blue
 
'Imposta lo stile del trattino del pulsante di opzione.
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Rendi visibile il formato della linea.
radio2.LineFormat.IsVisible = True
 
'Rendi visibile il formato di riempimento.
radio2.FillFormat.IsVisible = True
 
'Aggiungi un altro pulsante di opzione.
Dim radio3 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(9, 0, 2, 0, 30, 110)
 
'Imposta la sua stringa di testo.
radio3.Text = "40-49"
 
'Imposta la cella A1 come cella collegata per il pulsante di opzione.
radio3.LinkedCell = "A1"
 
'Rendi il pulsante di opzione 3-D.
radio3.Shadow = True
 
'Imposta il colore di primo piano del pulsante di opzione.
radio3.FillFormat.ForeColor = Color.LightGreen
 
'Imposta lo stile della linea del pulsante di opzione.
radio3.LineFormat.Style = MsoLineStyle.ThickThin
 
'Imposta il peso del pulsante di opzione.
radio3.LineFormat.Weight = 4
 
'Imposta il colore della linea del pulsante di opzione.
radio3.LineFormat.ForeColor = Color.Blue
 
'Imposta lo stile del trattino del pulsante di opzione.
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Rendi visibile il formato della linea.
radio3.LineFormat.IsVisible = True
 
'Rendi visibile il formato di riempimento.
radio3.FillFormat.IsVisible = True
 
'Ottieni le forme.
Dim shapeobjects() As Aspose.Cells.Shape = New Aspose.Cells.Shape() {box, radio1, radio2, radio3}
 
'Raggruppa le forme.
Dim group As Aspose.Cells.GroupShape = excelbook.Worksheets(0).Shapes.Group(shapeobjects)
 
'Salva il file excel.
excelbook.Save("groupshapes.xls")

Guarda anche

GradientStyleType GroupFill