StructuredDocumentTag

StructuredDocumentTag class

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

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Yapılandırılmış Belge Etiketleri veya İçerik Denetimi belgeleme 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 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; }	Bu yapı bloğunun kategorisini belirtirSDT node. olamazhükümsüz .
BuildingBlockGallery { get; set; }	Bu yapı bloğunun türünü belirtirSDT . olamazhükümsüz .
CalendarType { get; set; }	Bu takvimin türünü belirtirSDT . VarsayılanDefault
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 biçimlendirmesiSDT .
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.
DateDisplayFormat { get; set; }	Tarihlerin görüntülendiği biçimi temsil eden dize.
DateDisplayLocale { get; set; }	Bu ekranda görüntülenen tarih için dil biçimini ayarlamayı/almayı sağlar.SDT .
DateStorageFormat { get; set; }	Bir tarih SDT’sinin saklandığı tarihin biçimini alır/ayarlarSDT 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çimlendirmesiSDT .
FirstChild { get; }	Düğümün ilk çocuğunu alır.
FullDate { get; set; }	Bu dosyaya en son girilen tam tarih ve saati belirtirSDT .
HasChildNodes { get; }	Geri Döndürürdoğru eğer bu düğümün herhangi bir alt düğümü varsa.
Id { get; }	Bunun için benzersiz, salt okunur, kalıcı bir sayısal Kimlik belirtirSDT.
override IsComposite { get; }	Geri Döndürürdoğru çünkü bu düğümün alt düğümleri olabilir.
IsShowingPlaceholderText { get; set; }	Bu içeriğin ne olduğunu belirtirSDT yer tutucu text (SDT içindeki normal metin içeriklerinin aksine) içerecek şekilde yorumlanacaktır.
IsTemporary { get; set; }	Bunun olup olmadığını belirtirSDT içerikleri değiştirildiğinde WordProcessingML belgesinden kaldırılacaktır.
LastChild { get; }	Düğümün son çocuğunu alır.
Level { get; }	Bu seviyeyi alırSDT belge ağacında meydana gelir.
ListItems { get; }	AlırSdtListItemCollection bununla ilişkiliSDT .
LockContentControl { get; set; }	olarak ayarlandığındadoğru , bu özellik bir kullanıcının bunu silmesini engelleyecektirSDT .
LockContents { get; set; }	olarak ayarlandığındadoğru , bu özellik bir kullanıcının bu içeriği düzenlemesini engelleyecektirSDT .
Multiline { get; set; }	Bunun olup olmadığını belirtirSDT birden fazla satır metne izin verir.
NextSibling { get; }	Bu düğümü hemen takip eden düğümü alır.
override NodeType { get; }	Geri DöndürürStructuredDocumentTag .
ParentNode { get; }	Bu düğümün en yakın üst düğümünü alır.
Placeholder { get; }	Şunu alır: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, belirtilen şekilde boşturXmlMapping element veyaIsShowingPlaceholderText elemandoğru .
PlaceholderName { get; set; }	Adını alır veya ayarlarBuildingBlock yer tutucu metin içeren.
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.
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. Şu şekilde olamaz:hükümsüz .
Title { get; set; }	Bu ile ilişkili dostça adı belirtirSDT . olamazhükümsüz .
WordOpenXML { get; }	Düğümün içinde bulunan XML’i temsil eden bir dize alırFlatOpc biçim.
WordOpenXMLMinimal { get; }	Düğümün içinde bulunan XML’i temsil eden bir dize alırFlatOpc format. Bunun aksineWordOpenXML özellik, bu yöntem içerikle ilgili olmayan parçaları hariç tutan soyulmuş 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 eşlemesini temsil eden bir nesne alır.

yöntemler

İsim	Tanım
override Accept(DocumentVisitor)	Bir ziyaretçiyi kabul eder.
override AcceptEnd(DocumentVisitor)	StructuredDocumentTag’ın sonunu ziyaret eden bir ziyaretçiyi kabul eder.
override AcceptStart(DocumentVisitor)	StructuredDocumentTag’in başlangıcını ziyaret eden bir ziyaretçiyi kabul eder.
AppendChild<T>(T)	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üğü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.
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.
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.
RemoveSelfOnly()	Yalnızca bu SDT düğümünü 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 bir listesini seçer.
SelectSingleNode(string)	İlkini seçerNode XPath ifadesiyle eşleşen.
SetCheckedSymbol(int, string)	Bir onay kutusu içerik denetiminin işaretli durumunu temsil etmek için kullanılan simgeyi ayarlar.
SetUncheckedSymbol(int, string)	Bir onay kutusu içerik denetiminin işaretlenmemiş durumunu temsil etmek için kullanılan simgeyi 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 tarafından tanımlanan 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ış ve içeriği manipüle etmek için bir dizi genel yöntem ve özellik sağlar.StructuredDocumentTag . SDT düğümlerinin bir belge içindeki özel XML paketlerine eşlenmesi, kullanılarak gerçekleştirilebilirXmlMapping mülk.

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

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

Örnekler

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

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

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

// 2 - Belgedeki bir stile adıyla başvuruda bulunun:
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