PreferredWidth

PreferredWidth class

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

public sealed class PreferredWidth

Özellikleri

İsim Tanım
Type { get; } Bu tercih edilen genişlik değeri için kullanılan ölçü birimini alır.
Value { get; } Tercih edilen genişlik değerini alır. Ölçü birimi şurada belirtilmiştir:Type özellik.

yöntemler

İsim Tanım
static FromPercent(double) Yüzde olarak belirtilen tercih edilen genişliği temsil eden yeni bir örnek 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 örnek 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) Belirtilen PreferredWidth değerinin geçerli PreferredWidth değerine eşit olup olmadığını belirler.
override GetHashCode() Bu tür için bir karma işlevi olarak hizmet eder.
override ToString() Bu nesnenin değerini görüntüleyen kullanıcı dostu bir dize döndürür.

Alanlar

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

Notlar

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

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

Örnekler

Bir tablonun, sayfa genişliğinin %50’sine otomatik 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 göre mutlak bir tercih edilen genişlik 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 göreli bir tercih edilen genişlik 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şlik belirtilmemiş bir hücre, kullanılabilir alanın geri kalanını alacaktır.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// "PreferredWidth" özelliğinin her yapılandırması 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