StructuredDocumentTag

StructuredDocumentTag class

Bir belgedeki yapılandırılmış bir belge etiketini (SDT veya içerik denetimi) temsil eder.

public class StructuredDocumentTag : CompositeNode, IStructuredDocumentTag

yapıcılar

İsim Tanım
StructuredDocumentTag(DocumentBase, SdtType, MarkupLevel) Yeni bir örneğini başlatır Yapılandırılmış belge etiketi sınıf.

Özellikleri

İsim Tanım
Appearance { get; set; } Yapılandırılmış bir belge etiketinin görünümünü alır/ayarlar.
BuildingBlockCategory { get; set; } Bunun için yapı taşı kategorisini belirtir SDT node. null olamaz.
BuildingBlockGallery { get; set; } Bunun için yapı taşı türünü belirtir SDT . Boş olamaz.
CalendarType { get; set; } Bunun için takvim türünü belirtir SDT . VarsayılanDefault
Checked { get; set; } Onay Kutusunun geçerli durumunu alır/ayarlar SDT . Bu özellik için varsayılan değer false’tur.
ChildNodes { get; } Bu düğümün tüm acil alt düğümlerini alır.
Color { get; set; } Yapılandırılmış belge etiketinin rengini alır veya ayarlar.
ContentsFont { get; } Girilen metne uygulanacak yazı tipi biçimlendirmesi SDT .
Count { get; } Bu düğümün acil alt öğelerinin sayısını alır.
CustomNodeId { get; set; } Özel düğüm tanımlayıcısını belirtir.
DateDisplayFormat { get; set; } Tarihlerin görüntülendiği biçimi temsil eden dize. Boş olamaz. İngilizce (ABD) için tarihler “aa/gg/yyyy” şeklindedir.
DateDisplayLocale { get; set; } Burada görüntülenen tarih için dil biçimini ayarlamaya/almaya izin verir. SDT .
DateStorageFormat { get; set; } Bir tarih SDT’sinin saklandığı tarihin biçimini alır/ayarlar. SDT belgenin veri deposundaki bir XML düğümüne bağlıdır. Varsayılan değerDateTime
virtual Document { get; } Bu düğümün ait olduğu belgeyi alır.
EndCharacterFont { get; } Girilen metnin son karakterine uygulanacak yazı tipi biçimlendirmesi SDT .
FirstChild { get; } Düğümün ilk alt öğesini alır.
FullDate { get; set; } Buna en son girilen tam tarih ve saati belirtir SDT .
HasChildNodes { get; } Bu düğümün herhangi bir alt düğümü varsa doğru döndürür.
Id { get; } Bunun için benzersiz bir salt okunur kalıcı sayısal kimlik belirtir SDT.
override IsComposite { get; } Bu düğümün alt düğümleri olabileceğinden true değerini döndürür.
IsShowingPlaceholderText { get; set; } Bunun içeriğinin olup olmadığını belirtir. SDT yer tutucu text içerecek şekilde yorumlanmalıdır (SDT içindeki normal metin içeriklerinin aksine).
IsTemporary { get; set; } Bunun olup olmadığını belirtir SDT content değiştirildiğinde WordProcessingML belgesinden kaldırılacaktır.
LastChild { get; } Düğümün son alt öğesini alır.
Level { get; } Bunun hangi düzeyde olduğunu alır SDT belge ağacında gerçekleşir.
ListItems { get; } AlırSdtListItemCollection bununla ilişkili SDT .
LockContentControl { get; set; } true olarak ayarlandığında, bu özellik bir kullanıcının bunu silmesini engeller. SDT .
LockContents { get; set; } true olarak ayarlandığında, bu özellik bir kullanıcının bunun içeriğini düzenlemesini engeller. SDT .
Multiline { get; set; } Bunun olup olmadığını belirtir SDT birden çok metin satırına izin verir.
NextSibling { get; } Bu düğümden hemen sonraki düğümü alır.
override NodeType { get; } İade NodeType.StructuredDocumentTag .
ParentNode { get; } Bu düğümün hemen üst öğesini alır.
Placeholder { get; } BuildingBlock bu SDT çalıştırma içeriği boş olduğunda görüntülenmesi gereken yer tutucu metni içeren, ilişkili eşlenen XML öğesi,XmlMapping element veyaIsShowingPlaceholderText eleman doğrudur.
PlaceholderName { get; set; } Adını alır veya ayarlarBuildingBlock yer tutucu metni içeren.
PreviousSibling { get; } Bu düğümden hemen önceki düğümü alır.
Range { get; } Bir döndürür Menzil belgenin bu düğümde bulunan bölümünü temsil eden nesne.
SdtType { get; } Bunun türünü alır Yapılandırılmış belge etiketi .
Style { get; set; } Yapılandırılmış belge etiketinin Stilini alır veya ayarlar.
StyleName { get; set; } Yapılandırılmış belge etiketine uygulanan stilin adını alır veya ayarlar.
Tag { get; set; } Geçerli SDT düğümüyle ilişkili bir etiketi belirtir. Boş olamaz.
Title { get; set; } Bununla ilişkili kolay adı belirtir SDT . Boş olamaz.
WordOpenXML { get; } Dizindeki düğümde bulunan XML’i temsil eden bir dize alır.FlatOpc biçim.
XmlMapping { get; } Bu yapılandırılmış belge etiketinin geçerli belgenin özel bir XML bölümünde XML data ile eşlenmesini temsil eden bir nesne alır.

