update example

Author: AnnaVekhina

CS/SpreadsheetExamples/Form1.cs

@@ -76,7 +76,7 @@ void InitData(GroupsOfSpreadsheetExamples examples) {
             examples[3].Groups.Add(new SpreadsheetExample("Shared and Array Formulas", FormulaActions.CreateSharedAndArrayFormulasAction));
 
             // Add nodes to the "Formatting" group of examples.
-            examples[4].Groups.Add(new SpreadsheetExample("Apply a Style", FormattingActions.ApplayStyleAction));
+            examples[4].Groups.Add(new SpreadsheetExample("Apply a Style", FormattingActions.ApplyStyleAction));
             examples[4].Groups.Add(new SpreadsheetExample("Create and Modify a Style", FormattingActions.CreateModifyStyleAction));
             examples[4].Groups.Add(new SpreadsheetExample("Individual Cell Formatting", FormattingActions.FormatCellAction));
             examples[4].Groups.Add(new SpreadsheetExample("Date Formats", FormattingActions.SetDateFormatsAction));

CS/SpreadsheetExamples/SpreadsheetActions/CellActions.cs

@@ -44,7 +44,7 @@ static void ChangeCellValue(Workbook workbook) {
             worksheet.Cells["B7"].Value = 'a';
             worksheet.Cells["B8"].Value = Int32.MaxValue;
 
-            // Fill all cells in the range with 10.
+            // Fill all cells in the "B10:E10" range with 10.
             worksheet.Range["B10:E10"].Value = 10;
             #endregion #CellValue
         }
@@ -81,8 +81,10 @@ static void SetValueFromText(IWorkbook workbook) {
                 worksheet.Cells["B8"].SetValueFromText("27-Jul-16 5:43PM", true);
                 worksheet.Cells["B9"].SetValueFromText("=SQRT(25)");
 
-                // Fill all cells in the range with 10.
-                worksheet.Range["C11:F11"].SetValueFromText("=B1");
+                // Apply the time display format to the "C11:F11" cell range.
+                worksheet.Range["C11:F11"].NumberFormat = "m/d/yy h:mm";
+                // Fill all cells in the "C11:F11" range with the "B1" cell value. 
+                worksheet.Range["C11:F11"].SetValueFromText("=B1", true);
                 #endregion #SetValueFromText
             }
             finally {
@@ -103,14 +105,15 @@ static void CreateNamedRange(Workbook workbook) {
 
             // Create a new defined name with the specifed range name and absolute reference.
             DefinedName definedName = worksheet.DefinedNames.Add("rangeB17D20", "Sheet1!$B$17:$D$20");
-            // Create a range using the specified defined name.
+            // Create a range and use the specified defined name.
             CellRange B17D20 = worksheet.Range[definedName.Name];
             #endregion #NamedRange
         }
 
         static void AddHyperlink(Workbook workbook) {
 
             Worksheet worksheet = workbook.Worksheets[0];
+            
             worksheet.Range["A:C"].ColumnWidthInCharacters = 12;
 
             #region #AddHyperlink
@@ -128,6 +131,7 @@ static void AddHyperlink(Workbook workbook) {
         static void CopyCellDataAndStyle(Workbook workbook) {
             #region #CopyCell
             Worksheet worksheet = workbook.Worksheets[0];
+            
             worksheet.Columns["A"].WidthInCharacters = 32;
             worksheet.Columns["B"].WidthInCharacters = 20;
             Style style = workbook.Styles[BuiltInStyleId.Input];
@@ -182,13 +186,12 @@ static void MergeAndSplitCells(Workbook workbook) {
             worksheet.Cells["C3"].FillColor = Color.LightSalmon;
 
             #region #MergeCells
-            // Merge cells contained in the range.
+            // Merge cells contained in the "A1:C5" range.
             worksheet.MergeCells(worksheet.Range["A1:C5"]);
             #endregion #MergeCells
         }
 
         static void ClearCells(Workbook workbook) {
-
             Worksheet worksheet = workbook.Worksheets[0];
 
             worksheet.Range["A:D"].ColumnWidthInCharacters = 30;

CS/SpreadsheetExamples/SpreadsheetActions/DocumentPropertiesActions.cs

@@ -69,10 +69,10 @@ static void CustomPropertiesValue(IWorkbook workbook)
                 #endregion #CustomProperties
 
                 #region #LinkToContent
-                //Define a name to the cell to be linked to the custom property
+                // Define a name to the cell linked to the custom property.
                 workbook.DefinedNames.Add("checked_by", "E6");
 
-                //Connect the custom property with the named cell
+                // Connect the custom property with the named cell.
                 workbook.DocumentProperties.Custom.LinkToContent("Checked by", "checked_by");
                 #endregion #LinkToContent
 

CS/SpreadsheetExamples/SpreadsheetActions/ExportActions.cs

@@ -19,6 +19,7 @@ static void ExportToPdf(Workbook workbook)
             workbook.Worksheets[0].Cells["D8"].Value = "This document is exported to the PDF format.";
 
             #region #ExportToPdf
+            // Export the workbook to PDF.
             using (FileStream pdfFileStream = new FileStream("Documents\\Document_PDF.pdf", FileMode.Create))
             {
                 workbook.ExportToPdf(pdfFileStream);

CS/SpreadsheetExamples/SpreadsheetActions/FormattingActions.cs

@@ -8,7 +8,7 @@
 namespace SpreadsheetExamples {
     public static class FormattingActions {
         #region Actions
-        public static Action<Workbook> ApplayStyleAction = ApplayStyle;
+        public static Action<Workbook> ApplyStyleAction = ApplyStyle;
         public static Action<Workbook> CreateModifyStyleAction = CreateModifyStyle;
         public static Action<Workbook> FormatCellAction = FormatCell;
         public static Action<Workbook> SetDateFormatsAction = SetDateFormats;
@@ -19,17 +19,17 @@ public static class FormattingActions {
         public static Action<Workbook> AddCellBordersAction = AddCellBorders;
         #endregion
 
-        static void ApplayStyle(Workbook workbook) {
+        static void ApplyStyle(Workbook workbook) {
             #region #ApplyCellStyle
             Worksheet worksheet = workbook.Worksheets[0];
 
             // Access the built-in "Good" MS Excel style from the Styles collection of the workbook.
             Style styleGood = workbook.Styles[BuiltInStyleId.Good];
 
-            // Apply the "Good" style to a range of cells.
+            // Apply the "Good" style to a cell range.
             worksheet.Range["A1:C4"].Style = styleGood;
 
-            // Access a custom style that has been previously created in the loaded document by its name.
+            // Access a previously created custom style by its name.
             Style customStyle = workbook.Styles["Custom Style"];
 
             // Apply the custom style to the cell.
@@ -45,19 +45,19 @@ static void ApplayStyle(Workbook workbook) {
 
         static void CreateModifyStyle(Workbook workbook) {
             #region #CreateNewStyle
-            // Add a new style under the "My Style" name to the Styles collection of the workbook.
+            // Add a new style under the "My Style" name to the workbook's Styles collection.
             Style myStyle = workbook.Styles.Add("My Style");
 
             // Specify formatting characteristics for the style.
             myStyle.BeginUpdate();
             try {
-                // Set the font color to Blue.
+                // Specify the font color.
                 myStyle.Font.Color = Color.Blue;
 
-                // Set the font size to 12.
+                // Specify the font size.
                 myStyle.Font.Size = 12;
 
-                // Set the horizontal alignment to Center.
+                // Specify the horizontal alignment.
                 myStyle.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Center;
 
                 // Set the background.
@@ -104,7 +104,7 @@ static void FormatCell(Workbook workbook) {
             worksheet.Range["C3:E6"].Value = "Test";
 
             #region #CellFormatting
-            // Access the cell to be formatted.
+            // Access the "B2" cell.
             Cell cell = worksheet.Cells["B2"];
 
             // Specify font settings (font name, color, size and style).
@@ -113,19 +113,19 @@ static void FormatCell(Workbook workbook) {
             cell.Font.Size = 14;
             cell.Font.FontStyle = SpreadsheetFontStyle.Bold;
 
-            // Specify cell background color.
+            // Specify the cell background color.
             cell.Fill.BackgroundColor = Color.LightSkyBlue;
 
-            // Specify text alignment in the cell. 
+            // Specify text alignment. 
             cell.Alignment.Vertical = SpreadsheetVerticalAlignment.Center;
             cell.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Center;
             #endregion #CellFormatting
 
             #region #RangeFormatting
-            // Access the range of cells to be formatted.
+            // Access the "C3:E6" cell range.
             CellRange range = worksheet.Range["C3:E6"];
 
-            // Begin updating of the range formatting. 
+            // Start to update the cell range formatting. 
             Formatting rangeFormatting = range.BeginUpdateFormatting();
 
             // Specify font settings (font name, color, size and style).
@@ -134,14 +134,14 @@ static void FormatCell(Workbook workbook) {
             rangeFormatting.Font.Size = 14;
             rangeFormatting.Font.FontStyle = SpreadsheetFontStyle.Bold;
 
-            // Specify cell background color.
+            // Specify the cell background color.
             rangeFormatting.Fill.BackgroundColor = Color.LightSkyBlue;
 
-            // Specify text alignment in cells.
+            // Specify text alignment.
             rangeFormatting.Alignment.Vertical = SpreadsheetVerticalAlignment.Center;
             rangeFormatting.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Center;
 
-            // End updating of the range formatting.
+            // Finalize to update the cell range formatting.
             range.EndUpdateFormatting(rangeFormatting);
             #endregion #RangeFormatting
         }
@@ -229,7 +229,7 @@ static void ChangeCellColors(Workbook workbook) {
             worksheet.Cells["A1"].Font.Color = Color.Red;
             worksheet.Cells["A1"].FillColor = Color.Yellow;
 
-            // Format a range of cells.
+            // Format a cell range.
             CellRange range = worksheet.Range["C3:D4"];
             Formatting rangeFormatting = range.BeginUpdateFormatting();
             rangeFormatting.Font.Color = Color.Blue;
@@ -250,15 +250,15 @@ static void SpecifyCellFont(Workbook workbook) {
             #region #FontSettings
             // Access the Font object.
             SpreadsheetFont cellFont = worksheet.Cells["A1"].Font;
-            // Set the font name.
+            // Specify the font name.
             cellFont.Name = "Times New Roman";
-            // Set the font size.
+            // Specify the font size.
             cellFont.Size = 14;
-            // Set the font color.
+            // Specify the font color.
             cellFont.Color = Color.Blue;
             // Format text as bold.
             cellFont.Bold = true;
-            // Set font to be underlined.
+            // Specify the font underline type.
             cellFont.UnderlineType = UnderlineType.Double;
             #endregion #FontSettings
         }
@@ -272,30 +272,36 @@ static void AlignCellContents(Workbook workbook) {
             range.RowHeight = 200;
 
             #region #AlignCellContents
+            // Align the "A1" cell content.
             Cell cellA1 = worksheet.Cells["A1"];
             cellA1.Value = "Right and top";
             cellA1.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Right;
             cellA1.Alignment.Vertical = SpreadsheetVerticalAlignment.Top;
 
+            // Align the "A2" cell content.
             Cell cellA2 = worksheet.Cells["A2"];
             cellA2.Value = "Center";
             cellA2.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Center;
             cellA2.Alignment.Vertical = SpreadsheetVerticalAlignment.Center;
 
+            // Align the "A3" cell content.
             Cell cellA3 = worksheet.Cells["A3"];
             cellA3.Value = "Left and bottom, indent";
             cellA3.Alignment.Indent = 1;
 
+            // Align the "B1" cell content.
             Cell cellB1 = worksheet.Cells["B1"];
             cellB1.Value = "The Alignment.ShrinkToFit property is applied";
             cellB1.Alignment.ShrinkToFit = true;
 
+            // Align the "B2" cell content.
             Cell cellB2 = worksheet.Cells["B2"];
             cellB2.Value = "Rotated Cell Contents";
             cellB2.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Center;
             cellB2.Alignment.Vertical = SpreadsheetVerticalAlignment.Center;
             cellB2.Alignment.RotationAngle = 15;
 
+            // Align the "B3" cell content.
             Cell cellB3 = worksheet.Cells["B3"];
             cellB3.Value = "The Alignment.WrapText property is applied to wrap the text within a cell";
             cellB3.Alignment.WrapText = true;
@@ -306,7 +312,7 @@ static void AddCellBorders(Workbook workbook) {
             #region #CellBorders
             Worksheet worksheet = workbook.Worksheets[0];
 
-            // Set each particular border for the cell.
+            // Specify borders for the "B2" cell.
             Cell cellB2 = worksheet.Cells["B2"];
             Borders cellB2Borders = cellB2.Borders;
             cellB2Borders.LeftBorder.LineStyle = BorderLineStyle.MediumDashDot;
@@ -321,27 +327,27 @@ static void AddCellBorders(Workbook workbook) {
             cellB2Borders.DiagonalBorderLineStyle = BorderLineStyle.Thick;
             cellB2Borders.DiagonalBorderColor = Color.Red;
 
-            // Set diagonal borders for the cell.
+            // Specify diagonal borders for the "C4" cell.
             Cell cellC4 = worksheet.Cells["C4"];
             Borders cellC4Borders = cellC4.Borders;
             cellC4Borders.SetDiagonalBorders(Color.Orange, BorderLineStyle.Double, DiagonalBorderType.UpAndDown);
 
-            // Set all outside borders for the cell in one step. 
+            // Specify outside borders for the "D6" cell. 
             Cell cellD6 = worksheet.Cells["D6"];
             cellD6.Borders.SetOutsideBorders(Color.Gold, BorderLineStyle.Double);
             #endregion #CellBorders
 
             #region #CellRangeBorders
-            // Set all borders for the range of cells in one step.
+            // Specify all borders for the "B8:F13" cell range.
             CellRange range1 = worksheet.Range["B8:F13"];
             range1.Borders.SetAllBorders(Color.Green, BorderLineStyle.Double);
 
-            // Set all inside and outside borders separately for the range of cells.
+            // Specify inside and outside borders for the "C15:F18" cell range.
             CellRange range2 = worksheet.Range["C15:F18"];
             range2.SetInsideBorders(Color.SkyBlue, BorderLineStyle.MediumDashed);
             range2.Borders.SetOutsideBorders(Color.DeepSkyBlue, BorderLineStyle.Medium);
 
-            // Set all horizontal and vertical borders separately for the range of cells.
+            // Specify horizontal and vertical borders for the "D21:F23" cell range.
             CellRange range3 = worksheet.Range["D21:F23"];
             Formatting range3Formatting = range3.BeginUpdateFormatting();
             Borders range3Borders = range3Formatting.Borders;
@@ -351,7 +357,7 @@ static void AddCellBorders(Workbook workbook) {
             range3Borders.InsideVerticalBorders.Color = Color.Blue;
             range3.EndUpdateFormatting(range3Formatting);
 
-            // Set each particular border for the range of cell. 
+            // Specify borders for the "E25:F26" cell range. 
             CellRange range4 = worksheet.Range["E25:F26"];
             Formatting range4Formatting = range4.BeginUpdateFormatting();
             Borders range4Borders = range4Formatting.Borders;