/// <summary>
/// Method to insert a basic table
/// Will honour the existing table if passed in
/// </summary>
private void ProcessTable(mshtmlTable table, HtmlTableProperty tableProperties)
{
try
{
// obtain a reference to the body node and indicate table present
mshtmlDomNode bodyNode = (mshtmlDomNode)document.body;
bool tableCreated = false;
// ensure a table node has been defined to work with
if (table == null)
{
// create the table and indicate it was created
table = (mshtmlTable)document.createElement(TABLE_TAG);
tableCreated = true;
}
// define the table border, width, cell padding and spacing
table.border = tableProperties.BorderSize;
if (tableProperties.TableWidth > 0) table.width = (tableProperties.TableWidthMeasurement == MeasurementOption.Pixel) ? string.Format("{0}", tableProperties.TableWidth) : string.Format("{0}%", tableProperties.TableWidth);
else table.width = string.Empty;
if (tableProperties.TableAlignment != HorizontalAlignOption.Default) table.align = tableProperties.TableAlignment.ToString().ToLower();
else table.align = string.Empty;
table.cellPadding = tableProperties.CellPadding.ToString();
table.cellSpacing = tableProperties.CellSpacing.ToString();
// define the given table caption and alignment
string caption = tableProperties.CaptionText;
mshtmlTableCaption tableCaption = table.caption;
if (caption != null && caption != string.Empty)
{
// ensure table caption correctly defined
if (tableCaption == null) tableCaption = table.createCaption();
((mshtmlElement)tableCaption).innerText = caption;
if (tableProperties.CaptionAlignment != HorizontalAlignOption.Default) tableCaption.align = tableProperties.CaptionAlignment.ToString().ToLower();
if (tableProperties.CaptionLocation != VerticalAlignOption.Default) tableCaption.vAlign = tableProperties.CaptionLocation.ToString().ToLower();
}
else
{
// if no caption specified remove the existing one
if (tableCaption != null)
{
// prior to deleting the caption the contents must be cleared
((mshtmlElement)tableCaption).innerText = null;
table.deleteCaption();
}
}
// determine the number of rows one has to insert
int numberRows, numberCols;
if (tableCreated)
{
numberRows = Math.Max((int)tableProperties.TableRows, 1);
}
else
{
numberRows = Math.Max((int)tableProperties.TableRows, 1) - (int)table.rows.length;
}
// layout the table structure in terms of rows and columns
table.cols = (int)tableProperties.TableColumns;
if (tableCreated)
{
// this section is an optimization based on creating a new table
// the section below works but not as efficiently
numberCols = Math.Max((int)tableProperties.TableColumns, 1);
// insert the appropriate number of rows
mshtmlTableRow tableRow;
for (int idxRow = 0; idxRow < numberRows; idxRow++)
{
tableRow = (mshtmlTableRow)table.insertRow(-1);
// add the new columns to the end of each row
for (int idxCol = 0; idxCol < numberCols; idxCol++)
{
tableRow.insertCell(-1);
}
}
}
else
{
// if the number of rows is increasing insert the decrepency
if (numberRows > 0)
{
// insert the appropriate number of rows
for (int idxRow = 0; idxRow < numberRows; idxRow++)
{
table.insertRow(-1);
}
}
else
{
// remove the extra rows from the table
for (int idxRow = numberRows; idxRow < 0; idxRow++)
{
table.deleteRow(table.rows.length - 1);
}
}
// have the rows constructed
// now ensure the columns are correctly defined for each row
mshtmlElementCollection rows = table.rows;
foreach (mshtmlTableRow tableRow in rows)
{
numberCols = Math.Max((int)tableProperties.TableColumns, 1) - (int)tableRow.cells.length;
if (numberCols > 0)
{
// add the new column to the end of each row
for (int idxCol = 0; idxCol < numberCols; idxCol++)
{
tableRow.insertCell(-1);
}
}
else
{
// reduce the number of cells in the given row
// remove the extra rows from the table
for (int idxCol = numberCols; idxCol < 0; idxCol++)
{
tableRow.deleteCell(tableRow.cells.length - 1);
}
}
}
}
// if the table was created then it requires insertion into the DOM
// otherwise property changes are sufficient
if (tableCreated)
{
// table processing all complete so insert into the DOM
mshtmlDomNode tableNode = (mshtmlDomNode)table;
mshtmlElement tableElement = (mshtmlElement)table;
mshtmlSelection selection = document.selection;
mshtmlTextRange textRange = GetTextRange();
// final insert dependant on what user has selected
if (textRange != null)
{
// text range selected so overwrite with a table
try
{
string selectedText = textRange.text;
if (selectedText != null)
{
// place selected text into first cell
mshtmlTableRow tableRow = (mshtmlTableRow)table.rows.item(0, null);
((mshtmlElement)tableRow.cells.item(0, null)).innerText = selectedText;
}
textRange.pasteHTML(tableElement.outerHTML);
}
catch (Exception ex)
{
throw new HtmlEditorException("Invalid Text selection for the Insertion of a Table.", "ProcessTable", ex);
}
}
else
{
mshtmlControlRange controlRange = GetAllControls();
if (controlRange != null)
{
// overwrite any controls the user has selected
try
{
// clear the selection and insert the table
// only valid if multiple selection is enabled
for (int idx = 1; idx < controlRange.length; idx++)
{
controlRange.remove(idx);
}
controlRange.item(0).outerHTML = tableElement.outerHTML;
// this should work with initial count set to zero
// controlRange.add((mshtmlControlElement)table);
}
catch (Exception ex)
{
throw new HtmlEditorException("Cannot Delete all previously Controls selected.", "ProcessTable", ex);
}
}
else
{
// insert the table at the end of the HTML
bodyNode.appendChild(tableNode);
}
}
}
else
{
// table has been correctly defined as being the first selected item
// need to remove other selected items
mshtmlControlRange controlRange = GetAllControls();
if (controlRange != null)
{
// clear the controls selected other than than the first table
// only valid if multiple selection is enabled
for (int idx = 1; idx < controlRange.length; idx++)
{
controlRange.remove(idx);
}
}
}
}
catch (Exception ex)
{
// throw an exception indicating table structure change error
throw new HtmlEditorException("Unable to modify Html Table properties.", "ProcessTable", ex);
}
}
/// <summary>
/// Given an Html Table Element determines the table properties
/// Returns the properties as an HtmlTableProperty class
/// </summary>
private HtmlTableProperty GetTableProperties(mshtmlTable table)
{
// define a set of base table properties
HtmlTableProperty tableProperties = new HtmlTableProperty(true);
// if user has selected a table extract those properties
if (table != null)
{
try
{
// have a table so extract the properties
mshtmlTableCaption caption = table.caption;
// if have a caption persist the values
if (caption != null)
{
tableProperties.CaptionText = ((mshtmlElement)table.caption).innerText;
if (caption.align != null) tableProperties.CaptionAlignment = (HorizontalAlignOption)TryParseEnum(typeof(HorizontalAlignOption), caption.align, HorizontalAlignOption.Default);
if (caption.vAlign != null) tableProperties.CaptionLocation = (VerticalAlignOption)TryParseEnum(typeof(VerticalAlignOption), caption.vAlign, VerticalAlignOption.Default);
}
// look at the table properties
if (table.border != null) tableProperties.BorderSize = TryParseByte(table.border.ToString(), tableProperties.BorderSize);
if (table.align != null) tableProperties.TableAlignment = (HorizontalAlignOption)TryParseEnum(typeof(HorizontalAlignOption), table.align, HorizontalAlignOption.Default);
// define the table rows and columns
int rows = Math.Min(table.rows.length, Byte.MaxValue);
int cols = Math.Min(table.cols, Byte.MaxValue);
if (cols == 0 && rows > 0)
{
// cols value not set to get the maxiumn number of cells in the rows
foreach (mshtmlTableRow tableRow in table.rows)
{
cols = Math.Max(cols, (int)tableRow.cells.length);
}
}
tableProperties.TableRows = (byte)Math.Min(rows, byte.MaxValue);
tableProperties.TableColumns = (byte)Math.Min(cols, byte.MaxValue);
// define the remaining table properties
if (table.cellPadding != null) tableProperties.CellPadding = TryParseByte(table.cellPadding.ToString(), tableProperties.CellPadding);
if (table.cellSpacing != null) tableProperties.CellSpacing = TryParseByte(table.cellSpacing.ToString(), tableProperties.CellSpacing);
if (table.width != null)
{
string tableWidth = table.width.ToString();
if (tableWidth.TrimEnd(null).EndsWith("%"))
{
tableProperties.TableWidth = TryParseUshort(tableWidth.Remove(tableWidth.LastIndexOf("%"), 1), tableProperties.TableWidth);
tableProperties.TableWidthMeasurement = MeasurementOption.Percent;
}
else
{
tableProperties.TableWidth = TryParseUshort(tableWidth, tableProperties.TableWidth);
tableProperties.TableWidthMeasurement = MeasurementOption.Pixel;
}
}
else
{
tableProperties.TableWidth = 0;
tableProperties.TableWidthMeasurement = MeasurementOption.Pixel;
}
}
catch (Exception ex)
{
// throw an exception indicating table structure change be determined
throw new HtmlEditorException("Unable to determine Html Table properties.", "GetTableProperties", ex);
}
}
// return the table properties
return tableProperties;
}
/// <summary>
/// Method to create a table class
/// Insert method then works on this table
/// </summary>
public void TableInsert(HtmlTableProperty tableProperties)
{
// call the private insert table method with a null table entry
ProcessTable(null, tableProperties);
}
/// <summary>
/// Method to modify a tables properties
/// Ensure a table is currently selected or insertion point is within a table
/// </summary>
public bool TableModify(HtmlTableProperty tableProperties)
{
// define the Html Table element
mshtmlTable table = GetTableElement();
// if a table has been selected then process
if (table != null)
{
ProcessTable(table, tableProperties);
return true;
}
else
{
return false;
}
}
/// <summary>
/// Method to return a table defintion based on the user selection
/// If table selected (or insertion point within table) returns these values
/// </summary>
public void GetTableDefinition(out HtmlTableProperty table, out bool tableFound)
{
// see if a table selected or insertion point inside a table
mshtmlTable htmlTable = GetTableElement();
// process according to table being defined
if (htmlTable == null)
{
table = new HtmlTableProperty(true);
tableFound = false;
}
else
{
table = GetTableProperties(htmlTable);
tableFound = true;
}
}