CellFormat

CellFormat class

Representerar all formatering för en tabellcell.

För att lära dig mer, besökArbeta med tabeller dokumentationsartikel.

public class CellFormat

Egenskaper

namnBeskrivning
Borders { get; }Hämtar en samling av cellens kantlinjer.
BottomPadding { get; set; }Returnerar eller anger mängden mellanslag (i punkter) som ska läggas till under cellens innehåll.
FitText { get; set; }Omsann , anpassar texten i cellen och komprimerar varje stycke till cellens bredd.
HideMark { get; set; }Returnerar eller anger synligheten för cellmarkeringen.
HorizontalMerge { get; set; }Anger hur cellen sammanfogas horisontellt med andra celler i raden.
LeftPadding { get; set; }Returnerar eller anger mängden utrymme (i punkter) som ska läggas till vänster om cellens innehåll.
Orientation { get; set; }Returnerar eller anger orienteringen för text i en tabellcell.
PreferredWidth { get; set; }Returnerar eller anger önskad cellbredd.
RightPadding { get; set; }Returnerar eller anger mängden utrymme (i punkter) som ska läggas till till höger om cellens innehåll.
Shading { get; }Returnerar enShading objekt som refererar till skuggningsformateringen för cellen.
TopPadding { get; set; }Returnerar eller anger mängden utrymme (i punkter) som ska läggas till ovanför cellens innehåll.
VerticalAlignment { get; set; }Returnerar eller anger den vertikala justeringen av text i cellen.
VerticalMerge { get; set; }Anger hur cellen sammanfogas med andra celler vertikalt.
Width { get; set; }Hämtar cellens bredd i punkter.
WrapText { get; set; }Omsann , radbryt text för cellen.

Metoder

namnBeskrivning
ClearFormatting()Återställer till standardcellformatering. Ändrar inte cellens bredd.
SetPaddings(double, double, double, double)Anger mängden utrymme (i punkter) som ska läggas till vänster/överst/höger/nederst i cellens innehåll.

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 ange 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 man ä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 på 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 på 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 skapar 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ämpas på den aktuella cellen,
// och alla nya celler som vi skapar med byggaren efteråt.
// Detta kommer inte att påverka de celler 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 för att få plats med 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

CellCollection Class CellMerge Enum