Shape

Shape class

Otomatik Şekil, metin kutusu, serbest biçim, OLE nesnesi, ActiveX denetimi veya resim gibi çizim katmanındaki bir nesneyi temsil eder.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Şekillerle Çalışma belgeleme makalesi.

public sealed class Shape : ShapeBase

yapıcılar

İsim	Tanım
Shape(DocumentBase, ShapeType)	Yeni bir şekil nesnesi oluşturur.

Özellikleri

İsim	Tanım
Adjustments { get; }	Bir şeklin ayar ham değerlerine erişim sağlar. Herhangi bir ayar ham değeri içermeyen bir şekil için boş bir koleksiyon döndürür.
AllowOverlap { get; set; }	Bu şeklin diğer şekillerle örtüşüp örtüşmeyeceğini belirten bir değer alır veya ayarlar.
AlternativeText { get; set; }	Grafik yerine görüntülenecek alternatif metni tanımlar.
AnchorLocked { get; set; }	Şeklin bağlantısının kilitli olup olmadığını belirtir.
AspectRatioLocked { get; set; }	Şeklin en boy oranının kilitli olup olmadığını belirtir.
BehindText { get; set; }	Şeklin metnin altında mı yoksa üstünde mi olduğunu belirtir.
Bottom { get; }	Şeklin içeren bloğunun alt kenarının konumunu alır.
Bounds { get; set; }	Şeklin içeren bloğunun konumunu ve boyutunu alır veya ayarlar.
BoundsInPoints { get; }	Şeklin içeren bloğunun konumunu ve boyutunu, en üstteki şeklin çapa noktasına göre noktalar halinde alır.
BoundsWithEffects { get; }	Çizim efektleri uygulandıktan sonra bu şekil nesnesinin sahip olduğu son kapsamı alır. Değer noktalarla ölçülür.
CanHaveImage { get; }	Geri Döndürürdoğru eğer şekil türü şeklin bir görüntüye sahip olmasına izin veriyorsa.
Chart { get; }	Bu şeklin bir özelliği varsa grafik özelliklerine erişim sağlar.Chart .
CoordOrigin { get; set; }	Bu şeklin bulunduğu bloğun sol üst köşesindeki koordinatlar.
CoordSize { get; set; }	Bu şeklin bulunduğu bloğun içindeki koordinat alanının genişliği ve yüksekliği.
Count { get; }	Bu düğümün hemen alt düğümlerinin sayısını alır.
CustomNodeId { get; set; }	Özel düğüm tanımlayıcısını belirtir.
DistanceBottom { get; set; }	Belge metni ile şeklin alt kenarı arasındaki mesafeyi (nokta cinsinden) döndürür veya ayarlar.
DistanceLeft { get; set; }	Belge metni ile şeklin sol kenarı arasındaki mesafeyi (nokta cinsinden) döndürür veya ayarlar.
DistanceRight { get; set; }	Belge metni ile şeklin sağ kenarı arasındaki mesafeyi (nokta cinsinden) döndürür veya ayarlar.
DistanceTop { get; set; }	Belge metni ile şeklin üst kenarı arasındaki mesafeyi (nokta cinsinden) döndürür veya ayarlar.
virtual Document { get; }	Bu düğümün ait olduğu belgeyi alır.
ExtrusionEnabled { get; }	Geri Döndürürdoğru eğer bir ekstrüzyon efekti etkinleştirilmişse.
Fill { get; }	Şekil için dolgu biçimlendirmesini alır.
FillColor { get; set; }	Şeklin kapalı yolunu dolduran fırça rengini tanımlar.
Filled { get; set; }	Şeklin kapalı yolunun doldurulup doldurulmayacağını belirler.
FirstChild { get; }	Düğümün ilk çocuğunu alır.
FirstParagraph { get; }	Şekildeki ilk paragrafı alır.
FlipOrientation { get; set; }	Bir şeklin yönünü değiştirir.
Font { get; }	Bu nesnenin yazı tipi biçimlendirmesine erişim sağlar.
Glow { get; }	Şekil için parıltı biçimlendirmesini alır.
HasChart { get; }	Geri Döndürürdoğru eğer buShape bir tane varChart .
HasChildNodes { get; }	Geri Döndürürdoğru eğer bu düğümün herhangi bir alt düğümü varsa.
HasImage { get; }	Geri Döndürürdoğru eğer şeklin görüntü baytları varsa veya bir görüntüye bağlantı veriyorsa.
HasSmartArt { get; }	Geri Döndürürdoğru eğer buShape bir SmartArt nesnesi var.
Height { get; set; }	Şeklin içeren bloğunun yüksekliğini alır veya ayarlar.
HeightRelative { get; set; }	Şeklin göreli yüksekliğinin yüzdesini temsil eden değeri alır veya ayarlar.
Hidden { get; set; }	Şeklin görünür olup olmadığını belirten bir Boole değeri alır veya ayarlar.
HorizontalAlignment { get; set; }	Şeklin yatay olarak nasıl konumlandırılacağını belirtir.
HorizontalRuleFormat { get; }	Yatay kural şeklinin özelliklerine erişim sağlar. Yatay kural olmayan bir şekil için, şunu döndürür:hükümsüz .
HRef { get; set; }	Bir şeklin tam köprü adresini alır veya ayarlar.
ImageData { get; }	Şeklin görüntüsüne erişim sağlar. Geri döndürürhükümsüz eğer şeklin bir görüntüsü olamazsa.
override IsComposite { get; }	Geri Döndürürdoğru çünkü bu düğümün alt düğümleri olabilir.
IsDecorative { get; set; }	Şeklin belgede dekoratif olup olmadığını belirten bayrağı alır veya ayarlar.
IsDeleteRevision { get; }	Değişiklik izleme etkinleştirilmişken bu nesnenin Microsoft Word’de silinmesi durumunda doğru değerini döndürür.
IsGroup { get; }	Geri Döndürürdoğru eğer bu bir grup şekliyse.
IsHorizontalRule { get; }	Geri Döndürürdoğru eğer bu şekil yatay bir cetvel ise.
IsImage { get; }	Geri Döndürürdoğru eğer bu şekil bir görüntü şekliyse.
IsInline { get; }	Bu şeklin metinle aynı hizada konumlandırılıp konumlandırılmadığını belirlemenin hızlı bir yolu.
IsInsertRevision { get; }	Bu nesnenin Microsoft Word’e değişiklik izleme etkinleştirilmişken eklenip eklenmediğini döndürür.
IsLayoutInCell { get; set; }	Şeklin bir tablonun içinde mi yoksa dışında mı görüntüleneceğini belirten bir bayrak alır veya ayarlar.
IsMoveFromRevision { get; }	Geri Döndürürdoğru bu nesne Microsoft Word’de değişiklik izleme etkinleştirilmişken taşınırsa (silinirse).
IsMoveToRevision { get; }	Geri Döndürürdoğru bu nesne Microsoft Word’de değişiklik izleme etkinleştirilmişken taşınırsa (eklenirse).
IsSignatureLine { get; }	Şeklin birSignatureLine .
IsTopLevel { get; }	Geri Döndürürdoğru eğer bu şekil bir grup şeklinin çocuğu değilse.
IsWordArt { get; }	Geri Döndürürdoğru eğer bu şekil bir WordArt nesnesiyse.
LastChild { get; }	Düğümün son çocuğunu alır.
LastParagraph { get; }	Şekildeki son paragrafı alır.
Left { get; set; }	Şeklin içeren bloğunun sol kenarının konumunu alır veya ayarlar.
LeftRelative { get; set; }	Şeklin yüzde olarak göreli sol konumunu temsil eden değeri alır veya ayarlar.
MarkupLanguage { get; }	Bu grafik nesnesi için kullanılan MarkupLanguage’ı alır.
Name { get; set; }	İsteğe bağlı şekil adını alır veya ayarlar.
NextSibling { get; }	Bu düğümü hemen takip eden düğümü alır.
override NodeType { get; }	Geri DöndürürShape .
OleFormat { get; }	Bir şeklin OLE verilerine erişim sağlar. OLE nesnesi veya ActiveX denetimi olmayan bir şekil için, şunu döndürür:hükümsüz .
ParentNode { get; }	Bu düğümün en yakın üst düğümünü alır.
ParentParagraph { get; }	Hemen üst paragrafı döndürür.
PreviousSibling { get; }	Bu düğümden hemen önceki düğümü alır.
Range { get; }	BirRangebu düğümde bulunan bir belgenin bölümünü temsil eden nesne.
Reflection { get; }	Şekil için yansıma biçimlendirmesini alır.
RelativeHorizontalPosition { get; set; }	Şeklin yatay olarak nasıl konumlandırıldığını belirtir.
RelativeHorizontalSize { get; set; }	Şeklin yatay yöndeki göreli boyutunun değerini alır veya ayarlar.
RelativeVerticalPosition { get; set; }	Şeklin dikey olarak nasıl konumlandırıldığını belirtir.
RelativeVerticalSize { get; set; }	Şeklin dikey yöndeki göreli boyutunun değerini alır veya ayarlar.
Right { get; }	Şeklin içeren bloğunun sağ kenarının konumunu alır.
Rotation { get; set; }	Bir şeklin döndürüleceği açıyı (derece olarak) tanımlar. Pozitif değer saat yönünde dönüş açısına karşılık gelir.
ScreenTip { get; set; }	Fare işaretçisi şeklin üzerine geldiğinde görüntülenen metni tanımlar.
ShadowEnabled { get; }	Geri Döndürürdoğru gölge efekti etkinleştirilmişse.
ShadowFormat { get; }	Şekil için gölge biçimlendirmesi alır.
ShapeType { get; }	Şekil türünü alır.
SignatureLine { get; }	AlırSignatureLine şekil bir imza satırıysa nesne. Geri dönerhükümsüz aksi takdirde.
SizeInPoints { get; }	Şeklin boyutunu noktalar halinde alır.
SoftEdge { get; }	Şekil için yumuşak kenar biçimlendirmesi alır.
StoryType { get; }	Geri DöndürürTextbox .
Stroke { get; }	Bir şekil için bir kontur tanımlar.
StrokeColor { get; set; }	Bir vuruşun rengini tanımlar.
Stroked { get; set; }	Yolun çizilip çizilmeyeceğini tanımlar.
StrokeWeight { get; set; }	Bir şeklin yolunu noktalar halinde çizen fırça kalınlığını tanımlar.
Target { get; set; }	Şekil köprüsü için hedef çerçeveyi alır veya ayarlar.
TextBox { get; }	Metnin bir şekil içinde nasıl görüntüleneceğini belirten nitelikleri tanımlar.
TextPath { get; }	Metin yolunun (WordArt nesnesinin) metnini tanımlar.
Title { get; set; }	Geçerli şekil nesnesinin başlığını (başlığını) alır veya ayarlar.
Top { get; set; }	Şeklin içeren bloğunun üst kenarının konumunu alır veya ayarlar.
TopRelative { get; set; }	Şeklin yüzde olarak göreli en üst konumunu temsil eden değeri alır veya ayarlar.
VerticalAlignment { get; set; }	Şeklin dikey olarak nasıl konumlandırılacağını belirtir.
Width { get; set; }	Şeklin içeren bloğunun genişliğini alır veya ayarlar.
WidthRelative { get; set; }	Şeklin göreli genişliğinin yüzdesini temsil eden değeri alır veya ayarlar.
WrapSide { get; set; }	Metnin şeklin etrafına nasıl sarılacağını belirtir.
WrapType { get; set; }	Şeklin satır içi mi yoksa yüzen mi olduğunu tanımlar. Yüzen şekiller için şeklin etrafındaki metnin sarma modunu tanımlar.
ZOrder { get; set; }	Çakışan şekillerin görüntülenme sırasını belirler.

