GroupShape

GroupShape class

Representerar en grupp av former i ett dokument.

public class GroupShape : ShapeBase

Konstruktörer

namn Beskrivning
GroupShape(DocumentBase) Skapar en ny gruppform.

Egenskaper

namn Beskrivning
AllowOverlap { get; set; } Hämtar eller ställer in 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 en 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 över text.
Bottom { get; } Hämtar positionen för den nedre kanten av det innehållande blocket av formen.
Bounds { get; set; } Hämtar eller ställer in platsen och storleken på formens innehållsblock.
BoundsInPoints { get; } Hämtar platsen och storleken på formens innehållande block i punkter, i förhållande till ankaret för den översta formen.
BoundsWithEffects { get; } Får den slutliga omfattningen som detta formobjekt har efter applicering av ritningseffekter. Värdet mäts i punkter.
CanHaveImage { get; } Returnerar sant om formtypen tillåter att formen har en bild.
ChildNodes { get; } Hämtar alla omedelbara underordnade noder för denna nod.
CoordOrigin { get; set; } Koordinaterna i det övre vänstra hörnet av det innehållande blocket med denna form.
CoordSize { get; set; } Bredden och höjden på koordinatutrymmet inuti det innehållande blocket med denna form.
Count { get; } Hämtar antalet omedelbara barn till denna nod.
CustomNodeId { get; set; } Anger anpassad nodidentifierare.
DistanceBottom { get; set; } Returnerar eller ställer in avståndet (i punkter) mellan dokumenttexten och den nedre kanten av formen.
DistanceLeft { get; set; } Returnerar eller ställer in avståndet (i punkter) mellan dokumenttexten och den vänstra kanten av formen.
DistanceRight { get; set; } Returnerar eller ställer in avståndet (i punkter) mellan dokumenttexten och den högra kanten av formen.
DistanceTop { get; set; } Returnerar eller ställer in avståndet (i punkter) mellan dokumenttexten och formens övre kant.
virtual Document { get; } Hämtar dokumentet som denna nod tillhör.
Fill { get; } Får fyllningsformatering för formen.
FirstChild { get; } Får det första barnet i noden.
FlipOrientation { get; set; } Ändrar orienteringen för en form.
Font { get; } Ger tillgång till teckensnittsformateringen för detta objekt.
HasChildNodes { get; } Returnerar sant om denna nod har några underordnade noder.
Height { get; set; } Hämtar eller ställer in höjden på formens innehållsblock.
HorizontalAlignment { get; set; } Anger hur formen placeras horisontellt.
HRef { get; set; } Hämtar eller ställer in den fullständiga hyperlänkadressen för en form.
override IsComposite { get; } Returnerar sant 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 detta objekt raderades i Microsoft Word medan ändringsspårning var aktiverad.
IsGroup { get; } Returnerar sant om detta är en gruppform.
IsHorizontalRule { get; } Returnerar sant om denna form är en horisontell regel.
IsImage { get; } Returnerar sant om denna form är en bildform.
IsInline { get; } Ett snabbt sätt att avgöra om denna form är placerad i linje med text.
IsInsertRevision { get; } Returnerar sant om det här objektet infogades i Microsoft Word medan ändringsspårning var aktiverad.
IsLayoutInCell { get; set; } Hämtar eller sätter en flagga som indikerar om formen visas inuti en tabell eller utanför den.
IsMoveFromRevision { get; } Returnerar Sann om det här objektet flyttades (borttogs) i Microsoft Word medan ändringsspårning var aktiverad.
IsMoveToRevision { get; } Returnerar Sann om detta objekt flyttades (infogades) i Microsoft Word medan ändringsspårning var aktiverad.
IsSignatureLine { get; } Indikerar att formen är en SignatureLine.
IsTopLevel { get; } Returnerar sant om denna form inte är ett underordnat till en gruppform.
IsWordArt { get; } Returnerar sant om den här formen är ett WordArt-objekt.
LastChild { get; } Hämtar nodens sista underordnade.
Left { get; set; } Hämtar eller ställer in positionen för den vänstra kanten av formens innehållsblock.
MarkupLanguage { get; } Får MarkupLanguage som används för detta grafiska objekt.
Name { get; set; } Hämtar eller ställer in det valfria formnamnet.
NextSibling { get; } Hämtar noden omedelbart efter denna nod.
override NodeType { get; } ReturnerarGroupShape .
ParentNode { get; } Hämtar den omedelbara föräldern till denna nod.
ParentParagraph { get; } Returnerar det omedelbara överordnade stycket.
PreviousSibling { get; } Hämtar noden omedelbart före denna nod.
Range { get; } Returnerar en Räckvidd objekt som representerar den del av ett dokument som finns i denna nod.
RelativeHorizontalPosition { get; set; } Anger i förhållande till vad formen är placerad horisontellt.
RelativeVerticalPosition { get; set; } Anger i förhållande till vad formen är placerad vertikalt.
Right { get; } Får positionen för den högra kanten av det innehållande blocket av formen.
Rotation { get; set; } Definierar vinkeln (i grader) som en form roteras. Positivt värde motsvarar medurs rotationsvinkel.
ScreenTip { get; set; } Definierar texten som visas när muspekaren rör sig över formen.
ShadowFormat { get; } Får skuggformatering för formen.
ShapeType { get; } Hämtar formtypen.
SizeInPoints { get; } Får formens storlek i poäng.
Target { get; set; } Hämtar eller ställer in målramen för formhyperlänken.
Title { get; set; } Hämtar eller ställer in titeln (bildtexten) för det aktuella formobjektet.
Top { get; set; } Hämtar eller ställer in positionen för den övre kanten av formens innehållsblock.
VerticalAlignment { get; set; } Anger hur formen är placerad vertikalt.
Width { get; set; } Hämtar eller ställer in bredden på formens innehållsblock.
WrapSide { get; set; } Anger hur texten lindas runt formen.
WrapType { get; set; } Definierar om formen är inline eller flytande. För flytande former definierar lindningsläget för text runt formen.
ZOrder { get; set; } Bestämmer visningsordningen för överlappande former.

