Listelerle Çalışma

Genel Bakış

Bu kılavuz, Aspose.Words FOSS for .NET içinde numaralı ve madde işaretli listelerin nasıl temsil edildiğini ve kontrol edildiğini gösterir. Bir List, onu kullanan her paragraf tarafından paylaşılan yeniden kullanılabilir bir liste tanımıdır, ListFormat, tek bir paragrafın bir listeye ve mevcut seviyesine nasıl atıfta bulunduğunu gösterir ve ListLevel, bir listenin bir seviyesi için gerçek numaralandırma veya madde işareti biçimlendirmesini tutar.


Liste Nesnesi ve ListCollection

List, bir liste tanımını temsil eder — bir belgenin birçok paragraf için uygulayabileceği numaralandırma kuralları. List.ListId onu tanımlar, List.IsMultiLevel birden fazla seviye tanımlayıp tanımlamadığını rapor eder ve List.ListLevels, listenin tanımladığı her seviye için bir ListLevel tutan bir ListLevelCollection döndürür. List.IsListStyleDefinition ve IsListStyleReference, kendi biçimlendirmesini tanımlayan bir listeyi, bir bağlantılı Style aracılığıyla biçimlendirme referansı yapan bir listeden ayırır (List.Style üzerinden kullanılabilir). Her belgenin listelerine Document.Lists üzerinden erişilir; bu, bir ListCollection döndürür: ListCollection.Add(listTemplate), Word’ün önceden tanımlanmış ListTemplate biçimlerinden yeni bir liste oluşturur, Add(listStyle), bir Style üzerinden oluşturur, AddSingleLevelList(listTemplate), tek seviyeli bir varyant oluşturur ve AddCopy(srcList), mevcut bir listeyi kopyalar — paragrafların aynı sayacı paylaşmak yerine bağımsız numaralandırmaya (yeni bir başlangıç) sahip olmasını istediğinizde faydalıdır. ListCollection.GetListByListId(listId), belirli bir listeyi alır ve Count, belgenin kaç listeye sahip olduğunu rapor eder.

Paragraflara ListFormat ile Listeler Uygulama

ListFormat, bir paragrafın biçimlendirmesinden erişildiğinde, paragrafın hangi listeye ait olduğunu ve hangi seviyede olduğunu kontrol eder. ListFormat.List, paragrafın kullandığı List‘dir ve ListFormat.ListLevelNumber, o listedeki sıfır tabanlı seviyedir; IsListItem, paragrafın bir listenin parçası olup olmadığını rapor eder. ApplyBulletDefault() ve ApplyNumberDefault(), Word’ün varsayılan madde işareti veya numaralı liste biçimlendirmesini bir paragrafta tek bir çağrıyla uygular, RemoveNumbers(), liste biçimlendirmesini kaldırır ve ListIndent()/ListOutdent(), bir paragrafı listenin seviyelerinde daha derine ya da daha sığa taşır — bir liste paragrafının başında Tab ya da Shift+Tab tuşlarına basıldığında Word’ün yaptığı aynı işlemler.

Liste Seviyeleri ve Numara Stili

ListLevel, bir listedeki bir seviyenin biçimlendirmesini tutar: NumberStyle (Arabic rakamları veya Roman rakamları gibi bir NumberStyle enum değeri), NumberFormat (sayıyı nokta veya parantez gibi metinle birleştiren format dizesi), StartAt (başlangıç sayısı) ve RestartAfterLevel (hangi üst seviyenin artışı bu seviyenin sayacını yeniden başlatır). Alignment (bir ListLevelAlignment değeri: Left, Center, Right) ve TrailingCharacter (bir ListTrailingCharacter değeri: Tab, Space, Nothing) etiketin paragraf metninden nasıl konumlandırılacağını ve ayrılacağını kontrol eder, ayrıca kesin yerleşim için TabPosition, NumberPosition ve TextPosition bulunur. IsLegal, yasal stil numaralandırmayı zorlar (her zaman Arabic, NumberStyle ne olursa olsun) ve LinkedStyle, seviyeyi bir paragraf Style ile ilişkilendirir. Resim madde işaretleri için, CreatePictureBullet() ve DeletePictureBullet() bir ImageData madde işareti görüntüsünü yönetir ve ListLevel.Font, sayı ya da madde işareti karakterinin biçimlendirmesini ayarlar. ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat), numaralandırma dizisindeki belirli bir konumdaki gerçek etiket değerini hesaplar.

Liste Etiketleri ve Ön Tanımlı Şablonlar

