Table
Table class
Word belgesindeki bir tabloyu temsil eder.
Daha fazlasını öğrenmek için şu adresi ziyaret edin:Tablolarla Çalışmak dokümantasyon makalesi.
public class Table : CompositeNode
yapıcılar
İsim | Tanım |
---|---|
Table(DocumentBase) | Yeni bir örneğini başlatırTable class. |
Özellikleri
İsim | Tanım |
---|---|
AbsoluteHorizontalDistance { get; set; } | Tablo özellikleri tarafından belirtilen mutlak yatay kayan tablo konumunu puan cinsinden alır veya ayarlar. Varsayılan değer 0. ‘dir |
AbsoluteVerticalDistance { get; set; } | Tablo özellikleri tarafından belirtilen mutlak dikey kayan tablo konumunu puan cinsinden alır veya ayarlar. Varsayılan değer 0. |
Alignment { get; set; } | Satır içi tablonun belgede nasıl hizalanacağını belirtir. |
AllowAutoFit { get; set; } | Microsoft Word ve Aspose.Words’ün tablodaki hücreleri içeriklerine uyacak şekilde otomatik olarak yeniden boyutlandırmasına olanak tanır. |
AllowCellSpacing { get; set; } | “Hücreler arasındaki boşluğa izin ver” seçeneğini alır veya ayarlar. |
AllowOverlap { get; } | Bir kayan tablonun, belge içindeki diğer kayan nesnelerin görüntülendiğinde kapsamlarıyla çakışmasına izin verip vermeyeceğini alır. Varsayılan değer:doğru . |
Bidi { get; set; } | Bunun sağdan sola bir tablo olup olmadığını alır veya ayarlar. |
BottomPadding { get; set; } | Hücre içeriğinin altına eklenecek alan miktarını (puan cinsinden) alır veya ayarlar. |
CellSpacing { get; set; } | Hücreler arasındaki boşluk miktarını (nokta cinsinden) alır veya ayarlar. |
Count { get; } | Bu düğümün doğrudan alt öğelerinin sayısını alır. |
CustomNodeId { get; set; } | Özel düğüm tanımlayıcısını belirtir. |
Description { get; set; } | Bu tablonun açıklamasını alır veya ayarlar. Tabloda yer alan bilgilerin alternatif metin gösterimini sağlar. |
DistanceBottom { get; set; } | Tablonun alt kısmı ile onu çevreleyen metin arasındaki mesafeyi nokta cinsinden alır veya ayarlar. |
DistanceLeft { get; set; } | Soldaki tablo ile çevresindeki metin arasındaki mesafeyi puan cinsinden alır veya ayarlar. |
DistanceRight { get; set; } | Tablonun sağı ile onu çevreleyen metin arasındaki mesafeyi nokta cinsinden alır veya ayarlar. |
DistanceTop { get; set; } | Masa üstü ile etrafındaki metin arasındaki mesafeyi nokta cinsinden alır veya ayarlar. |
virtual Document { get; } | Bu düğümün ait olduğu belgeyi alır. |
FirstChild { get; } | Düğümün ilk çocuğunu alır. |
FirstRow { get; } | İlkini döndürürRow tablodaki düğüm. |
HasChildNodes { get; } | İadelerdoğru bu düğümün herhangi bir alt düğümü varsa. |
HorizontalAnchor { get; set; } | Kayan tablonun yatay konumunun hesaplanması gereken temel nesneyi alır. Varsayılan değer:Column . |
override IsComposite { get; } | İadelerdoğru çünkü bu düğüm alt düğümlere sahip olabilir. |
LastChild { get; } | Düğümün son çocuğunu alır. |
LastRow { get; } | Sonuncuyu döndürürRow tablodaki düğüm. |
LeftIndent { get; set; } | Tablonun sol girintisini temsil eden değeri alır veya ayarlar. |
LeftPadding { get; set; } | Hücre içeriğinin soluna eklenecek alan miktarını (puan cinsinden) alır veya ayarlar. |
NextSibling { get; } | Bu düğümden hemen sonra gelen düğümü alır. |
override NodeType { get; } | İadelerTable . |
ParentNode { get; } | Bu düğümün doğrudan ebeveynini alır. |
PreferredWidth { get; set; } | Tablonun tercih edilen genişliğini alır veya ayarlar. |
PreviousSibling { get; } | Bu düğümden hemen önceki düğümü alır. |
Range { get; } | Bir değeri döndürürRange Bu düğümde bulunan bir belgenin bölümünü temsil eden nesne. |
RelativeHorizontalAlignment { get; set; } | Kayan tablonun göreceli yatay hizalamasını alır veya ayarlar. |
RelativeVerticalAlignment { get; set; } | Kayan tablonun göreli dikey hizalamasını alır veya ayarlar. |
RightPadding { get; set; } | Hücre içeriğinin sağına eklenecek alan miktarını (puan cinsinden) alır veya ayarlar. |
Rows { get; } | Tablonun satırlarına yazılı erişim sağlar. |
Style { get; set; } | Bu tabloya uygulanan tablo stilini alır veya ayarlar. |
StyleIdentifier { get; set; } | Bu tabloya uygulanan tablo stilinin yerel ayardan bağımsız stil tanımlayıcısını alır veya ayarlar. |
StyleName { get; set; } | Bu tabloya uygulanan tablo stilinin adını alır veya ayarlar. |
StyleOptions { get; set; } | Bir tablo stilinin bu tabloya nasıl uygulanacağını belirten bit bayraklarını alır veya ayarlar. |
TextWrapping { get; set; } | Alır veya ayarlarTextWrapping tablo. için |
Title { get; set; } | Bu tablonun başlığını alır veya ayarlar. Tabloda yer alan bilgilerin alternatif metin gösterimini sağlar. |
TopPadding { get; set; } | Hücre içeriğinin üzerine eklenecek alan miktarını (puan cinsinden) alır veya ayarlar. |
VerticalAnchor { get; set; } | Kayan tablonun dikey konumunun hesaplanması gereken temel nesneyi alır. Varsayılan değer:Margin . |
yöntemler
İsim | Tanım |
---|---|
override Accept(DocumentVisitor) | Ziyaretçi kabul eder. |
AppendChild(Node) | Belirtilen düğümü, bu düğüm için alt düğümler listesinin sonuna ekler. |
AutoFit(AutoFitBehavior) | Belirtilen otomatik sığdırma davranışına göre tabloyu ve hücreleri yeniden boyutlandırır. |
ClearBorders() | Bu tablodaki tüm tablo ve hücre kenarlıklarını kaldırır. |
ClearShading() | Masadaki tüm gölgelemeyi kaldırır. |
Clone(bool) | Düğümün bir kopyasını oluşturur. |
ConvertToHorizontallyMergedCells() | Yatay olarak genişliğe göre birleştirilmiş hücreleri, genişliğe göre birleştirilmiş hücrelere dönüştürürHorizontalMerge . |
CreateNavigator() | Düğümlerin arasında geçiş yapmak ve düğümleri okumak için kullanılabilecek gezgini oluşturur. |
EnsureMinimum() | Tabloda hiç satır yoksa bir tane oluşturur ve eklerRow . |
GetAncestor(NodeType) | Belirtilenin ilk atayı alırNodeType . |
GetAncestor(Type) | Belirtilen nesne türünün ilk atayı alır. |
GetChild(NodeType, int, bool) | Belirtilen türle eşleşen N’inci alt düğümü döndürür. |
GetChildNodes(NodeType, bool) | Belirtilen türle eşleşen alt düğümlerin canlı bir koleksiyonunu döndürür. |
GetEnumerator() | Bu düğümün alt düğümleri üzerindeki her stil yinelemesi için destek sağlar. |
override GetText() | Bu düğümün ve tüm alt öğelerinin metnini alır. |
IndexOf(Node) | Alt düğüm dizisinde belirtilen alt düğümün dizinini döndürür. |
InsertAfter(Node, Node) | Belirtilen düğümü, belirtilen referans düğümünün hemen sonrasına ekler. |
InsertBefore(Node, Node) | Belirtilen düğümü, belirtilen referans düğümünün hemen öncesine ekler. |
NextPreOrder(Node) | Ön sipariş ağaç geçiş algoritmasına göre sonraki düğümü alır. |
PrependChild(Node) | Belirtilen düğümü, bu düğüm için alt düğümler listesinin başına ekler. |
PreviousPreOrder(Node) | Ön sipariş ağaç geçiş algoritmasına göre önceki düğümü alır. |
Remove() | Kendini üst öğeden kaldırır. |
RemoveAllChildren() | Geçerli düğümün tüm alt düğümlerini kaldırır. |
RemoveChild(Node) | Belirtilen alt düğümü kaldırır. |
RemoveSmartTags() | Tümünü kaldırırSmartTag Geçerli düğümün alt düğümleri. |
SelectNodes(string) | XPath ifadesiyle eşleşen düğümlerin listesini seçer. |
SelectSingleNode(string) | İlkini seçerNode XPath ifadesiyle eşleşen. |
SetBorder(BorderType, LineStyle, double, Color, bool) | Belirtilen tablo kenarlığını belirtilen çizgi stiline, genişliğine ve rengine ayarlar. |
SetBorders(LineStyle, double, Color) | Tüm tablo kenarlıklarını belirtilen çizgi stiline, genişliğine ve rengine ayarlar. |
SetShading(TextureIndex, Color, Color) | Gölgelendirmeyi tüm tablo üzerinde belirtilen değerlere ayarlar. |
ToString(SaveFormat) | Düğümün içeriğini belirtilen formatta bir dizeye aktarır. |
ToString(SaveOptions) | Belirtilen kaydetme seçeneklerini kullanarak düğümün içeriğini bir dizeye aktarır. |
Notlar
Table
blok düzeyinde bir düğümdür ve türetilmiş sınıfların çocuğu olabilir.Story
veya InlineStory
.
Table
bir veya daha fazlasını içerebilirRow
düğümler.
Minimum geçerli tablonun en az bir taneye sahip olması gerekirRow
.
Örnekler
Bir tablonun nasıl oluşturulacağını gösterir.
Document doc = new Document();
Table table = new Table(doc);
doc.FirstSection.Body.AppendChild(table);
// Tablolar, paragraf içerebilen hücreleri içeren satırları içerir
// diziler, şekiller ve hatta diğer tablolar gibi tipik öğelerle.
// Bir tabloda "EnsureMinimum" yöntemini çağırmak şunları sağlayacaktır:
// tabloda en az bir satır, hücre ve paragraf var.
Row firstRow = new Row(doc);
table.AppendChild(firstRow);
Cell firstCell = new Cell(doc);
firstRow.AppendChild(firstCell);
Paragraph paragraph = new Paragraph(doc);
firstCell.AppendChild(paragraph);
// Tablonun ilk satırındaki ilk çağrıya metin ekleyin.
Run run = new Run(doc, "Hello world!");
paragraph.AppendChild(run);
doc.Save(ArtifactsDir + "Table.CreateTable.docx");
Belgedeki tüm tabloların nasıl yineleneceğini ve her hücrenin içeriğinin nasıl yazdırılacağını gösterir.
Document doc = new Document(MyDir + "Tables.docx");
TableCollection tables = doc.FirstSection.Body.Tables;
Assert.AreEqual(2, tables.ToArray().Length);
for (int i = 0; i < tables.Count; i++)
{
Console.WriteLine($"Start of Table {i}");
RowCollection rows = tables[i].Rows;
// Bir satır koleksiyonunu bir diziye kopyalamak için "ToArray" yöntemini kullanabiliriz.
Assert.AreEqual(rows, rows.ToArray());
Assert.AreNotSame(rows, rows.ToArray());
for (int j = 0; j < rows.Count; j++)
{
Console.WriteLine($"\tStart of Row {j}");
CellCollection cells = rows[j].Cells;
// Bir hücre koleksiyonunu bir diziye kopyalamak için "ToArray" yöntemini kullanabiliriz.
Assert.AreEqual(cells, cells.ToArray());
Assert.AreNotSame(cells, cells.ToArray());
for (int k = 0; k < cells.Count; k++)
{
string cellText = cells[k].ToString(SaveFormat.Text).Trim();
Console.WriteLine($"\t\tContents of Cell:{k} = \"{cellText}\"");
}
Console.WriteLine($"\tEnd of Row {j}");
}
Console.WriteLine($"End of Table {i}\n");
}
Biçimlendirilmiş bir 2x2 tablonun nasıl oluşturulacağını gösterir.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();
builder.InsertCell();
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.Write("Row 1, cell 1.");
builder.InsertCell();
builder.Write("Row 1, cell 2.");
builder.EndRow();
// Tabloyu oluştururken belge oluşturucu mevcut RowFormat/CellFormat özellik değerlerini uygulayacaktır
// imlecin bulunduğu geçerli satıra/hücreye ve onları oluştururken yeni satırlara/hücrelere.
Assert.AreEqual(CellVerticalAlignment.Center, table.Rows[0].Cells[0].CellFormat.VerticalAlignment);
Assert.AreEqual(CellVerticalAlignment.Center, table.Rows[0].Cells[1].CellFormat.VerticalAlignment);
builder.InsertCell();
builder.RowFormat.Height = 100;
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 2, cell 1.");
builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 2, cell 2.");
builder.EndRow();
builder.EndTable();
// Önceden eklenen satırlar ve hücreler, oluşturucunun biçimlendirmesindeki değişikliklerden geriye dönük olarak etkilenmez.
Assert.AreEqual(0, table.Rows[0].RowFormat.Height);
Assert.AreEqual(HeightRule.Auto, table.Rows[0].RowFormat.HeightRule);
Assert.AreEqual(100, table.Rows[1].RowFormat.Height);
Assert.AreEqual(HeightRule.Exactly, table.Rows[1].RowFormat.HeightRule);
Assert.AreEqual(TextOrientation.Upward, table.Rows[1].Cells[0].CellFormat.Orientation);
Assert.AreEqual(TextOrientation.Downward, table.Rows[1].Cells[1].CellFormat.Orientation);
doc.Save(ArtifactsDir + "DocumentBuilder.BuildTable.docx");
Belge oluşturucu kullanmadan iç içe tablonun nasıl oluşturulacağını gösterir.
public void CreateNestedTable()
{
Document doc = new Document();
// Üç satır ve dört sütundan oluşan dış tabloyu oluşturup belgeye ekleyin.
Table outerTable = CreateTable(doc, 3, 4, "Outer Table");
doc.FirstSection.Body.AppendChild(outerTable);
// İki satır ve iki sütundan oluşan başka bir tablo oluşturun ve bunu ilk tablonun ilk hücresine ekleyin.
Table innerTable = CreateTable(doc, 2, 2, "Inner Table");
outerTable.FirstRow.FirstCell.AppendChild(innerTable);
doc.Save(ArtifactsDir + "Table.CreateNestedTable.docx");
}
/// <summary>
/// Her hücrede verilen boyut ve metinle belgede yeni bir tablo oluşturur.
/// </summary>
private static Table CreateTable(Document doc, int rowCount, int cellCount, string cellText)
{
Table table = new Table(doc);
for (int rowId = 1; rowId <= rowCount; rowId++)
{
Row row = new Row(doc);
table.AppendChild(row);
for (int cellId = 1; cellId <= cellCount; cellId++)
{
Cell cell = new Cell(doc);
cell.AppendChild(new Paragraph(doc));
cell.FirstParagraph.AppendChild(new Run(doc, cellText));
row.AppendChild(cell);
}
}
// Tablonuza sırasıyla başlık ve açıklama eklemek için "Başlık" ve "Açıklama" özelliklerini kullanabilirsiniz.
// Bu özellikleri kullanabilmemiz için tablonun en az bir satıra sahip olması gerekir.
// Bu özellikler ISO/IEC 29500 uyumlu .docx belgeleri için anlamlıdır (bkz. OoxmlCompliance sınıfı).
// Belgeyi ISO/IEC 29500 öncesi formatlarda kaydedersek, Microsoft Word bu özellikleri göz ardı eder.
table.Title = "Aspose table title";
table.Description = "Aspose table description";
return table;
}
Ayrıca bakınız
- class CompositeNode
- ad alanı Aspose.Words.Tables
- toplantı Aspose.Words