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ş birList‘i yeniden kullanmak yerine. - Standart listeler için her
ListLevelözelliğini manuel olarak yapılandırmak yerineListFormat.ApplyNumberDefault()/ApplyBulletDefault()‘i tercih edin. - Liste biçimlendirmesini doğrudan değiştirmeden önce
List.IsListStyleReferenceveIsListStyleDefinition‘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
| Sorun | Neden | Düzeltme |
|---|---|---|
| Bağımsız olarak numaralandırılması gereken iki paragraf aynı sıralamayı sürdürür | Her 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ülenmiyor | ListLevel.NumberFormat, seviyenin NumberStyle için beklenen desenle eşleşmiyor | Dü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üyor | ListLevelNumber, 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üyor | Seviye için bir resimli madde işareti oluşturulmadı ya da varsayılan metin madde işareti biçimlendirmesi hâlâ etkin | Metin 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öntem | Açıklama |
|---|---|
List | Yeniden kullanılabilir bir liste (numaralandırma/işaret) tanımı |
ListCollection | Bir 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 |
ListFormat | Paragraf 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 |
ListLevel | List bir seviyesinin numaralandırma/madde işareti biçimlendirmesi |
ListLevel.NumberStyle / NumberFormat | Bir seviye için sayı stili ve biçim dizesi |
ListLabel | Belirli bir liste öğesi için oluşturulmuş etiket (metin ve değer) |
ListTemplate | Word’ün önceden tanımlanmış liste biçimlerinin enum’ı |