StructuredDocumentTag

StructuredDocumentTag class

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

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Yapılandırılmış Belge Etiketleri veya İçerik Kontrolü dokümantasyon makalesi.

public class StructuredDocumentTag : CompositeNode, IStructuredDocumentTag

yapıcılar

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

Ö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şının kategorisini belirtirSDT node. Olamazhükümsüz .
BuildingBlockGallery { get; set; }	Bunun için yapı taşının türünü belirtirSDT . Olamazhükümsüz .
CalendarType { get; set; }	Bunun için takvim türünü belirtirSDT . Varsayılan:Default
Checked { get; set; }	Onay Kutusunun geçerli durumunu alır/ayarlarSDT . Bu özelliğin varsayılan değeri:YANLIŞ .
Color { get; set; }	Yapılandırılmış belge etiketinin rengini alır veya ayarlar.
ContentsFont { get; }	Girilen metne uygulanacak yazı tipi formatıSDT .
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.
DateDisplayFormat { get; set; }	Tarihlerin görüntülendiği biçimi temsil eden dize. Yapılamazhükümsüz . İngilizce (ABD) için tarihler “aa/gg/yyyy"dir
DateDisplayLocale { get; set; }	Burada görüntülenen tarih için dil biçimini ayarlamanıza/almanıza olanak tanır.SDT .
DateStorageFormat { get; set; }	SDT’nin saklandığı tarih için tarihin biçimini alır/ayarlar.SDTbelgenin veri deposundaki bir XML düğümüne bağlanır. Varsayılan değer:DateTime
virtual Document { get; }	Bu düğümün ait olduğu belgeyi alır.
EndCharacterFont { get; }	Girilen metnin son karakterine uygulanacak yazı tipi formatıSDT .
FirstChild { get; }	Düğümün ilk çocuğunu alır.
FullDate { get; set; }	Buna en son girilen tam tarih ve saati belirtirSDT .
HasChildNodes { get; }	İadelerdoğru bu düğümün herhangi bir alt düğümü varsa.
Id { get; }	Bunun için benzersiz bir salt okunur kalıcı sayısal kimlik belirtirSDT.
override IsComposite { get; }	İadelerdoğru çünkü bu düğüm alt düğümlere sahip olabilir.
IsShowingPlaceholderText { get; set; }	Bunun içeriğinin olup olmadığını belirtir.SDTyer tutucu text ‘yi (SDT içindeki normal metin içeriklerinin aksine) içerecek şekilde yorumlanacaktır.
IsTemporary { get; set; }	Bunun olup olmadığını belirtirSDT içeriği değiştirildiğinde WordProcessingML belgesinden kaldırılacaktır.
LastChild { get; }	Düğümün son çocuğunu alır.
Level { get; }	Bunun hangi düzeyde olduğunu alırSDT belge ağacında oluşur.
ListItems { get; }	AlırSdtListItemCollection bununla ilişkiliSDT .
LockContentControl { get; set; }	Olarak ayarlandığındadoğru , bu özellik kullanıcının bunu silmesini yasaklayacakSDT .
LockContents { get; set; }	Olarak ayarlandığındadoğru , bu özellik kullanıcının bu içeriği düzenlemesini yasaklarSDT .
Multiline { get; set; }	Bunun olup olmadığını belirtirSDT birden fazla metin satırına izin verir.
NextSibling { get; }	Bu düğümden hemen sonra gelen düğümü alır.
override NodeType { get; }	İadelerStructuredDocumentTag .
ParentNode { get; }	Bu düğümün doğrudan ebeveynini alır.
Placeholder { get; }	AlırBuildingBlockBu SDT çalıştırma içerikleri boş olduğunda görüntülenmesi gereken yer tutucu metni içeren, ilişkili eşlenen XML öğesi,XmlMapping element veyaIsShowingPlaceholderText elemandoğru .
PlaceholderName { get; set; }	Adını alır veya ayarlarBuildingBlock yer tutucu metni içerir.
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.
SdtType { get; }	Bunun türünü alırYapı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. Yapılamazhükümsüz .
Title { get; set; }	Bununla ilişkili kolay adı belirtirSDT . Olamazhükümsüz .
WordOpenXML { get; }	Düğümdeki düğümün içerdiği XML’i temsil eden bir dize alır.FlatOpc format.
WordOpenXMLMinimal { get; }	Düğümdeki düğümün içerdiği XML’i temsil eden bir dize alır.FlatOpc format. Şunun aksineWordOpenXMLözelliğinden yararlanarak, bu yöntem, içerikle ilgili olmayan bölümleri hariç tutan sadeleştirilmiş bir belge oluşturur.
XmlMapping { get; }	Bu yapılandırılmış belge etiketinin, geçerli belgenin özel bir XML bölümündeki XML data ile eşlenmesini temsil eden bir nesne alır.

yöntemler

İsim	Tanım
override Accept(DocumentVisitor)	Ziyaretçi 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()	Düğümlerin arasında geçiş yapmak ve düğümleri okumak için kullanılabilecek gezgini oluşturur.
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.
GetEnumerator()	Bu düğümün alt düğümleri üzerindeki 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 dizisinde belirtilen alt düğümün dizinini döndürür.
InsertAfter(Node, Node)	Belirtilen düğümü, belirtilen referans düğümünün hemen sonrasına ekler.
InsertBefore(Node, Node)	Belirtilen düğümü, belirtilen referans düğümünün hemen öncesine 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ğ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.
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ı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.
SetCheckedSymbol(int, string)	Onay kutusu içerik denetiminin işaretli durumunu temsil etmek için kullanılan sembolü ayarlar.
SetUncheckedSymbol(int, string)	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 formatta 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 its davranışını ve görünümünü bir belgeye yerleştirmeye olanak tanır.

Bu sürümde Aspose.Words, davranışını ve içeriğini 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, kullanılarak gerçekleştirilebilir.XmlMapping mülk.

StructuredDocumentTag bir belgede aşağıdaki yerlerde bulunabilir:

• Blok düzeyinde - Paragraflar ve tablolar arasında, bir çocuğun çocuğu olarakBody ,HeaderFooter , Comment ,Footnote veya birShape düğüm.
• Satır düzeyi - Bir tablodaki satırlar arasında, bir öğenin alt öğesi olarakTable düğüm.
• Hücre düzeyi - Bir tablo satırındaki hücreler arasında, bir alt öğe olarakRow düğüm.
• Satır içi düzey - Bir çocuğun çocuğu olarak içerideki satır içi içerik arasındaParagraph.
• Başka birinin içine yerleştirilmişStructuredDocumentTag.

Örnekler

İçerik kontrol öğelerine ilişkin stillerle nasıl çalışılacağını gösterir.

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

// Aşağıda belgeden yapılandırılmış belge etiketine 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 referans verin:
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;

    Console.WriteLine(sdt.WordOpenXMLMinimal);

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

Ayrıca bakınız

• class CompositeNode
• interface IStructuredDocumentTag
• ad alanı Aspose.Words.Markup
• toplantı Aspose.Words