CellFormat

CellFormat class

Representa todo el formato de una celda de tabla.

Para obtener más información, visite elTrabajar con tablas Artículo de documentación.

public class CellFormat

Propiedades

NombreDescripción
Borders { get; }Obtiene la colección de bordes de la celda.
BottomPadding { get; set; }Devuelve o establece la cantidad de espacio (en puntos) que se agregará debajo del contenido de la celda.
FitText { get; set; }Siverdadero , ajusta el texto en la celda, comprimiendo cada párrafo al ancho de la celda.
HideMark { get; set; }Devuelve o establece la visibilidad de la marca de celda.
HorizontalMerge { get; set; }Especifica cómo se fusiona la celda horizontalmente con otras celdas en la fila.
LeftPadding { get; set; }Devuelve o establece la cantidad de espacio (en puntos) que se agregará a la izquierda del contenido de la celda.
Orientation { get; set; }Devuelve o establece la orientación del texto en una celda de la tabla.
PreferredWidth { get; set; }Devuelve o establece el ancho preferido de la celda.
RightPadding { get; set; }Devuelve o establece la cantidad de espacio (en puntos) que se agregará a la derecha del contenido de la celda.
Shading { get; }Devuelve unShading objeto que hace referencia al formato de sombreado de la celda.
TopPadding { get; set; }Devuelve o establece la cantidad de espacio (en puntos) que se agregará sobre el contenido de la celda.
VerticalAlignment { get; set; }Devuelve o establece la alineación vertical del texto en la celda.
VerticalMerge { get; set; }Especifica cómo se fusiona la celda con otras celdas verticalmente.
Width { get; set; }Obtiene el ancho de la celda en puntos.
WrapText { get; set; }Siverdadero , ajustar el texto de la celda.

Métodos

NombreDescripción
ClearFormatting()Restablece el formato de celda predeterminado. No modifica el ancho de la celda.
SetPaddings(double, double, double, double)Establece la cantidad de espacio (en puntos) que se agregará a la izquierda/arriba/derecha/abajo del contenido de la celda.

Ejemplos

Muestra cómo modificar el formato de una celda de tabla.

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

// Utilice la propiedad "CellFormat" de una celda para establecer el formato que modifica la apariencia de esa celda.
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

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

Muestra cómo modificar el formato de filas y celdas en una tabla.

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();

// Utilice la propiedad "RowFormat" de la primera fila para modificar el formato
// del contenido de todas las celdas de esta fila.
RowFormat rowFormat = table.FirstRow.RowFormat;
rowFormat.Height = 25;
rowFormat.Borders[BorderType.Bottom].Color = Color.Red;

// Utilice la propiedad "CellFormat" de la primera celda de la última fila para modificar el formato del contenido de esa celda.
CellFormat cellFormat = table.LastRow.FirstCell.CellFormat;
cellFormat.Width = 100;
cellFormat.Shading.BackgroundPatternColor = Color.Orange;

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

Muestra cómo crear una tabla con bordes personalizados.

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

builder.StartTable();

// Configuración de opciones de formato de tabla para un generador de documentos
// los aplicará a cada fila y celda que agreguemos.
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();

//Cambiar el formato se aplicará a la celda actual,
// y cualquier celda nueva que creemos con el constructor posteriormente.
//Esto no afectará las celdas que hemos agregado previamente.
builder.CellFormat.Shading.ClearFormatting();

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

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

builder.EndRow();

// Aumenta la altura de la fila para que se ajuste al texto vertical.
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");

Ver también

CellCollection Class CellMerge Enum