FieldListNum

FieldListNum class

LISTNUM alanını uygular.

public class FieldListNum : Field

yapıcılar

İsim Tanım
FieldListNum() Default_Constructor

Özellikleri

İsim Tanı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; } FieldFormat alanın biçimlendirmesine yazılı erişim sağlayan nesne.
HasListName { get; } Soyut numaralandırma tanımının adının alan kodu tarafından sağlanıp sağlanmadığını gösteren 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 (sonucunu yeniden hesaplamamalı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. null. olabilir
Start { get; } Alanın başlangıcını temsil eden düğümü alır.
StartingNumber { get; set; } Bu alan için başlangıç değerini alır veya ayarlar.
virtual Type { get; } Microsoft Word alan türünü alır.

yöntemler

İsim Tanı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. Alandan hemen sonra bir düğüm döndürür. Alanın sonu, üst düğümünün son çocuğu ise, üst paragrafını döndürür. Alan zaten kaldırılmışsa, döner hükümsüz .
Unlink() Bağlantıyı kaldır alanını gerçekleştirir.
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 ayrıca, onları numaralı listeleri taklit etmek için kullanmamıza izin veren çeşitli seçeneklere 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 ayarlayabiliriz.
// Bu alan "0)" gösterecektir.
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üzeyinde 1 değerini gösterecek.
builder.InsertField(FieldType.FieldListNum, true);

// Bu alan liste düzeyinde bir sayıma başlar. "1" değerini görüntüler.
builder.InsertField(FieldType.FieldListNum, true);

// Bu alan liste düzeyinde bir sayıma başlar. "1" değerini görüntüler.
// Farklı liste düzeylerinin farklı biçimlendirmeleri vardır,
// böylece bu alanlar birleştirilmiş "1)a)i)" değerini gösterecek.
builder.InsertField(FieldType.FieldListNum, true);
builder.Writeln("Paragraph 2");

// Ekleyeceğimiz sonraki LISTNUM alanı, saymaya liste düzeyinde devam edecek
// önceki LISTNUM alanının açık olduğunu.
// Farklı bir liste düzeyine atlamak için "ListLevel" özelliğini kullanabiliriz.
// Bu LISTNUM alanı 3. liste seviyesinde kalsaydı, "ii)" gösterirdi,
// ancak 2. listeye taşıdığımız için saymaya o seviyede 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 türüne öykünmesini sağlamak için ListName özelliğini ayarlayabiliriz.
// "NumberDefault", AUTONUM'a öykünür, "OutlineDefault", AUTONUMOUT'a öykünür,
// ve "LegalDefault", AUTONUMLGL alanlarını öykünür.
// Başlangıç numarası 1 olan "OutlineDefault" liste adı, "I" öğesinin görüntülenmesine neden olur.
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, bu yüzden her yeni alan için onu ayarlamamız gerekecek.
// Bu alan saymaya farklı liste adı ile devam eder ve "II." gösterir.
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