Interface IWSection

Represents a section.

Inherited Members

ICompositeEntity.ChildEntities

IEntity.Document

IEntity.EntityType

IEntity.IsComposite

IEntity.NextSibling

IEntity.Owner

IEntity.PreviousSibling

Namespace: Syncfusion.DocIO.DLS

Assembly: Syncfusion.DocIO.Base.dll

Syntax

public interface IWSection : ICompositeEntity, IEntity

Properties

Body

Gets the section body. Read-only.

Declaration

WTextBody Body { get; }

Property Value

Type	Description
WTextBody	The WTextBody of the current section.

BreakCode

Gets or sets section break code of the current section.

Declaration

SectionBreakCode BreakCode { get; set; }

Property Value

Type	Description
SectionBreakCode	The SectionBreakCode member that specifies the break code.

Columns

Gets the collection of columns which logically divide page on many printing or publishing areas. Read-only.

Declaration

ColumnCollection Columns { get; }

Property Value

Type	Description
ColumnCollection	The collection of columns in the section.

HeadersFooters

Gets headers and footers of the current section. Read-only.

Declaration

WHeadersFooters HeadersFooters { get; }

Property Value

Type	Description
WHeadersFooters	The WHeadersFooters instance that specifies current section header, footer.

PageSetup

Gets the page setup of the current section. Read-only.

Declaration

WPageSetup PageSetup { get; }

Property Value

Type	Description
WPageSetup	The WPageSetup of the current section.

Paragraphs

Gets the paragraphs in the current section. Read-only.

Declaration

IWParagraphCollection Paragraphs { get; }

Property Value

Type	Description
IWParagraphCollection	The IWParagraphCollection that represents the collection of IWParagraph in the section.

ProtectForm

Gets or sets a value indicating whether to allow editing of form fields in the section.

Declaration

bool ProtectForm { get; set; }

Property Value

Type	Description
System.Boolean	True if to allow editing of form fields; otherwise, false.

Tables

Gets the tables in the current section. Read-only.

Declaration

IWTableCollection Tables { get; }

Property Value

Type	Description
IWTableCollection	The IWTableCollection that represents the collection of IWTable in the section.

Methods

AddColumn(Single, Single)

Adds a new Column to the section.

Declaration

Column AddColumn(float width, float spacing)

Parameters

Type	Name	Description
System.Single	width	The float that specifies the width of the column.
System.Single	spacing	The float that specifies the spacing between the columns.

Returns

Type	Description
Column	The reference to the newly added Column object.

Examples

The following example illustrates how to have multiple columns in a section.

private void Button1_Click(System.Object sender, System.EventArgs e)
{
    //Create a new Word document
    WordDocument document = new WordDocument();
    //Add the section into Word document
    IWSection section = document.AddSection();
    //Add the column into the section
    section.AddColumn(150, 20);
    //Add the column into the section
    section.AddColumn(150, 20);
    //Add the column into the section
    section.AddColumn(150, 20);
    //Add a paragraph to created section
    IWParagraph paragraph = section.AddParagraph();
    //Add a paragraph to created section
    paragraph = section.AddParagraph();
     paragraph.Text = "Lorem ipsum dolor sit amet, lacus amet amet ultricies. Quisque mi venenatis morbi libero, orci dis, mi ut et class porta, massa ligula magna enim, aliquam orci vestibulum Turpis facilisis vitae consequat, cum a a,turpis dui consequat massa in dolor per, felis non amet.Auctor eleifend in omnis elit vestibulum, donec non elementum tellus est mauris, id aliquam, at lacus, arcu pretium proin lacus dolor et. Eu tortor, vel ultrices amet dignissim mauris vehicula";
    //Append the text to the created paragraph
    paragraph.AppendText(paragraph.Text);
    //Add the column breaks
    paragraph.AppendBreak(BreakType.ColumnBreak);
    //Add a paragraph to created section
    paragraph = section.AddParagraph();
    //Append the text to the created paragraph
    paragraph.AppendText(paragraph.Text);
    //Add the column breaks
    paragraph.AppendBreak(BreakType.ColumnBreak);
    //Add a paragraph to created section
    paragraph = section.AddParagraph();
    //Append the text to the created paragraph
    paragraph.AppendText(paragraph.Text);
    //Save and close the Word document instance
    document.Save("Sample.docx", FormatType.Docx);
    document.Close();
}

