Dipnotlar ve Son Notlar
Dipnotlar ve Sonnotlar
Aspose.Words FOSS for .NET, tek bir Footnote düğüm sınıfı ile dipnotları ve sonnotları temsil eder; bu sınıf FootnoteType özelliği ile ayrılır, ayrıca Aspose.Words.Notes ad alanında ayrı numaralandırma-seçenekleri ve ayırıcı sınıfları bulunur.
Dipnot ve Sonnot İçeriğini Okuma
Footnote, bir bileşik hikaye düğümüdür — Body veya bir tablo hücresi gibi, Paragraphs ve Tables içerir — ve bir dipnot ya da sonnot metnini tutar. FootnoteType özelliği (bir FootnoteType enum değeri, Footnote veya Endnote) hangi tür olduğunu ayırır. ReferenceMark, yapılandırılmış referans işareti karakterini döndürür, ActualReferenceMark gerçekte render edilen işareti (otomatik numaralandırmayı dikkate alarak) döndürür ve IsAuto işaretin otomatik numaralandırılıp numaralandırılmadığını rapor eder. ParentParagraph, dipnot veya sonnot referansının bulunduğu ana belge gövdesindeki paragrafı bulur. GetText(), dipnotun düz metin içeriğini çıkarır ve diğer hikaye-seviyesi düğümlerde bulunan metoda benzer.
Numaralandırma ve Konumlandırmayı Yapılandırma
Numaralandırma ve yerleştirme davranışı, dipnotlar ve sonnotlar için FootnoteOptions ve EndnoteOptions aracılığıyla ayrı ayrı kontrol edilir; her ikisi de ortak IFootnoteOptions arayüzünü uygular. FootnoteOptions.Position (bir FootnotePosition değeri — BottomOfPage veya BeneathText) ve EndnoteOptions.Position (bir EndnotePosition değeri — EndOfSection veya EndOfDocument) her türün nerede konumlandırılacağını belirler. İkisi de NumberStyle, StartNumber ve RestartRule (bir FootnoteNumberingRule değeri — Continuous, RestartSection, RestartPage veya Default) sunar ve numaralandırma sırasını kontrol eder. FootnoteOptions, ayrıca Columns‘yi sunar; bu, dipnotların sayfanın alt kısmında birden fazla sütunda yerleştirilmesi içindir.
Dipnot ve Sonnot Ayırıcıları
FootnoteSeparator, Word’ün ana belge gövdesi ile dipnotları/sonnotları arasına eklediği içeriği tutan bir story düğümüdür — varsayılan olarak kısa bir yatay çizgi, ancak herhangi bir paragraf içeriği içerebilir. SeparatorType özelliği (bir FootnoteSeparatorType değeri) Word’ün tanımladığı altı ayırıcı rolünü ayırır: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice ve sonnot eşdeğerleri. FootnoteSeparatorCollection, GetByFootnoteSeparatorType(FootnoteSeparatorType) aracılığıyla bir belgede tüm ayırıcı düğümlerine tiplenmiş erişim sağlar.
İpuçları ve En İyi Uygulamalar
Footnote.FootnoteType‘ı kontrol edin, birFootnotedüğümünün dipnot olduğunu varsaymadan önce — aynı sınıf hem dipnotları hem de sonnotları temsil eder.- Otomatik numaralı işaretler yapılandırılmış işaret karakterinden farklı olduğundan, işaretin gerçekte nasıl görüneceğine ihtiyacınız olduğunda
ActualReferenceMark‘ıReferenceMarkyerine kullanın. FootnoteOptionsveEndnoteOptions‘i dipnot/sonnot içeriği eklemeden önce yapılandırın, böylece numaralandırma kuralları ilk notadan itibaren tutarlı bir şekilde uygulanır.FootnoteSeparatoriçeriği nadiren özelleştirilir — çoğu belge Word’ün varsayılan ayırıcıya dayanır — ancak bir belge özel bir devam bildirimi gerektiriyorsa tamamen erişilebilir durumdadır.
Yaygın Sorunlar
| Sorun | Neden | Düzeltme |
|---|---|---|
| Dipnot ve sonnot işleme mantığında karıştırıldı | İkisi de aynı Footnote sınıfını kullanıyor | Footnote.FootnoteType üzerine dallan |
| Referans işaret metni, oluşturulan çıktı ile eşleşmiyor | ActualReferenceMark yerine ReferenceMark kullanıldı | Render edilmiş işaret için ActualReferenceMark‘ı okuyun |
| Numaralandırma sayfa/bölüm başına beklenmedik bir şekilde yeniden başlar | RestartRule, RestartPage veya RestartSection olarak ayarlanır | Belge genelinde numaralandırma için RestartRule‘ı Continuous olarak ayarlayın |
| Sayfanın altındaki dipnot sütunları göz ardı edilir | FootnoteOptions.Columns ayarlanmamış | Columns öğesini FootnoteOptions üzerinde açıkça ayarlayın |
FAQ
Kod içinde bir dipnotu sonnottan nasıl ayırt ederim?
FootnoteType özelliğini Footnote nesnesinde kontrol edin — FootnoteType.Footnote veya FootnoteType.Endnote döndürür.
Dipnotlar ve sonnotlar farklı numaralandırma kurallarına sahip olabilir mi?
Evet — FootnoteOptions ve EndnoteOptions bağımsız olarak yapılandırılır, her biri kendi Position, NumberStyle, StartNumber ve RestartRule öğesine sahiptir.
FootnoteSeparator ne için kullanılır?
Bu, Word’ün ana belge gövdesini dipnotlarından veya sonnotlarından görsel olarak ayırmak için eklediği içeriği ve bir dipnot bir sonraki sayfaya devam ettiğinde gösterilen uyarıyı temsil eder.
Footnote not içinde tabloları destekliyor mu?
Evet — Footnote, Paragraphs ile birlikte bir Tables özelliği sunar, çünkü ana belge gövdesi gibi birleşik bir hikaye düğümüdür.
API Reference Özet
| Sınıf / Metod | Açıklama |
|---|---|
Footnote | Bir dipnot veya sonnotun içeriği için konteyner düğümü |
FootnoteType | Enum: Footnote, Endnote |
FootnoteOptions | Belge/bölüm için dipnot numaralandırma ve konum ayarları |
EndnoteOptions | Belge/bölüm için sonnot numaralandırma ve konum ayarları |
FootnotePosition / EndnotePosition | Yerleşim için enum’lar (BottomOfPage/BeneathText, EndOfSection/EndOfDocument) |
FootnoteNumberingRule | Numaralandırmanın ne zaman yeniden başlayacağını kontrol eden enum |
FootnoteSeparator | Dipnot/sonnot ayırıcı içeriği için hikaye düğümü |
FootnoteSeparatorCollection | Tüm FootnoteSeparator düğümlerine tipli erişim |
FootnoteSeparatorType | Bir düğümün temsil ettiği altı ayırıcı rolünden hangisini tanımlayan enum |