com.aspose.words

Class TextColumnCollection

java.lang.Object

com.aspose.words.TextColumnCollection

public class TextColumnCollection
extends java.lang.Object

A collection of TextColumn objects that represent all the columns of text in a section of a document.

To learn more, visit the Working with Sections documentation article.

Remarks:

Use setCount(int) to set the number of text columns.

To make all columns equal width and spaced evenly, set getEvenlySpaced() / setEvenlySpaced(boolean) to true and specify the amount of space between the columns in getSpacing() / setSpacing(double). MS Word will automatically calculate column widths.

If you have getEvenlySpaced() / setEvenlySpaced(boolean) set to false, you need to specify width and spacing for each column individually. Use the indexer to access individual TextColumn objects.

When using custom column widths, make sure the sum of all column widths and spacings between them equals page width minus left and right page margins.

Examples:

Shows how to create multiple evenly spaced columns in a section.

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

 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setSpacing(100.0);
 columns.setCount(2);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");

 doc.save(getArtifactsDir() + "PageSetup.ColumnsSameWidth.docx");
 
 

See Also:

PageSetup, Section

Method Summary

Modifier and Type	Method and Description
TextColumn	get(int index) Returns a text column at the specified index.
int	getCount() Gets the number of columns in the section of a document.
boolean	getEvenlySpaced() True if text columns are of equal width and evenly spaced.
boolean	getLineBetween() When true, adds a vertical line between columns.
double	getSpacing() When columns are evenly spaced, gets or sets the amount of space between each column in points.
double	getWidth() When columns are evenly spaced, gets the width of the columns.
void	setCount(int newCount) Arranges text into the specified number of text columns.
void	setEvenlySpaced(boolean value) True if text columns are of equal width and evenly spaced.
void	setLineBetween(boolean value) When true, adds a vertical line between columns.
void	setSpacing(double value) When columns are evenly spaced, gets or sets the amount of space between each column in points.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setCount

public void setCount(int newCount)

Arranges text into the specified number of text columns.

Remarks:

When getEvenlySpaced() / setEvenlySpaced(boolean) is false and you increase the number of columns, new TextColumn objects are created with zero width and spacing. You need to set width and spacing for the new columns.

Examples:

Shows how to create multiple evenly spaced columns in a section.

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

 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setSpacing(100.0);
 columns.setCount(2);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");

 doc.save(getArtifactsDir() + "PageSetup.ColumnsSameWidth.docx");
 
 

Parameters:

newCount - The number of columns the text is to be arranged into.

getEvenlySpaced

public boolean getEvenlySpaced()

True if text columns are of equal width and evenly spaced.

Examples:

Shows how to create unevenly spaced columns.

 
 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);
 PageSetup pageSetup = builder.getPageSetup();

 TextColumnCollection columns = pageSetup.getTextColumns();
 columns.setEvenlySpaced(false);
 columns.setCount(2);

 // Determine the amount of room that we have available for arranging columns.
 double contentWidth = pageSetup.getPageWidth() - pageSetup.getLeftMargin() - pageSetup.getRightMargin();

 Assert.assertEquals(468.0d, contentWidth, 0.01d);

 // Set the first column to be narrow.
 TextColumn column = columns.get(0);
 column.setWidth(100.0);
 column.setSpaceAfter(20.0);

 // Set the second column to take the rest of the space available within the margins of the page.
 column = columns.get(1);
 column.setWidth(contentWidth - column.getWidth() - column.getSpaceAfter());

 builder.writeln("Narrow column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Wide column 2.");

 doc.save(getArtifactsDir() + "PageSetup.CustomColumnWidth.docx");
 
 

Returns:

The corresponding boolean value.

setEvenlySpaced

public void setEvenlySpaced(boolean value)

True if text columns are of equal width and evenly spaced.

Examples:

Shows how to create unevenly spaced columns.

 
 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);
 PageSetup pageSetup = builder.getPageSetup();

 TextColumnCollection columns = pageSetup.getTextColumns();
 columns.setEvenlySpaced(false);
 columns.setCount(2);

 // Determine the amount of room that we have available for arranging columns.
 double contentWidth = pageSetup.getPageWidth() - pageSetup.getLeftMargin() - pageSetup.getRightMargin();

 Assert.assertEquals(468.0d, contentWidth, 0.01d);

 // Set the first column to be narrow.
 TextColumn column = columns.get(0);
 column.setWidth(100.0);
 column.setSpaceAfter(20.0);

 // Set the second column to take the rest of the space available within the margins of the page.
 column = columns.get(1);
 column.setWidth(contentWidth - column.getWidth() - column.getSpaceAfter());

 builder.writeln("Narrow column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Wide column 2.");

 doc.save(getArtifactsDir() + "PageSetup.CustomColumnWidth.docx");
 
 

