Paragraph

Paragraph class

Metnin bir paragrafını temsil eder.

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

public class Paragraph : CompositeNode

yapıcılar

İsimTanım
Paragraph(DocumentBase)Yeni bir örneğini başlatırParagraph class.

Özellikleri

İsimTanım
BreakIsStyleSeparator { get; }Bu paragraf sonu bir Stil Ayırıcı ise doğrudur. Stil ayırıcı, one paragrafının farklı paragraf stillerine sahip parçalardan oluşmasına olanak tanır.
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.
virtual Document { get; }Bu düğümün ait olduğu belgeyi alır.
FirstChild { get; }Düğümün ilk çocuğunu alır.
FrameFormat { get; }Çerçeve biçimlendirme özelliklerine erişim sağlar.
HasChildNodes { get; }İadelerdoğru bu düğümün herhangi bir alt düğümü varsa.
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.
IsEndOfCell { get; }Bu paragraf bir paragraftaki son paragrafsa doğrudurCell ; aksi halde yanlış.
IsEndOfDocument { get; }Bu paragraf belgenin son bölümünün son paragrafı ise doğrudur.
IsEndOfHeaderFooter { get; }Bu paragraf paragraftaki son paragrafsa doğruHeaderFooter (ana metin hikayesi) birSection ; aksi halde yanlış.
IsEndOfSection { get; }Bu paragraf paragraftaki son paragrafsa doğruBody (ana metin hikayesi) birSection ; aksi halde yanlış.
IsFormatRevision { get; }Microsoft Word’de değişiklik izleme etkinken nesnenin biçimlendirmesi değiştirilmişse doğru değerini döndürür.
IsInCell { get; }Bu paragrafın doğrudan alt öğesi ise doğrudurCell ; aksi halde yanlış.
IsInsertRevision { get; }Bu nesne Microsoft Word’e değişiklik izleme etkinken eklenmişse doğru değerini döndürür.
IsListItem { get; }Paragrafın orijinal revizyondaki madde işaretli veya numaralı listedeki bir öğe olması durumunda doğrudur.
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.
ListFormat { get; }Paragrafın liste biçimlendirme özelliklerine erişim sağlar.
ListLabel { get; }Bir alırListLabelbu paragraf için liste numaralandırma değerine ve formatlama ‘ye erişim sağlayan nesne.
NextSibling { get; }Bu düğümden hemen sonra gelen düğümü alır.
override NodeType { get; }İadelerParagraph .
ParagraphBreakFont { get; }Paragraf sonu karakterinin yazı tipi formatına erişim sağlar.
ParagraphFormat { get; }Paragraf biçimlendirme özelliklerine erişim sağlar.
ParentNode { get; }Bu düğümün doğrudan ebeveynini alır.
ParentSection { get; }Üst öğeyi alırSection paragrafın.
ParentStory { get; }Oluşturulabilecek ana bölüm düzeyindeki öyküyü alır.Body veyaHeaderFooter .
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.
Runs { get; }Paragrafın içinde yazılan metin parçaları koleksiyonuna erişim sağlar.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Ziyaretçi kabul eder.
AppendChild(Node)Belirtilen düğümü, bu düğüm için alt düğümler listesinin sonuna ekler.
AppendField(string)Bu paragrafa bir alan ekler.
AppendField(FieldType, bool)Bu paragrafa bir alan ekler.
AppendField(string, string)Bu paragrafa bir alan 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.
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.
GetEffectiveTabStops()Stiller veya listeler tarafından dolaylı olarak uygulananlar da dahil olmak üzere, bu paragrafa uygulanan tüm sekme duraklarının dizisini döndürür.
GetEnumerator()Bu düğümün alt düğümleri üzerindeki her stil yinelemesi için destek sağlar.
override GetText()Paragraf sonu karakteri de dahil olmak üzere bu paragrafın metnini alır.
IndexOf(Node)Alt düğüm dizisinde belirtilen alt düğümün dizinini döndürür.
InsertAfter(NodeNode)Belirtilen düğümü, belirtilen referans düğümünün hemen sonrasına ekler.
InsertBefore(NodeNode)Belirtilen düğümü, belirtilen referans düğümünün hemen öncesine ekler.
InsertField(string, Node, bool)Bu paragrafa bir alan ekler.
InsertField(FieldType, bool, Node, bool)Bu paragrafa bir alan ekler.
InsertField(string, string, Node, bool)Bu paragrafa bir alan ekler.
JoinRunsWithSameFormatting()Birleştirmeler paragrafta aynı biçimlendirmeyle çalışır.
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.
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.
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

Paragraph blok düzeyinde bir düğümdür ve from ‘den türetilen sınıfların çocuğu olabilirStory veyaInlineStory.

Paragraph herhangi bir sayıda satır içi düzey düğümü ve yer imini içerebilir.

Bir paragrafın içinde oluşabilecek alt düğümlerin tam listesi şunlardan oluşur: BookmarkStart ,BookmarkEnd , FieldStart ,FieldSeparator , FieldEnd ,FormField , Comment ,Footnote , Run ,SpecialChar , Shape ,GroupShape , SmartTag.

Microsoft Word’deki geçerli bir paragraf her zaman paragraf sonu karakteriyle biter ve minimum geçerli paragraf yalnızca paragraf sonundan oluşur.Paragraph sınıfı uygun paragraf sonu karakterini end sonuna otomatik olarak ekler ve bu karakter, sınıfın alt düğümlerinin bir parçası değildir.Paragraph , dolayısıyla aParagraph boş olabilir.

Paragrafın sonunu eklemeyinParagraphBreak veya hücrenin sonuCell Belge Microsoft Word’de açıldığında paragrafın geçersiz olmasına neden olabileceği için paragrafın metninin içindeki karakterleri.

Örnekler

Aspose.Words belgesinin elle nasıl oluşturulacağını gösterir.

Document doc = new Document();

// Boş bir belge bir bölüm, bir gövde ve bir paragraftan oluşur.
// Tüm bu düğümleri kaldırmak için "RemoveAllChildren" yöntemini çağırın,
// ve çocuğu olmayan bir belge düğümü elde ederiz.
doc.RemoveAllChildren();

// Bu belgede artık içerik ekleyebileceğimiz bileşik alt düğüm yok.
// Eğer onu düzenlemek istiyorsak, düğüm koleksiyonunu yeniden doldurmamız gerekecek.
// Öncelikle yeni bir bölüm oluşturun ve ardından bunu alt öğe olarak kök belge düğümüne ekleyin.
Section section = new Section(doc);
doc.AppendChild(section);

// Bölüm için bazı sayfa yapısı özelliklerini ayarlayın.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// Bir bölümün tüm içeriğini içerecek ve görüntüleyecek bir gövdeye ihtiyacı vardır
// bölümün üstbilgisi ve altbilgisi arasındaki sayfada.
Body body = new Body(doc);
section.AppendChild(body);

// Bir paragraf oluşturun, bazı biçimlendirme özelliklerini ayarlayın ve ardından onu alt öğe olarak gövdeye ekleyin.
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// Son olarak belgeyi yapmak için biraz içerik ekleyin. Bir koşu oluşturun,
// görünüşünü ve içeriğini ayarlayın ve ardından onu alt öğe olarak paragrafa ekleyin.
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);

Assert.AreEqual("Hello World!", doc.GetText().Trim());

doc.Save(ArtifactsDir + "Section.CreateManually.docx");

Ayrıca bakınız