PreferredWidth

PreferredWidth class

Bir tablonun veya hücrenin tercih edilen genişliğini belirtmek için kullanılan bir değeri ve onun ölçü birimini temsil eder.

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

public sealed class PreferredWidth

Özellikleri

İsimTanım
Type { get; }Tercih edilen bu genişlik değeri için kullanılan ölçü birimini alır.
Value { get; }Tercih edilen genişlik değerini alır. Ölçü birimi belirtilenType özellik.

yöntemler

İsimTanım
static FromPercent(double)Yüzde olarak belirtilen tercih edilen genişliği temsil eden yeni bir örneği döndüren bir oluşturma yöntemi.
static FromPoints(double)Bir dizi nokta kullanılarak belirtilen tercih edilen genişliği temsil eden yeni bir örneği döndüren bir oluşturma yöntemi.
override Equals(object)Belirtilen nesnenin değer olarak geçerli nesneye eşit olup olmadığını belirler.
Equals(PreferredWidth)Belirtilenin olup olmadığını belirlerPreferredWidth şimdiki değere eşittirPreferredWidth .
override GetHashCode()Bu tür için karma işlevi görevi görür.
override ToString()Bu nesnenin değerini görüntüleyen kullanıcı dostu bir dize döndürür.

Alanlar

İsimTanım
static readonly Auto“Tercih edilen genişlik belirtilmedi” değerini temsil eden bir örneği döndürür.

Notlar

Tercih edilen genişlik yüzde, nokta sayısı veya özel bir “yok/otomatik” değer olarak belirtilebilir.

Bu sınıfın örnekleri değişmezdir.

Örnekler

Bir tablonun sayfa genişliğinin %50’sine otomatik olarak sığacak şekilde nasıl ayarlanacağını gösterir.

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

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Cell #1");
builder.InsertCell();
builder.Write("Cell #2");
builder.InsertCell();
builder.Write("Cell #3");

table.PreferredWidth = PreferredWidth.FromPercent(50);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTableWithPreferredWidth.docx");

Tablo hücreleri için tercih edilen genişliğin nasıl ayarlanacağını gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();

// "PreferredWidth" sınıfını tablo hücrelerine uygulamanın iki yolu vardır.
// 1 - Noktalara dayalı olarak tercih edilen mutlak genişliği ayarlayın:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

// 2 - Tablonun genişliğinin yüzdesine göre tercih edilen göreceli genişliği ayarlayın:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

builder.InsertCell();

// Tercih edilen genişliği belirtilmeyen bir hücre, kullanılabilir alanın geri kalanını kaplayacaktır.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// "PreferredWidth" özelliğinin her konfigürasyonu yeni bir nesne oluşturur.
Assert.AreNotEqual(table.FirstRow.Cells[1].CellFormat.PreferredWidth.GetHashCode(),
    builder.CellFormat.PreferredWidth.GetHashCode());

builder.CellFormat.Shading.BackgroundPatternColor = Color.LightGreen;
builder.Writeln("Automatically sized cell.");

doc.Save(ArtifactsDir + "DocumentBuilder.InsertCellsWithPreferredWidths.docx");

Ayrıca bakınız

CellVerticalAlignment Enum PreferredWidthType Enum