| 
									
										
										
										
											2017-04-01 07:32:12 +00:00
										 |  |  | #### Worksheet Object
 | 
					
						
							| 
									
										
										
										
											2017-03-31 21:46:02 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | In addition to the base sheet keys, worksheets also add: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | - `ws['!cols']`: array of column properties objects.  Column widths are actually | 
					
						
							|  |  |  |   stored in files in a normalized manner, measured in terms of the "Maximum | 
					
						
							|  |  |  |   Digit Width" (the largest width of the rendered digits 0-9, in pixels).  When | 
					
						
							|  |  |  |   parsed, the column objects store the pixel width in the `wpx` field, character | 
					
						
							|  |  |  |   width in the `wch` field, and the maximum digit width in the `MDW` field. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | - `ws['!merges']`: array of range objects corresponding to the merged cells in | 
					
						
							|  |  |  |   the worksheet.  Plaintext utilities are unaware of merge cells.  CSV export | 
					
						
							|  |  |  |   will write all cells in the merge range if they exist, so be sure that only | 
					
						
							|  |  |  |   the first cell (upper-left) in the range is set. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-04-04 18:41:11 +00:00
										 |  |  | - `ws['protect']`: object of write sheet protection properties.  The `password` | 
					
						
							|  |  |  |   key specifies the password.  The writer uses the XOR obfuscation method.  The | 
					
						
							|  |  |  |   following keys control the sheet protection (same as ECMA-376 18.3.1.85): | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | | key                   | functionality disabled if value is true              | | 
					
						
							|  |  |  | |:----------------------|:-----------------------------------------------------| | 
					
						
							|  |  |  | | `selectLockedCells`   | Select locked cells                                  | | 
					
						
							|  |  |  | | `selectUnlockedCells` | Select unlocked cells                                | | 
					
						
							|  |  |  | | `formatCells`         | Format cells                                         | | 
					
						
							|  |  |  | | `formatColumns`       | Format columns                                       | | 
					
						
							|  |  |  | | `formatRows`          | Format rows                                          | | 
					
						
							|  |  |  | | `insertColumns`       | Insert columns                                       | | 
					
						
							|  |  |  | | `insertRows`          | Insert rows                                          | | 
					
						
							|  |  |  | | `insertHyperlinks`    | Insert hyperlinks                                    | | 
					
						
							|  |  |  | | `deleteColumns`       | Delete columns                                       | | 
					
						
							|  |  |  | | `deleteRows`          | Delete rows                                          | | 
					
						
							|  |  |  | | `sort`                | Sort                                                 | | 
					
						
							|  |  |  | | `autoFilter`          | Filter                                               | | 
					
						
							|  |  |  | | `pivotTables`         | Use PivotTable reports                               | | 
					
						
							|  |  |  | | `objects`             | Edit objects                                         | | 
					
						
							|  |  |  | | `scenarios`           | Edit scenarios                                       | | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-04-10 05:10:54 +00:00
										 |  |  | - `ws['!autofilter']`: AutoFilter object following the schema: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```typescript | 
					
						
							|  |  |  | type AutoFilter = { | 
					
						
							|  |  |  | 	ref:string; // A-1 based range representing the AutoFilter table range | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-04-01 07:32:12 +00:00
										 |  |  | #### Chartsheet Object
 | 
					
						
							| 
									
										
										
										
											2017-03-27 21:35:15 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-31 21:46:02 +00:00
										 |  |  | Chartsheets are represented as standard sheets.  They are distinguished with the | 
					
						
							|  |  |  | `!type` property set to `"chart"`. | 
					
						
							| 
									
										
										
										
											2017-03-27 21:35:15 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-31 21:46:02 +00:00
										 |  |  | The underlying data and `!ref` refer to the cached data in the chartsheet.  The | 
					
						
							|  |  |  | first row of the chartsheet is the underlying header. | 
					
						
							| 
									
										
										
										
											2017-03-27 21:35:15 +00:00
										 |  |  | 
 |