Parameters:

value - The corresponding boolean value.

getSpacing

public double getSpacing()

When columns are evenly spaced, gets or sets the amount of space between each column in points.

Remarks:

Has effect only when getEvenlySpaced() / setEvenlySpaced(boolean) is set to true.

Examples:

Shows how to create multiple evenly spaced columns in a section.

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

 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setSpacing(100.0);
 columns.setCount(2);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");

 doc.save(getArtifactsDir() + "PageSetup.ColumnsSameWidth.docx");
 
 

Returns:

The corresponding double value.

setSpacing

public void setSpacing(double value)

When columns are evenly spaced, gets or sets the amount of space between each column in points.

Remarks:

Has effect only when getEvenlySpaced() / setEvenlySpaced(boolean) is set to true.

Examples:

Shows how to create multiple evenly spaced columns in a section.

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

 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setSpacing(100.0);
 columns.setCount(2);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");

 doc.save(getArtifactsDir() + "PageSetup.ColumnsSameWidth.docx");
 
 

Parameters:

value - The corresponding double value.

getWidth

public double getWidth()

When columns are evenly spaced, gets the width of the columns.

Remarks:

Has effect only when getEvenlySpaced() / setEvenlySpaced(boolean) is set to true.

Examples:

Shows how to create multiple evenly spaced columns in a section.

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

 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setSpacing(100.0);
 columns.setCount(2);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");

 doc.save(getArtifactsDir() + "PageSetup.ColumnsSameWidth.docx");
 
 

Returns:

The corresponding double value.

getLineBetween

public boolean getLineBetween()

When true, adds a vertical line between columns.

Examples:

Shows how to separate columns with a vertical line.

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

 // Configure the current section's PageSetup object to divide the text into several columns.
 // Set the "LineBetween" property to "true" to put a dividing line between columns.
 // Set the "LineBetween" property to "false" to leave the space between columns blank.
 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setLineBetween(lineBetween);
 columns.setCount(3);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 3.");

 doc.save(getArtifactsDir() + "PageSetup.VerticalLineBetweenColumns.docx");
 
 

Returns:

The corresponding boolean value.

setLineBetween

public void setLineBetween(boolean value)

When true, adds a vertical line between columns.

Examples:

Shows how to separate columns with a vertical line.

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

 // Configure the current section's PageSetup object to divide the text into several columns.
 // Set the "LineBetween" property to "true" to put a dividing line between columns.
 // Set the "LineBetween" property to "false" to leave the space between columns blank.
 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setLineBetween(lineBetween);
 columns.setCount(3);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 3.");

 doc.save(getArtifactsDir() + "PageSetup.VerticalLineBetweenColumns.docx");
 
 

Parameters:

value - The corresponding boolean value.

getCount

public int getCount()

Gets the number of columns in the section of a document.

Examples:

Shows how to create multiple evenly spaced columns in a section.

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

 TextColumnCollection columns = builder.getPageSetup().getTextColumns();
 columns.setSpacing(100.0);
 columns.setCount(2);

 builder.writeln("Column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Column 2.");

 doc.save(getArtifactsDir() + "PageSetup.ColumnsSameWidth.docx");
 
 

Returns:

The number of columns in the section of a document.

get

public TextColumn get(int index)

Returns a text column at the specified index.

Examples:

Shows how to create unevenly spaced columns.

 
 Document doc = new Document();
 DocumentBuilder builder = new DocumentBuilder(doc);
 PageSetup pageSetup = builder.getPageSetup();

 TextColumnCollection columns = pageSetup.getTextColumns();
 columns.setEvenlySpaced(false);
 columns.setCount(2);

 // Determine the amount of room that we have available for arranging columns.
 double contentWidth = pageSetup.getPageWidth() - pageSetup.getLeftMargin() - pageSetup.getRightMargin();

 Assert.assertEquals(468.0d, contentWidth, 0.01d);

 // Set the first column to be narrow.
 TextColumn column = columns.get(0);
 column.setWidth(100.0);
 column.setSpaceAfter(20.0);

 // Set the second column to take the rest of the space available within the margins of the page.
 column = columns.get(1);
 column.setWidth(contentWidth - column.getWidth() - column.getSpaceAfter());

 builder.writeln("Narrow column 1.");
 builder.insertBreak(BreakType.COLUMN_BREAK);
 builder.writeln("Wide column 2.");

 doc.save(getArtifactsDir() + "PageSetup.CustomColumnWidth.docx");
 
 

Returns:

A text column at the specified index.