Private Sub button_Click(sender As Object, e As EventArgs)
    'Create a new Word document
    Dim document As New WordDocument()
    'Add the section into Word document
    Dim section As IWSection = document.AddSection()
    'Add the column into the section
    section.AddColumn(150, 20)
    'Add the column into the section
    section.AddColumn(150, 20)
    'Add the column into the section
    section.AddColumn(150, 20)
    'Add a paragraph to created section
    Dim paragraph As IWParagraph = section.AddParagraph()
    'Add a paragraph to created section
    paragraph = section.AddParagraph()
    Dim paraText As String = "Lorem ipsum dolor sit amet, lacus amet amet ultricies. Quisque mi venenatis morbi libero, orci dis, mi ut et class porta, massa ligula magna enim, aliquam orci vestibulum Turpis facilisis vitae consequat, cum a a,turpis dui consequat massa in dolor per, felis non amet.Auctor eleifend in omnis elit vestibulum, donec non elementum tellus est mauris, id aliquam, at lacus, arcu pretium proin lacus dolor et. Eu tortor, vel ultrices amet dignissim mauris vehicula"
    'Append the text to the created paragraph
    paragraph.AppendText(paraText)
    'Add the column breaks
    paragraph.AppendBreak(BreakType.ColumnBreak)
    'Add a paragraph to created section
    paragraph = section.AddParagraph()
    'Append the text to the created paragraph
    paragraph.AppendText(paraText)
    'Add the column breaks
    paragraph.AppendBreak(BreakType.ColumnBreak)
    'Add a paragraph to created section
    paragraph = section.AddParagraph()
    'Append the text to the created paragraph
    paragraph.AppendText(paraText)
    'Save and close the Word document instance
    document.Save("Sample.docx", FormatType.Docx)
    document.Close()
End Sub

AddParagraph()

Adds the IWParagraph to the section body.

Declaration

IWParagraph AddParagraph()

Returns

Type	Description
IWParagraph	The reference to the newly created paragraph.

Examples

The following example illustrates how to add a paragraph to the section.

private void Button1_Click(System.Object sender, System.EventArgs e)
{
    //Create a new Word document 
    WordDocument document = new WordDocument();
    //Gets the first section in the document
    IWSection section = document.AddSection();
    //Add new paragraph to the section
    IWParagraph paragraph = section.AddParagraph();
    paragraph.AppendText("First paragraph in section");
    //Save and close the document
    document.Save("Sample.docx", FormatType.Docx);
    document.Close();
}

Private Sub button_Click(sender As Object, e As EventArgs)
    'Create a new Word document 
    Dim document As New WordDocument()
    'Gets the first section in the document
    Dim section As IWSection = document.AddSection()
    'Add new paragraph to the section
    Dim paragraph As IWParagraph = section.AddParagraph()
    paragraph.AppendText("First paragraph in section")
    'Save and close the document
    document.Save("Sample.docx", FormatType.Docx)
    document.Close()
End Sub

AddTable()

Adds the IWTable to the section body.

Declaration

IWTable AddTable()

Returns

Type	Description
IWTable	The reference to the newly created table.

Examples

The following example illustrates how to add a table to the section.

private void Button1_Click(System.Object sender, System.EventArgs e)
{
    //Create a new Word document 
    WordDocument document = new WordDocument();
    //Gets the first section in the document
    IWSection section = document.AddSection();
    //Add new table to the section
    IWTable table = section.AddTable();
    //Set rows and columns count
    table.ResetCells(2, 2);
    //Add contents to the table
    IWParagraph paragraph = table[0, 0].AddParagraph();
    paragraph.AppendText("Apple");
    paragraph = table[0, 1].AddParagraph();
    paragraph.AppendText("Red");
    paragraph = table[1, 0].AddParagraph();
    paragraph.AppendText("Banana");
    paragraph = table[1, 1].AddParagraph();
    paragraph.AppendText("Yellow");
    //Save and close the document
    document.Save("Sample.docx", FormatType.Docx);
    document.Close();
}

Private Sub button_Click(sender As Object, e As EventArgs)
    'Create a new Word document 
    Dim document As New WordDocument()
    'Gets the first section in the document
    Dim section As IWSection = document.AddSection()
    'Add new table to the section
    Dim table As IWTable = section.AddTable()
    'Set rows and columns count
    table.ResetCells(2, 2)
    'Add contents to the table
    Dim paragraph As IWParagraph = table(0, 0).AddParagraph()
    paragraph.AppendText("Apple")
    paragraph = table(0, 1).AddParagraph()
    paragraph.AppendText("Red")
    paragraph = table(1, 0).AddParagraph()
    paragraph.AppendText("Banana")
    paragraph = table(1, 1).AddParagraph()
    paragraph.AppendText("Yellow")
    'Save and close the document
    document.Save("Sample.docx", FormatType.Docx)
    document.Close()
End Sub

Clone()

Clones the WSection, creates a duplicate copy.

Declaration

WSection Clone()

Returns

Type	Description
WSection	The cloned WSection object.

MakeColumnsEqual()

Makes all columns in the current section to be of equal width.

Declaration

void MakeColumnsEqual()

Examples

The following example illustrates how to have make the columns to be of equal width in a section.

private void Button1_Click(System.Object sender, System.EventArgs e)
{
    //Create a new Word document 
    WordDocument document = new WordDocument("Sample.docx");
    //Gets the first section in the document
    IWSection section = document.Sections[0];
    //Make the columns to be of equal width
    section.MakeColumnsEqual();
    //Save and close the document
    document.Save("Result.docx", FormatType.Docx);
    document.Close();
}

Private Sub button_Click(sender As Object, e As EventArgs)
    'Create a new Word document 
    Dim document As New WordDocument("Sample.docx")
    'Gets the first section in the document
    Dim section As IWSection = document.Sections(0)
    'Make the columns to be of equal width
    section.MakeColumnsEqual()
    'Save and close the document
    document.Save("Result.docx", FormatType.Docx)
    document.Close()
End Sub