GroupShape

GroupShape class

Representerar en grupp former i ett dokument.

För att lära dig mer, besökHur man lägger till en gruppform i ett Word-dokument dokumentationsartikel.

public class GroupShape : ShapeBase

Konstruktörer

namn	Beskrivning
GroupShape(DocumentBase)	Skapar en ny gruppform.

Egenskaper

namn	Beskrivning
AllowOverlap { get; set; }	Hämtar eller anger ett värde som anger om denna form kan överlappa andra former.
AlternativeText { get; set; }	Definierar alternativ text som ska visas istället för grafik.
AnchorLocked { get; set; }	Anger om formens ankare är låst.
AspectRatioLocked { get; set; }	Anger om formens bildförhållande är låst.
BehindText { get; set; }	Anger om formen är under eller ovanför texten.
Bottom { get; }	Hämtar positionen för den nedre kanten av det block som innehåller formen.
Bounds { get; set; }	Hämtar eller anger plats och storlek för det block som innehåller formen.
BoundsInPoints { get; }	Hämtar platsen och storleken på det block som innehåller formen i punkter, i förhållande till ankaret för den översta formen.
BoundsWithEffects { get; }	Hämtar den slutliga utsträckningen som detta formobjekt har efter att riteffekter har tillämpats. Värdet mäts i punkter.
CanHaveImage { get; }	Returersann om formtypen tillåter att formen har en bild.
CoordOrigin { get; set; }	Koordinaterna i det övre vänstra hörnet av det block som innehåller den här formen.
CoordSize { get; set; }	Bredden och höjden på koordinatutrymmet inuti det block som innehåller den här formen.
Count { get; }	Hämtar antalet omedelbara barn till denna nod.
CustomNodeId { get; set; }	Anger anpassad nodidentifierare.
DistanceBottom { get; set; }	Returnerar eller anger avståndet (i punkter) mellan dokumenttexten och formens nedre kant.
DistanceLeft { get; set; }	Returnerar eller anger avståndet (i punkter) mellan dokumenttexten och formens vänstra kant.
DistanceRight { get; set; }	Returnerar eller anger avståndet (i punkter) mellan dokumenttexten och formens högra kant.
DistanceTop { get; set; }	Returnerar eller anger avståndet (i punkter) mellan dokumenttexten och formens övre kant.
virtual Document { get; }	Hämtar dokumentet som denna nod tillhör.
Fill { get; }	Hämtar fyllningsformatering för formen.
FirstChild { get; }	Hämtar nodens första barn.
FlipOrientation { get; set; }	Växlar orienteringen på en form.
Font { get; }	Ger åtkomst till teckensnittsformateringen för detta objekt.
Glow { get; }	Hämtar glödformatering för formen.
HasChildNodes { get; }	Returersann om den här noden har några undernoder.
Height { get; set; }	Hämtar eller ställer in höjden på det block som innehåller formen.
HeightRelative { get; set; }	Hämtar eller ställer in värdet som representerar procentandelen av formens relativa höjd.
Hidden { get; set; }	Hämtar eller ställer in ett booleskt värde som anger om formen är synlig.
HorizontalAlignment { get; set; }	Anger hur formen placeras horisontellt.
HRef { get; set; }	Hämtar eller anger den fullständiga hyperlänkadressen för en form.
override IsComposite { get; }	Returersann eftersom denna nod kan ha underordnade noder.
IsDecorative { get; set; }	Hämtar eller ställer in flaggan som anger om formen är dekorativ i dokumentet.
IsDeleteRevision { get; }	Returnerar sant om det här objektet togs bort i Microsoft Word medan ändringsspårning var aktiverad.
IsGroup { get; }	Returersann om detta är en gruppform.
IsHorizontalRule { get; }	Returersann om denna form är en horisontell linje.
IsImage { get; }	Returersann om den här formen är en bildform.
IsInline { get; }	Ett snabbt sätt att avgöra om den här formen är placerad i linje med texten.
IsInsertRevision { get; }	Returnerar sant om det här objektet infogades i Microsoft Word medan ändringsspårning var aktiverad.
IsLayoutInCell { get; set; }	Hämtar eller anger en flagga som anger om formen visas inuti en tabell eller utanför den.
IsMoveFromRevision { get; }	Returersann om det här objektet flyttades (raderades) i Microsoft Word medan ändringsspårning var aktiverad.
IsMoveToRevision { get; }	Returersann om det här objektet flyttades (infogades) i Microsoft Word medan ändringsspårning var aktiverad.
IsSignatureLine { get; }	Indikerar att formen är enSignatureLine .
IsTopLevel { get; }	Returersann om den här formen inte är underordnad en gruppform.
IsWordArt { get; }	Returersann om den här formen är ett WordArt-objekt.
LastChild { get; }	Hämtar nodens sista barn.
Left { get; set; }	Hämtar eller anger positionen för den vänstra kanten av det block som formen innehåller.
LeftRelative { get; set; }	Hämtar eller ställer in värdet som representerar formens relativa vänstra position i procent.
MarkupLanguage { get; }	Hämtar MarkupLanguage som används för detta grafikobjekt.
Name { get; set; }	Hämtar eller anger det valfria formnamnet.
NextSibling { get; }	Hämtar noden som följer direkt efter denna nod.
override NodeType { get; }	ReturerGroupShape .
ParentNode { get; }	Hämtar den omedelbara föräldern till denna nod.
ParentParagraph { get; }	Returnerar det omedelbara överordnade stycket.
PreviousSibling { get; }	Hämtar noden som omedelbart föregår denna nod.
Range { get; }	Returnerar enRangeobjekt som representerar den del av ett dokument som finns i denna nod.
Reflection { get; }	Hämtar reflektionsformatering för formen.
RelativeHorizontalPosition { get; set; }	Anger i förhållande till vad formen är placerad horisontellt.
RelativeHorizontalSize { get; set; }	Hämtar eller ställer in värdet för formens relativa storlek i horisontell riktning.
RelativeVerticalPosition { get; set; }	Anger i förhållande till vad formen är placerad vertikalt.
RelativeVerticalSize { get; set; }	Hämtar eller ställer in värdet för formens relativa storlek i vertikal riktning.
Right { get; }	Hämtar positionen för den högra kanten av det block som innehåller formen.
Rotation { get; set; }	Definierar vinkeln (i grader) som en form roteras med. Positivt värde motsvarar medurs rotationsvinkel.
ScreenTip { get; set; }	Definierar texten som visas när muspekaren flyttas över formen.
ShadowFormat { get; }	Hämtar skuggformatering för formen.
ShapeType { get; }	Hämtar formtypen.
SizeInPoints { get; }	Hämtar formens storlek i punkter.
SoftEdge { get; }	Hämtar mjuka kanter för formen.
Target { get; set; }	Hämtar eller ställer in målramen för formens hyperlänk.
Title { get; set; }	Hämtar eller anger titeln (bildtexten) för det aktuella formobjektet.
Top { get; set; }	Hämtar eller anger positionen för den övre kanten av det block som formen innehåller.
TopRelative { get; set; }	Hämtar eller ställer in värdet som representerar formens relativa toppposition i procent.
VerticalAlignment { get; set; }	Anger hur formen placeras vertikalt.
Width { get; set; }	Hämtar eller ställer in bredden på det block som innehåller formen.
WidthRelative { get; set; }	Hämtar eller ställer in värdet som representerar procentandelen av formens relativa bredd.
WrapSide { get; set; }	Anger hur texten radbryts runt formen.
WrapType { get; set; }	Definierar om formen är inbäddad eller flytande. För flytande former definieras radbrytningsläget för text runt formen.
ZOrder { get; set; }	Bestämmer visningsordningen för överlappande former.