yöntemler

İsim	Tanım
override Accept(DocumentVisitor)	Bir ziyaretçiyi kabul eder.
override AcceptEnd(DocumentVisitor)	Şeklin sonunu ziyaret eden bir ziyaretçiyi kabul eder.
override AcceptStart(DocumentVisitor)	Şeklin başlangıcını ziyaret eden bir ziyaretçiyi kabul eder.
AdjustWithEffects(RectangleF)	Kaynak dikdörtgene efekt kapsamının değerlerini ekler ve son dikdörtgeni döndürür.
AppendChild<T>(T)	Belirtilen düğümü bu düğüm için alt düğümler listesinin sonuna ekler.
Clone(bool)	Düğümün bir kopyasını oluşturur.
CreateNavigator()	Düğümleri gezmek ve okumak için kullanılabilen gezgini oluşturur.
GetAncestor(NodeType)	Belirtilenin ilk atasını alırNodeType .
GetAncestor(Type)	Belirtilen nesne türünün ilk atasını alır.
GetChild(NodeType, int, bool)	Belirtilen türle eşleşen N’inci alt düğümü döndürür.
GetChildNodes(NodeType, bool)	Belirtilen türle eşleşen alt düğümlerin canlı bir koleksiyonunu döndürür.
GetEnumerator()	Bu düğümün alt düğümleri üzerindeki her stil yinelemesi için destek sağlar.
GetShapeRenderer()	Bu şekli bir görüntüye dönüştürmek için kullanılabilecek bir nesne oluşturur ve döndürür.
override GetText()	Bu düğümün ve tüm alt düğümlerinin metnini alır.
IndexOf(Node)	Alt düğüm dizisindeki belirtilen alt düğümün dizinini döndürür.
InsertAfter<T>(T, Node)	Belirtilen düğümü belirtilen referans düğümünden hemen sonra ekler.
InsertBefore<T>(T, Node)	Belirtilen düğümü belirtilen referans düğümünden hemen önce ekler.
LocalToParent(PointF)	Yerel koordinat alanındaki bir değeri ana şeklin koordinat alanına dönüştürür.
NextPreOrder(Node)	Ön sipariş ağacı geçiş algoritmasına göre bir sonraki düğümü alır.
PrependChild<T>(T)	Belirtilen düğümü bu düğüm için alt düğümler listesinin başına ekler.
PreviousPreOrder(Node)	Ön sipariş ağacı geçiş algoritmasına göre önceki düğümü alır.
Remove()	Kendini ana öğeden kaldırır.
RemoveAllChildren()	Geçerli düğümün tüm alt düğümlerini kaldırır.
RemoveChild<T>(T)	Belirtilen alt düğümü kaldırır.
RemoveSmartTags()	Tümünü kaldırırSmartTag geçerli düğümün alt düğümleri.
SelectNodes(string)	XPath ifadesiyle eşleşen düğümlerin bir listesini seçer.
SelectSingleNode(string)	İlkini seçerNode XPath ifadesiyle eşleşen.
ToString(SaveFormat)	Düğümün içeriğini belirtilen biçimde bir dizeye aktarır.
ToString(SaveOptions)	Belirtilen kaydetme seçeneklerini kullanarak düğümün içeriğini bir dizeye aktarır.
UpdateSmartArtDrawing()	Aspose.Words’ün SmartArt soğuk işleme motorunu kullanarak SmartArt önceden işlenmiş çizimini günceller.

