ShapeBase

ShapeBase class

Basklass för objekt i ritskiktet, såsom en AutoShape, freeform, 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 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; }ReturnerarSann om formtypen tillåter att formen har en bild.
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; }ReturnerarSann om denna nod har några undernoder.
Height { get; set; }Hämtar eller ställer in höjden på formens innehållsblock.
HeightRelative { get; set; }Hämtar eller ställer in värdet som representerar procentandelen av formens relativa höjd.
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; }ReturnerarSann 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; }ReturnerarSann om detta är en gruppform.
IsHorizontalRule { get; }ReturnerarSann om denna form är en horisontell regel.
IsImage { get; }ReturnerarSann 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; }ReturnerarSann om det här objektet flyttades (borttogs) i Microsoft Word medan ändringsspårning var aktiverad.
IsMoveToRevision { get; }ReturnerarSann om detta objekt flyttades (infogades) i Microsoft Word medan ändringsspårning var aktiverad.
IsSignatureLine { get; }Indikerar att formen är enSignatureLine .
IsTopLevel { get; }ReturnerarSannom denna form inte är ett underordnat till en gruppform.
IsWordArt { get; }ReturnerarSann 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.
LeftRelative { get; set; }Hämtar eller ställer in värdet som representerar formens relativa vänstra position i procent.
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.
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 omedelbart före denna nod.
Range { get; }Returnerar enRange 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.
RelativeHorizontalSize { get; set; }Hämtar eller ställer in värdet på 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 på formens relativa storlek i vertikal riktning.
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.
TopRelative { get; set; }Hämtar eller ställer in värdet som representerar formens relativa topposition i procent.
VerticalAlignment { get; set; }Anger hur formen är placerad vertikalt.
Width { get; set; }Hämtar eller ställer in bredden på formens innehållsblock.
WidthRelative { get; set; }Hämtar eller ställer in värdet som representerar procentandelen av formens relativa bredd.
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

namnBeskrivning
abstract 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()Skapar navigator som kan användas för att korsa och läsa noder.
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(NodeNode)Infogar den angivna noden omedelbart efter den angivna referensnoden.
InsertBefore(NodeNode)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 allaSmartTagunderliggande 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.
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

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

En form är en nod i dokumentträdet.

Om formen är ett barn till enParagraph objekt, då sägs formen vara “top-level”. Toppnivå-former mäts och placeras i punkter.

En form kan också förekomma som barn till enGroupShape objekt när flera former är grupperade. Underordnade former av en gruppform är placerade i koordinatutrymmet och units som definieras avCoordSize ochCoordOrigin egenskaper för gruppformen parent .

En form kan placeras inline med text eller flytande. Positioneringsmetoden kontrolleras med hjälp avWrapType fast egendom.

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

En flytande form 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 kommer att 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