// ________________________________________________________________
/// This sample function modifies cells and cell ranges.
public void doSampleFunction()
{
// for common usage
unoidl.com.sun.star.sheet.XSpreadsheet xSheet = getSpreadsheet(0);
unoidl.com.sun.star.beans.XPropertySet xPropSet = null;
unoidl.com.sun.star.table.XCell xCell = null;
unoidl.com.sun.star.table.XCellRange xCellRange = null;
// *** Access and modify a VALUE CELL ***
Console.WriteLine("*** Sample for service table.Cell ***");
xCell = xSheet.getCellByPosition(0, 0);
// Set cell value.
xCell.setValue(1234);
// Get cell value.
double nDblValue = xCell.getValue() * 2;
xSheet.getCellByPosition(0, 1).setValue(nDblValue);
// *** Create a FORMULA CELL and query error type ***
xCell = xSheet.getCellByPosition(0, 2);
// Set formula string.
xCell.setFormula("=1/0");
// Get error type.
bool bValid = (xCell.getError() == 0);
// Get formula string.
String aText = "The formula " + xCell.getFormula() + " is ";
aText += bValid ? "valid." : "erroneous.";
// *** Insert a TEXT CELL using the XText interface ***
xCell = xSheet.getCellByPosition(0, 3);
unoidl.com.sun.star.text.XText xCellText =
(unoidl.com.sun.star.text.XText)xCell;
unoidl.com.sun.star.text.XTextCursor xTextCursor =
xCellText.createTextCursor();
xCellText.insertString(xTextCursor, aText, false);
// *** Change cell properties ***
int nValue = bValid ? 0x00FF00 : 0xFF4040;
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)xCell;
xPropSet.setPropertyValue(
"CellBackColor", new uno.Any((Int32)nValue));
// *** Accessing a CELL RANGE ***
Console.WriteLine("*** Sample for service table.CellRange ***");
// Accessing a cell range over its position.
xCellRange = xSheet.getCellRangeByPosition(2, 0, 3, 1);
// Change properties of the range.
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)xCellRange;
xPropSet.setPropertyValue(
"CellBackColor", new uno.Any((Int32)0x8080FF));
// Accessing a cell range over its name.
xCellRange = xSheet.getCellRangeByName("C4:D5");
// Change properties of the range.
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)xCellRange;
xPropSet.setPropertyValue(
"CellBackColor", new uno.Any((Int32)0xFFFF80));
// *** Using the CELL CURSOR to add some data below of
// the filled area ***
Console.WriteLine("*** Sample for service table.CellCursor ***");
// Create a cursor using the XSpreadsheet method createCursorByRange()
xCellRange = xSheet.getCellRangeByName("A1");
unoidl.com.sun.star.sheet.XSheetCellRange xSheetCellRange =
(unoidl.com.sun.star.sheet.XSheetCellRange)xCellRange;
unoidl.com.sun.star.sheet.XSheetCellCursor xSheetCellCursor =
xSheet.createCursorByRange(xSheetCellRange);
unoidl.com.sun.star.table.XCellCursor xCursor =
(unoidl.com.sun.star.table.XCellCursor)xSheetCellCursor;
// Move to the last filled cell.
xCursor.gotoEnd();
// Move one row down.
xCursor.gotoOffset(0, 1);
xCursor.getCellByPosition(0, 0).setFormula(
"Beyond of the last filled cell.");
// *** Modifying COLUMNS and ROWS ***
Console.WriteLine("*** Sample for services table.TableRows and " +
"table.TableColumns ***");
unoidl.com.sun.star.table.XColumnRowRange xCRRange =
(unoidl.com.sun.star.table.XColumnRowRange)xSheet;
unoidl.com.sun.star.table.XTableColumns xColumns =
xCRRange.getColumns();
unoidl.com.sun.star.table.XTableRows xRows = xCRRange.getRows();
// Get column C by index (interface XIndexAccess).
uno.Any aColumnObj = xColumns.getByIndex(2);
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)aColumnObj.Value;
xPropSet.setPropertyValue("Width", new uno.Any((Int32)5000));
// Get the name of the column.
unoidl.com.sun.star.container.XNamed xNamed =
(unoidl.com.sun.star.container.XNamed)aColumnObj.Value;
aText = "The name of this column is " + xNamed.getName() + ".";
xSheet.getCellByPosition(2, 2).setFormula(aText);
// Get column D by name (interface XNameAccess).
unoidl.com.sun.star.container.XNameAccess xColumnsName =
(unoidl.com.sun.star.container.XNameAccess)xColumns;
aColumnObj = xColumnsName.getByName("D");
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)aColumnObj.Value;
xPropSet.setPropertyValue(
"IsVisible", new uno.Any((Boolean)false));
// Get row 7 by index (interface XIndexAccess)
uno.Any aRowObj = xRows.getByIndex(6);
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)aRowObj.Value;
xPropSet.setPropertyValue("Height", new uno.Any((Int32)5000));
xSheet.getCellByPosition(2, 6).setFormula("What a big cell.");
// Create a cell series with the values 1 ... 7.
for (int nRow = 8; nRow < 15; ++nRow)
{
xSheet.getCellByPosition(0, nRow).setValue(nRow - 7);
}
// Insert a row between 1 and 2
xRows.insertByIndex(9, 1);
// Delete the rows with the values 3 and 4.
xRows.removeByIndex(11, 2);
// *** Inserting CHARTS ***
Console.WriteLine("*** Sample for service table.TableCharts ***");
unoidl.com.sun.star.table.XTableChartsSupplier xChartsSupp =
(unoidl.com.sun.star.table.XTableChartsSupplier)xSheet;
unoidl.com.sun.star.table.XTableCharts xCharts =
xChartsSupp.getCharts();
// The chart will base on the last cell series, initializing all values.
String aName = "newChart";
unoidl.com.sun.star.awt.Rectangle aRect =
new unoidl.com.sun.star.awt.Rectangle();
aRect.X = 10000;
aRect.Y = 3000;
aRect.Width = aRect.Height = 5000;
unoidl.com.sun.star.table.CellRangeAddress[] aRanges =
new unoidl.com.sun.star.table.CellRangeAddress[1];
aRanges[0] = createCellRangeAddress(xSheet, "A9:A14");
// Create the chart.
xCharts.addNewByName(aName, aRect, aRanges, false, false);
// Get the chart by name.
uno.Any aChartObj = xCharts.getByName(aName);
unoidl.com.sun.star.table.XTableChart xChart =
(unoidl.com.sun.star.table.XTableChart)aChartObj.Value;
// Query the state of row and column headers.
aText = "Chart has column headers: ";
aText += xChart.getHasColumnHeaders() ? "yes" : "no";
xSheet.getCellByPosition(2, 8).setFormula(aText);
aText = "Chart has row headers: ";
aText += xChart.getHasRowHeaders() ? "yes" : "no";
xSheet.getCellByPosition(2, 9).setFormula(aText);
}
/** All samples regarding the service com.sun.star.sheet.SheetCellRange. */
public void doCellRangeSamples()
{
unoidl.com.sun.star.sheet.XSpreadsheet xSheet = getSpreadsheet(0);
unoidl.com.sun.star.table.XCellRange xCellRange = null;
unoidl.com.sun.star.beans.XPropertySet xPropSet = null;
unoidl.com.sun.star.table.CellRangeAddress aRangeAddress = null;
// Preparation
setFormula(xSheet, "B5", "First cell");
setFormula(xSheet, "B6", "Second cell");
// Get cell range B5:B6 by position - (column, row, column, row)
xCellRange = xSheet.getCellRangeByPosition(1, 4, 1, 5);
// --- Change cell range properties. ---
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)xCellRange;
// from com.sun.star.styles.CharacterProperties
xPropSet.setPropertyValue(
"CharColor", new uno.Any((Int32)0x003399));
xPropSet.setPropertyValue(
"CharHeight", new uno.Any((Single)20.0));
// from com.sun.star.styles.ParagraphProperties
xPropSet.setPropertyValue(
"ParaLeftMargin", new uno.Any((Int32)500));
// from com.sun.star.table.CellProperties
xPropSet.setPropertyValue(
"IsCellBackgroundTransparent", new uno.Any(false));
xPropSet.setPropertyValue(
"CellBackColor", new uno.Any((Int32)0x99CCFF));
// --- Replace text in all cells. ---
unoidl.com.sun.star.util.XReplaceable xReplace =
(unoidl.com.sun.star.util.XReplaceable)xCellRange;
unoidl.com.sun.star.util.XReplaceDescriptor xReplaceDesc =
xReplace.createReplaceDescriptor();
xReplaceDesc.setSearchString("cell");
xReplaceDesc.setReplaceString("text");
// property SearchWords searches for whole cells!
xReplaceDesc.setPropertyValue("SearchWords", new uno.Any(false));
int nCount = xReplace.replaceAll(xReplaceDesc);
// --- Merge cells. ---
xCellRange = xSheet.getCellRangeByName("F3:G6");
prepareRange(xSheet, "E1:H7", "XMergeable");
unoidl.com.sun.star.util.XMergeable xMerge =
(unoidl.com.sun.star.util.XMergeable)xCellRange;
xMerge.merge(true);
// --- Column properties. ---
xCellRange = xSheet.getCellRangeByName("B1");
unoidl.com.sun.star.table.XColumnRowRange xColRowRange =
(unoidl.com.sun.star.table.XColumnRowRange)xCellRange;
unoidl.com.sun.star.table.XTableColumns xColumns =
xColRowRange.getColumns();
uno.Any aColumnObj = xColumns.getByIndex(0);
xPropSet = (unoidl.com.sun.star.beans.XPropertySet)aColumnObj.Value;
xPropSet.setPropertyValue("Width", new uno.Any((Int32)6000));
unoidl.com.sun.star.container.XNamed xNamed =
(unoidl.com.sun.star.container.XNamed)aColumnObj.Value;
// --- Cell range data ---
prepareRange(xSheet, "A9:C30", "XCellRangeData");
xCellRange = xSheet.getCellRangeByName("A10:C30");
unoidl.com.sun.star.sheet.XCellRangeData xData =
(unoidl.com.sun.star.sheet.XCellRangeData)xCellRange;
uno.Any [][] aValues =
{
new uno.Any [] { new uno.Any("Name"),
new uno.Any("Fruit"),
new uno.Any("Quantity") },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Apples"),
new uno.Any((Double)3.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Oranges"),
new uno.Any((Double)7.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Apples"),
new uno.Any((Double)3.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Apples"),
new uno.Any((Double)9.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Apples"),
new uno.Any((Double)5.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Oranges"),
new uno.Any((Double)6.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Oranges"),
new uno.Any((Double)3.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Apples"),
new uno.Any((Double)8.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Oranges"),
new uno.Any((Double)1.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Oranges"),
new uno.Any((Double)2.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Oranges"),
new uno.Any((Double)7.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Apples"),
new uno.Any((Double)1.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Apples"),
new uno.Any((Double)8.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Oranges"),
new uno.Any((Double)8.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Apples"),
new uno.Any((Double)7.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Apples"),
new uno.Any((Double)1.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Oranges"),
new uno.Any((Double)9.0) },
new uno.Any [] { new uno.Any("Bob"),
new uno.Any("Oranges"),
new uno.Any((Double)3.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Oranges"),
new uno.Any((Double)4.0) },
new uno.Any [] { new uno.Any("Alice"),
new uno.Any("Apples"),
new uno.Any((Double)9.0) }
};
xData.setDataArray(aValues);
// --- Get cell range address. ---
unoidl.com.sun.star.sheet.XCellRangeAddressable xRangeAddr =
(unoidl.com.sun.star.sheet.XCellRangeAddressable)xCellRange;
aRangeAddress = xRangeAddr.getRangeAddress();
// --- Sheet operation. ---
// uses the range filled with XCellRangeData
unoidl.com.sun.star.sheet.XSheetOperation xSheetOp =
(unoidl.com.sun.star.sheet.XSheetOperation)xData;
double fResult = xSheetOp.computeFunction(
unoidl.com.sun.star.sheet.GeneralFunction.AVERAGE);
// --- Fill series ---
// Prepare the example
setValue(xSheet, "E10", 1);
setValue(xSheet, "E11", 4);
setDate(xSheet, "E12", 30, 1, 2002);
setFormula(xSheet, "I13", "Text 10");
setFormula(xSheet, "E14", "Jan");
setValue(xSheet, "K14", 10);
setValue(xSheet, "E16", 1);
setValue(xSheet, "F16", 2);
setDate(xSheet, "E17", 28, 2, 2002);
setDate(xSheet, "F17", 28, 1, 2002);
setValue(xSheet, "E18", 6);
setValue(xSheet, "F18", 4);
}
