Paragraph

Paragraph class

Bir paragraf metni temsil eder.

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

public class Paragraph : CompositeNode

yapıcılar

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

Özellikleri

İsimTanım
BreakIsStyleSeparator { get; }Bu paragraf sonu bir Stil Ayırıcısıysa Doğru. Bir stil ayırıcısı, bir paragrafının farklı paragraf stillerine sahip parçalardan oluşmasına izin verir.
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.
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; }Geri Döndürürdoğru eğer bu düğümün herhangi bir alt düğümü varsa.
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.
IsEndOfCell { get; }Bu paragraf bir paragrafın son paragrafıysa doğrudurCell ; aksi takdirde yanlış.
IsEndOfDocument { get; }Bu paragraf belgenin son bölümündeki son paragraf ise doğrudur.
IsEndOfHeaderFooter { get; }Bu paragraf, paragrafın son paragrafıysa doğrudur.HeaderFooter (ana metin hikayesi)Section ; aksi takdirde yanlış.
IsEndOfSection { get; }Bu paragraf, paragrafın son paragrafıysa doğrudur.Body (ana metin hikayesi)Section ; aksi takdirde yanlış.
IsFormatRevision { get; }Değişiklik izleme etkinleştirilmişken Microsoft Word’de nesnenin biçimlendirmesinin değiştirilmesi durumunda doğru değerini döndürür.
IsInCell { get; }Bu paragrafın doğrudan bir alt paragrafı olması durumunda doğrudurCell ; aksi takdirde yanlış.
IsInsertRevision { get; }Bu nesnenin Microsoft Word’e değişiklik izleme etkinleştirilmişken eklenip eklenmediğini döndürür.
IsListItem { get; }Paragraf orijinal revizyonda madde işaretli veya numaralı bir listede yer aldığında doğrudur.
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.
ListFormat { get; }Paragrafın liste biçimlendirme özelliklerine erişim sağlar.
ListLabel { get; }Bir tane alırListLabelBu paragraf için liste numaralandırma değerine ve biçimlendirmeye erişim sağlayan nesne
NextSibling { get; }Bu düğümü hemen takip eden düğümü alır.
override NodeType { get; }Geri DöndürürParagraph .
ParagraphBreakFont { get; }Paragraf sonu karakterinin yazı tipi biçimlendirmesine erişim sağlar.
ParagraphFormat { get; }Paragraf biçimlendirme özelliklerine erişim sağlar.
ParentNode { get; }Bu düğümün en yakın üst düğümünü alır.
ParentSection { get; }Üst öğeyi alırSection paragrafın.
ParentStory { get; }Ana bölüm düzeyindeki hikayeyi alır.Body veyaHeaderFooter .
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.
Runs { get; }Paragrafın içindeki metin parçalarının yazılmış koleksiyonuna erişim sağlar.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Bir ziyaretçiyi kabul eder.
override AcceptEnd(DocumentVisitor)Belgenin paragrafının sonunu ziyaret eden bir ziyaretçiyi kabul eder.
override AcceptStart(DocumentVisitor)Belgenin paragrafının 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.
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üğü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.
GetEffectiveTabStops()Bu paragrafa uygulanan tüm sekme duraklarının dizisini döndürür; buna stiller veya listeler tarafından dolaylı olarak uygulananlar da dahildir.
GetEnumerator()Bu düğümün alt düğümleri üzerindeki her stil yinelemesi için destek sağlar.
override GetText()Paragraf sonu karakteri dahil olmak üzere bu paragrafın 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.
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()Paragraftaki aynı biçimlendirmeyle koşuları birleştirir.
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.
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.
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

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

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

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

Microsoft Word’de geçerli bir paragraf her zaman bir paragraf sonu karakteriyle biter ve asgari geçerli bir paragraf sadece bir paragraf sonundan oluşur.Paragraph sınıfı otomatik olarak uygun paragraf sonu karakterini sonuna ekler ve bu karakter alt düğümlerin bir parçası değildirParagraph , bu nedenle aParagraph boş olabilir.

Paragrafın sonunu dahil etmeyinParagraphBreak veya hücrenin sonuCell Paragrafın metni içindeki karakterlerin olmaması, belge Microsoft Word’de açıldığında paragrafın geçersiz olmasına neden olabilir.

Ö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üyle sonuçlanır.
doc.RemoveAllChildren();

// Bu belgenin artık içerik ekleyebileceğimiz bileşik alt düğümleri yok.
// Düzenlemek istersek, düğüm koleksiyonunu yeniden doldurmamız gerekecektir.
// İlk önce yeni bir bölüm oluşturun ve ardından onu kök belge düğümüne bir alt bölüm olarak ekleyin.
Section section = new Section(doc);
doc.AppendChild(section);

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

// Bir bölümün, tüm içeriklerini barındıracak 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ştur, bazı biçimlendirme özelliklerini ayarla ve sonra onu gövdeye bir alt paragraf olarak ekle.
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 çalışma oluşturun,
// Görünümünü ve içeriğini ayarlayın ve ardından paragrafın bir alt öğesi olarak 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

PaperSize Enum ParagraphAlignment Enum