ListLabel, belirli bir liste öğesi örneği için oluşturulan etiketi tanımlar — LabelString, Word’ün gösterdiği metin (örneğin “3.” veya “•")dır, LabelValue, altındaki sayısal değerdir ve Font, etiketin biçimlendirmesidir. ListTemplate, Word’ün ön tanımlı liste biçimlerinin bir enum’udur (madde işareti stilleri olarak BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds ve numaralı biçimler), ListCollection.Add(listTemplate) ile birlikte, her özelliği tek tek oluşturmak yerine yerleşik bir biçimden başlanmasını sağlar.


İpuçları ve En İyi Uygulamalar

  • Yeni bir paragraf grubunun bağımsız olarak yeniden başlayan liste numaralandırmasına ihtiyacı olduğunda ListCollection.AddCopy(srcList) kullanın; zaten diğer paragraflara eklenmiş bir List‘i yeniden kullanmak yerine.
  • Standart listeler için her ListLevel özelliğini manuel olarak yapılandırmak yerine ListFormat.ApplyNumberDefault() / ApplyBulletDefault()‘i tercih edin.
  • Liste biçimlendirmesini doğrudan değiştirmeden önce List.IsListStyleReference ve IsListStyleDefinition‘i kontrol edin — stil referanslı bir listenin biçimlendirmesi, onun bağlı Style‘si tarafından kontrol edilebilir.
  • Numaralamanın belirli taslak seviyelerinde sıfırlanması gerektiğinde varsayılan yeniden başlatma davranışına güvenmek yerine, iç içe listelerde RestartAfterLevel‘i açıkça ayarlayın.
  • Paragrafı liste seviyeleri arasında taşımak için ListFormat.ListIndent()/ListOutdent() kullanın, ListLevelNumber‘yi doğrudan ayarlamak yerine; çünkü bu yöntemler paragrafın liste biçimlendirmesini dahili olarak tutarlı tutar.

Sık Karşılaşılan Sorunlar

SorunNedenDüzeltme
Bağımsız olarak numaralandırılması gereken iki paragraf aynı sıralamayı sürdürürHer iki paragrafın ListFormat.List öğesi aynı paylaşılan List nesnesine işaret ederİkinci paragrafı aynı List tekrar kullanmak yerine ListCollection.AddCopy(srcList) aracılığıyla kendi listesine sahip yap
Özel bir numaralandırma format dizesi beklenen şekilde görüntülenmiyorListLevel.NumberFormat, seviyenin NumberStyle için beklenen desenle eşleşmiyorDüzenlenen seviyede NumberFormat ve NumberStyle değerlerinin tutarlı şekilde ayarlandığını doğrulayın
Seviyeler programatik olarak değiştirildikten sonra liste girintisi hatalı görünüyorListLevelNumber, ilgili konum özellikleri güncellenmeden doğrudan ayarlandıListLevelNumber doğrudan ayarlamak yerine ListFormat.ListIndent()/ListOutdent() kullanın
Resimli madde işareti görünmüyorSeviye için bir resimli madde işareti oluşturulmadı ya da varsayılan metin madde işareti biçimlendirmesi hâlâ etkinMetin madde işareti biçimlendirmesini kaldırmadan önce ListLevel.CreatePictureBullet() çağırın ve görsel verisini sağlayın

FAQ

List ve ListFormat arasındaki fark nedir?

List, paragraflar arasında paylaşılan yeniden kullanılabilir numaralandırma/madde işareti tanımıdır; ListFormat ise paragraf başına özeldir — belirli bir paragrafın hangi List‘yi kullandığını ve hangi seviyede olduğunu, ListFormat.List ve ListLevelNumber aracılığıyla gösterir.

Bir paragrafın bir listenin parçası olup olmadığını nasıl kontrol ederim?

Paragrafın biçimlendirmesiyle ilgili ListFormat.IsListItem‘ı okuyun; eğer true ise, ListFormat.List ve ListLevelNumber hangi listeye ve seviyeye ait olduğunu açıklar.

Mevcut bir listeden bağımsız olarak yeni bir listenin 1’den numaralandırılmasını nasıl başlatırım?

Liste tanımının bağımsız bir kopyasını oluşturmak için ListCollection.AddCopy(srcList) kullanın, ardından kopyayı yeni paragraflara uygulayın — aynı sayacı devam ettirecek orijinal List‘i yeniden kullanmak yerine.

Sıfırdan madde işaretli veya numaralı bir listeyi nasıl oluşturabilirim?

Word’ün varsayılan biçimlendirmesi için ListFormat.ApplyBulletDefault() veya ApplyNumberDefault() kullanın, ya da ListCollection.Add(listTemplate)‘yi bir ListTemplate değeriyle birlikte kullanarak Word’ün önceden tanımlanmış biçimlerinden birine başlayın ve ardından ortaya çıkan List.ListLevels‘ü özelleştirin.

Numara biçimini, örneğin “1)” yerine “1.” gibi nasıl kontrol edebilirim?

İlgili seviyede ListLevel.NumberFormat‘i istenen biçim dizesine ayarlayın, aynı zamanda sayısal stil için NumberStyle‘i de belirleyin.


API Reference Özet

Sınıf/YöntemAçıklama
ListYeniden kullanılabilir bir liste (numaralandırma/işaret) tanımı
ListCollectionBir belgede bulunan tüm listelerin koleksiyonu
ListCollection.Add(listTemplate) / AddCopy(srcList)Önceden tanımlı bir şablondan bir liste oluşturun ya da mevcut bir listeyi kopyalayın
ListFormatParagraf başına bir List ve mevcut seviyeye referans
ListFormat.ApplyBulletDefault() / ApplyNumberDefault()Bir paragraf için varsayılan madde işareti veya numaralı biçimlendirmeyi uygula
ListLevelList bir seviyesinin numaralandırma/madde işareti biçimlendirmesi
ListLevel.NumberStyle / NumberFormatBir seviye için sayı stili ve biçim dizesi
ListLabelBelirli bir liste öğesi için oluşturulmuş etiket (metin ve değer)
ListTemplateWord’ün önceden tanımlanmış liste biçimlerinin enum’ı

Ayrıca Bakınız

 Türkçe