Notlar

KullanımıShape Microsoft Word belgesinde şekiller oluşturabilir veya değiştirebilirsiniz.

Bir şeklin önemli bir özelliği şudur:ShapeTypedifferent türündeki şekiller bir Word belgesinde farklı yeteneklere sahip olabilir. Örneğin, yalnızca image ve OLE shapes içinde resim barındırabilir. Şekillerin çoğu metin barındırabilir, ancak hepsi barındıramaz.

Metne sahip olabilen, içerebilen şekillerParagraph ve Table Çocuklar olarak düğümler.

Örnekler

Sayfanın ortasına kayan bir resmin nasıl ekleneceğini gösterir.

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

// Üst üste gelen metnin arkasında görünecek yüzen bir resim ekleyin ve onu sayfanın ortasına hizalayın.
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");

Bir belgeden resimlerin nasıl çıkarılacağını ve bunların yerel dosya sistemine ayrı dosyalar olarak nasıl kaydedileceğini gösterir.

Document doc = new Document(MyDir + "Images.docx");

// Şekil koleksiyonunu belgeden al,
// ve her şeklin görüntü verisini, görüntü içeren bir dosya olarak yerel dosya sistemine kaydeder.
NodeCollection shapes = doc.GetChildNodes(NodeType.Shape, true);