Metoder

namn	Beskrivning
override Accept(DocumentVisitor)	Tar emot en besökare.
override AcceptEnd(DocumentVisitor)	Accepterar en besökare för att besöka slutet av gruppformen.
override AcceptStart(DocumentVisitor)	Accepterar en besökare för att besöka början av gruppformen.
AdjustWithEffects(RectangleF)	Lägger till värdena för effektens omfattning i källrektangeln och returnerar den slutliga rektangeln.
AppendChild<T>(T)	Lägger till den angivna noden i slutet av listan över underordnade noder för denna nod.
Clone(bool)	Skapar en duplikat av noden.
CreateNavigator()	Skapar en navigator som kan användas för att korsa och läsa noder.
GetAncestor(NodeType)	Hämtar den första förfadern till den angivnaNodeType .
GetAncestor(Type)	Hämtar den första förfadern till den angivna objekttypen.
GetChild(NodeType, int, bool)	Returnerar en N:te underordnad nod som matchar den angivna typen.
GetChildNodes(NodeType, bool)	Returnerar en live-samling av underordnade noder som matchar den angivna typen.
GetEnumerator()	Ger stöd för iterationen för varje stil över de underordnade noderna till denna nod.
GetShapeRenderer()	Skapar och returnerar ett objekt som kan användas för att rendera denna form till en bild.
override GetText()	Hämtar texten för denna nod och alla dess underordnade noder.
IndexOf(Node)	Returnerar indexet för den angivna undernoden i undernodsmatrisen.
InsertAfter<T>(T, Node)	Infogar den angivna noden omedelbart efter den angivna referensnoden.
InsertBefore<T>(T, Node)	Infogar den angivna noden omedelbart före den angivna referensnoden.
LocalToParent(PointF)	Konverterar ett värde från det lokala koordinatrummet till koordinatrummet för den överordnade formen.
NextPreOrder(Node)	Hämtar nästa nod enligt algoritmen för förbeställningsträdtraversering.
PrependChild<T>(T)	Lägger till den angivna noden i början av listan över underordnade noder för denna nod.
PreviousPreOrder(Node)	Hämtar föregående nod enligt algoritmen för trädtraversering i förbeställning.
Remove()	Tar bort sig själv från föräldern.
RemoveAllChildren()	Tar bort alla undernoder till den aktuella noden.
RemoveChild<T>(T)	Tar bort den angivna undernoden.
RemoveSmartTags()	Tar bort allaSmartTag underordnade noder till den aktuella noden.
SelectNodes(string)	Väljer en lista med noder som matchar XPath-uttrycket.
SelectSingleNode(string)	Väljer den förstaNode som matchar XPath-uttrycket.
ToString(SaveFormat)	Exporterar nodens innehåll till en sträng i det angivna formatet.
ToString(SaveOptions)	Exporterar nodens innehåll till en sträng med de angivna sparalternativen.

