GroupShape

GroupShape class

Bir belgedeki şekil grubunu temsil eder.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Word Belgesine Grup Şekli Nasıl Eklenir dokümantasyon makalesi.

public class GroupShape : ShapeBase

yapıcılar

İsimTanım
GroupShape(DocumentBase)Yeni bir grup şekli oluşturur.

Özellikleri

İsimTanım
AllowOverlap { get; set; }Bu şeklin diğer şekillerle örtüşüp çakışmayacağını 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 olacağını belirtir.
Bottom { get; }Şeklin taşıyıcı bloğunun alt kenarının konumunu alır.
Bounds { get; set; }Şeklin bulunduğu bloğun konumunu ve boyutunu alır veya ayarlar.
BoundsInPoints { get; }En üstteki şeklin bağlantısına göre, şeklin içerdiği blokun konumunu ve boyutunu noktalar cinsinden alır.
BoundsWithEffects { get; }Çizim efektleri uygulandıktan sonra bu şekil nesnesinin sahip olduğu son boyutu alır. Değer, nokta cinsinden ölçülür.
CanHaveImage { get; }İadelerdoğru şekil türü, şeklin bir resme sahip olmasına izin veriyorsa.
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 doğrudan alt öğelerinin 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.
Fill { get; }Şeklin dolgu formatını alır.
FirstChild { get; }Düğümün ilk çocuğunu alır.
FlipOrientation { get; set; }Şeklin yönünü değiştirir.
Font { get; }Bu nesnenin yazı tipi formatlamasına erişim sağlar.
HasChildNodes { get; }İadelerdoğru bu düğümün herhangi bir alt düğümü varsa.
Height { get; set; }Şeklin bulunduğu bloğun yüksekliğini alır veya ayarlar.
HeightRelative { get; set; }Şeklin göreceli yüksekliğinin yüzdesini temsil eden değeri alır veya ayarlar.
HorizontalAlignment { get; set; }Şeklin yatay olarak nasıl konumlandırılacağını belirtir.
HRef { get; set; }Bir şeklin tam köprü adresini alır veya ayarlar.
override IsComposite { get; }İadelerdoğru çünkü bu düğüm alt düğümlere sahip olabilir.
IsDecorative { get; set; }Belgedeki şeklin dekoratif olup olmadığını belirten bayrağı alır veya ayarlar.
IsDeleteRevision { get; }Değişiklik izleme etkinken bu nesne Microsoft Word’de silinmişse true değerini döndürür.
IsGroup { get; }İadelerdoğru eğer bu bir grup şekli ise.
IsHorizontalRule { get; }İadelerdoğru eğer bu şekil yatay bir kural ise.
IsImage { get; }İadelerdoğru bu şekil bir resim şekli ise.
IsInline { get; }Bu şeklin metinle satır içi olarak konumlandırılıp konumlandırılmadığını belirlemenin hızlı bir yolu.
IsInsertRevision { get; }Bu nesne Microsoft Word’e değişiklik izleme etkinken eklenmişse doğru değerini döndürür.
IsLayoutInCell { get; set; }Şeklin tablonun içinde mi yoksa dışında mı görüntüleneceğini belirten bir bayrak alır veya ayarlar.
IsMoveFromRevision { get; }İadelerdoğru değişiklik izleme etkinken bu nesne Microsoft Word’de taşındıysa (silindiyse).
IsMoveToRevision { get; }İadelerdoğru bu nesne Microsoft Word’de değişiklik izleme etkinken taşınmışsa (eklenmişse).
IsSignatureLine { get; }Şeklin bir olduğunu belirtirSignatureLine .
IsTopLevel { get; }İadelerdoğrubu şekil bir grup şeklinin alt öğesi değilse.
IsWordArt { get; }İadelerdoğru bu şekil bir WordArt nesnesiyse.
LastChild { get; }Düğümün son çocuğunu alır.
Left { get; set; }Şeklin içeren bloğunun sol kenarının konumunu alır veya ayarlar.
LeftRelative { get; set; }Şeklin göreceli sol konumunu yüzde cinsinden temsil eden değeri alır veya ayarlar.
MarkupLanguage { get; }Bu grafik nesnesi için kullanılan MarkupLanguage’ı döndürür.
Name { get; set; }İsteğe bağlı şekil adını alır veya ayarlar.
NextSibling { get; }Bu düğümden hemen sonra gelen düğümü alır.
override NodeType { get; }İadelerGroupShape .
ParentNode { get; }Bu düğümün doğrudan ebeveynini alır.
ParentParagraph { get; }Doğrudan üst paragrafı döndürür.
PreviousSibling { get; }Bu düğümden hemen önceki düğümü alır.
Range { get; }Bir değeri döndürürRange Bu düğümde bulunan bir belgenin bölümünü temsil eden nesne.
RelativeHorizontalPosition { get; set; }Şeklin yatay olarak nasıl konumlandırılacağına göre belirtir.
RelativeHorizontalSize { get; set; }Şeklin göreceli boyutunun değerini yatay yönde alır veya ayarlar.
RelativeVerticalPosition { get; set; }Şeklin dikey olarak neye göre konumlandırıldığını belirtir.
RelativeVerticalSize { get; set; }Şeklin göreli boyutunun değerini dikey yönde alır veya ayarlar.
Right { get; }Şeklin içeren bloğunun sağ kenarının konumunu alır.
Rotation { get; set; }Şeklin döndürüldüğü açıyı (derece cinsinden) 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ülenecek metni tanımlar.
ShadowFormat { get; }Şeklin gölge formatını alır.
ShapeType { get; }Şekil türünü alır.
SizeInPoints { get; }Şeklin boyutunu nokta cinsinden alır.
Target { get; set; }Şekil köprüsü için hedef çerçeveyi alır veya ayarlar.
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 göreli üst konumunu yüzde cinsinden 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öreceli genişliğinin yüzdesini temsil eden değeri alır veya ayarlar.
WrapSide { get; set; }Metnin şeklin etrafına nasıl sarıldığını belirtir.
WrapType { get; set; }Şeklin satır içi mi yoksa kayan mı olduğunu tanımlar. Kayan şekiller için, şeklin etrafındaki metin için kaydırma modunu tanımlar.
ZOrder { get; set; }Çakışan şekillerin görüntülenme sırasını belirler.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Ziyaretçi kabul eder.
AdjustWithEffects(RectangleF)Efekt kapsamının kaynak dikdörtgen değerlerine eklenir ve son dikdörtgeni döndürür.
AppendChild(Node)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üğümlerin arasında geçiş yapmak ve düğümleri okumak için kullanılabilecek gezgini oluşturur.
FetchInheritedShapeAttr(int)Sistem kullanımı için ayrılmıştır. IShapeAttrSource.
FetchShapeAttr(int)Sistem kullanımı için ayrılmıştır. IShapeAttrSource.
GetAncestor(NodeType)Belirtilenin ilk atayı alırNodeType .
GetAncestor(Type)Belirtilen nesne türünün ilk atayı 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.
GetDirectShapeAttr(int)Sistem kullanımı için ayrılmıştır. IShapeAttrSource.
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 öğelerinin metnini alır.
IndexOf(Node)Alt düğüm dizisinde belirtilen alt düğümün dizinini döndürür.
InsertAfter(NodeNode)Belirtilen düğümü, belirtilen referans düğümünün hemen sonrasına ekler.
InsertBefore(NodeNode)Belirtilen düğümü, belirtilen referans düğümünün hemen öncesine ekler.
LocalToParent(PointF)Yerel koordinat alanından bir değeri üst şeklin koordinat alanına dönüştürür.
NextPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre sonraki düğümü alır.
PrependChild(Node)Belirtilen düğümü, bu düğüm için alt düğümler listesinin başına ekler.
PreviousPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre önceki düğümü alır.
Remove()Kendini üst öğeden kaldırır.
RemoveAllChildren()Geçerli düğümün tüm alt düğümlerini kaldırır.
RemoveChild(Node)Belirtilen alt düğümü kaldırır.
RemoveShapeAttr(int)Sistem kullanımı için ayrılmıştır. IShapeAttrSource.
RemoveSmartTags()Tümünü kaldırırSmartTagGeçerli düğümün alt düğümleri.
SelectNodes(string)XPath ifadesiyle eşleşen düğümlerin listesini seçer.
SelectSingleNode(string)İlkini seçerNode XPath ifadesiyle eşleşen.
SetShapeAttr(int, object)Sistem kullanımı için ayrılmıştır. IShapeAttrSource.
ToString(SaveFormat)Düğümün içeriğini belirtilen formatta bir dizeye aktarır.
ToString(SaveOptions)Belirtilen kaydetme seçeneklerini kullanarak düğümün içeriğini bir dizeye aktarır.

Notlar

AGroupShape bileşik bir düğümdür ve sahip olabilirShape ve GroupShape çocuklar gibi düğümler.

Her biriGroupShape alt şekilleri için yeni bir koordinat sistemi tanımlar. Koordinat sistemi,CoordSize ve CoordOrigin özellikler.

Örnekler

Bir şekil grubunun nasıl oluşturulacağını ve bir belge ziyaretçisi kullanılarak içeriğinin nasıl yazdırılacağını gösterir.

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

    // SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped gibi "Primitive Olmayan" şekiller oluşturmanız gerekiyorsa,
    // ÜstKöşelerBirYuvarlakBirKesilmiş, TekKöşeYuvarlak, ÜstKöşelerYuvarlak, ÇaprazKöşelerYuvarlak
    // lütfen DocumentBuilder.InsertShape yöntemlerini kullanın.
    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>
/// Ziyaret edilen şekil grubunun içeriğini konsola yazdırır.
/// </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;
}

Ayrıca bakınız