Comment

Comment class

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

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Yorumlarla Çalışma belgeleme makalesi.

public sealed class Comment : InlineStory

yapıcılar

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

Özellikleri

İsimTanım
Ancestor { get; }Üst öğeyi döndürürCommentnesne. Geri dönerhükümsüz en ü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 hemen alt düğümlerinin 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.
DateTimeUtc { get; }Yorumun yapıldığı UTC tarih ve saatini alır.
virtual Document { get; }Bu düğümün ait olduğu belgeyi alır.
Done { get; set; }Yorumun yapıldığına işaret edildiğ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 biçimlendirmesine erişim sağlar.
HasChildNodes { get; }Geri Döndürürdoğru eğer bu düğümün herhangi bir alt düğümü varsa.
Id { get; set; }Yorum tanımlayıcısını alır veya ayarlar.
Initial { get; set; }Belirli bir yorumla ilişkili kullanıcının baş harflerini döndürür veya ayarlar.
override IsComposite { get; }Geri Döndürürdoğru çünkü bu düğümün alt düğümleri olabilir.
IsDeleteRevision { get; }Değişiklik izleme etkinleştirilmişken bu nesnenin Microsoft Word’de silinmesi durumunda doğru değerini döndürür.
IsInsertRevision { get; }Bu nesnenin Microsoft Word’e değişiklik izleme etkinleştirilmişken eklenip eklenmediğini döndürür.
IsMoveFromRevision { get; }Geri Döndürürdoğru bu nesne Microsoft Word’de değişiklik izleme etkinleştirilmişken taşınırsa (silinirse).
IsMoveToRevision { get; }Geri Döndürürdoğru bu nesne Microsoft Word’de değişiklik izleme etkinleştirilmişken taşınırsa (eklenirse).
LastChild { get; }Düğümün son çocuğunu alır.
LastParagraph { get; }Hikayedeki son paragrafı alır.
NextSibling { get; }Bu düğümü hemen takip eden düğümü alır.
override NodeType { get; }Geri DöndürürComment .
Paragraphs { get; }Hikayenin doğrudan alt öğeleri olan paragrafların bir koleksiyonunu alır.
ParentId { get; set; }Üst yorum kimliğini alır veya ayarlar. Bir değer-1 yorumun ebeveyni olmadığı anlamına gelir.
ParentNode { get; }Bu düğümün en yakın üst düğümünü 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; }BirRangebu düğümde bulunan bir belgenin bölümünü temsil eden nesne.
Replies { get; }Bir koleksiyon döndürürComment belirtilen yorumun doğrudan çocukları olan nesneler.
override StoryType { get; }Geri DöndürürComments .
Tables { get; }Hikayenin doğrudan alt öğeleri olan tabloların bir koleksiyonunu alır.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Bir ziyaretçiyi kabul eder.
override AcceptEnd(DocumentVisitor)Yorumun sonunu ziyaret eden bir ziyaretçiyi kabul eder.
override AcceptStart(DocumentVisitor)Yorumun başlangıcını ziyaret eden bir ziyaretçiyi kabul eder.
AddReply(string, string, DateTime, string)Bu yoruma bir yanıt ekler.
AppendChild<T>(T)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üğümleri gezmek ve okumak için kullanılabilen gezgini oluşturur.
EnsureMinimum()Son çocuk bir paragraf değilse, boş bir paragraf oluşturur ve ekler.
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.
RemoveAllReplies()Bu yoruma gelen tüm yanıtları kaldırır.
RemoveChild<T>(T)Belirtilen alt düğümü kaldırır.
RemoveReply(Comment)Bu yoruma verilen belirtilen yanıtı kaldırır.
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.
SetText(string)Bu, yorumun metnini kolayca ayarlamanıza olanak tanıyan kullanışlı bir yöntemdir.
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

Yorum, metnin bir bölgesine veya metindeki bir konuma sabitlenmiş bir açıklamadır. Yorum, blok düzeyinde keyfi miktarda içerik barındırabilir.

Eğer birComment nesne kendi başına meydana geldiğinde, yorum, nesnenin konumuna sabitlenir.Comment nesne.

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

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

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

Örnekler

Bir paragrafa yorum eklemenin nasıl yapılacağını 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, bu yorumu belge gövdesinde sağ tıklayarak düzenleyebilir veya yanıtlayabiliriz.
doc.Save(ArtifactsDir + "InlineStory.AddComment.docx");

Bir belgeye nasıl yorum ekleneceğini ve ardından buna 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ın bulunduğu yerde gösterilecektir.
// Sayfanın sağ kenar boşluğunun dışında ve paragrafına noktalı bir çizgiyle bağlanıyor.
builder.CurrentParagraph.AppendChild(comment);

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

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

// Diğer yorumlara yanıt vermeyen yorumlar "en üst düzey"dir. Bunların ata yorumları yoktur.
Assert.Null(comment.Ancestor);

// Cevapların üst düzey bir yorumu vardır.
Assert.AreEqual(comment, comment.Replies[0].Ancestor);

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

Ayrıca bakınız