yöntemler

İsim Tanım
override Accept(DocumentVisitor) Bir ziyaretçiyi kabul eder.
AppendChild(Node) Belirtilen düğümü, bu düğüm için alt düğümler listesinin sonuna ekler.
Clear() Bu yapılandırılmış belge etiketinin içeriğini temizler ve tanımlanmışsa bir yer tutucu görüntüler.
Clone(bool) Düğümün bir kopyasını oluşturur.
CreateNavigator() Sistem kullanımı için ayrılmıştır. IXPathNavigable.
GetAncestor(NodeType) Belirtilenin ilk atasını alırNodeType .
GetAncestor(Type) Belirtilen nesne türünün ilk üst öğesini alır.
GetChild(NodeType, int, bool) Belirtilen türle eşleşen N. alt düğümü döndürür.
GetChildNodes(NodeType, bool) Belirtilen türle eşleşen canlı bir alt düğüm koleksiyonu döndürür.
GetEnumerator() Bu düğümün alt düğümleri üzerinde her stil yinelemesi için destek sağlar.
override GetText() Bu düğümün ve tüm alt öğelerinin metnini alır.
IndexOf(Node) Alt düğüm dizisindeki belirtilen alt düğümün dizinini döndürür.
InsertAfter(Node, Node) Belirtilen referans düğümünden hemen sonra belirtilen düğümü ekler.
InsertBefore(Node, Node) Belirtilen düğümü, belirtilen referans düğümünden hemen önce ekler.
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ğacı 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.
RemoveSelfOnly() Yalnızca bu SDT düğümünün kendisini kaldırır, ancak içeriğini belge ağacının içinde tutar.
RemoveSmartTags() Tümünü kaldırırSmartTag geçerli düğümün alt düğümleri.
SelectNodes(string) XPath ifadesiyle eşleşen düğümlerin listesini seçer.
SelectSingleNode(string) XPath ifadesiyle eşleşen ilk Düğümü seçer.
SetCheckedSymbol(int, string) Bir onay kutusu içerik denetiminin işaretli durumunu temsil etmek için kullanılan sembolü ayarlar.
SetUncheckedSymbol(int, string) Bir onay kutusu içerik denetiminin işaretlenmemiş durumunu temsil etmek için kullanılan sembolü ayarlar.
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.

Notlar

Yapılandırılmış belge etiketleri (SDT’ler), müşteri tanımlı semantiğin yanı sıra davranışını ve görünümünü bir belgeye yerleştirmeye izin verir.

Bu sürümde Aspose.Words, davranış ve içeriği değiştirmek için bir dizi genel yöntem ve özellik sağlar.StructuredDocumentTag . SDT düğümlerinin bir belge içindeki özel XML paketleriyle eşlenmesi, XmlMapping Emlak.

StructuredDocumentTag bir belgede aşağıdaki yerlerde ortaya çıkabilir:

  • Blok düzeyi - Paragraflar ve tablolar arasında, birBody ,HeaderFooter , Comment ,Footnote veya birShape düğüm.
  • Row-level - Bir tablonun alt öğesi olarak bir tablodaki satırlar arasındaTable düğüm.
  • Hücre düzeyi - Bir tablo satırındaki hücreler arasında, birRow düğüm.
  • Satır içi düzey - İçerideki satır içi içerik arasında, bir çocuğun çocuğu olarakParagraph.
  • Bir başkasının içine yuvalanmışStructuredDocumentTag.

Örnekler

İçerik kontrol öğeleri için stiller ile nasıl çalışılacağını gösterir.

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

// Aşağıda, belgeden yapılandırılmış bir belge etiketine bir stil uygulamanın iki yolu verilmiştir.
// 1 - Belgenin stil koleksiyonundan bir stil nesnesi uygulayın:
Style quoteStyle = doc.Styles[StyleIdentifier.Quote];
StructuredDocumentTag sdtPlainText =
    new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Inline) { Style = quoteStyle };

// 2 - Belgedeki bir stile ada göre başvuru yapın:
StructuredDocumentTag sdtRichText =
    new StructuredDocumentTag(doc, SdtType.RichText, MarkupLevel.Inline) { StyleName = "Quote" };

builder.InsertNode(sdtPlainText);
builder.InsertNode(sdtRichText);

Assert.AreEqual(NodeType.StructuredDocumentTag, sdtPlainText.NodeType);

NodeCollection tags = doc.GetChildNodes(NodeType.StructuredDocumentTag, true);

foreach (Node node in tags)
{
    StructuredDocumentTag sdt = (StructuredDocumentTag)node;

    Assert.AreEqual(StyleIdentifier.Quote, sdt.Style.StyleIdentifier);
    Assert.AreEqual("Quote", sdt.StyleName);
}

Ayrıca bakınız