CellFormat

CellFormat class

Representerar all formatering för en tabellcell.

public class CellFormat

Egenskaper

namn Beskrivning
Borders { get; } Får samling av cellens kanter.
BottomPadding { get; set; } Returnerar eller ställer in mängden utrymme (i poäng) som ska läggas till under innehållet i cellen.
FitText { get; set; } Om sant, passar text i cellen och komprimerar varje stycke till cellens bredd.
HorizontalMerge { get; set; } Anger hur cellen sammanfogas horisontellt med andra celler i raden.
LeftPadding { get; set; } Returnerar eller ställer in mängden utrymme (i poäng) som ska läggas till till vänster om innehållet i cellen.
Orientation { get; set; } Returnerar eller ställer in orienteringen för text i en tabellcell.
PreferredWidth { get; set; } Returnerar eller ställer in önskad bredd på cellen.
RightPadding { get; set; } Returnerar eller ställer in mängden utrymme (i poäng) som ska läggas till till höger om innehållet i cellen.
Shading { get; } Returnerar ett Shading-objekt som refererar till skuggformateringen för cellen.
TopPadding { get; set; } Returnerar eller ställer in mängden utrymme (i poäng) som ska läggas till ovanför innehållet i cellen.
VerticalAlignment { get; set; } Returnerar eller ställer in den vertikala justeringen av text i cellen.
VerticalMerge { get; set; } Anger hur cellen sammanfogas med andra celler vertikalt.
Width { get; set; } Får cellens bredd i punkter.
WrapText { get; set; } Om sant, radbryt text för cellen.

Metoder

namn Beskrivning
ClearFormatting() Återställer till standardcellformatering. Ändrar inte cellens bredd.
SetPaddings(double, double, double, double) Ställer in mängden utrymme (i poäng) som ska läggas till till vänster/överst/höger/botten av innehållet i cellen.

Exempel

Visar hur man ändrar formateringen av en tabellcell.

Document doc = new Document(MyDir + "Tables.docx");
Table table = doc.FirstSection.Body.Tables[0];
Cell firstCell = table.FirstRow.FirstCell;

// Använd en cells "CellFormat"-egenskap för att ställa in formatering som ändrar cellens utseende.
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

doc.Save(ArtifactsDir + "Table.CellFormat.docx");

Visar hur du ändrar formatet för rader och celler i en tabell.

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

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("City");
builder.InsertCell();
builder.Write("Country");
builder.EndRow();
builder.InsertCell();
builder.Write("London");
builder.InsertCell();
builder.Write("U.K.");
builder.EndTable();

// Använd den första radens "RowFormat"-egenskap för att ändra formateringen
// av innehållet i alla celler i den här raden.
RowFormat rowFormat = table.FirstRow.RowFormat;
rowFormat.Height = 25;
rowFormat.Borders[BorderType.Bottom].Color = Color.Red;

// Använd egenskapen "CellFormat" för den första cellen i den sista raden för att ändra formateringen av cellens innehåll.
CellFormat cellFormat = table.LastRow.FirstCell.CellFormat;
cellFormat.Width = 100;
cellFormat.Shading.BackgroundPatternColor = Color.Orange;

doc.Save(ArtifactsDir + "Table.RowCellFormat.docx");

Visar hur man bygger en tabell med anpassade ramar.

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

builder.StartTable();

// Ställa in tabellformateringsalternativ för en dokumentbyggare
// kommer att tillämpa dem på varje rad och cell som vi lägger till med den.
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;

builder.CellFormat.ClearFormatting();
builder.CellFormat.Width = 150;
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.CellFormat.Shading.BackgroundPatternColor = Color.GreenYellow;
builder.CellFormat.WrapText = false;
builder.CellFormat.FitText = true;

builder.RowFormat.ClearFormatting();
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.RowFormat.Height = 50;
builder.RowFormat.Borders.LineStyle = LineStyle.Engrave3D;
builder.RowFormat.Borders.Color = Color.Orange;

builder.InsertCell();
builder.Write("Row 1, Col 1");

builder.InsertCell();
builder.Write("Row 1, Col 2");
builder.EndRow();

// Ändring av formateringen kommer att tillämpa den på den aktuella cellen,
// och eventuella nya celler som vi skapar med byggaren efteråt.
// Detta kommer inte att påverka cellerna som vi har lagt till tidigare.
builder.CellFormat.Shading.ClearFormatting();

builder.InsertCell();
builder.Write("Row 2, Col 1");

builder.InsertCell();
builder.Write("Row 2, Col 2");

builder.EndRow();

// Öka radhöjden så att den passar den vertikala texten.
builder.InsertCell();
builder.RowFormat.Height = 150;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 3, Col 1");

builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 3, Col 2");

builder.EndRow();
builder.EndTable();

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

Se även