Assert.AreEqual(9, shapes.Count(s => ((Shape)s).HasImage));

int imageIndex = 0;
foreach (Shape shape in shapes.OfType<Shape>())
{
    if (shape.HasImage)
    {
         // Şekillerin görüntü verileri birçok olası görüntü formatındaki görüntüleri içerebilir.
        // Her bir resim için, formatına bağlı olarak otomatik olarak bir dosya uzantısı belirleyebiliriz.
        string imageFileName =
            $"File.ExtractImages.{imageIndex}{FileFormatUtil.ImageTypeToExtension(shape.ImageData.ImageType)}";
        shape.ImageData.Save(ArtifactsDir + imageFileName);
        imageIndex++;
    }
}

Bir belgeden tüm şekillerin nasıl silineceğini gösterir.

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

// İçerisinde başka bir şekil bulunan bir grup şekliyle birlikte iki şekil ekle.
builder.InsertShape(ShapeType.Rectangle, 400, 200);
builder.InsertShape(ShapeType.Star, 300, 300);

GroupShape group = new GroupShape(doc);
group.Bounds = new RectangleF(100, 50, 200, 100);
group.CoordOrigin = new Point(-1000, -500);

Shape subShape = new Shape(doc, ShapeType.Cube);
subShape.Width = 500;
subShape.Height = 700;
subShape.Left = 0;
subShape.Top = 0;

group.AppendChild(subShape);
builder.InsertNode(group);

Assert.AreEqual(3, doc.GetChildNodes(NodeType.Shape, true).Count);
Assert.AreEqual(1, doc.GetChildNodes(NodeType.GroupShape, true).Count);

// Belgeden tüm Şekil düğümlerini kaldır.
NodeCollection shapes = doc.GetChildNodes(NodeType.Shape, true);
shapes.Clear();

// Tüm şekiller gitti, ancak grup şekli hala belgede.
Assert.AreEqual(1, doc.GetChildNodes(NodeType.GroupShape, true).Count);
Assert.AreEqual(0, doc.GetChildNodes(NodeType.Shape, true).Count);

// Tüm grup şekillerini ayrı ayrı kaldır.
NodeCollection groupShapes = doc.GetChildNodes(NodeType.GroupShape, true);
groupShapes.Clear();

Assert.AreEqual(0, doc.GetChildNodes(NodeType.GroupShape, true).Count);
Assert.AreEqual(0, doc.GetChildNodes(NodeType.Shape, true).Count);

Ayrıca bakınız

• class ShapeBase
• ad alanı Aspose.Words.Drawing
• toplantı Aspose.Words