HeaderFooter

HeaderFooter class

Bir bölümün üstbilgi veya altbilgi metni için kapsayıcıyı temsil eder.

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

public class HeaderFooter : Story

yapıcılar

İsim	Tanım
HeaderFooter(DocumentBase, HeaderFooterType)	Belirtilen türde yeni bir üst bilgi veya alt bilgi oluşturur.

Özellikleri

İsim	Tanım
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.
FirstParagraph { get; }	Hikayedeki ilk paragrafı alır.
HasChildNodes { get; }	İadeler`doğru` bu düğümün herhangi bir alt düğümü varsa.
HeaderFooterType { get; }	Bu üstbilgi/altbilginin türünü alır.
override IsComposite { get; }	İadeler`doğru` çünkü bu düğüm alt düğümlere sahip olabilir.
IsHeader { get; }	Eğer bu doğruysa`HeaderFooter` nesne bir başlıktır.
IsLinkedToPrevious { get; set; }	Bu üst bilgi veya alt bilgi, önceki bölümde karşılık gelen üst bilgi veya alt bilgiye bağlıysa doğrudur.
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; }	İadelerHeaderFooter .
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.
ParentSection { get; }	Bu hikayenin ana bölümünü alır.
PreviousSibling { get; }	Bu düğümden hemen önceki düğümü alır.
Range { get; }	Bir değeri döndürür`Range` Bu düğümde bulunan bir belgenin bölümünü temsil eden nesne.
StoryType { get; }	Bu hikayenin türünü alır.
Tables { get; }	Hikayenin doğrudan alt öğeleri olan tabloların bir koleksiyonunu alır.

yöntemler

İsim	Tanım
override Accept(DocumentVisitor)	Ziyaretçi kabul eder.
AppendChild(Node)	Belirtilen düğümü, bu düğüm için alt düğümler listesinin sonuna ekler.
AppendParagraph(string)	Oluşturan bir kısayol yöntemi`Paragraph` isteğe bağlı metin içeren nesneyi seçer ve onu bu nesnenin 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.
DeleteShapes()	Bu hikayenin metnindeki tüm şekilleri siler.
GetAncestor(NodeType)	Belirtilenin ilk atayı alır`NodeType` .
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.
RemoveChild(Node)	Belirtilen alt düğümü kaldırır.
RemoveSmartTags()	Tümünü kaldırır`SmartTag`Geçerli düğümün alt düğümleri.
SelectNodes(string)	XPath ifadesiyle eşleşen düğümlerin listesini seçer.
SelectSingleNode(string)	İlkini seçer`Node` 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

HeaderFooter içerebilirParagraph VeMasa çocuk düğümleri.

HeaderFooter bölüm düzeyinde bir düğümdür ve yalnızca alt öğesi olabilirSection . Yalnızca bir tane olabilirHeaderFooter her biri içinHeaderFooterType içindeSection.

EğerSection yokHeaderFooter belirli bir türden or HeaderFooteralt düğümü yoksa, bu üst bilgi/alt bilgi, Microsoft Word’deki önceki bölümün aynı türdeki üst bilgi/alt bilgisine bağlı olarak kabul edilir.

Ne zamanHeaderFooter en az bir tane içerirParagraph, artık Microsoft Word’deki öncekiyle bağlantılı olarak kabul edilmiyor.

Örnekler

Belgenin altbilgisindeki metnin nasıl değiştirileceğini gösterir.

Document doc = new Document(MyDir + "Footer.docx");

HeaderFooterCollection headersFooters = doc.FirstSection.HeadersFooters;
HeaderFooter footer = headersFooters[HeaderFooterType.FooterPrimary];

FindReplaceOptions options = new FindReplaceOptions
{
    MatchCase = false,
    FindWholeWordsOnly = false
};

int currentYear = DateTime.Now.Year;
footer.Range.Replace("(C) 2006 Aspose Pty Ltd.", $"Copyright (C) {currentYear} by Aspose Pty Ltd.", options);

doc.Save(ArtifactsDir + "HeaderFooter.ReplaceText.docx");

Bir belgedeki tüm altbilgilerin nasıl silineceğini gösterir.

Document doc = new Document(MyDir + "Header and footer types.docx");

// Her bölümü yineleyin ve her türden altbilgiyi kaldırın.
foreach (Section section in doc.OfType<Section>())
{
    // Üç çeşit altbilgi ve başlık türü vardır.
    // 1 - Bir bölümün yalnızca ilk sayfasında görünen "İlk" üstbilgi/altbilgi.
    HeaderFooter footer = section.HeadersFooters[HeaderFooterType.FooterFirst];
    footer?.Remove();

    // 2 - Tek sayfalarda görünen "Birincil" üstbilgi/altbilgi.
    footer = section.HeadersFooters[HeaderFooterType.FooterPrimary];
    footer?.Remove();

     // 3 - Çift sayfalarda görünen "Çift" üstbilgi/altbilgi.
    footer = section.HeadersFooters[HeaderFooterType.FooterEven];
    footer?.Remove();

    Assert.AreEqual(0, section.HeadersFooters.Count(hf => !((HeaderFooter)hf).IsHeader));
}

doc.Save(ArtifactsDir + "HeaderFooter.RemoveFooters.docx");

Üstbilgi ve altbilginin nasıl oluşturulacağını gösterir.

Document doc = new Document();

// Bir başlık oluşturun ve ona bir paragraf ekleyin. O paragraftaki metin
// bu bölümün her sayfasının üst kısmında, ana metin metninin üstünde görünecektir.
HeaderFooter header = new HeaderFooter(doc, HeaderFooterType.HeaderPrimary);
doc.FirstSection.HeadersFooters.Add(header);

Paragraph para = header.AppendParagraph("My header.");

Assert.True(header.IsHeader);
Assert.True(para.IsEndOfHeaderFooter);

// Bir altbilgi oluşturun ve ona bir paragraf ekleyin. O paragraftaki metin
// bu bölümün her sayfasının altında, ana gövde metninin altında görünecektir.
HeaderFooter footer = new HeaderFooter(doc, HeaderFooterType.FooterPrimary);
doc.FirstSection.HeadersFooters.Add(footer);

para = footer.AppendParagraph("My footer.");

Assert.False(footer.IsHeader);
Assert.True(para.IsEndOfHeaderFooter);

Assert.AreEqual(footer, para.ParentStory);
Assert.AreEqual(footer.ParentSection, para.ParentSection);
Assert.AreEqual(footer.ParentSection, header.ParentSection);

doc.Save(ArtifactsDir + "HeaderFooter.Create.docx");

Ayrıca bakınız

class Story
ad alanı Aspose.Words
toplantı Aspose.Words

FrameFormat Class HeaderFooterCollection Class