Metoder

namn Beskrivning
override Accept(DocumentVisitor) Accepterar en besökare.
AdjustWithEffects(RectangleF) Lägger till källrektangelvärdena för effektomfattningen och returnerar den sista rektangeln.
AppendChild(Node) Lägger till den angivna noden i slutet av listan över underordnade noder för denna nod.
Clone(bool) Skapar en dubblett av noden.
CreateNavigator() Reserverad för systemanvändning. IXPathNavigable.
FetchInheritedShapeAttr(int) Reserverad för systemanvändning. IShapeAttrSource.
FetchShapeAttr(int) Reserverad för systemanvändning. IShapeAttrSource.
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 aktiv samling av underordnade noder som matchar den angivna typen.
GetDirectShapeAttr(int) Reserverad för systemanvändning. IShapeAttrSource.
GetEnumerator() Tillhandahåller stöd för varje stiliteration över undernoderna för denna nod.
GetShapeRenderer() Skapar och returnerar ett objekt som kan användas för att återge denna form till en bild.
override GetText() Hämtar texten för denna nod och alla dess underordnade.
IndexOf(Node) Returnerar indexet för den angivna undernoden i den underordnade nodmatrisen.
InsertAfter(Node, Node) Infogar den angivna noden omedelbart efter den angivna referensnoden.
InsertBefore(Node, Node) Infogar den angivna noden omedelbart före den angivna referensnoden.
LocalToParent(PointF) Konverterar ett värde från det lokala koordinatutrymmet till koordinatutrymmet för den överordnade formen.
NextPreOrder(Node) Hämtar nästa nod enligt algoritmen för förbeställningsträdet.
PrependChild(Node) 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 förbeställningsträdet.
Remove() Tar bort sig själv från föräldern.
RemoveAllChildren() Tar bort alla undernoder för den aktuella noden.
RemoveChild(Node) Tar bort den angivna underordnade noden.
RemoveShapeAttr(int) Reserverad för systemanvändning. IShapeAttrSource.
RemoveSmartTags() Tar bort allaSmartTag underliggande noder till den aktuella noden.
SelectNodes(string) Väljer en lista med noder som matchar XPath-uttrycket.
SelectSingleNode(string) Väljer den första noden som matchar XPath-uttrycket.
SetShapeAttr(int, object) Reserverad för systemanvändning. IShapeAttrSource.
ToString(SaveFormat) Exporterar innehållet i noden till en sträng i angivet format.
ToString(SaveOptions) Exporterar innehållet i noden till en sträng med de angivna sparalternativen.

Anmärkningar

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

VarjeGroupShape definierar ett nytt koordinatsystem för dess underordnade former. Koordinatsystemet definieras med hjälp avCoordSize och CoordOrigin egenskaper.

Exempel

Visar hur man skapar en grupp av 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 "NonPrimitive" former, som SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped,
    // TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded, DiagonalCornersRounded
    // använd DocumentBuilder.InsertShape metoder.
    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