Comment

Comment class

Yorum metni için bir kapsayıcıyı temsil eder.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Yorumlarla Çalışmak dokümantasyon makalesi.

public sealed class Comment : InlineStory

yapıcılar

İsimTanım
Comment(DocumentBase)Yeni bir örneğini başlatırComment class.
Comment(DocumentBase, string, string, DateTime)Yeni bir örneğini başlatırComment class.

Özellikleri

İsimTanım
Ancestor { get; }Üst öğeyi döndürürComment nesne. İadelerhükümsüz üst düzey yorumlar için.
Author { get; set; }Bir yorumun yazar adını döndürür veya ayarlar.
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.
DateTime { get; set; }Yorumun yapıldığı tarih ve saati alır.
virtual Document { get; }Bu düğümün ait olduğu belgeyi alır.
Done { get; set; }Yorumun tamamlandı olarak işaretlendiğini belirten bayrağı alır veya ayarlar.
FirstChild { get; }Düğümün ilk çocuğunu alır.
FirstParagraph { get; }Hikayedeki ilk paragrafı alır.
Font { get; }Bu nesnenin bağlantı karakterinin yazı tipi formatlamasına erişim sağlar.
HasChildNodes { get; }İadelerdoğru bu düğümün herhangi bir alt düğümü varsa.
Id { get; }Yorum tanımlayıcısını alır.
Initial { get; set; }Belirli bir yorumla ilişkili kullanıcının baş harflerini döndürür veya ayarlar.
override IsComposite { get; }İadelerdoğru çünkü bu düğüm alt düğümlere sahip olabilir.
IsDeleteRevision { get; }Değişiklik izleme etkinken bu nesne Microsoft Word’de silinmişse true değerini döndürür.
IsInsertRevision { get; }Bu nesne Microsoft Word’e değişiklik izleme etkinken eklenmişse doğru değerini döndürür.
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).
LastChild { get; }Düğümün son çocuğunu alır.
LastParagraph { get; }Hikayedeki son paragrafı alır.
NextSibling { get; }Bu düğümden hemen sonra gelen düğümü alır.
override NodeType { get; }İadelerComment .
Paragraphs { get; }Hikayenin doğrudan alt öğeleri olan paragrafların bir koleksiyonunu alır.
ParentNode { get; }Bu düğümün doğrudan ebeveynini alır.
ParentParagraph { get; }Üst öğeyi alırParagraph bu düğümün.
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.
Replies { get; }Şunların bir koleksiyonunu döndürür:Comment belirtilen yorumun doğrudan alt öğeleri olan nesneler.
override StoryType { get; }İadelerComments .
Tables { get; }Hikayenin doğrudan alt öğeleri olan tabloların bir koleksiyonunu alır.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Ziyaretçi kabul eder.
AddReply(string, string, DateTime, string)Bu yoruma bir yanıt ekler.
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.
EnsureMinimum()Son alt öğe bir paragraf değilse, boş bir paragraf oluşturur ve ekler.
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.
RemoveAllReplies()Bu yoruma verilen tüm yanıtları kaldırır.
RemoveChild(Node)Belirtilen alt düğümü kaldırır.
RemoveReply(Comment)Bu yoruma verilen belirtilen yanıtı kaldırır.
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.
SetText(string)Bu, yorum metnini kolayca ayarlamanıza olanak tanıyan kullanışlı bir yöntemdir.
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

Yorum, metnin bir bölgesine veya metindeki bir konuma sabitlenen bir açıklamadır. Bir yorum, isteğe bağlı miktarda blok düzeyinde içerik içerebilir.

Eğer birComment nesne kendi başına oluştuğunda, yorum konumuna bağlanır.Comment nesne.

Bir yorumu metnin bir bölgesine bağlamak için üç nesne gereklidir:Comment , CommentRangeStart VeCommentRangeEnd . Her üç nesnenin de aynı öğesini paylaşması gerekirId değer.

Comment satır içi düzeyde bir düğümdür ve yalnızca alt öğesi olabilirParagraph.

Comment içerebilirParagraph VeTable çocuk düğümleri.

Örnekler

Bir paragrafa nasıl yorum ekleneceğini gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Hello world!");

Comment comment = new Comment(doc, "John Doe", "JD", DateTime.Today);
builder.CurrentParagraph.AppendChild(comment);
builder.MoveTo(comment.AppendChild(new Paragraph(doc)));
builder.Write("Comment text.");

Assert.AreEqual(DateTime.Today, comment.DateTime);

 // Microsoft Word'de, belge gövdesindeki bu yoruma sağ tıklayarak onu düzenleyebilir veya yanıtlayabiliriz.
doc.Save(ArtifactsDir + "InlineStory.AddComment.docx");

Bir belgeye nasıl yorum ekleneceğini ve ardından ona nasıl yanıt verileceğini gösterir.

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

Comment comment = new Comment(doc, "John Doe", "J.D.", DateTime.Now);
comment.SetText("My comment.");

// Yorumu belgenin gövdesindeki bir düğüme yerleştirin.
// Bu yorum paragrafın bulunduğu yerde görünecek,
// sayfanın sağ kenar boşluğunun dışında ve onu paragrafına bağlayan noktalı bir çizgiyle.
builder.CurrentParagraph.AppendChild(comment);

// Ana yorumun altında görünecek bir yanıt ekleyin.
comment.AddReply("Joe Bloggs", "J.B.", DateTime.Now, "New reply");

// Yorumlar ve yanıtların her ikisi de Yorum düğümleridir.
Assert.AreEqual(2, doc.GetChildNodes(NodeType.Comment, true).Count);

// Diğer yorumlara cevap vermeyen yorumlar "üst seviye"dir. Ata yorumlarına sahip değiller.
Assert.Null(comment.Ancestor);

// Yanıtların üst düzey bir yorumu var.
Assert.AreEqual(comment, comment.Replies[0].Ancestor);

doc.Save(ArtifactsDir + "Comment.AddCommentWithReply.docx");

Ayrıca bakınız

ComHelper Class CommentCollection Class