Anmärkningar

EnGroupShape är en sammansatt nod och kan haShape och GroupShape noder som barn.

VarjeGroupShapedefinierar ett nytt koordinatsystem för dess underformer. Koordinatsystemet definieras med hjälp avCoordSize och CoordOrigin egenskaper.

Exempel

Visar hur man skapar en grupp med former och skriver ut dess innehåll med hjälp av en dokumentbesökare.

public void GroupOfShapes()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    // Om du behöver skapa "Icke-primitiva" former, till exempel SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped,
    // ÖvreHörnEttRundatEttBeskärt, EnkeltHörnRundat, ÖvreHörnRundade, DiagonalaHörnRundade
    // använd DocumentBuilder.InsertShape-metoderna.
    Shape balloon = new Shape(doc, ShapeType.Balloon)
    {
        Width = 200,
        Height = 200,
        Stroke = { Color = Color.Red }
    };

    Shape cube = new Shape(doc, ShapeType.Cube)
    {
        Width = 100,
        Height = 100,
        Stroke = { Color = Color.Blue }
    };

    GroupShape group = new GroupShape(doc);
    group.AppendChild(balloon);
    group.AppendChild(cube);

    Assert.True(group.IsGroup);

    builder.InsertNode(group);

    ShapeGroupPrinter printer = new ShapeGroupPrinter();
    group.Accept(printer);

    Console.WriteLine(printer.GetText());
}

/// <summary>
/// Skriver ut innehållet i en besökt formgrupp till konsolen.
/// </summary>
public class ShapeGroupPrinter : DocumentVisitor
{
    public ShapeGroupPrinter()
    {
        mBuilder = new StringBuilder();
    }

    public string GetText()
    {
        return mBuilder.ToString();
    }

    public override VisitorAction VisitGroupShapeStart(GroupShape groupShape)
    {
        mBuilder.AppendLine("Shape group started:");
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitGroupShapeEnd(GroupShape groupShape)
    {
        mBuilder.AppendLine("End of shape group");
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitShapeStart(Shape shape)
    {
        mBuilder.AppendLine("\tShape - " + shape.ShapeType + ":");
        mBuilder.AppendLine("\t\tWidth: " + shape.Width);
        mBuilder.AppendLine("\t\tHeight: " + shape.Height);
        mBuilder.AppendLine("\t\tStroke color: " + shape.Stroke.Color);
        mBuilder.AppendLine("\t\tFill color: " + shape.Fill.ForeColor);
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitShapeEnd(Shape shape)
    {
        mBuilder.AppendLine("\tEnd of shape");
        return VisitorAction.Continue;
    }

    private readonly StringBuilder mBuilder;
}

Se även

• class ShapeBase
• namnutrymme Aspose.Words.Drawing
• hopsättning Aspose.Words