FieldListNum

FieldListNum class

LISTNUM alanını uygular.

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

public class FieldListNum : Field

yapıcılar

İsimTanım
FieldListNum()Default_Constructor

Özellikleri

İsimTanım
DisplayResult { get; }Görüntülenen alan sonucunu temsil eden metni alır.
End { get; }Alan sonunu temsil eden düğümü alır.
Format { get; }Bir alırFieldFormat Alanın formatlamasına yazılı erişim sağlayan nesne.
HasListName { get; }Soyut numaralandırma tanımının adının alanın kodu tarafından sağlanıp sağlanmadığını belirten bir değer döndürür.
IsDirty { get; set; }Belgede yapılan diğer değişiklikler nedeniyle alanın geçerli sonucunun artık doğru (eski) olup olmadığını alır veya ayarlar.
IsLocked { get; set; }Alanın kilitli olup olmadığını alır veya ayarlar (sonucu yeniden hesaplanmamalıdır).
ListLevel { get; set; }Alanın varsayılan davranışını geçersiz kılarak listedeki düzeyi alır veya ayarlar.
ListName { get; set; }Numaralandırma için kullanılan soyut numaralandırma tanımının adını alır veya ayarlar.
LocaleId { get; set; }Alanın LCID’sini alır veya ayarlar.
Result { get; set; }Alan ayırıcı ile alan sonu arasındaki metni alır veya ayarlar.
Separator { get; }Alan ayırıcıyı temsil eden düğümü alır. Olabilirhükümsüz .
Start { get; }Alanın başlangıcını temsil eden düğümü alır.
StartingNumber { get; set; }Bu alanın başlangıç değerini alır veya ayarlar.
virtual Type { get; }Microsoft Word alan türünü alır.

yöntemler

İsimTanım
GetFieldCode()Alan başlangıcı ile alan ayırıcı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür. Alt alanların hem alan kodu hem de alan sonucu dahil edilir.
GetFieldCode(bool)Alan başlangıcı ile alan ayırıcı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür.
Remove()Alanı belgeden kaldırır. Alanın hemen ardından bir düğüm döndürür. Alanın sonu, üst düğümünün son child ‘si ise, üst paragrafını döndürür. Alan zaten kaldırılmışsa şunu döndürür:hükümsüz .
Unlink()Alanın bağlantısını kaldırır.
Update()Alan güncellemesini gerçekleştirir. Alan zaten güncelleniyorsa atar.
Update(bool)Bir alan güncellemesi gerçekleştirir. Alan zaten güncelleniyorsa atar.

Örnekler

LISTNUM alanlarıyla paragrafların nasıl numaralandırılacağını gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// LISTNUM alanları, her LISTNUM alanında artan bir sayı görüntüler.
// Bu alanlar aynı zamanda onları numaralandırılmış listeleri taklit etmek için kullanmamıza izin veren çeşitli seçeneklere de sahiptir.
FieldListNum field = (FieldListNum)builder.InsertField(FieldType.FieldListNum, true);

// Listeler varsayılan olarak 1'den saymaya başlar ancak bu sayıyı 0 gibi farklı bir değere de ayarlayabiliriz.
// Bu alanda "0)" görüntülenecektir.
field.StartingNumber = "0";
builder.Writeln("Paragraph 1");

Assert.AreEqual(" LISTNUM  \\s 0", field.GetFieldCode());

 // LISTNUM alanları her liste düzeyi için ayrı sayıları korur.
// LISTNUM alanını başka bir LISTNUM alanıyla aynı paragrafa ekleme
// sayı yerine liste düzeyini artırır.
// Bir sonraki alan yukarıda başlattığımız sayıma devam edecek ve liste düzeyi 1'de "1" değerini görüntüleyecektir.
builder.InsertField(FieldType.FieldListNum, true);

// Bu alan liste düzeyinde 2'den bir sayım başlatacaktır. "1" değerini görüntüleyecektir.
builder.InsertField(FieldType.FieldListNum, true);

// Bu alan liste düzeyinde 3'ten bir sayım başlatacaktır. "1" değerini görüntüleyecektir.
// Farklı liste seviyelerinin farklı formatları vardır,
// böylece bu alanlar bir araya getirildiğinde "1)a)i)" değeri görüntülenecektir.
builder.InsertField(FieldType.FieldListNum, true);
builder.Writeln("Paragraph 2");

// Ekleyeceğimiz bir sonraki LISTNUM alanı liste düzeyinde sayıma devam edecek
// önceki LISTNUM alanının açık olduğu.
// Farklı bir liste düzeyine atlamak için "ListLevel" özelliğini kullanabiliriz.
// Bu LISTNUM alanı liste düzeyi 3'te kalırsa "ii)" görüntülenir,
// ama liste düzeyi 2'ye taşıdığımız için o düzeyde saymaya devam ediyor ve "b)" gösteriyor.
field = (FieldListNum)builder.InsertField(FieldType.FieldListNum, true);
field.ListLevel = "2";
builder.Writeln("Paragraph 3");

Assert.AreEqual(" LISTNUM  \\l 2", field.GetFieldCode());

// Alanın farklı bir AUTONUM alan tipini taklit etmesini sağlamak için ListName özelliğini ayarlayabiliriz.
// "NumberDefault" AUTONUM'u taklit eder, "OutlineDefault" AUTONUMOUT'u taklit eder,
// ve "LegalDefault", AUTONUMLGL alanlarını taklit eder.
// Başlangıç numarası 1 olan "OutlineDefault" liste adı, "I." görüntülenmesiyle sonuçlanacaktır.
field = (FieldListNum)builder.InsertField(FieldType.FieldListNum, true);
field.StartingNumber = "1";
field.ListName = "OutlineDefault";
builder.Writeln("Paragraph 4");

Assert.IsTrue(field.HasListName);
Assert.AreEqual(" LISTNUM  OutlineDefault \\s 1", field.GetFieldCode());

// ListName önceki alandan taşınmaz, dolayısıyla onu her yeni alan için ayarlamamız gerekecek.
// Bu alan farklı liste adı ile sayıma devam eder ve "II." değerini görüntüler.
field = (FieldListNum)builder.InsertField(FieldType.FieldListNum, true);
field.ListName = "OutlineDefault";
builder.Writeln("Paragraph 5");

doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.LISTNUM.docx");

Ayrıca bakınız

FieldLink Class FieldMacroButton Class