XL.Sheet.GetText
----------------

Queries the text of a sheet in a workbook.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [XL](component_XL.md) | [3.5](newinversion35.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "XL.Sheet.GetText"; BookRef; Index { ; Flags } ) 

**MBS**( **"XL.Sheet.GetText";** /\* Queries the text of a sheet in a workbook. \*/  
**$BookRef**; /\* The reference number for the workbook.e.g. $ref \*/   
**$Index**; /\* The index of the sheet you want to query text. Value can be 0 to [XL.Book.SheetCount](XLBookSheetCount.md)-1. \*/   
**$Flags**) /\* Optional; Various flags.  
Whether to return formulas as text.  
If you pass 1 here, the formulas will be returned instead of their result.  
Add 2 to return rich text cells as rich text instead of plain text.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| BookRef | The reference number for the workbook. | $ref |  |
| Index | The index of the sheet you want to query text. Value can be 0 to [XL.Book.SheetCount](XLBookSheetCount.md)-1. | $index |  |
| Flags | Various flags.   Whether to return formulas as text.   If you pass 1 here, the formulas will be returned instead of their result.   Add 2 to return rich text cells as rich text instead of plain text. | 0 | Optional |

### Result

Returns text of sheet.

### Description

Queries the text of a sheet in a workbook.  
Numbers are formatted as floating point numbers with dot as decimal separator.  
Boolean values are returned as FALSE or TRUE.  
### See also

- [XL.Book.SheetCount](XLBookSheetCount.md)
- [XL.Sheet.GetMerge](XLSheetGetMerge.md)
- [XL.Sheet.GetName](XLSheetGetName.md)
- [XL.Sheet.GetZoom](XLSheetGetZoom.md)

### Release notes

- **Version 13.3**
    - Added new flag to [XL.Book.GetText](https://www.mbsplugins.eu/XLBookGetText.shtml) and [XL.Sheet.GetText](https://www.mbsplugins.eu/XLSheetGetText.shtml) to return texts as rich text.

### Blog Entries

- [MBS FileMaker Plugin, version 13.3pr1](https://www.mbsplugins.de/archive/2023-06-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [LibXL for FileMaker with extras](https://www.mbsplugins.de/archive/2021-03-02/LibXL_for_FileMaker_with_extra/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 1/2025, Seite 29](https://filemaker-magazin.de/neuigkeit/4282-Appetithappen-FMM_202501)

This function checks for a license.

Created 18th August 2014 , last changed 12nd May 2023

  
[XL.Sheet.GetTabColorRGB](XLSheetGetTabColorRGB.md) - [XL.Sheet.GetTopLeftView](XLSheetGetTopLeftView.md)

[HTML Version](XLSheetGetText.shtml)