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.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Tablolarla Çalışma belgeleme makalesi.

public sealed class PreferredWidth

Özellikleri

İsimTanı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,Type mülk.

yöntemler

İsimTanım
static FromPercent(double)Yüzde olarak belirtilen tercih edilen bir genişliği temsil eden yeni bir örnek döndüren bir oluşturma yöntemi.
static FromPoints(double)Belirli sayıda 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 geçerli nesneye eşit değerde olup olmadığını belirler.
Equals(PreferredWidth)Belirtilenin geçerli olup olmadığını belirlerPreferredWidth mevcut değere eşittirPreferredWidth .
override GetHashCode()Bu tür için bir 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 belirtilmemiş” değerini temsil eden bir örneği döndürür.

Notlar

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

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

Ö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 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 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 kalan kullanılabilir alanı kaplayacaktı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

CellVerticalAlignment Enum PreferredWidthType Enum