ListFormat

ListFormat class

Bir paragrafa hangi liste formatının uygulandığını kontrol etmeye izin verir.

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

public class ListFormat

Özellikleri

İsimTanım
IsListItem { get; }Paragrafa madde işaretli veya numaralı biçimlendirme uygulandığında doğrudur.
List { get; set; }Bu paragrafın üyesi olduğu listeyi alır veya ayarlar.
ListLevel { get; }Liste düzeyindeki biçimlendirmeyi ve geçerli paragrafa uygulanan biçimlendirme geçersiz kılmalarını döndürür.
ListLevelNumber { get; set; }Paragrafın liste düzeyi numarasını (0 ila 8) alır veya ayarlar.

yöntemler

İsimTanım
ApplyBulletDefault()Yeni bir varsayılan madde işaretli liste başlatır ve bunu paragrafa uygular.
ApplyNumberDefault()Yeni bir varsayılan numaralandırılmış liste başlatır ve bunu paragrafa uygular.
ListIndent()Geçerli paragrafın liste düzeyini bir düzey artırır.
ListOutdent()Geçerli paragrafın liste düzeyini bir düzey azaltır.
RemoveNumbers()Geçerli paragraftaki sayıları veya madde işaretlerini kaldırır ve liste düzeyini sıfıra ayarlar.

Notlar

Bir Microsoft Word belgesindeki bir paragraf madde işaretli veya numaralandırılmış olabilir. Bir paragraf madde işaretli veya numaralandırılmış olduğunda, paragrafa liste biçimlendirme uygulandığı söylenir.

Şunun nesnelerini yaratmıyorsunuz:ListFormat doğrudan sınıf. Siz erişinListFormat can ’nin kendisiyle ilişkilendirilmiş liste formatına sahip olduğu başka bir nesnenin özelliği olarak. Şu anda can ’nin liste formatına sahip olduğu nesneler şunlardır:Paragraph , Style VeDocumentBuilder.

ListFormat birParagraph söz konusu paragrafa hangi liste formatının ve liste düzeyinin uygulandığını belirtir .

ListFormat birStyle (applicable yalnızca paragraf stillerine) hangi liste formatının ve liste düzeyi ’nin söz konusu stilin tüm paragraflarına uygulandığını belirlemeye olanak tanır.

ListFormat birDocumentBuilder , geçerli imleç pozisyonundaki içindeki liste formatına erişim sağlar.DocumentBuilder.

Liste formatının kendisi bir dosyanın içinde saklanır.List Paragraflardan ayrı olarak depolanan nesnesi. liste nesneleri bir içinde saklanırListCollection Toplamak. Bir single varListCollection başına tahsilatDocument.

Paragraflar fiziksel olarak bir listeye ait değildir. Just paragrafları belirli bir liste nesnesine referans verir.List property ve listedeki belirli bir düzeyListLevelNumber property. Bu iki özelliği ayarlayarak, bir paragrafa hangi madde işaretlerinin ve numaralandırmanın uygulandığını kontrol edersiniz.

Örnekler

Liste düzeyleriyle nasıl çalışılacağını gösterir.

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

Assert.False(builder.ListFormat.IsListItem);

// Liste, paragraf kümelerini önek sembolleri ve girintilerle düzenlememize ve süslememize olanak tanır.
 // Girinti seviyesini artırarak iç içe listeler oluşturabiliriz.
 // Bir listeyi belge oluşturucunun "ListFormat" özelliğini kullanarak başlatabilir ve sonlandırabiliriz.
// Bir listenin başı ile sonu arasına eklediğimiz her paragraf, listede bir öğe haline gelecektir.
// Aşağıda belge oluşturucuyu kullanarak oluşturabileceğimiz iki tür liste bulunmaktadır.
// 1 - Numaralandırılmış bir liste:
// Numaralandırılmış listeler, her öğeyi numaralandırarak paragrafları için mantıksal bir düzen oluşturur.
builder.ListFormat.List = doc.Lists.Add(ListTemplate.NumberDefault);

Assert.True(builder.ListFormat.IsListItem);

// "ListLevelNumber" özelliğini ayarlayarak liste seviyesini arttırabiliriz
// geçerli liste öğesinde bağımsız bir alt liste başlatmak için.
// "NumberDefault" adı verilen Microsoft Word liste şablonu, ilk liste düzeyi için liste düzeyleri oluşturmak amacıyla sayıları kullanır.
 // Daha derin liste seviyelerinde harfler ve küçük harf Romen rakamları kullanılır.
for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// 2 - Madde işaretli liste:
// Bu liste, her paragraftan önce bir girinti ve madde işareti simgesi ("•") uygulayacaktır.
// Bu listenin daha derin seviyelerinde "■" ve "○" gibi farklı semboller kullanılacaktır.
builder.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);

for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// "Liste" bayrağının ayarını kaldırarak sonraki paragrafları liste olarak biçimlendirmemek için liste biçimlendirmesini devre dışı bırakabiliriz.
builder.ListFormat.List = null;

Assert.False(builder.ListFormat.IsListItem);

doc.Save(ArtifactsDir + "Lists.SpecifyListLevel.docx");

Ayrıca bakınız