com.aspose.words
Class TextColumnCollection

java.lang.Object
    extended by 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.

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

To make all columns equal width and spaced evenly, set EvenlySpaced to true and specify the amount of space between the columns in Spacing. MS Word will automatically calculate column widths.

If you have EvenlySpaced 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.

See Also:
PageSetup, Section

Property Getters/Setters Summary
intgetCount()
           Gets the number of columns in the section of a document.
booleangetEvenlySpaced()
voidsetEvenlySpaced(boolean value)
          True if text columns are of equal width and evenly spaced.
booleangetLineBetween()
voidsetLineBetween(boolean value)
           When true, adds a vertical line between columns.
doublegetSpacing()
voidsetSpacing(double value)
           When columns are evenly spaced, gets or sets the amount of space between each column in points.
doublegetWidth()
           When columns are evenly spaced, gets the width of the columns.
TextColumnget(int index)
           Returns a text column at the specified index.
 
Method Summary
voidsetCount(int newCount)
           Arranges text into the specified number of text columns.
 

Property Getters/Setters Detail

getCount

public int getCount()
Gets the number of columns in the section of a document.

getEvenlySpaced/setEvenlySpaced

public boolean getEvenlySpaced() / public void setEvenlySpaced(boolean value)
True if text columns are of equal width and evenly spaced.

Example:

Creates multiple columns of different widths in a section using DocumentBuilder.
DocumentBuilder builder = new DocumentBuilder();

TextColumnCollection columns = builder.getPageSetup().getTextColumns();
// Show vertical line between columns.
columns.setLineBetween(true);
// Indicate we want to create column with different widths.
columns.setEvenlySpaced(false);
// Create two columns, note they will be created with zero widths, need to set them.
columns.setCount(2);

// Set the first column to be narrow.
TextColumn c1 = columns.get(0);
c1.setWidth(100);
c1.setSpaceAfter(20);

// Set the second column to take the rest of the space available on the page.
TextColumn c2 = columns.get(1);
PageSetup ps = builder.getPageSetup();
double contentWidth = ps.getPageWidth() - ps.getLeftMargin() - ps.getRightMargin();
c2.setWidth(contentWidth - c1.getWidth() - c1.getSpaceAfter());

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

builder.getDocument().save(getMyDir() + "PageSetup.ColumnsCustomWidth Out.doc");

getLineBetween/setLineBetween

public boolean getLineBetween() / public void setLineBetween(boolean value)
When true, adds a vertical line between columns.

Example:

Creates multiple columns of different widths in a section using DocumentBuilder.
DocumentBuilder builder = new DocumentBuilder();

TextColumnCollection columns = builder.getPageSetup().getTextColumns();
// Show vertical line between columns.
columns.setLineBetween(true);
// Indicate we want to create column with different widths.
columns.setEvenlySpaced(false);
// Create two columns, note they will be created with zero widths, need to set them.
columns.setCount(2);

// Set the first column to be narrow.
TextColumn c1 = columns.get(0);
c1.setWidth(100);
c1.setSpaceAfter(20);

// Set the second column to take the rest of the space available on the page.
TextColumn c2 = columns.get(1);
PageSetup ps = builder.getPageSetup();
double contentWidth = ps.getPageWidth() - ps.getLeftMargin() - ps.getRightMargin();
c2.setWidth(contentWidth - c1.getWidth() - c1.getSpaceAfter());

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

builder.getDocument().save(getMyDir() + "PageSetup.ColumnsCustomWidth Out.doc");

getSpacing/setSpacing

public double getSpacing() / public void setSpacing(double value)
When columns are evenly spaced, gets or sets the amount of space between each column in points. Has effect only when EvenlySpaced is set to true.

getWidth

public double getWidth()
When columns are evenly spaced, gets the width of the columns.

Has effect only when EvenlySpaced is set to true.


get

public TextColumn get(int index)
Returns a text column at the specified index.

Example:

Creates multiple columns of different widths in a section using DocumentBuilder.
DocumentBuilder builder = new DocumentBuilder();

TextColumnCollection columns = builder.getPageSetup().getTextColumns();
// Show vertical line between columns.
columns.setLineBetween(true);
// Indicate we want to create column with different widths.
columns.setEvenlySpaced(false);
// Create two columns, note they will be created with zero widths, need to set them.
columns.setCount(2);

// Set the first column to be narrow.
TextColumn c1 = columns.get(0);
c1.setWidth(100);
c1.setSpaceAfter(20);

// Set the second column to take the rest of the space available on the page.
TextColumn c2 = columns.get(1);
PageSetup ps = builder.getPageSetup();
double contentWidth = ps.getPageWidth() - ps.getLeftMargin() - ps.getRightMargin();
c2.setWidth(contentWidth - c1.getWidth() - c1.getSpaceAfter());

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

builder.getDocument().save(getMyDir() + "PageSetup.ColumnsCustomWidth Out.doc");

Method Detail

setCount

public void setCount(int newCount)
Arranges text into the specified number of text columns.

When EvenlySpaced 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.

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

See Also:
          Aspose.Words Documentation - the home page for the Aspose.Words Product Documentation.
          Aspose.Words Support Forum - our preferred method of support.