diff --git a/libraries/radpdfprocessing/editing/table/overview.md b/libraries/radpdfprocessing/editing/table/overview.md index 6a591674..056fd336 100644 --- a/libraries/radpdfprocessing/editing/table/overview.md +++ b/libraries/radpdfprocessing/editing/table/overview.md @@ -31,8 +31,7 @@ If you are new to the document editors, start with the editor choice in this art ## Defining Table Content -Each `Table` contains a collection of [TableRow]({%slug radpdfprocessing-editing-table-tablerow%}) instances, and each row contains a collection of [TableCell]({%slug radpdfprocessing-editing-table-tablecell%}) instances. In practice, the workflow is straightforward: -to create a simple table, add the required cells and then assign content to each cell. +Each `Table` contains a collection of [TableRow]({%slug radpdfprocessing-editing-table-tablerow%}) instances, and each row contains a collection of [TableCell]({%slug radpdfprocessing-editing-table-tablecell%}) instances. To create a table, add the required cells and then assign content to each cell. 1. Create a `Table` instance. 2. Add rows and cells. @@ -141,7 +140,7 @@ Example 7 creates a simple table with two cells. **Example 8** inserts the table from **Example 7** in a `RadFixedDocumentEditor` and specifies the table layout type to `AutoFit`. -#### **Example 8: Insert `AutoFit` table** +### Example 8: Insert an AutoFit Table @@ -201,24 +200,19 @@ Starting with **Q3 2024**, RadPdfProcessing supports the `Dotted`, `Dashed`, and | `Dashed` | ![Preview of a dashed PDF table border](images/pdf-dashed-border.png) | | `DashSmallGap` | ![Preview of a dash-small-gap PDF table border](images/pdf-dash-small-gap-border.png) | -## Typical Next Steps +## Next Steps Continue with the article that matches your next task: -1. Use [TableRow]({%slug radpdfprocessing-editing-table-tablerow%}) and [TableCell]({%slug radpdfprocessing-editing-table-tablecell%}) when you want to customize row-level or cell-level behavior. -2. Review [Generating a Table with RadFixedDocumentEditor]({%slug generate-table-with-radfixeddocumenteditor%}) for a focused document-editor workflow. -3. Review [Creating Custom Layout Tables with RadPdfProcessing]({%slug customize-table-layout-radpdfprocessing%}) if you need more advanced layout control. -4. Use [Avoiding Table Splits Across Pages Using FixedContentEditor in RadPdfProcessing]({%slug avoid-table-splits-across-pages-radpdfprocessing%}) when page breaking is the main concern. +* [TableRow]({%slug radpdfprocessing-editing-table-tablerow%}) and [TableCell]({%slug radpdfprocessing-editing-table-tablecell%})—Customize row-level or cell-level behavior +* [Generating a Table with RadFixedDocumentEditor]({%slug generate-table-with-radfixeddocumenteditor%})—Follow a focused document-editor workflow +* [Creating Custom Layout Tables with RadPdfProcessing]({%slug customize-table-layout-radpdfprocessing%})—Apply more advanced layout control +* [Avoiding Table Splits Across Pages Using FixedContentEditor in RadPdfProcessing]({%slug avoid-table-splits-across-pages-radpdfprocessing%})—Handle page-breaking scenarios ## See Also * [FixedContentEditor]({%slug radpdfprocessing-editing-fixedcontenteditor%}) * [RadFixedDocumentEditor]({%slug radpdfprocessing-editing-radfixeddocumenteditor%}) -* [TableRow]({%slug radpdfprocessing-editing-table-tablerow%}) -* [TableCell]({%slug radpdfprocessing-editing-table-tablecell%}) * [How to Generate a Table with Images with PdfProcessing]({%slug generate-table-with-images-pdf-processing%}) -* [Creating Custom Layout Tables with RadPdfProcessing]({%slug customize-table-layout-radpdfprocessing%}) * [Implementing Column Span in RadPdfProcessing Tables]({%slug table-column-span-radpdfprocessing%}) -* [Generating a Table with RadFixedDocumentEditor]({%slug generate-table-with-radfixeddocumenteditor%}) -* [Avoiding Table Splits Across Pages Using FixedContentEditor in RadPdfProcessing]({%slug avoid-table-splits-across-pages-radpdfprocessing%}) * [How to Achieve Alternating Row Color for Tables in PdfProcessing]({%slug alternating-row-color-in-pdf-tables%}) diff --git a/libraries/radspreadprocessing/overview.md b/libraries/radspreadprocessing/overview.md index f1d0d1a1..e9c1a17b 100644 --- a/libraries/radspreadprocessing/overview.md +++ b/libraries/radspreadprocessing/overview.md @@ -1,7 +1,7 @@ --- title: Overview -description: RadSpreadProcessing is a cross-platform library for creating, importing, and exporting spreadsheet documents in XLSX, CSV, TXT, and PDF formats with support for 200+ functions. -page_title: Overview +description: Learn about RadSpreadProcessing, a cross-platform library for creating, importing, and exporting XLSX, CSV, TXT, and PDF spreadsheets. +page_title: RadSpreadProcessing Library Overview slug: radspreadprocessing-overview tags: spread, processing, spreadsheet, excel, xlsx, csv, pdf, import, export published: True @@ -12,36 +12,23 @@ position: 0 **Telerik SpreadProcessing Library** allows you to generate and convert documents to XLSX, CSV, TXT, and PDF. **RadSpreadProcessing** ships with built-in support for the computation of more than 200 functions, like SUM, AVERAGE, and more. You can create spreadsheets from scratch, modify existing documents or convert between the most common spreadsheet formats. You can save the generated workbook to a local file, stream, or stream it to the client browser. -![SpreadProcessing](images/spread-processing-overview.jpg) +![Diagram showing RadSpreadProcessing converting between XLSX, CSV, and TXT formats](images/spread-processing-overview.jpg) -In this article, we list the library's most popular features. If you want to start using the library right away, see [Getting Started with RadSpreadProcessing]({%slug radspreadprocessing-getting-started%}). +This article lists the most popular features of the library. To start using RadSpreadProcessing right away, see [Getting Started with RadSpreadProcessing]({%slug radspreadprocessing-getting-started%}). -![Rad Spread Processing Overview 01](images/RadSpreadProcessing_Overview_01.png) +![A sample spreadsheet showing a Monthly Report with product data in columns for ID, Product, and Quantity](images/RadSpreadProcessing_Overview_01.png) >note If you still do not have **Telerik Document Processing installed**, check the **[First Steps]({%slug getting-started-first-steps%})** topic to learn how to obtain the packages through the different suites with Telerik controls. ## Key Features -* Create from scratch and modify existing documents from spreadsheet formats: XLSX and CSV. -* Export to PDF. -* Convert between the different formats. -* Extract and populate cells with data. -* Built-in support for computation of more than 200 functions, like SUM, AVERAGE, and more. -* Add custom functions as well. -* Protection from editing operations using passwords or removing such passwords. -* Most of the important Excel features are supported: - * Data validation - restrict the types of input to cells (for example, allow only numbers). - * Grouping to organize data (for example, collapse some rows/columns). - * Filtering, sorting, freeze panes, hidden rows, and more. -* GenAI-powered Document Insights - The following table describes the most popular features of the `RadSpreadProcessing` library. | Feature | Description | |---------|-------------| | [**Shapes and Images**]({%slug radspreadprocessing-features-shapes-and-images%}) | API for insertion, positioning and deletion of images in worksheets. Starting with Q3 2024, RadSpreadProcessing provides support for SVG FormSource (vector graphics image format). | | [**Charts**]({%slug radspreadprocessing-features-charts%}) | Add, remove and manipulate chart objects in your spreadsheet documents. | -| [**Conditional Formatting**]({%slug radspreadprocessing-features-conditional-formatting%}) |Make it easy to analyze data, find critical issues, patterns and trends by representing the data inside in a user-friendly manner. | +| [**Conditional Formatting**]({%slug radspreadprocessing-features-conditional-formatting%}) | Make it easy to analyze data, find critical issues, patterns and trends by representing the data inside in a user-friendly manner. | | [**Hyperlinks**]({%slug radspreadprocessing-features-hyperlink%}) | The API enables you to add, remove, edit and search for hyperlinks in the worksheets of the document. | | [**Workbook Protection**]({%slug radspreadprocessing-features-protection-workbook%}) | Prevents the users from modifying the workbook by adding, removing, renaming or reordering sheets. | | [**Worksheet protection**]({%slug radspreadprocessing-features-protection-worksheet%}) | Restricts the user from modifying the content and structure of the worksheet. Additionally, the model offers protection options that let you choose a set of commands that will be available to the user when protection is enabled. | @@ -52,11 +39,11 @@ The following table describes the most popular features of the `RadSpreadProcess | [**Theming**]({%slug radspreadprocessing-features-styling-document-themes%}) | The document model comes with predefined themes called Document themes. They enable you to specify colors, fonts and a variety of graphic effects in a document and affect the look and feel of the whole workbook. | | [**Resizing**]({%slug radspreadprocessing-working-with-rows-and-columns-resizing%}) | Auto fit or resize rows and columns. | | [**Number Formats**]({%slug radspreadprocessing-features-number-formats%}) | Enable you to format the data in the cells so it can be easily readable. The document model exposes the following categories of predefined formats: **General**, **Number**, **Currency**, **Accounting**, **Date**, **Time**, **Percentage**, **Fraction**, **Scientific**, **Text**, **Special** and also allows you to create **custom** formats. | -| **Copy/Paste** | Add or [copy worksheets]({%slug radspreadprocessing-working-with-worksheets-copy-worksheet%}) within or across workbooks. Of course, [copying and pasting of cells]({%slug radspreadprocessing-features-clipboard-support%}) is supported as well. | +| **Copy/Paste** | Add or [copy worksheets]({%slug radspreadprocessing-working-with-worksheets-copy-worksheet%}) within or across workbooks. [Copying and pasting of cells]({%slug radspreadprocessing-features-clipboard-support%}) is also supported. | | [**Data Validation**]({%slug radspreadprocessing-features-data-validation%}) | Enables you to control the type of data or the values that users enter into a cell. Different data validation rules are available, including list, number, date, text length or custom rules. | | [**Filtering**]({%slug radspreadprocessing-features-filtering%}) | Filter worksheet data. | | [**Sorting**]({%slug radspreadprocessing-features-sorting%}) | Sort data in the worksheet. | -| [**Find and replace data**]({%slug radspreadprocessing-features-find-and-replace%}). | Find, find all, replace and replace all functionalities | +| [**Find and replace data**]({%slug radspreadprocessing-features-find-and-replace%}) | Find, find all, replace and replace all functionalities. | | [**Freeze Panes**]({%slug radspreadprocessing-features-freeze-panes%}) | Keep part of the worksheet visible at all times when scrolling. | | [**Hidden rows and columns**]({%slug radspreadprocessing-working-with-rows-and-columns-hiding%}) | The API of the workbook model allows you to set the hidden state of each row or column. | | [**Merge and unmerge cells**]({%slug radspreadprocessing-features-merge-unmerge-cells%}) | You have the ability to merge two or more adjacent cells into a single cell that spans over multiple rows and columns. | diff --git a/libraries/radspreadprocessing/working-with-cells/what-is-cell.md b/libraries/radspreadprocessing/working-with-cells/what-is-cell.md index ecaa8de4..d83960c6 100644 --- a/libraries/radspreadprocessing/working-with-cells/what-is-cell.md +++ b/libraries/radspreadprocessing/working-with-cells/what-is-cell.md @@ -1,7 +1,7 @@ --- title: What is a Cell? -description: Learn about the concept of cells in RadSpreadProcessing worksheets, including their structure and properties. -page_title: What is a Cell? +description: Learn how RadSpreadProcessing models worksheet cells, what data and formatting each cell stores, and which cell APIs to use next. +page_title: RadSpreadProcessing Worksheet Cell Overview slug: radspreadprocessing-working-with-cells-what-is-cell tags: cells, spreadsheet, radspreadprocessing, worksheet, model, concept, structure, properties, xlsx, spread published: True @@ -10,38 +10,52 @@ position: 0 # What is a Cell? +A cell is the smallest addressable unit in a RadSpreadProcessing worksheet. Use this article to understand how cells are identified, what information they store, and which related APIs and articles help you start working with them. +## Cell Addresses -Cells are the basic data units in a worksheet. The following sections describe the structure and characteristics of cells in the document model. - +A worksheet organizes cells into rows and columns. Each cell sits at the intersection of one row and one column and has a unique address in A1 notation. -## What is a Cell? +For example, `A1` identifies the top-left cell in the worksheet, while `XFD1048576` identifies the last possible cell in an Excel-compatible worksheet. These addresses are useful when you read formulas, reason about ranges, or follow examples elsewhere in the documentation. -A cell is the basic data unit in a worksheet. Cells are organized in rows and columns and can also be referred to as an intersection point of a column and a row. Cells are identified by a letter and number combination that indicates the letter of their column and the number of their row. For example, the top left cell is referred to as `A1` and the bottom right cell is `XFD1048576`. - +When you need to work with a single cell or a range of cells in code, continue with [Accessing Cells of a Worksheet]({%slug radspreadprocessing-working-with-cells-accessing-cells-of-worksheet%}). -## What Are Its Characteristics? +## Cell Content and Properties -Cells have the following characteristics: - +A cell can hold both data and the settings that control how that data appears. In practice, a cell commonly includes the following parts: -* **Value and Formatting**: A cell serves as a storage unit in a worksheet and you can assign any text, number, Boolean, or formula value to it. Additionally, you can style each cell with various fonts, font sizes, fore and background colors, bold, italics, and underline. Cells also support horizontal and vertical text alignment, indentation, and text rotation settings. - +* Value data such as text, numbers, Boolean values, dates, or formulas. +* Formatting such as fonts, number formats, foreground and background colors, bold, italic, and underline. +* Layout settings such as horizontal and vertical alignment, text wrapping, indentation, and text rotation. +* Border and fill settings that control how the cell is outlined and shaded. -* **Fill**: You can style cells with pattern fills with various colors and pattern styles. The model also supports gradient fills that allow you to specify two colors and choose between six shading styles. - +Cells can start empty and still carry formatting or other properties. When a cell contains a formula, the stored formula text and the displayed result are not always the same value. For details about supported value types and how the `Value` property behaves, see [Cell Value Types]({%slug radspreadprocessing-working-with-cells-cell-value-types%}). -* **Borders**: Each cell can have left, right, top, bottom, and diagonal borders or any combination of these. Additionally, the borders can appear with different styles and colors. - +## Cell Behavior in a Worksheet -* **Text Wrap**: The text wrapping option formats the cell so that its contained text appears on multiple lines. - +Cells participate in worksheet operations that affect one cell, many cells, or an entire range. The most common behaviors include: -* **Copy and Paste**: The document model allows you to copy the contents of an arbitrary region of cells and choose the data and formatting to include in the paste region. The model supports seven types of special paste options: All, Formulas, Formulas and Number Formatting, Column Widths, Values, Values and Number Formatting, and Formatting. For more information on the copy/paste feature, see the [Clipboard Support]({%slug radspreadprocessing-features-clipboard-support%}) article. - +* Copying and pasting data, formulas, formatting, or column widths. For more information, see [Clipboard Support]({%slug radspreadprocessing-features-clipboard-support%}). +* Filling neighboring cells automatically with repeated, linear, exponential, date-based, or autofill series. For more information, see [Fill Data Automatically]({%slug radspreadprocessing-features-fill-data-automatically-repeat-values%}). +* Merging adjacent cells into a single visual region and unmerging them later. For more information, see [Merge and Unmerge Cells]({%slug radspreadprocessing-features-merge-unmerge-cells%}). +* Reading, setting, and clearing properties through `CellSelection`, which is the main API surface for working with one cell or many cells together. -* **Fill Data Automatically**: The document model helps you fill the contents of a specified set of cells automatically based on some initial values. You can repeat or construct linear, exponential, date, and auto fill data series. For more information, see the [Fill Data Automatically]({%slug radspreadprocessing-features-fill-data-automatically-repeat-values%}) section. - +This behavior matters because many RadSpreadProcessing APIs work with selections and ranges rather than with a standalone cell object. If your next task is to read or update content, formatting, or other properties, start with [Get, Set and Clear Cell Properties]({%slug radspreadprocessing-working-with-cells-get-set-clear-properties%}). + +## Next Steps + +Continue with the article that matches your next task: + +* [Accessing Cells of a Worksheet]({%slug radspreadprocessing-working-with-cells-accessing-cells-of-worksheet%})—Access a single cell or a range of cells in code +* [Cell Value Types]({%slug radspreadprocessing-working-with-cells-cell-value-types%})—Understand supported data types and formula values +* [Get, Set and Clear Cell Properties]({%slug radspreadprocessing-working-with-cells-get-set-clear-properties%})—Read or update formatting and other cell properties +* [Fill Data Automatically]({%slug radspreadprocessing-features-fill-data-automatically-repeat-values%})—Populate neighboring cells with repeated or sequential data +* [Merge and Unmerge Cells]({%slug radspreadprocessing-features-merge-unmerge-cells%})—Combine adjacent cells into a single visual region + +## See Also + +* [Accessing Cells of a Worksheet]({%slug radspreadprocessing-working-with-cells-accessing-cells-of-worksheet%}) +* [Cell Value Types]({%slug radspreadprocessing-working-with-cells-cell-value-types%}) +* [Get, Set and Clear Cell Properties]({%slug radspreadprocessing-working-with-cells-get-set-clear-properties%}) +* [Clipboard Support]({%slug radspreadprocessing-features-clipboard-support%}) -* **Merge and Unmerge**: You can merge adjacent cells so that they appear as one. A single cell can span over several rows or columns. For more information, refer to the [Merge and Unmerge Cells]({%slug radspreadprocessing-features-merge-unmerge-cells%}) article. - diff --git a/libraries/radspreadprocessing/working-with-rows-and-columns/what-is-row-column.md b/libraries/radspreadprocessing/working-with-rows-and-columns/what-is-row-column.md index 6fe0bfab..6a0322dd 100644 --- a/libraries/radspreadprocessing/working-with-rows-and-columns/what-is-row-column.md +++ b/libraries/radspreadprocessing/working-with-rows-and-columns/what-is-row-column.md @@ -1,7 +1,7 @@ --- title: What is a Row? What is a Column? -description: Learn about the concepts of rows and columns in RadSpreadProcessing spreadsheet worksheets, including height, width, and auto fit options. -page_title: What is a Row? What is a Column? +description: Learn how RadSpreadProcessing models rows and columns, including addressing, height, width, and auto-fit sizing options. +page_title: RadSpreadProcessing Rows and Columns Overview slug: radspreadprocessing-working-with-rows-and-columns-what-is-row-column tags: rows, columns, spreadsheet, radspreadprocessing, worksheet, model, concept, structure, xlsx, spread, workbook published: True @@ -10,17 +10,17 @@ position: 0 # What is a Row? What is a Column? +Rows and columns are the structural units of every RadSpreadProcessing worksheet. Use this article to understand how rows and columns are identified, what sizing options they provide, and which related APIs help you work with them in code. +## Row and Column Addressing -The following sections describe the concepts of rows and columns in the RadSpreadProcessing document model. +A worksheet organizes cells into rows and columns. **Rows** are groups of cells on the same horizontal line. Each row is identified by a number - the first row has index 1 and the last row is 1048576. -## What is a Row? What is a Column? +**Columns** are groups of cells stacked on the same vertical line. Each column is identified by a letter or combination of letters - the first column is A and the last column is XFD. -**Rows** in the document model of `RadSpreadProcessing` are groups of cells that are on the same **horizontal line**. Each row is identified by a number. For example, the first row has an index 1, the second is 2, and the last is 1048576. +A cell sits at the intersection of one row and one column, and its address combines the column letter and row number. For example, `B3` refers to the cell in column B, row 3. -Similarly, a **column** is a group of cells that are vertically stacked and appear on the same **vertical line**. Columns in `RadSpreadProcessing` are identified by a letter or a combination of letters. For example, the first column is called A, the second is B, and the last column is XFD. - -![Rows and columns in a spreadsheet](images/RowAndColumn.png) +![A spreadsheet grid showing labeled rows (numbers on the left) and columns (letters at the top)](images/RowAndColumn.png) ## Row Height @@ -32,14 +32,20 @@ Rows offer several approaches for determining their height: | Height | Allows you to make a given set of rows appear with a fixed height. | | Auto Fit | Sets the height of a specific row based on the content of all cells in the row. The height is determined by the cell with the tallest content. | -Similarly, columns expose several ways to set their width: +## Column Width + +Columns offer several approaches for determining their width: | Option | Description | |---|---| | Default Width | Each column has a default width of 65. When the column does not have an explicit width set, it appears with its default width. | | Width | Allows you to make a given set of columns appear with a fixed width. | | Auto Fit | Sets the width of a specified column based on the content of all cells in the column. The width is determined by the cell with the widest content. | - -For more information about setting row height and column width, see the [Resizing Rows and Columns]({%slug radspreadprocessing-working-with-rows-and-columns-resizing%}) article. - +For more information about setting row height and column width, see [Resizing Rows and Columns]({%slug radspreadprocessing-working-with-rows-and-columns-resizing%}). + +## See Also + +* [Insert and Remove Rows and Columns]({%slug radspreadprocessing-working-with-rows-and-columns-insert-and-remove%}) +* [Resizing Rows and Columns]({%slug radspreadprocessing-working-with-rows-and-columns-resizing%}) +* [Hidden Rows and Columns]({%slug radspreadprocessing-working-with-rows-and-columns-hiding%})