ShapeBase

ShapeBase class

Basklass för objekt i ritlagret, till exempel en autoform, frihandsformat, OLE-objekt, ActiveX-kontroll eller bild.

För att lära dig mer, besökArbeta med former dokumentationsartikel.

public abstract class ShapeBase : CompositeNode

Egenskaper

namnBeskrivning
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.
abstract NodeType { get; }Hämtar typen av denna nod.
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

namnBeskrivning
abstract Accept(DocumentVisitor)Tar emot en besökare.
abstract AcceptEnd(DocumentVisitor)När den implementeras i en härledd klass, anropas VisitXXXEnd-metoden för den angivna dokumentbesökaren.
abstract AcceptStart(DocumentVisitor)När den implementeras i en härledd klass, anropas VisitXXXStart-metoden för den angivna dokumentbesökaren.
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

Detta är en abstrakt klass. De två härledda klasser som du kan instansiera ärShape ochGroupShape.

En form är en nod i dokumentträdet.

Om formen är underordnad enParagraph objekt, då sägs formen vara “på toppnivå”. Former på toppnivå mäts och placeras i punkter.

En form kan också förekomma som underordnad till enGroupShape objekt när flera shapes grupperas. Underformer till en gruppform placeras i koordinatrummet och units definieras avCoordSize ochCoordOrigin egenskaper för gruppformen parent .

En form kan placeras inbäddad i texten eller flytande. Positioneringsmetoden styrs med hjälp avWrapType egendom.

När en form är flytande positioneras den i förhållande till något (t.ex. det aktuella stycket, marginalen eller sidan). Formens relativa positionering anges med hjälp av .RelativeHorizontalPosition ochRelativeVerticalPosition egenskaper.

En flytande form kan placeras explicit med hjälp avLeft ochTop egenskaper eller justerad i förhållande till något annat objekt med hjälp avHorizontalAlignment ochVerticalAlignment egenskaper.

Exempel

Visar hur man infogar en flytande bild i mitten av en sida.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Infoga en flytande bild som visas bakom den överlappande texten och justera den mot sidans mitt.
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");
shape.WrapType = WrapType.None;
shape.BehindText = true;
shape.RelativeHorizontalPosition = RelativeHorizontalPosition.Page;
shape.RelativeVerticalPosition = RelativeVerticalPosition.Page;
shape.HorizontalAlignment = HorizontalAlignment.Center;
shape.VerticalAlignment = VerticalAlignment.Center;

doc.Save(ArtifactsDir + "Image.CreateFloatingPageCenter.docx");

Se även