diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
index 0d8bff3e35..7d7f4431fc 100644
--- a/.openpublishing.publish.config.json
+++ b/.openpublishing.publish.config.json
@@ -232,6 +232,10 @@
"ReferenceTOC": "docs/docs-ref-autogen/excel_1_16/toc.yml",
"ConceptualTOCUrl": "/office/dev/add-ins/toc.json"
},
+ {
+ "ReferenceTOC": "docs/docs-ref-autogen/excel_1_17/toc.yml",
+ "ConceptualTOCUrl": "/office/dev/add-ins/toc.json"
+ },
{
"ReferenceTOC": "docs/docs-ref-autogen/excel_online/toc.yml",
"ConceptualTOCUrl": "/office/dev/add-ins/toc.json"
diff --git a/docs/docfx.json b/docs/docfx.json
index 4326277df6..ae2ccb7263 100644
--- a/docs/docfx.json
+++ b/docs/docfx.json
@@ -467,6 +467,18 @@
"src": "docs-ref-autogen/excel_1_16",
"dest": "api"
},
+ {
+ "files": ["**/toc.yml"],
+ "group": "excel-js-1.17",
+ "src": "docs-ref-autogen/excel_1_17",
+ "dest": "api/office-js-docs-reference"
+ },
+ {
+ "files": ["**/*.md", "**/*.yml"],
+ "group": "excel-js-1.17",
+ "src": "docs-ref-autogen/excel_1_17",
+ "dest": "api"
+ },
{
"files": ["**/toc.yml"],
"group": "excel-js-online",
@@ -801,6 +813,10 @@
"dest": "excel-js-1.16",
"moniker_range": "excel-js-1.16"
},
+ "excel-js-1.17": {
+ "dest": "excel-js-1.17",
+ "moniker_range": "excel-js-1.17"
+ },
"excel-js-online": {
"dest": "excel-js-online",
"moniker_range": "excel-js-online"
@@ -962,6 +978,8 @@
"docs-ref-autogen/excel_1_15/excel/**": ["excel 1.15"],
"docs-ref-autogen/excel_1_16/**": ["excel 1.16"],
"docs-ref-autogen/excel_1_16/excel/**": ["excel 1.16"],
+ "docs-ref-autogen/excel_1_17/**": ["excel 1.17"],
+ "docs-ref-autogen/excel_1_17/excel/**": ["excel 1.17"],
"docs-ref-autogen/excel_online/**": ["excel online"],
"docs-ref-autogen/excel_online/excel/**": ["excel online"],
"docs-ref-autogen/office/**": ["common preview"],
@@ -1049,6 +1067,7 @@
"docs-ref-autogen/excel_1_14/**": "excel",
"docs-ref-autogen/excel_1_15/**": "excel",
"docs-ref-autogen/excel_1_16/**": "excel",
+ "docs-ref-autogen/excel_1_17/**": "excel",
"docs-ref-autogen/excel_online/**": "excel",
"docs-ref-autogen/excel_1_1/excel/**": "excel",
"docs-ref-autogen/excel_1_2/excel/**": "excel",
@@ -1066,6 +1085,7 @@
"docs-ref-autogen/excel_1_14/excel/**": "excel",
"docs-ref-autogen/excel_1_15/excel/**": "excel",
"docs-ref-autogen/excel_1_16/excel/**": "excel",
+ "docs-ref-autogen/excel_1_17/excel/**": "excel",
"docs-ref-autogen/excel_online/excel/**": "excel",
"docs-ref-autogen/office/**": "non-product-specific",
"docs-ref-autogen/office/office/**": "non-product-specific",
diff --git a/docs/docs-ref-autogen/common/toc.yml b/docs/docs-ref-autogen/common/toc.yml
index 1fc6856fef..35aaa3adcd 100644
--- a/docs/docs-ref-autogen/common/toc.yml
+++ b/docs/docs-ref-autogen/common/toc.yml
@@ -475,6 +475,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/common_preview/toc.yml b/docs/docs-ref-autogen/common_preview/toc.yml
index 1fc6856fef..35aaa3adcd 100644
--- a/docs/docs-ref-autogen/common_preview/toc.yml
+++ b/docs/docs-ref-autogen/common_preview/toc.yml
@@ -475,6 +475,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel/excel.yml b/docs/docs-ref-autogen/excel/excel.yml
index f8632e5876..a20379eb45 100644
--- a/docs/docs-ref-autogen/excel/excel.yml
+++ b/docs/docs-ref-autogen/excel/excel.yml
@@ -9,6 +9,7 @@ enums:
- 'excel!Excel.ArrowheadStyle:enum'
- 'excel!Excel.ArrowheadWidth:enum'
- 'excel!Excel.AutoFillType:enum'
+ - 'excel!Excel.Base64EncodingType:enum'
- 'excel!Excel.BindingType:enum'
- 'excel!Excel.BlockedErrorCellValueSubType:enum'
- 'excel!Excel.BorderIndex:enum'
@@ -371,6 +372,7 @@ classes:
interfaces:
- 'excel!Excel.AllowEditRangeOptions:interface'
- 'excel!Excel.ArrayCellValue:interface'
+ - 'excel!Excel.Base64EncodedImage:interface'
- 'excel!Excel.BasicDataValidation:interface'
- 'excel!Excel.BindingDataChangedEventArgs:interface'
- 'excel!Excel.BindingSelectionChangedEventArgs:interface'
@@ -982,6 +984,8 @@ interfaces:
- 'excel!Excel.LinkedEntityCellValue:interface'
- 'excel!Excel.LinkedEntityId:interface'
- 'excel!Excel.ListDataValidation:interface'
+ - 'excel!Excel.LocalImageCellValue:interface'
+ - 'excel!Excel.LocalImageCellValueCacheId:interface'
- 'excel!Excel.NameErrorCellValue:interface'
- 'excel!Excel.NotAvailableErrorCellValue:interface'
- 'excel!Excel.NullErrorCellValue:interface'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.application.yml b/docs/docs-ref-autogen/excel/excel/excel.application.yml
index 07e44fa000..398fe9a651 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.application.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.application.yml
@@ -127,6 +127,20 @@ properties:
content: 'readonly decimalSeparator: string;'
return:
type: string
+ - name: formatStaleValues
+ uid: 'excel!Excel.Application#formatStaleValues:member'
+ package: excel!
+ fullName: formatStaleValues
+ summary: >-
+ Specifies whether the Format Stale Values option within Calculation Options is enabled or disabled. The stale
+ formulas are rendered with stale formatting if the option is enabled.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'formatStaleValues: boolean;'
+ return:
+ type: boolean
- name: iterativeCalculation
uid: 'excel!Excel.Application#iterativeCalculation:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.base64encodedimage.yml b/docs/docs-ref-autogen/excel/excel/excel.base64encodedimage.yml
new file mode 100644
index 0000000000..b77272dc17
--- /dev/null
+++ b/docs/docs-ref-autogen/excel/excel/excel.base64encodedimage.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSType
+name: Excel.Base64EncodedImage
+uid: 'excel!Excel.Base64EncodedImage:interface'
+package: excel!
+fullName: Excel.Base64EncodedImage
+summary: The base64 encoding type and data of an image.
+remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: true
+isDeprecated: false
+type: interface
+properties:
+ - name: data
+ uid: 'excel!Excel.Base64EncodedImage#data:member'
+ package: excel!
+ fullName: data
+ summary: The base64 string encoding.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'data: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.Base64EncodedImage#type:member'
+ package: excel!
+ fullName: type
+ summary: The file type of the encoded image.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'type: Base64EncodingType | "JPG" | "PNG";'
+ return:
+ type: ' | "JPG" | "PNG"'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.base64encodingtype.yml b/docs/docs-ref-autogen/excel/excel/excel.base64encodingtype.yml
new file mode 100644
index 0000000000..9d8cb06036
--- /dev/null
+++ b/docs/docs-ref-autogen/excel/excel/excel.base64encodingtype.yml
@@ -0,0 +1,26 @@
+### YamlMime:TSEnum
+name: Excel.Base64EncodingType
+uid: 'excel!Excel.Base64EncodingType:enum'
+package: excel!
+fullName: Excel.Base64EncodingType
+summary: The file type represented by the base64 encoding.
+remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: true
+isDeprecated: false
+fields:
+ - name: JPG
+ uid: 'excel!Excel.Base64EncodingType.JPG:member'
+ package: excel!
+ summary: |-
+ The JPG file type.
+
+ * \[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"JPG"'
+ - name: PNG
+ uid: 'excel!Excel.Base64EncodingType.PNG:member'
+ package: excel!
+ summary: |-
+ The PNG file type.
+
+ * \[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PNG"'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml
index 0dafb9523e..e0336f8563 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml
@@ -9,5 +9,5 @@ isPreview: false
isDeprecated: false
syntax: >-
export type CellValue = (ArrayCellValue | BooleanCellValue | DoubleCellValue | EntityCellValue | EmptyCellValue |
- ErrorCellValue | FormattedNumberCellValue | LinkedEntityCellValue | ReferenceCellValue | StringCellValue |
- ValueTypeNotAvailableCellValue | WebImageCellValue) & CellValueExtraProperties;
+ ErrorCellValue | FormattedNumberCellValue | LinkedEntityCellValue | LocalImageCellValue | ReferenceCellValue |
+ StringCellValue | ValueTypeNotAvailableCellValue | WebImageCellValue) & CellValueExtraProperties;
diff --git a/docs/docs-ref-autogen/excel/excel/excel.cellvaluetype.yml b/docs/docs-ref-autogen/excel/excel/excel.cellvaluetype.yml
index eed431d2bb..b46b087d1d 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.cellvaluetype.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.cellvaluetype.yml
@@ -102,6 +102,14 @@ fields:
* \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
value: '"LinkedEntity"'
+ - name: localImage
+ uid: 'excel!Excel.CellValueType.localImage:member'
+ package: excel!
+ summary: |-
+ Represents a `LocalImageCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LocalImage"'
- name: notAvailable
uid: 'excel!Excel.CellValueType.notAvailable:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.conditionalformat.yml b/docs/docs-ref-autogen/excel/excel/excel.conditionalformat.yml
index cc6e3f77d8..579e9b21f6 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.conditionalformat.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.conditionalformat.yml
@@ -520,8 +520,8 @@ methods:
package: excel!
fullName: changeRuleToCellValue(properties)
summary: Change the conditional format rule type to cell value.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToCellValue(properties: Excel.ConditionalCellValueRule): void;'
@@ -537,8 +537,8 @@ methods:
package: excel!
fullName: changeRuleToColorScale()
summary: Change the conditional format rule type to color scale.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToColorScale(): void;'
@@ -550,8 +550,8 @@ methods:
package: excel!
fullName: changeRuleToContainsText(properties)
summary: Change the conditional format rule type to text comparison.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToContainsText(properties: Excel.ConditionalTextComparisonRule): void;'
@@ -567,8 +567,8 @@ methods:
package: excel!
fullName: changeRuleToCustom(formula)
summary: Change the conditional format rule type to custom.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToCustom(formula: string): void;'
@@ -584,8 +584,8 @@ methods:
package: excel!
fullName: changeRuleToDataBar()
summary: Change the conditional format rule type to data bar.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToDataBar(): void;'
@@ -597,8 +597,8 @@ methods:
package: excel!
fullName: changeRuleToIconSet()
summary: Change the conditional format rule type to icon set.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToIconSet(): void;'
@@ -610,8 +610,8 @@ methods:
package: excel!
fullName: changeRuleToPresetCriteria(properties)
summary: Change the conditional format rule type to preset criteria.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToPresetCriteria(properties: Excel.ConditionalPresetCriteriaRule): void;'
@@ -627,8 +627,8 @@ methods:
package: excel!
fullName: changeRuleToTopBottom(properties)
summary: Change the conditional format rule type to top/bottom.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'changeRuleToTopBottom(properties: Excel.ConditionalTopBottomRule): void;'
@@ -851,8 +851,8 @@ methods:
package: excel!
fullName: setRanges(ranges)
summary: Set the ranges that the conditonal format rule is applied to.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'setRanges(ranges: Range | RangeAreas | string): void;'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.conditionalrangeformat.yml b/docs/docs-ref-autogen/excel/excel/excel.conditionalrangeformat.yml
index 3f21ed21ae..f42700b172 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.conditionalrangeformat.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.conditionalrangeformat.yml
@@ -81,8 +81,8 @@ methods:
package: excel!
fullName: clearFormat()
summary: Remove the format properties from a conditional format rule. This creates a rule with no format settings.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'clearFormat(): void;'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvalue.yml
index c82cc4adaa..9d9d7d29a2 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvalue.yml
@@ -45,11 +45,13 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'errorSubType?: FieldErrorCellValueSubType | "Unknown" | "WebImageMissingFilePart" | "DataProviderError";'
+ content: >-
+ errorSubType?: FieldErrorCellValueSubType | "Unknown" | "WebImageMissingFilePart" | "DataProviderError" |
+ "RichValueRelMissingFilePart";
return:
type: >-
| "Unknown" | "WebImageMissingFilePart" |
- "DataProviderError"
+ "DataProviderError" | "RichValueRelMissingFilePart"
- name: errorType
uid: 'excel!Excel.FieldErrorCellValue#errorType:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvaluesubtype.yml
index 5b12c954c9..e60693a0d3 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvaluesubtype.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.fielderrorcellvaluesubtype.yml
@@ -16,6 +16,16 @@ fields:
* \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
value: '"DataProviderError"'
+ - name: richValueRelMissingFilePart
+ uid: 'excel!Excel.FieldErrorCellValueSubType.richValueRelMissingFilePart:member'
+ package: excel!
+ summary: >-
+ An error caused by a missing file. In this case, the RichValueRel.xml file is missing from the metro package.
+ Displays as error type \#FIELD! in Excel.
+
+
+ * \[ [API set: 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RichValueRelMissingFilePart"'
- name: unknown
uid: 'excel!Excel.FieldErrorCellValueSubType.unknown:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationdata.yml b/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationdata.yml
index 5472ab0df2..00123b6ccf 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationdata.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationdata.yml
@@ -77,6 +77,20 @@ properties:
content: 'decimalSeparator?: string;'
return:
type: string
+ - name: formatStaleValues
+ uid: 'excel!Excel.Interfaces.ApplicationData#formatStaleValues:member'
+ package: excel!
+ fullName: formatStaleValues
+ summary: >-
+ Specifies whether the Format Stale Values option within Calculation Options is enabled or disabled. The stale
+ formulas are rendered with stale formatting if the option is enabled.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'formatStaleValues?: boolean;'
+ return:
+ type: boolean
- name: iterativeCalculation
uid: 'excel!Excel.Interfaces.ApplicationData#iterativeCalculation:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationloadoptions.yml b/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationloadoptions.yml
index c9713f3f07..50764041d6 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationloadoptions.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationloadoptions.yml
@@ -91,6 +91,20 @@ properties:
content: 'decimalSeparator?: boolean;'
return:
type: boolean
+ - name: formatStaleValues
+ uid: 'excel!Excel.Interfaces.ApplicationLoadOptions#formatStaleValues:member'
+ package: excel!
+ fullName: formatStaleValues
+ summary: >-
+ Specifies whether the Format Stale Values option within Calculation Options is enabled or disabled. The stale
+ formulas are rendered with stale formatting if the option is enabled.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'formatStaleValues?: boolean;'
+ return:
+ type: boolean
- name: iterativeCalculation
uid: 'excel!Excel.Interfaces.ApplicationLoadOptions#iterativeCalculation:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationupdatedata.yml b/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationupdatedata.yml
index 7b83311a0b..cce6b8785c 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationupdatedata.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.interfaces.applicationupdatedata.yml
@@ -27,6 +27,20 @@ properties:
content: 'calculationMode?: Excel.CalculationMode | "Automatic" | "AutomaticExceptTables" | "Manual";'
return:
type: ' | "Automatic" | "AutomaticExceptTables" | "Manual"'
+ - name: formatStaleValues
+ uid: 'excel!Excel.Interfaces.ApplicationUpdateData#formatStaleValues:member'
+ package: excel!
+ fullName: formatStaleValues
+ summary: >-
+ Specifies whether the Format Stale Values option within Calculation Options is enabled or disabled. The stale
+ formulas are rendered with stale formatting if the option is enabled.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'formatStaleValues?: boolean;'
+ return:
+ type: boolean
- name: iterativeCalculation
uid: 'excel!Excel.Interfaces.ApplicationUpdateData#iterativeCalculation:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfodata.yml b/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfodata.yml
index 19b99a999e..5fdcf0d026 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfodata.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfodata.yml
@@ -14,8 +14,8 @@ properties:
package: excel!
fullName: currencySymbol
summary: Gets the currency symbol for currency values. This is based on current system settings.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'currencySymbol?: string;'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfoloadoptions.yml b/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfoloadoptions.yml
index 5e54f7df5a..78876bb11a 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfoloadoptions.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.interfaces.numberformatinfoloadoptions.yml
@@ -28,8 +28,8 @@ properties:
package: excel!
fullName: currencySymbol
summary: Gets the currency symbol for currency values. This is based on current system settings.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'currencySymbol?: boolean;'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.localimagecellvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.localimagecellvalue.yml
new file mode 100644
index 0000000000..957ac6cc8b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel/excel/excel.localimagecellvalue.yml
@@ -0,0 +1,102 @@
+### YamlMime:TSType
+name: Excel.LocalImageCellValue
+uid: 'excel!Excel.LocalImageCellValue:interface'
+package: excel!
+fullName: Excel.LocalImageCellValue
+summary: Represents the value of a cell containing a locally stored or generated image.
+remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: true
+isDeprecated: false
+type: interface
+properties:
+ - name: altText
+ uid: 'excel!Excel.LocalImageCellValue#altText:member'
+ package: excel!
+ fullName: altText
+ summary: Represents the alternate text used in accessibility scenarios to describe what the image represents.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'altText?: string;'
+ return:
+ type: string
+ - name: attribution
+ uid: 'excel!Excel.LocalImageCellValue#attribution:member'
+ package: excel!
+ fullName: attribution
+ summary: Represents attribution information to describe the source and license requirements for this image.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'attribution?: CellValueAttributionAttributes[];'
+ return:
+ type: '[]'
+ - name: basicType
+ uid: 'excel!Excel.LocalImageCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.LocalImageCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#VALUE!" | string;'
+ return:
+ type: '"#VALUE!" | string'
+ - name: image
+ uid: 'excel!Excel.LocalImageCellValue#image:member'
+ package: excel!
+ fullName: image
+ summary: 'Represents the image itself, either cached or encoded.'
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'image: LocalImageCellValueCacheId | Base64EncodedImage;'
+ return:
+ type: >-
+ |
+ - name: provider
+ uid: 'excel!Excel.LocalImageCellValue#provider:member'
+ package: excel!
+ fullName: provider
+ summary: >-
+ Represents information that describes the entity or individual who provided the image. This information is used
+ for branding purposes in image cards.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'provider?: CellValueProviderAttributes;'
+ return:
+ type: ''
+ - name: type
+ uid: 'excel!Excel.LocalImageCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.localImage | "LocalImage";'
+ return:
+ type: ' | "LocalImage"'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.localimagecellvaluecacheid.yml b/docs/docs-ref-autogen/excel/excel/excel.localimagecellvaluecacheid.yml
new file mode 100644
index 0000000000..a17c1425b8
--- /dev/null
+++ b/docs/docs-ref-autogen/excel/excel/excel.localimagecellvaluecacheid.yml
@@ -0,0 +1,23 @@
+### YamlMime:TSType
+name: Excel.LocalImageCellValueCacheId
+uid: 'excel!Excel.LocalImageCellValueCacheId:interface'
+package: excel!
+fullName: Excel.LocalImageCellValueCacheId
+summary: The UID of a previously cached image.
+remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: true
+isDeprecated: false
+type: interface
+properties:
+ - name: cacheUid
+ uid: 'excel!Excel.LocalImageCellValueCacheId#cacheUid:member'
+ package: excel!
+ fullName: cacheUid
+ summary: Represents the image's UID as it appears in the cache.
+ remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: true
+ isDeprecated: false
+ syntax:
+ content: 'cacheUid: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel/excel/excel.numberformatinfo.yml b/docs/docs-ref-autogen/excel/excel/excel.numberformatinfo.yml
index 690a602784..66f9bb07a2 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.numberformatinfo.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.numberformatinfo.yml
@@ -28,8 +28,8 @@ properties:
package: excel!
fullName: currencySymbol
summary: Gets the currency symbol for currency values. This is based on current system settings.
- remarks: '\[ [API set: ExcelApi BETA (PREVIEW ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
- isPreview: true
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
isDeprecated: false
syntax:
content: 'readonly currencySymbol: string;'
diff --git a/docs/docs-ref-autogen/excel/excel/excel.worksheet.yml b/docs/docs-ref-autogen/excel/excel/excel.worksheet.yml
index 4f08749717..8b2b1237c0 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.worksheet.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.worksheet.yml
@@ -1591,7 +1591,7 @@ events:
package: excel!
fullName: onNameChanged
summary: Occurs when the worksheet name is changed.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -1816,7 +1816,7 @@ events:
package: excel!
fullName: onVisibilityChanged
summary: Occurs when the worksheet visibility is changed.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
diff --git a/docs/docs-ref-autogen/excel/excel/excel.worksheetcollection.yml b/docs/docs-ref-autogen/excel/excel/excel.worksheetcollection.yml
index a3694c4dbe..2d75e0af02 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.worksheetcollection.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.worksheetcollection.yml
@@ -646,7 +646,7 @@ events:
Occurs when a worksheet is moved within a workbook. This event only triggers when a worksheet is directly moved
within a workbook. This event doesn't trigger when the position of a worksheet is indirectly changed, such as when
a new worksheet is inserted and causes existing worksheets to change positions.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -660,7 +660,7 @@ events:
package: excel!
fullName: onNameChanged
summary: Occurs when the worksheet name is changed in the worksheet collection.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -747,7 +747,7 @@ events:
package: excel!
fullName: onVisibilityChanged
summary: Occurs when the worksheet visibility is changed in the worksheet collection.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
diff --git a/docs/docs-ref-autogen/excel/excel/excel.worksheetmovedeventargs.yml b/docs/docs-ref-autogen/excel/excel/excel.worksheetmovedeventargs.yml
index 9b143c0165..066d242f2c 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.worksheetmovedeventargs.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.worksheetmovedeventargs.yml
@@ -11,7 +11,7 @@ summary: >-
an event. Note that if the position of a worksheet changes as a result of moving a different worksheet, then this
event won't trigger for both position changes. This event only triggers for the primary worksheet move, and not any
worksheet position changes that occur as a result of that primary move.
-remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
type: interface
@@ -21,7 +21,7 @@ properties:
package: excel!
fullName: positionAfter
summary: 'Gets the new position of the worksheet, after the move.'
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -33,7 +33,7 @@ properties:
package: excel!
fullName: positionBefore
summary: 'Gets the previous position of the worksheet, prior to the move.'
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -45,7 +45,7 @@ properties:
package: excel!
fullName: source
summary: The source of the event. It can be local or remote (through co-authoring).
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -57,7 +57,7 @@ properties:
package: excel!
fullName: type
summary: Gets the type of the event.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -69,7 +69,7 @@ properties:
package: excel!
fullName: worksheetId
summary: Gets the ID of the worksheet that was moved.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
diff --git a/docs/docs-ref-autogen/excel/excel/excel.worksheetnamechangedeventargs.yml b/docs/docs-ref-autogen/excel/excel/excel.worksheetnamechangedeventargs.yml
index 6dd90fac0b..baa3274562 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.worksheetnamechangedeventargs.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.worksheetnamechangedeventargs.yml
@@ -4,7 +4,7 @@ uid: 'excel!Excel.WorksheetNameChangedEventArgs:interface'
package: excel!
fullName: Excel.WorksheetNameChangedEventArgs
summary: Provides information about the worksheet whose name has changed.
-remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
type: interface
@@ -14,7 +14,7 @@ properties:
package: excel!
fullName: nameAfter
summary: 'Gets the new name of the worksheet, after the name change.'
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -26,7 +26,7 @@ properties:
package: excel!
fullName: nameBefore
summary: 'Gets the previous name of the worksheet, before the name changed.'
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -38,7 +38,7 @@ properties:
package: excel!
fullName: source
summary: The source of the event. It can be local or remote (through co-authoring).
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -50,7 +50,7 @@ properties:
package: excel!
fullName: type
summary: Gets the type of the event.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -62,7 +62,7 @@ properties:
package: excel!
fullName: worksheetId
summary: Gets the ID of the worksheet with the new name.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
diff --git a/docs/docs-ref-autogen/excel/excel/excel.worksheetvisibilitychangedeventargs.yml b/docs/docs-ref-autogen/excel/excel/excel.worksheetvisibilitychangedeventargs.yml
index b660157640..af89c4a514 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.worksheetvisibilitychangedeventargs.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.worksheetvisibilitychangedeventargs.yml
@@ -4,7 +4,7 @@ uid: 'excel!Excel.WorksheetVisibilityChangedEventArgs:interface'
package: excel!
fullName: Excel.WorksheetVisibilityChangedEventArgs
summary: Provides information about the worksheet whose visibility has changed.
-remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
type: interface
@@ -14,7 +14,7 @@ properties:
package: excel!
fullName: source
summary: The source of the event. It can be local or remote (through co-authoring).
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -26,7 +26,7 @@ properties:
package: excel!
fullName: type
summary: Gets the type of the event.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -38,7 +38,7 @@ properties:
package: excel!
fullName: visibilityAfter
summary: 'Gets the new visibility setting of the worksheet, after the visibility change.'
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -50,7 +50,7 @@ properties:
package: excel!
fullName: visibilityBefore
summary: 'Gets the previous visibility setting of the worksheet, before the visibility change.'
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
@@ -62,7 +62,7 @@ properties:
package: excel!
fullName: worksheetId
summary: Gets the ID of the worksheet whose visibility has changed.
- remarks: '\[ [API set: ExcelApiOnline 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
syntax:
diff --git a/docs/docs-ref-autogen/excel/toc.yml b/docs/docs-ref-autogen/excel/toc.yml
index 5bcbd6c294..93c03fee9d 100644
--- a/docs/docs-ref-autogen/excel/toc.yml
+++ b/docs/docs-ref-autogen/excel/toc.yml
@@ -38,6 +38,8 @@ items:
uid: 'excel!Excel.ArrowheadWidth:enum'
- name: AutoFillType
uid: 'excel!Excel.AutoFillType:enum'
+ - name: Base64EncodingType
+ uid: 'excel!Excel.Base64EncodingType:enum'
- name: BindingType
uid: 'excel!Excel.BindingType:enum'
- name: BlockedErrorCellValueSubType
@@ -439,6 +441,8 @@ items:
uid: 'excel!Excel.ArrayCellValue:interface'
- name: AutoFilter
uid: 'excel!Excel.AutoFilter:class'
+ - name: Base64EncodedImage
+ uid: 'excel!Excel.Base64EncodedImage:interface'
- name: BasicDataValidation
uid: 'excel!Excel.BasicDataValidation:interface'
- name: Binding
@@ -817,6 +821,10 @@ items:
uid: 'excel!Excel.LinkedWorkbookCollection:class'
- name: ListDataValidation
uid: 'excel!Excel.ListDataValidation:interface'
+ - name: LocalImageCellValue
+ uid: 'excel!Excel.LocalImageCellValue:interface'
+ - name: LocalImageCellValueCacheId
+ uid: 'excel!Excel.LocalImageCellValueCacheId:interface'
- name: NamedItem
uid: 'excel!Excel.NamedItem:class'
- name: NamedItemArrayValues
@@ -1589,6 +1597,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_1/toc.yml b/docs/docs-ref-autogen/excel_1_1/toc.yml
index c57734fb38..6caa9323f8 100644
--- a/docs/docs-ref-autogen/excel_1_1/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_1/toc.yml
@@ -617,6 +617,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_10/toc.yml b/docs/docs-ref-autogen/excel_1_10/toc.yml
index fc0763f96b..38f6cced51 100644
--- a/docs/docs-ref-autogen/excel_1_10/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_10/toc.yml
@@ -1301,6 +1301,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_11/toc.yml b/docs/docs-ref-autogen/excel_1_11/toc.yml
index 93ac6a01a4..710b04d857 100644
--- a/docs/docs-ref-autogen/excel_1_11/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_11/toc.yml
@@ -1313,6 +1313,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_12/toc.yml b/docs/docs-ref-autogen/excel_1_12/toc.yml
index c53491d2f8..b223210beb 100644
--- a/docs/docs-ref-autogen/excel_1_12/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_12/toc.yml
@@ -1359,6 +1359,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_13/toc.yml b/docs/docs-ref-autogen/excel_1_13/toc.yml
index 3665ddc06d..95b751961f 100644
--- a/docs/docs-ref-autogen/excel_1_13/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_13/toc.yml
@@ -1369,6 +1369,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_14/toc.yml b/docs/docs-ref-autogen/excel_1_14/toc.yml
index 31443cbe8b..131a6de69e 100644
--- a/docs/docs-ref-autogen/excel_1_14/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_14/toc.yml
@@ -1387,6 +1387,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_15/toc.yml b/docs/docs-ref-autogen/excel_1_15/toc.yml
index 3f008edd9f..1c345a8a58 100644
--- a/docs/docs-ref-autogen/excel_1_15/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_15/toc.yml
@@ -1391,6 +1391,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvaluetype.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvaluetype.yml
index eed431d2bb..b46b087d1d 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvaluetype.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvaluetype.yml
@@ -102,6 +102,14 @@ fields:
* \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
value: '"LinkedEntity"'
+ - name: localImage
+ uid: 'excel!Excel.CellValueType.localImage:member'
+ package: excel!
+ summary: |-
+ Represents a `LocalImageCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LocalImage"'
- name: notAvailable
uid: 'excel!Excel.CellValueType.notAvailable:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvalue.yml
index c82cc4adaa..9d9d7d29a2 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvalue.yml
@@ -45,11 +45,13 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'errorSubType?: FieldErrorCellValueSubType | "Unknown" | "WebImageMissingFilePart" | "DataProviderError";'
+ content: >-
+ errorSubType?: FieldErrorCellValueSubType | "Unknown" | "WebImageMissingFilePart" | "DataProviderError" |
+ "RichValueRelMissingFilePart";
return:
type: >-
| "Unknown" | "WebImageMissingFilePart" |
- "DataProviderError"
+ "DataProviderError" | "RichValueRelMissingFilePart"
- name: errorType
uid: 'excel!Excel.FieldErrorCellValue#errorType:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvaluesubtype.yml
index 5b12c954c9..e60693a0d3 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvaluesubtype.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.fielderrorcellvaluesubtype.yml
@@ -16,6 +16,16 @@ fields:
* \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
value: '"DataProviderError"'
+ - name: richValueRelMissingFilePart
+ uid: 'excel!Excel.FieldErrorCellValueSubType.richValueRelMissingFilePart:member'
+ package: excel!
+ summary: >-
+ An error caused by a missing file. In this case, the RichValueRel.xml file is missing from the metro package.
+ Displays as error type \#FIELD! in Excel.
+
+
+ * \[ [API set: 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RichValueRelMissingFilePart"'
- name: unknown
uid: 'excel!Excel.FieldErrorCellValueSubType.unknown:member'
package: excel!
diff --git a/docs/docs-ref-autogen/excel_1_16/toc.yml b/docs/docs-ref-autogen/excel_1_16/toc.yml
index 1bc09f3826..5bec9b0522 100644
--- a/docs/docs-ref-autogen/excel_1_16/toc.yml
+++ b/docs/docs-ref-autogen/excel_1_16/toc.yml
@@ -1521,6 +1521,9 @@ items:
- name: ExcelApi online-only requirement set
href: ../../requirement-sets/excel/excel-api-online-requirement-set.md
displayName: Excel
+ - name: ExcelApi 1.17 requirement set
+ href: ../../requirement-sets/excel/excel-api-1-17-requirement-set.md
+ displayName: Excel
- name: ExcelApi 1.16 requirement set
href: ../../requirement-sets/excel/excel-api-1-16-requirement-set.md
displayName: Excel
diff --git a/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime.yml b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime.yml
new file mode 100644
index 0000000000..f70f61325b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime.yml
@@ -0,0 +1,49 @@
+### YamlMime:TSPackage
+uid: custom-functions-runtime!
+name: custom-functions-runtime
+type: package
+summary: ''
+interfaces:
+ - 'custom-functions-runtime!CustomFunctions.CancelableInvocation:interface'
+ - 'custom-functions-runtime!CustomFunctions.Invocation:interface'
+ - 'custom-functions-runtime!CustomFunctions.StreamingInvocation:interface'
+classes:
+ - 'custom-functions-runtime!CustomFunctions.Error:class'
+enums:
+ - 'custom-functions-runtime!CustomFunctions.ErrorCode:enum'
+functions:
+ - name: 'CustomFunctions.associate(id, functionObject)'
+ uid: 'custom-functions-runtime!CustomFunctions.associate:function(1)'
+ package: custom-functions-runtime!
+ summary: Associates the JavaScript function to the name given by the "id" property in the metadata JSON file.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'export function associate(id: string, functionObject: Function): void;'
+ parameters:
+ - id: id
+ description: ''
+ type: string
+ - id: functionObject
+ description: ''
+ type: Function
+ return:
+ type: void
+ description: ''
+ - name: CustomFunctions.associate(mappings)
+ uid: 'custom-functions-runtime!CustomFunctions.associate:function(2)'
+ package: custom-functions-runtime!
+ summary: Associates the JavaScript functions to the names given by the "id" properties in the metadata JSON file.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'export function associate(mappings: { [key: string]: Function }): void;'
+ parameters:
+ - id: mappings
+ description: ''
+ type: '{ [key: string]: Function }'
+ return:
+ type: void
+ description: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.cancelableinvocation.yml b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.cancelableinvocation.yml
new file mode 100644
index 0000000000..d0351422d9
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.cancelableinvocation.yml
@@ -0,0 +1,33 @@
+### YamlMime:TSType
+name: CustomFunctions.CancelableInvocation
+uid: 'custom-functions-runtime!CustomFunctions.CancelableInvocation:interface'
+package: custom-functions-runtime!
+fullName: CustomFunctions.CancelableInvocation
+summary: >-
+ Provides information about the invocation of a cancelable custom function. A cancelable custom function can provide a
+ handler for the onCanceled event.
+
+
+ To indicate that a function is cancelable, in the metadata JSON file, the function options should specify: `{
+ "cancelable": true }`
+
+
+ If the metadata JSON file is being generated from JSDoc comments, include the tag `@cancelable`.
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+events:
+ - name: onCanceled
+ uid: 'custom-functions-runtime!CustomFunctions.CancelableInvocation#onCanceled:member'
+ package: custom-functions-runtime!
+ fullName: onCanceled
+ summary: Event handler called when the custom function is canceled.
+ remarks: '\[ [API set: CustomFunctionsRuntime 1.1](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'onCanceled: () => void;'
+ return:
+ type: () => void
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.error.yml b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.error.yml
new file mode 100644
index 0000000000..cbaed342d6
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.error.yml
@@ -0,0 +1,85 @@
+### YamlMime:TSType
+name: CustomFunctions.Error
+uid: 'custom-functions-runtime!CustomFunctions.Error:class'
+package: custom-functions-runtime!
+fullName: CustomFunctions.Error
+summary: Use this class to handle errors and write custom error messages.
+remarks: |-
+ \[ [API set: CustomFunctionsRuntime 1.2](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]
+
+ #### Examples
+
+ ```javascript
+ /**
+ * Returns the #NUM! error as part of a 2-dimensional array.
+ * @customfunction
+ * @param {number} first First parameter.
+ * @param {number} second Second parameter.
+ * @param {number} third Third parameter.
+ * @returns {number[][]} Three results, as a 2-dimensional array.
+ */
+ function returnInvalidNumberError(first, second, third) {
+ // Use the `CustomFunctions.Error` object to retrieve an invalid number error.
+ const error = new CustomFunctions.Error(
+ CustomFunctions.ErrorCode.invalidNumber, // Corresponds to the #NUM! error in the Excel UI.
+ );
+
+ // Enter logic that processes the first, second, and third input parameters.
+ // Imagine that the second calculation results in an invalid number error.
+ const firstResult = first;
+ const secondResult = error;
+ const thirdResult = third;
+
+ // Return the results of the first and third parameter calculations
+ // and a #NUM! error in place of the second result.
+ return [[firstResult], [secondResult], [thirdResult]];
+ };
+ ```
+isPreview: false
+isDeprecated: false
+type: class
+constructors:
+ - name: '(constructor)(code, message)'
+ uid: 'custom-functions-runtime!CustomFunctions.Error:constructor(1)'
+ package: custom-functions-runtime!
+ fullName: '(constructor)(code, message)'
+ summary: Constructs a new instance of the `Error` class
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'constructor(code: ErrorCode, message?: string);'
+ parameters:
+ - id: code
+ description: ''
+ type: ''
+ - id: message
+ description: ''
+ type: string
+properties:
+ - name: code
+ uid: 'custom-functions-runtime!CustomFunctions.Error#code:member'
+ package: custom-functions-runtime!
+ fullName: code
+ summary: The error code returned by your custom function.
+ remarks: '\[ [API set: CustomFunctionsRuntime 1.2](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'code: ErrorCode;'
+ return:
+ type: ''
+ - name: message
+ uid: 'custom-functions-runtime!CustomFunctions.Error#message:member'
+ package: custom-functions-runtime!
+ fullName: message
+ summary: >-
+ Your custom error message, such as "This stock price is unavailable". Custom messages are only available with
+ certain error codes.
+ remarks: '\[ [API set: CustomFunctionsRuntime 1.2](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'message?: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.errorcode.yml b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.errorcode.yml
new file mode 100644
index 0000000000..2009dcb859
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.errorcode.yml
@@ -0,0 +1,92 @@
+### YamlMime:TSEnum
+name: CustomFunctions.ErrorCode
+uid: 'custom-functions-runtime!CustomFunctions.ErrorCode:enum'
+package: custom-functions-runtime!
+fullName: CustomFunctions.ErrorCode
+summary: >-
+ Error codes for custom functions. The error codes will appear in the cell that invoked the function.
+
+
+ Custom error messages appear in addition to these error codes. Custom messages display in the error indicator menu,
+ which is accessed by hovering over the error flag on each cell with an error.
+remarks: |-
+
+
+ #### Examples
+
+ ```javascript
+ /**
+ * Returns the #NUM! error as part of a 2-dimensional array.
+ * @customfunction
+ * @param {number} first First parameter.
+ * @param {number} second Second parameter.
+ * @param {number} third Third parameter.
+ * @returns {number[][]} Three results, as a 2-dimensional array.
+ */
+ function returnInvalidNumberError(first, second, third) {
+ // Use the `CustomFunctions.Error` object to retrieve an invalid number error.
+ const error = new CustomFunctions.Error(
+ CustomFunctions.ErrorCode.invalidNumber, // Corresponds to the #NUM! error in the Excel UI.
+ );
+
+ // Enter logic that processes the first, second, and third input parameters.
+ // Imagine that the second calculation results in an invalid number error.
+ const firstResult = first;
+ const secondResult = error;
+ const thirdResult = third;
+
+ // Return the results of the first and third parameter calculations
+ // and a #NUM! error in place of the second result.
+ return [[firstResult], [secondResult], [thirdResult]];
+ };
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: divisionByZero
+ uid: 'custom-functions-runtime!CustomFunctions.ErrorCode.divisionByZero:member'
+ package: custom-functions-runtime!
+ summary: >-
+ This error code indicates that the function used is dividing by zero or empty cells. A custom error message can't
+ be used.
+ value: '"#DIV/0!"'
+ - name: invalidName
+ uid: 'custom-functions-runtime!CustomFunctions.ErrorCode.invalidName:member'
+ package: custom-functions-runtime!
+ summary: >-
+ This error code indicates that there is a typo in the function name. Note that this error code is supported as a
+ custom function input error, but not as a custom function output error. A custom error message can't be used.
+ value: '"#NAME?"'
+ - name: invalidNumber
+ uid: 'custom-functions-runtime!CustomFunctions.ErrorCode.invalidNumber:member'
+ package: custom-functions-runtime!
+ summary: >-
+ This error code indicates that there is a problem with a number in the function. A custom error message can't be
+ used.
+ value: '"#NUM!"'
+ - name: invalidReference
+ uid: 'custom-functions-runtime!CustomFunctions.ErrorCode.invalidReference:member'
+ package: custom-functions-runtime!
+ summary: >-
+ This error code indicates that the function refers to an invalid cell. Note that this error code is supported as a
+ custom function input error, but not as a custom function output error. A custom error message can't be used.
+ value: '"#REF!"'
+ - name: invalidValue
+ uid: 'custom-functions-runtime!CustomFunctions.ErrorCode.invalidValue:member'
+ package: custom-functions-runtime!
+ summary: >-
+ This error code indicates that a value in the function is of the wrong data type. A custom error message can be
+ used in addition to the error code, if desired.
+ value: '"#VALUE!"'
+ - name: notAvailable
+ uid: 'custom-functions-runtime!CustomFunctions.ErrorCode.notAvailable:member'
+ package: custom-functions-runtime!
+ summary: >-
+ This error code indicates that the function or service isn't available. A custom error message can be used in
+ addition to the error code, if desired.
+ value: '"#N/A"'
+ - name: nullReference
+ uid: 'custom-functions-runtime!CustomFunctions.ErrorCode.nullReference:member'
+ package: custom-functions-runtime!
+ summary: This error code indicates that the ranges in the function don't intersect. A custom error message can't be used.
+ value: '"#NULL!"'
diff --git a/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.invocation.yml b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.invocation.yml
new file mode 100644
index 0000000000..f2d2eca70f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.invocation.yml
@@ -0,0 +1,64 @@
+### YamlMime:TSType
+name: CustomFunctions.Invocation
+uid: 'custom-functions-runtime!CustomFunctions.Invocation:interface'
+package: custom-functions-runtime!
+fullName: CustomFunctions.Invocation
+summary: Provides information about the invocation of a custom function.
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: address
+ uid: 'custom-functions-runtime!CustomFunctions.Invocation#address:member'
+ package: custom-functions-runtime!
+ fullName: address
+ summary: >-
+ The cell address where the function is being called, if requested, otherwise undefined.
+
+
+ To request the address for the function, in the metadata JSON file, the function options should specify: `{
+ "requiresAddress": true }`
+
+
+ If the metadata JSON file is being generated from JSDoc comments, include the tag `@requiresAddress`.
+ remarks: '\[ [API set: CustomFunctionsRuntime 1.1](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'address?: string;'
+ return:
+ type: string
+ - name: functionName
+ uid: 'custom-functions-runtime!CustomFunctions.Invocation#functionName:member'
+ package: custom-functions-runtime!
+ fullName: functionName
+ summary: The name of this function.
+ remarks: '\[ [API set: CustomFunctionsRuntime 1.1](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'functionName?: string;'
+ return:
+ type: string
+ - name: parameterAddresses
+ uid: 'custom-functions-runtime!CustomFunctions.Invocation#parameterAddresses:member'
+ package: custom-functions-runtime!
+ fullName: parameterAddresses
+ summary: >-
+ The range addresses where the function parameters are located, if requested, otherwise undefined.
+
+
+ To request the parameter addresses for the function, in the metadata JSON file, the function options should
+ specify: `{ "requiresParameterAddresses": true }`
+
+
+ If the metadata JSON file is being generated from JSDoc comments, include the tag
+ `@requiresParameterAddresses`.
+ remarks: '\[ [API set: CustomFunctionsRuntime 1.3](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'parameterAddresses?: string[];'
+ return:
+ type: 'string[]'
diff --git a/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.streaminginvocation.yml b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.streaminginvocation.yml
new file mode 100644
index 0000000000..aedd46ea47
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/custom-functions-runtime/customfunctions.streaminginvocation.yml
@@ -0,0 +1,62 @@
+### YamlMime:TSType
+name: CustomFunctions.StreamingInvocation
+uid: 'custom-functions-runtime!CustomFunctions.StreamingInvocation:interface'
+package: custom-functions-runtime!
+fullName: CustomFunctions.StreamingInvocation
+summary: >-
+ Provides information about the invocation of a streaming custom function. A streaming custom function can provide
+ results which can change over time.
+
+
+ Call `setResult()` one or more times to provide the result instead of returning a result from the function.
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: setResult
+ uid: 'custom-functions-runtime!CustomFunctions.StreamingInvocation#setResult:member'
+ package: custom-functions-runtime!
+ fullName: setResult
+ summary: Set the result for the custom function. May be called more than once.
+ remarks: >-
+ \[ [API set: CustomFunctionsRuntime 1.1](/javascript/api/requirement-sets/excel/custom-functions-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```javascript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/16-custom-functions/streaming-function.yaml
+
+ /** @CustomFunction
+ * @description Increments the cell with a given amount at a specified interval in milliseconds.
+ * @param {number} amount - The amount to add to the cell value on each increment.
+ * @param {number} interval - The time in milliseconds to wait before the next increment on the cell.
+ * @param {CustomFunctions.StreamingInvocation} invocation - Parameter to send results to Excel
+ * or respond to the user canceling the function.
+ * @returns An incrementing value.
+ */
+ function increment(amount: number, interval: number, invocation: CustomFunctions.StreamingInvocation):
+ void {
+ let result = 0;
+ const timer = setInterval(() => {
+ result += amount;
+ invocation.setResult(result);
+ }, interval);
+
+ invocation.onCanceled = () => {
+ clearInterval(timer);
+ }
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setResult: (value: ResultType | Error) => void;'
+ return:
+ type: '(value: ResultType | ) => void'
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel.yml b/docs/docs-ref-autogen/excel_1_17/excel.yml
new file mode 100644
index 0000000000..9c7d992ce8
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel.yml
@@ -0,0 +1,1240 @@
+### YamlMime:TSPackage
+uid: excel!
+name: excel
+type: package
+summary: ''
+enums:
+ - 'excel!Excel.AggregationFunction:enum'
+ - 'excel!Excel.ArrowheadLength:enum'
+ - 'excel!Excel.ArrowheadStyle:enum'
+ - 'excel!Excel.ArrowheadWidth:enum'
+ - 'excel!Excel.AutoFillType:enum'
+ - 'excel!Excel.BindingType:enum'
+ - 'excel!Excel.BlockedErrorCellValueSubType:enum'
+ - 'excel!Excel.BorderIndex:enum'
+ - 'excel!Excel.BorderLineStyle:enum'
+ - 'excel!Excel.BorderWeight:enum'
+ - 'excel!Excel.BuiltInStyle:enum'
+ - 'excel!Excel.BusyErrorCellValueSubType:enum'
+ - 'excel!Excel.CalcErrorCellValueSubType:enum'
+ - 'excel!Excel.CalculationMode:enum'
+ - 'excel!Excel.CalculationState:enum'
+ - 'excel!Excel.CalculationType:enum'
+ - 'excel!Excel.CellValueType:enum'
+ - 'excel!Excel.ChartAxisCategoryType:enum'
+ - 'excel!Excel.ChartAxisDisplayUnit:enum'
+ - 'excel!Excel.ChartAxisGroup:enum'
+ - 'excel!Excel.ChartAxisPosition:enum'
+ - 'excel!Excel.ChartAxisScaleType:enum'
+ - 'excel!Excel.ChartAxisTickLabelPosition:enum'
+ - 'excel!Excel.ChartAxisTickMark:enum'
+ - 'excel!Excel.ChartAxisTimeUnit:enum'
+ - 'excel!Excel.ChartAxisType:enum'
+ - 'excel!Excel.ChartBinType:enum'
+ - 'excel!Excel.ChartBoxQuartileCalculation:enum'
+ - 'excel!Excel.ChartColorScheme:enum'
+ - 'excel!Excel.ChartDataLabelPosition:enum'
+ - 'excel!Excel.ChartDataSourceType:enum'
+ - 'excel!Excel.ChartDisplayBlanksAs:enum'
+ - 'excel!Excel.ChartErrorBarsInclude:enum'
+ - 'excel!Excel.ChartErrorBarsType:enum'
+ - 'excel!Excel.ChartGradientStyle:enum'
+ - 'excel!Excel.ChartGradientStyleType:enum'
+ - 'excel!Excel.ChartLegendPosition:enum'
+ - 'excel!Excel.ChartLineStyle:enum'
+ - 'excel!Excel.ChartMapAreaLevel:enum'
+ - 'excel!Excel.ChartMapLabelStrategy:enum'
+ - 'excel!Excel.ChartMapProjectionType:enum'
+ - 'excel!Excel.ChartMarkerStyle:enum'
+ - 'excel!Excel.ChartParentLabelStrategy:enum'
+ - 'excel!Excel.ChartPlotAreaPosition:enum'
+ - 'excel!Excel.ChartPlotBy:enum'
+ - 'excel!Excel.ChartSeriesBy:enum'
+ - 'excel!Excel.ChartSeriesDimension:enum'
+ - 'excel!Excel.ChartSplitType:enum'
+ - 'excel!Excel.ChartTextHorizontalAlignment:enum'
+ - 'excel!Excel.ChartTextVerticalAlignment:enum'
+ - 'excel!Excel.ChartTickLabelAlignment:enum'
+ - 'excel!Excel.ChartTitlePosition:enum'
+ - 'excel!Excel.ChartTrendlineType:enum'
+ - 'excel!Excel.ChartType:enum'
+ - 'excel!Excel.ChartUnderlineStyle:enum'
+ - 'excel!Excel.ClearApplyTo:enum'
+ - 'excel!Excel.CloseBehavior:enum'
+ - 'excel!Excel.CommentChangeType:enum'
+ - 'excel!Excel.ConditionalCellValueOperator:enum'
+ - 'excel!Excel.ConditionalDataBarAxisFormat:enum'
+ - 'excel!Excel.ConditionalDataBarDirection:enum'
+ - 'excel!Excel.ConditionalFormatColorCriterionType:enum'
+ - 'excel!Excel.ConditionalFormatDirection:enum'
+ - 'excel!Excel.ConditionalFormatIconRuleType:enum'
+ - 'excel!Excel.ConditionalFormatPresetCriterion:enum'
+ - 'excel!Excel.ConditionalFormatRuleType:enum'
+ - 'excel!Excel.ConditionalFormatType:enum'
+ - 'excel!Excel.ConditionalIconCriterionOperator:enum'
+ - 'excel!Excel.ConditionalRangeBorderIndex:enum'
+ - 'excel!Excel.ConditionalRangeBorderLineStyle:enum'
+ - 'excel!Excel.ConditionalRangeFontUnderlineStyle:enum'
+ - 'excel!Excel.ConditionalTextOperator:enum'
+ - 'excel!Excel.ConditionalTopBottomCriterionType:enum'
+ - 'excel!Excel.ConnectErrorCellValueSubType:enum'
+ - 'excel!Excel.ConnectorType:enum'
+ - 'excel!Excel.ContentType:enum'
+ - 'excel!Excel.DataChangeType:enum'
+ - 'excel!Excel.DataSourceType:enum'
+ - 'excel!Excel.DataValidationAlertStyle:enum'
+ - 'excel!Excel.DataValidationOperator:enum'
+ - 'excel!Excel.DataValidationType:enum'
+ - 'excel!Excel.DateFilterCondition:enum'
+ - 'excel!Excel.DeleteShiftDirection:enum'
+ - 'excel!Excel.DocumentPropertyItem:enum'
+ - 'excel!Excel.DocumentPropertyType:enum'
+ - 'excel!Excel.DynamicFilterCriteria:enum'
+ - 'excel!Excel.EntityCompactLayoutIcons:enum'
+ - 'excel!Excel.ErrorCellValueType:enum'
+ - 'excel!Excel.ErrorCodes:enum'
+ - 'excel!Excel.EventSource:enum'
+ - 'excel!Excel.EventTriggerSource:enum'
+ - 'excel!Excel.EventType:enum'
+ - 'excel!Excel.ExternalErrorCellValueSubType:enum'
+ - 'excel!Excel.FieldErrorCellValueSubType:enum'
+ - 'excel!Excel.FillPattern:enum'
+ - 'excel!Excel.FilterDatetimeSpecificity:enum'
+ - 'excel!Excel.FilterOn:enum'
+ - 'excel!Excel.FilterOperator:enum'
+ - 'excel!Excel.GeometricShapeType:enum'
+ - 'excel!Excel.GroupOption:enum'
+ - 'excel!Excel.HeaderFooterState:enum'
+ - 'excel!Excel.HorizontalAlignment:enum'
+ - 'excel!Excel.IconSet:enum'
+ - 'excel!Excel.ImageFittingMode:enum'
+ - 'excel!Excel.InsertShiftDirection:enum'
+ - 'excel!Excel.KeyboardDirection:enum'
+ - 'excel!Excel.LabelFilterCondition:enum'
+ - 'excel!Excel.LinkedDataTypeState:enum'
+ - 'excel!Excel.LoadToType:enum'
+ - 'excel!Excel.NamedItemScope:enum'
+ - 'excel!Excel.NamedItemType:enum'
+ - 'excel!Excel.NumberFormatCategory:enum'
+ - 'excel!Excel.NumErrorCellValueSubType:enum'
+ - 'excel!Excel.PageOrientation:enum'
+ - 'excel!Excel.PaperType:enum'
+ - 'excel!Excel.PictureFormat:enum'
+ - 'excel!Excel.PivotAxis:enum'
+ - 'excel!Excel.PivotFilterTopBottomCriterion:enum'
+ - 'excel!Excel.PivotFilterType:enum'
+ - 'excel!Excel.PivotLayoutType:enum'
+ - 'excel!Excel.Placement:enum'
+ - 'excel!Excel.PrintComments:enum'
+ - 'excel!Excel.PrintErrorType:enum'
+ - 'excel!Excel.PrintMarginUnit:enum'
+ - 'excel!Excel.PrintOrder:enum'
+ - 'excel!Excel.ProtectionSelectionMode:enum'
+ - 'excel!Excel.QueryError:enum'
+ - 'excel!Excel.RangeCopyType:enum'
+ - 'excel!Excel.RangeUnderlineStyle:enum'
+ - 'excel!Excel.RangeValueType:enum'
+ - 'excel!Excel.ReadingOrder:enum'
+ - 'excel!Excel.ReferenceValueType:enum'
+ - 'excel!Excel.RefErrorCellValueSubType:enum'
+ - 'excel!Excel.RibbonTab:enum'
+ - 'excel!Excel.RowHiddenChangeType:enum'
+ - 'excel!Excel.SaveBehavior:enum'
+ - 'excel!Excel.SearchDirection:enum'
+ - 'excel!Excel.ShapeAutoSize:enum'
+ - 'excel!Excel.ShapeFillType:enum'
+ - 'excel!Excel.ShapeFontUnderlineStyle:enum'
+ - 'excel!Excel.ShapeLineDashStyle:enum'
+ - 'excel!Excel.ShapeLineStyle:enum'
+ - 'excel!Excel.ShapeScaleFrom:enum'
+ - 'excel!Excel.ShapeScaleType:enum'
+ - 'excel!Excel.ShapeTextHorizontalAlignment:enum'
+ - 'excel!Excel.ShapeTextHorizontalOverflow:enum'
+ - 'excel!Excel.ShapeTextOrientation:enum'
+ - 'excel!Excel.ShapeTextReadingOrder:enum'
+ - 'excel!Excel.ShapeTextVerticalAlignment:enum'
+ - 'excel!Excel.ShapeTextVerticalOverflow:enum'
+ - 'excel!Excel.ShapeType:enum'
+ - 'excel!Excel.ShapeZOrder:enum'
+ - 'excel!Excel.SheetVisibility:enum'
+ - 'excel!Excel.ShowAsCalculation:enum'
+ - 'excel!Excel.SlicerSortType:enum'
+ - 'excel!Excel.SortBy:enum'
+ - 'excel!Excel.SortDataOption:enum'
+ - 'excel!Excel.SortMethod:enum'
+ - 'excel!Excel.SortOn:enum'
+ - 'excel!Excel.SortOrientation:enum'
+ - 'excel!Excel.SpecialCellType:enum'
+ - 'excel!Excel.SpecialCellValueType:enum'
+ - 'excel!Excel.SpillErrorCellValueSubType:enum'
+ - 'excel!Excel.SubtotalLocationType:enum'
+ - 'excel!Excel.TopBottomSelectionType:enum'
+ - 'excel!Excel.ValueErrorCellValueSubType:enum'
+ - 'excel!Excel.ValueFilterCondition:enum'
+ - 'excel!Excel.VerticalAlignment:enum'
+ - 'excel!Excel.WorksheetPositionType:enum'
+classes:
+ - 'excel!Excel.Application:class'
+ - 'excel!Excel.AutoFilter:class'
+ - 'excel!Excel.Binding:class'
+ - 'excel!Excel.BindingCollection:class'
+ - 'excel!Excel.CellValueConditionalFormat:class'
+ - 'excel!Excel.Chart:class'
+ - 'excel!Excel.ChartAreaFormat:class'
+ - 'excel!Excel.ChartAxes:class'
+ - 'excel!Excel.ChartAxis:class'
+ - 'excel!Excel.ChartAxisFormat:class'
+ - 'excel!Excel.ChartAxisTitle:class'
+ - 'excel!Excel.ChartAxisTitleFormat:class'
+ - 'excel!Excel.ChartBinOptions:class'
+ - 'excel!Excel.ChartBorder:class'
+ - 'excel!Excel.ChartBoxwhiskerOptions:class'
+ - 'excel!Excel.ChartCollection:class'
+ - 'excel!Excel.ChartDataLabel:class'
+ - 'excel!Excel.ChartDataLabelFormat:class'
+ - 'excel!Excel.ChartDataLabels:class'
+ - 'excel!Excel.ChartDataTable:class'
+ - 'excel!Excel.ChartDataTableFormat:class'
+ - 'excel!Excel.ChartErrorBars:class'
+ - 'excel!Excel.ChartErrorBarsFormat:class'
+ - 'excel!Excel.ChartFill:class'
+ - 'excel!Excel.ChartFont:class'
+ - 'excel!Excel.ChartFormatString:class'
+ - 'excel!Excel.ChartGridlines:class'
+ - 'excel!Excel.ChartGridlinesFormat:class'
+ - 'excel!Excel.ChartLegend:class'
+ - 'excel!Excel.ChartLegendEntry:class'
+ - 'excel!Excel.ChartLegendEntryCollection:class'
+ - 'excel!Excel.ChartLegendFormat:class'
+ - 'excel!Excel.ChartLineFormat:class'
+ - 'excel!Excel.ChartMapOptions:class'
+ - 'excel!Excel.ChartPivotOptions:class'
+ - 'excel!Excel.ChartPlotArea:class'
+ - 'excel!Excel.ChartPlotAreaFormat:class'
+ - 'excel!Excel.ChartPoint:class'
+ - 'excel!Excel.ChartPointFormat:class'
+ - 'excel!Excel.ChartPointsCollection:class'
+ - 'excel!Excel.ChartSeries:class'
+ - 'excel!Excel.ChartSeriesCollection:class'
+ - 'excel!Excel.ChartSeriesFormat:class'
+ - 'excel!Excel.ChartTitle:class'
+ - 'excel!Excel.ChartTitleFormat:class'
+ - 'excel!Excel.ChartTrendline:class'
+ - 'excel!Excel.ChartTrendlineCollection:class'
+ - 'excel!Excel.ChartTrendlineFormat:class'
+ - 'excel!Excel.ChartTrendlineLabel:class'
+ - 'excel!Excel.ChartTrendlineLabelFormat:class'
+ - 'excel!Excel.ColorScaleConditionalFormat:class'
+ - 'excel!Excel.Comment:class'
+ - 'excel!Excel.CommentCollection:class'
+ - 'excel!Excel.CommentReply:class'
+ - 'excel!Excel.CommentReplyCollection:class'
+ - 'excel!Excel.ConditionalDataBarNegativeFormat:class'
+ - 'excel!Excel.ConditionalDataBarPositiveFormat:class'
+ - 'excel!Excel.ConditionalFormat:class'
+ - 'excel!Excel.ConditionalFormatCollection:class'
+ - 'excel!Excel.ConditionalFormatRule:class'
+ - 'excel!Excel.ConditionalRangeBorder:class'
+ - 'excel!Excel.ConditionalRangeBorderCollection:class'
+ - 'excel!Excel.ConditionalRangeFill:class'
+ - 'excel!Excel.ConditionalRangeFont:class'
+ - 'excel!Excel.ConditionalRangeFormat:class'
+ - 'excel!Excel.CultureInfo:class'
+ - 'excel!Excel.CustomConditionalFormat:class'
+ - 'excel!Excel.CustomProperty:class'
+ - 'excel!Excel.CustomPropertyCollection:class'
+ - 'excel!Excel.CustomXmlPart:class'
+ - 'excel!Excel.CustomXmlPartCollection:class'
+ - 'excel!Excel.CustomXmlPartScopedCollection:class'
+ - 'excel!Excel.DataBarConditionalFormat:class'
+ - 'excel!Excel.DataConnectionCollection:class'
+ - 'excel!Excel.DataPivotHierarchy:class'
+ - 'excel!Excel.DataPivotHierarchyCollection:class'
+ - 'excel!Excel.DataValidation:class'
+ - 'excel!Excel.DatetimeFormatInfo:class'
+ - 'excel!Excel.DocumentProperties:class'
+ - 'excel!Excel.Filter:class'
+ - 'excel!Excel.FilterPivotHierarchy:class'
+ - 'excel!Excel.FilterPivotHierarchyCollection:class'
+ - 'excel!Excel.FormatProtection:class'
+ - 'excel!Excel.FunctionResult:class'
+ - 'excel!Excel.Functions:class'
+ - 'excel!Excel.GeometricShape:class'
+ - 'excel!Excel.GroupShapeCollection:class'
+ - 'excel!Excel.HeaderFooter:class'
+ - 'excel!Excel.HeaderFooterGroup:class'
+ - 'excel!Excel.IconSetConditionalFormat:class'
+ - 'excel!Excel.Image:class'
+ - 'excel!Excel.IterativeCalculation:class'
+ - 'excel!Excel.Line:class'
+ - 'excel!Excel.NamedItem:class'
+ - 'excel!Excel.NamedItemArrayValues:class'
+ - 'excel!Excel.NamedItemCollection:class'
+ - 'excel!Excel.NumberFormatInfo:class'
+ - 'excel!Excel.PageBreak:class'
+ - 'excel!Excel.PageBreakCollection:class'
+ - 'excel!Excel.PageLayout:class'
+ - 'excel!Excel.PivotField:class'
+ - 'excel!Excel.PivotFieldCollection:class'
+ - 'excel!Excel.PivotHierarchy:class'
+ - 'excel!Excel.PivotHierarchyCollection:class'
+ - 'excel!Excel.PivotItem:class'
+ - 'excel!Excel.PivotItemCollection:class'
+ - 'excel!Excel.PivotLayout:class'
+ - 'excel!Excel.PivotTable:class'
+ - 'excel!Excel.PivotTableCollection:class'
+ - 'excel!Excel.PivotTableScopedCollection:class'
+ - 'excel!Excel.PivotTableStyle:class'
+ - 'excel!Excel.PivotTableStyleCollection:class'
+ - 'excel!Excel.PresetCriteriaConditionalFormat:class'
+ - 'excel!Excel.Query:class'
+ - 'excel!Excel.QueryCollection:class'
+ - 'excel!Excel.Range:class'
+ - 'excel!Excel.RangeAreas:class'
+ - 'excel!Excel.RangeAreasCollection:class'
+ - 'excel!Excel.RangeBorder:class'
+ - 'excel!Excel.RangeBorderCollection:class'
+ - 'excel!Excel.RangeCollection:class'
+ - 'excel!Excel.RangeFill:class'
+ - 'excel!Excel.RangeFont:class'
+ - 'excel!Excel.RangeFormat:class'
+ - 'excel!Excel.RangeSort:class'
+ - 'excel!Excel.RangeView:class'
+ - 'excel!Excel.RangeViewCollection:class'
+ - 'excel!Excel.RemoveDuplicatesResult:class'
+ - 'excel!Excel.RequestContext:class'
+ - 'excel!Excel.RowColumnPivotHierarchy:class'
+ - 'excel!Excel.RowColumnPivotHierarchyCollection:class'
+ - 'excel!Excel.Runtime:class'
+ - 'excel!Excel.Setting:class'
+ - 'excel!Excel.SettingCollection:class'
+ - 'excel!Excel.Shape:class'
+ - 'excel!Excel.ShapeCollection:class'
+ - 'excel!Excel.ShapeFill:class'
+ - 'excel!Excel.ShapeFont:class'
+ - 'excel!Excel.ShapeGroup:class'
+ - 'excel!Excel.ShapeLineFormat:class'
+ - 'excel!Excel.Slicer:class'
+ - 'excel!Excel.SlicerCollection:class'
+ - 'excel!Excel.SlicerItem:class'
+ - 'excel!Excel.SlicerItemCollection:class'
+ - 'excel!Excel.SlicerStyle:class'
+ - 'excel!Excel.SlicerStyleCollection:class'
+ - 'excel!Excel.Style:class'
+ - 'excel!Excel.StyleCollection:class'
+ - 'excel!Excel.Table:class'
+ - 'excel!Excel.TableCollection:class'
+ - 'excel!Excel.TableColumn:class'
+ - 'excel!Excel.TableColumnCollection:class'
+ - 'excel!Excel.TableRow:class'
+ - 'excel!Excel.TableRowCollection:class'
+ - 'excel!Excel.TableScopedCollection:class'
+ - 'excel!Excel.TableSort:class'
+ - 'excel!Excel.TableStyle:class'
+ - 'excel!Excel.TableStyleCollection:class'
+ - 'excel!Excel.TextConditionalFormat:class'
+ - 'excel!Excel.TextFrame:class'
+ - 'excel!Excel.TextRange:class'
+ - 'excel!Excel.TimelineStyle:class'
+ - 'excel!Excel.TimelineStyleCollection:class'
+ - 'excel!Excel.TopBottomConditionalFormat:class'
+ - 'excel!Excel.Workbook:class'
+ - 'excel!Excel.WorkbookCreated:class'
+ - 'excel!Excel.WorkbookProtection:class'
+ - 'excel!Excel.WorkbookRangeAreas:class'
+ - 'excel!Excel.Worksheet:class'
+ - 'excel!Excel.WorksheetCollection:class'
+ - 'excel!Excel.WorksheetCustomProperty:class'
+ - 'excel!Excel.WorksheetCustomPropertyCollection:class'
+ - 'excel!Excel.WorksheetFreezePanes:class'
+ - 'excel!Excel.WorksheetProtection:class'
+interfaces:
+ - 'excel!Excel.ArrayCellValue:interface'
+ - 'excel!Excel.BasicDataValidation:interface'
+ - 'excel!Excel.BindingDataChangedEventArgs:interface'
+ - 'excel!Excel.BindingSelectionChangedEventArgs:interface'
+ - 'excel!Excel.BlockedErrorCellValue:interface'
+ - 'excel!Excel.BooleanCellValue:interface'
+ - 'excel!Excel.BusyErrorCellValue:interface'
+ - 'excel!Excel.CalcErrorCellValue:interface'
+ - 'excel!Excel.CardLayoutListSection:interface'
+ - 'excel!Excel.CardLayoutPropertyReference:interface'
+ - 'excel!Excel.CardLayoutSectionStandardProperties:interface'
+ - 'excel!Excel.CardLayoutStandardProperties:interface'
+ - 'excel!Excel.CardLayoutTableSection:interface'
+ - 'excel!Excel.CellBorder:interface'
+ - 'excel!Excel.CellBorderCollection:interface'
+ - 'excel!Excel.CellProperties:interface'
+ - 'excel!Excel.CellPropertiesBorderLoadOptions:interface'
+ - 'excel!Excel.CellPropertiesFill:interface'
+ - 'excel!Excel.CellPropertiesFillLoadOptions:interface'
+ - 'excel!Excel.CellPropertiesFont:interface'
+ - 'excel!Excel.CellPropertiesFontLoadOptions:interface'
+ - 'excel!Excel.CellPropertiesFormat:interface'
+ - 'excel!Excel.CellPropertiesFormatLoadOptions:interface'
+ - 'excel!Excel.CellPropertiesLoadOptions:interface'
+ - 'excel!Excel.CellPropertiesProtection:interface'
+ - 'excel!Excel.CellValueAttributionAttributes:interface'
+ - 'excel!Excel.CellValueExtraProperties:interface'
+ - 'excel!Excel.CellValuePropertyMetadata:interface'
+ - 'excel!Excel.CellValuePropertyMetadataExclusions:interface'
+ - 'excel!Excel.CellValueProviderAttributes:interface'
+ - 'excel!Excel.ChangedEventDetail:interface'
+ - 'excel!Excel.ChangeDirectionState:interface'
+ - 'excel!Excel.ChartActivatedEventArgs:interface'
+ - 'excel!Excel.ChartAddedEventArgs:interface'
+ - 'excel!Excel.ChartDeactivatedEventArgs:interface'
+ - 'excel!Excel.ChartDeletedEventArgs:interface'
+ - 'excel!Excel.ColumnProperties:interface'
+ - 'excel!Excel.ColumnPropertiesLoadOptions:interface'
+ - 'excel!Excel.CommentAddedEventArgs:interface'
+ - 'excel!Excel.CommentChangedEventArgs:interface'
+ - 'excel!Excel.CommentDeletedEventArgs:interface'
+ - 'excel!Excel.CommentDetail:interface'
+ - 'excel!Excel.CommentMention:interface'
+ - 'excel!Excel.CommentRichContent:interface'
+ - 'excel!Excel.ConditionalCellValueRule:interface'
+ - 'excel!Excel.ConditionalColorScaleCriteria:interface'
+ - 'excel!Excel.ConditionalColorScaleCriterion:interface'
+ - 'excel!Excel.ConditionalDataBarRule:interface'
+ - 'excel!Excel.ConditionalIconCriterion:interface'
+ - 'excel!Excel.ConditionalPresetCriteriaRule:interface'
+ - 'excel!Excel.ConditionalTextComparisonRule:interface'
+ - 'excel!Excel.ConditionalTopBottomRule:interface'
+ - 'excel!Excel.ConnectErrorCellValue:interface'
+ - 'excel!Excel.CustomDataValidation:interface'
+ - 'excel!Excel.DataValidationErrorAlert:interface'
+ - 'excel!Excel.DataValidationPrompt:interface'
+ - 'excel!Excel.DataValidationRule:interface'
+ - 'excel!Excel.DateTimeDataValidation:interface'
+ - 'excel!Excel.Div0ErrorCellValue:interface'
+ - 'excel!Excel.DoubleCellValue:interface'
+ - 'excel!Excel.EmptyCellValue:interface'
+ - 'excel!Excel.EntityCardLayout:interface'
+ - 'excel!Excel.EntityCellValue:interface'
+ - 'excel!Excel.EntityCompactLayout:interface'
+ - 'excel!Excel.EntityPropertyExtraProperties:interface'
+ - 'excel!Excel.EntityViewLayouts:interface'
+ - 'excel!Excel.ExternalErrorCellValue:interface'
+ - 'excel!Excel.FieldErrorCellValue:interface'
+ - 'excel!Excel.FilterCriteria:interface'
+ - 'excel!Excel.FilterDatetime:interface'
+ - 'excel!Excel.FiveArrowsGraySet:interface'
+ - 'excel!Excel.FiveArrowsSet:interface'
+ - 'excel!Excel.FiveBoxesSet:interface'
+ - 'excel!Excel.FiveQuartersSet:interface'
+ - 'excel!Excel.FiveRatingSet:interface'
+ - 'excel!Excel.FormattedNumberCellValue:interface'
+ - 'excel!Excel.FormulaChangedEventDetail:interface'
+ - 'excel!Excel.FourArrowsGraySet:interface'
+ - 'excel!Excel.FourArrowsSet:interface'
+ - 'excel!Excel.FourRatingSet:interface'
+ - 'excel!Excel.FourRedToBlackSet:interface'
+ - 'excel!Excel.FourTrafficLightsSet:interface'
+ - 'excel!Excel.GettingDataErrorCellValue:interface'
+ - 'excel!Excel.Icon:interface'
+ - 'excel!Excel.IconCollections:interface'
+ - 'excel!Excel.InsertWorksheetOptions:interface'
+ - 'excel!Excel.Interfaces.AllowEditRangeCollectionData:interface'
+ - 'excel!Excel.Interfaces.AllowEditRangeCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.AllowEditRangeData:interface'
+ - 'excel!Excel.Interfaces.AllowEditRangeUpdateData:interface'
+ - 'excel!Excel.Interfaces.ApplicationData:interface'
+ - 'excel!Excel.Interfaces.ApplicationLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ApplicationUpdateData:interface'
+ - 'excel!Excel.Interfaces.AutoFilterData:interface'
+ - 'excel!Excel.Interfaces.AutoFilterLoadOptions:interface'
+ - 'excel!Excel.Interfaces.BindingCollectionData:interface'
+ - 'excel!Excel.Interfaces.BindingCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.BindingCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.BindingData:interface'
+ - 'excel!Excel.Interfaces.BindingLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CellValueConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.CellValueConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CellValueConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartAreaFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartAreaFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartAreaFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartAxesData:interface'
+ - 'excel!Excel.Interfaces.ChartAxesLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartAxesUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartAxisFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartAxisTitleData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisTitleFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisTitleFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartAxisTitleFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisTitleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartAxisTitleUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartAxisUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartBinOptionsData:interface'
+ - 'excel!Excel.Interfaces.ChartBinOptionsLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartBinOptionsUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartBorderData:interface'
+ - 'excel!Excel.Interfaces.ChartBorderLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartBorderUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartBoxwhiskerOptionsData:interface'
+ - 'excel!Excel.Interfaces.ChartBoxwhiskerOptionsLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartBoxwhiskerOptionsUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartCollectionData:interface'
+ - 'excel!Excel.Interfaces.ChartCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartData:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelData:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelsData:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelsLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelsUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartDataLabelUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartDataTableData:interface'
+ - 'excel!Excel.Interfaces.ChartDataTableFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartDataTableFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartDataTableFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartDataTableLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartDataTableUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartErrorBarsData:interface'
+ - 'excel!Excel.Interfaces.ChartErrorBarsFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartErrorBarsFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartErrorBarsFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartErrorBarsLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartErrorBarsUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartFontData:interface'
+ - 'excel!Excel.Interfaces.ChartFontLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartFontUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartFormatStringData:interface'
+ - 'excel!Excel.Interfaces.ChartFormatStringLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartFormatStringUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartGridlinesData:interface'
+ - 'excel!Excel.Interfaces.ChartGridlinesFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartGridlinesFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartGridlinesFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartGridlinesLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartGridlinesUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendEntryCollectionData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendEntryCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartLegendEntryCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendEntryData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendEntryLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartLegendEntryUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartLegendFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartLegendLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartLegendUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartLineFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartLineFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartLineFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartMapOptionsData:interface'
+ - 'excel!Excel.Interfaces.ChartMapOptionsLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartMapOptionsUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartPivotOptionsData:interface'
+ - 'excel!Excel.Interfaces.ChartPivotOptionsLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartPivotOptionsUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartPlotAreaData:interface'
+ - 'excel!Excel.Interfaces.ChartPlotAreaFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartPlotAreaFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartPlotAreaFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartPlotAreaLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartPlotAreaUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartPointData:interface'
+ - 'excel!Excel.Interfaces.ChartPointFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartPointFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartPointFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartPointLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartPointsCollectionData:interface'
+ - 'excel!Excel.Interfaces.ChartPointsCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartPointsCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartPointUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesCollectionData:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesData:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartSeriesUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartTitleData:interface'
+ - 'excel!Excel.Interfaces.ChartTitleFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartTitleFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartTitleFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartTitleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartTitleUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineCollectionData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineLabelData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineLabelFormatData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineLabelFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineLabelFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineLabelLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineLabelUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ChartTrendlineUpdateData:interface'
+ - 'excel!Excel.Interfaces.ChartUpdateData:interface'
+ - 'excel!Excel.Interfaces.CollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ColorScaleConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.ColorScaleConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ColorScaleConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.CommentCollectionData:interface'
+ - 'excel!Excel.Interfaces.CommentCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CommentCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.CommentData:interface'
+ - 'excel!Excel.Interfaces.CommentLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CommentReplyCollectionData:interface'
+ - 'excel!Excel.Interfaces.CommentReplyCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CommentReplyCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.CommentReplyData:interface'
+ - 'excel!Excel.Interfaces.CommentReplyLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CommentReplyUpdateData:interface'
+ - 'excel!Excel.Interfaces.CommentUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalDataBarNegativeFormatData:interface'
+ - 'excel!Excel.Interfaces.ConditionalDataBarNegativeFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalDataBarNegativeFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalDataBarPositiveFormatData:interface'
+ - 'excel!Excel.Interfaces.ConditionalDataBarPositiveFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalDataBarPositiveFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatCollectionData:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatRuleData:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatRuleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatRuleUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeBorderCollectionData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeBorderCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeBorderCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeBorderData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeBorderLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeBorderUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFillData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFillLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFillUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFontData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFontLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFontUpdateData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFormatData:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ConditionalRangeFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.CultureInfoData:interface'
+ - 'excel!Excel.Interfaces.CultureInfoLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CustomConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.CustomConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CustomConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.CustomPropertyCollectionData:interface'
+ - 'excel!Excel.Interfaces.CustomPropertyCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CustomPropertyCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.CustomPropertyData:interface'
+ - 'excel!Excel.Interfaces.CustomPropertyLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CustomPropertyUpdateData:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartCollectionData:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartData:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartScopedCollectionData:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartScopedCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.CustomXmlPartScopedCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.DataBarConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.DataBarConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.DataBarConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.DataPivotHierarchyCollectionData:interface'
+ - 'excel!Excel.Interfaces.DataPivotHierarchyCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.DataPivotHierarchyCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.DataPivotHierarchyData:interface'
+ - 'excel!Excel.Interfaces.DataPivotHierarchyLoadOptions:interface'
+ - 'excel!Excel.Interfaces.DataPivotHierarchyUpdateData:interface'
+ - 'excel!Excel.Interfaces.DataValidationData:interface'
+ - 'excel!Excel.Interfaces.DataValidationLoadOptions:interface'
+ - 'excel!Excel.Interfaces.DataValidationUpdateData:interface'
+ - 'excel!Excel.Interfaces.DatetimeFormatInfoData:interface'
+ - 'excel!Excel.Interfaces.DatetimeFormatInfoLoadOptions:interface'
+ - 'excel!Excel.Interfaces.DocumentPropertiesData:interface'
+ - 'excel!Excel.Interfaces.DocumentPropertiesLoadOptions:interface'
+ - 'excel!Excel.Interfaces.DocumentPropertiesUpdateData:interface'
+ - 'excel!Excel.Interfaces.FilterData:interface'
+ - 'excel!Excel.Interfaces.FilterLoadOptions:interface'
+ - 'excel!Excel.Interfaces.FilterPivotHierarchyCollectionData:interface'
+ - 'excel!Excel.Interfaces.FilterPivotHierarchyCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.FilterPivotHierarchyCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.FilterPivotHierarchyData:interface'
+ - 'excel!Excel.Interfaces.FilterPivotHierarchyLoadOptions:interface'
+ - 'excel!Excel.Interfaces.FilterPivotHierarchyUpdateData:interface'
+ - 'excel!Excel.Interfaces.FormatProtectionData:interface'
+ - 'excel!Excel.Interfaces.FormatProtectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.FormatProtectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.FunctionResultData:interface'
+ - 'excel!Excel.Interfaces.FunctionResultLoadOptions:interface'
+ - 'excel!Excel.Interfaces.GeometricShapeData:interface'
+ - 'excel!Excel.Interfaces.GeometricShapeLoadOptions:interface'
+ - 'excel!Excel.Interfaces.GroupShapeCollectionData:interface'
+ - 'excel!Excel.Interfaces.GroupShapeCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.GroupShapeCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.HeaderFooterData:interface'
+ - 'excel!Excel.Interfaces.HeaderFooterGroupData:interface'
+ - 'excel!Excel.Interfaces.HeaderFooterGroupLoadOptions:interface'
+ - 'excel!Excel.Interfaces.HeaderFooterGroupUpdateData:interface'
+ - 'excel!Excel.Interfaces.HeaderFooterLoadOptions:interface'
+ - 'excel!Excel.Interfaces.HeaderFooterUpdateData:interface'
+ - 'excel!Excel.Interfaces.IconSetConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.IconSetConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.IconSetConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ImageData:interface'
+ - 'excel!Excel.Interfaces.ImageLoadOptions:interface'
+ - 'excel!Excel.Interfaces.IterativeCalculationData:interface'
+ - 'excel!Excel.Interfaces.IterativeCalculationLoadOptions:interface'
+ - 'excel!Excel.Interfaces.IterativeCalculationUpdateData:interface'
+ - 'excel!Excel.Interfaces.LineData:interface'
+ - 'excel!Excel.Interfaces.LineLoadOptions:interface'
+ - 'excel!Excel.Interfaces.LineUpdateData:interface'
+ - 'excel!Excel.Interfaces.LinkedWorkbookCollectionData:interface'
+ - 'excel!Excel.Interfaces.LinkedWorkbookCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.LinkedWorkbookData:interface'
+ - 'excel!Excel.Interfaces.NamedItemArrayValuesData:interface'
+ - 'excel!Excel.Interfaces.NamedItemArrayValuesLoadOptions:interface'
+ - 'excel!Excel.Interfaces.NamedItemCollectionData:interface'
+ - 'excel!Excel.Interfaces.NamedItemCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.NamedItemCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.NamedItemData:interface'
+ - 'excel!Excel.Interfaces.NamedItemLoadOptions:interface'
+ - 'excel!Excel.Interfaces.NamedItemUpdateData:interface'
+ - 'excel!Excel.Interfaces.NamedSheetViewCollectionData:interface'
+ - 'excel!Excel.Interfaces.NamedSheetViewCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.NamedSheetViewData:interface'
+ - 'excel!Excel.Interfaces.NamedSheetViewUpdateData:interface'
+ - 'excel!Excel.Interfaces.NumberFormatInfoData:interface'
+ - 'excel!Excel.Interfaces.NumberFormatInfoLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PageBreakCollectionData:interface'
+ - 'excel!Excel.Interfaces.PageBreakCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PageBreakCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.PageBreakData:interface'
+ - 'excel!Excel.Interfaces.PageBreakLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PageLayoutData:interface'
+ - 'excel!Excel.Interfaces.PageLayoutLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PageLayoutUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotFieldCollectionData:interface'
+ - 'excel!Excel.Interfaces.PivotFieldCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotFieldCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotFieldData:interface'
+ - 'excel!Excel.Interfaces.PivotFieldLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotFieldUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotHierarchyCollectionData:interface'
+ - 'excel!Excel.Interfaces.PivotHierarchyCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotHierarchyCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotHierarchyData:interface'
+ - 'excel!Excel.Interfaces.PivotHierarchyLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotHierarchyUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotItemCollectionData:interface'
+ - 'excel!Excel.Interfaces.PivotItemCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotItemCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotItemData:interface'
+ - 'excel!Excel.Interfaces.PivotItemLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotItemUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotLayoutData:interface'
+ - 'excel!Excel.Interfaces.PivotLayoutLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotLayoutUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotTableCollectionData:interface'
+ - 'excel!Excel.Interfaces.PivotTableCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotTableCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotTableData:interface'
+ - 'excel!Excel.Interfaces.PivotTableLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotTableScopedCollectionData:interface'
+ - 'excel!Excel.Interfaces.PivotTableScopedCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotTableScopedCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotTableStyleCollectionData:interface'
+ - 'excel!Excel.Interfaces.PivotTableStyleCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotTableStyleCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotTableStyleData:interface'
+ - 'excel!Excel.Interfaces.PivotTableStyleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PivotTableStyleUpdateData:interface'
+ - 'excel!Excel.Interfaces.PivotTableUpdateData:interface'
+ - 'excel!Excel.Interfaces.PresetCriteriaConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.PresetCriteriaConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.PresetCriteriaConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.QueryCollectionData:interface'
+ - 'excel!Excel.Interfaces.QueryCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.QueryCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.QueryData:interface'
+ - 'excel!Excel.Interfaces.QueryLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeAreasCollectionData:interface'
+ - 'excel!Excel.Interfaces.RangeAreasCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeAreasCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeAreasData:interface'
+ - 'excel!Excel.Interfaces.RangeAreasLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeAreasUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeBorderCollectionData:interface'
+ - 'excel!Excel.Interfaces.RangeBorderCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeBorderCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeBorderData:interface'
+ - 'excel!Excel.Interfaces.RangeBorderLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeBorderUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeCollectionData:interface'
+ - 'excel!Excel.Interfaces.RangeCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeData:interface'
+ - 'excel!Excel.Interfaces.RangeFillData:interface'
+ - 'excel!Excel.Interfaces.RangeFillLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeFillUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeFontData:interface'
+ - 'excel!Excel.Interfaces.RangeFontLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeFontUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeFormatData:interface'
+ - 'excel!Excel.Interfaces.RangeFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeViewCollectionData:interface'
+ - 'excel!Excel.Interfaces.RangeViewCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeViewCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.RangeViewData:interface'
+ - 'excel!Excel.Interfaces.RangeViewLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RangeViewUpdateData:interface'
+ - 'excel!Excel.Interfaces.RemoveDuplicatesResultData:interface'
+ - 'excel!Excel.Interfaces.RemoveDuplicatesResultLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RowColumnPivotHierarchyCollectionData:interface'
+ - 'excel!Excel.Interfaces.RowColumnPivotHierarchyCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RowColumnPivotHierarchyCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.RowColumnPivotHierarchyData:interface'
+ - 'excel!Excel.Interfaces.RowColumnPivotHierarchyLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RowColumnPivotHierarchyUpdateData:interface'
+ - 'excel!Excel.Interfaces.RuntimeData:interface'
+ - 'excel!Excel.Interfaces.RuntimeLoadOptions:interface'
+ - 'excel!Excel.Interfaces.RuntimeUpdateData:interface'
+ - 'excel!Excel.Interfaces.SettingCollectionData:interface'
+ - 'excel!Excel.Interfaces.SettingCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SettingCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.SettingData:interface'
+ - 'excel!Excel.Interfaces.SettingLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SettingUpdateData:interface'
+ - 'excel!Excel.Interfaces.ShapeCollectionData:interface'
+ - 'excel!Excel.Interfaces.ShapeCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ShapeCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.ShapeData:interface'
+ - 'excel!Excel.Interfaces.ShapeFillData:interface'
+ - 'excel!Excel.Interfaces.ShapeFillLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ShapeFillUpdateData:interface'
+ - 'excel!Excel.Interfaces.ShapeFontData:interface'
+ - 'excel!Excel.Interfaces.ShapeFontLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ShapeFontUpdateData:interface'
+ - 'excel!Excel.Interfaces.ShapeGroupData:interface'
+ - 'excel!Excel.Interfaces.ShapeGroupLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ShapeLineFormatData:interface'
+ - 'excel!Excel.Interfaces.ShapeLineFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ShapeLineFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.ShapeLoadOptions:interface'
+ - 'excel!Excel.Interfaces.ShapeUpdateData:interface'
+ - 'excel!Excel.Interfaces.SlicerCollectionData:interface'
+ - 'excel!Excel.Interfaces.SlicerCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SlicerCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.SlicerData:interface'
+ - 'excel!Excel.Interfaces.SlicerItemCollectionData:interface'
+ - 'excel!Excel.Interfaces.SlicerItemCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SlicerItemCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.SlicerItemData:interface'
+ - 'excel!Excel.Interfaces.SlicerItemLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SlicerItemUpdateData:interface'
+ - 'excel!Excel.Interfaces.SlicerLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SlicerStyleCollectionData:interface'
+ - 'excel!Excel.Interfaces.SlicerStyleCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SlicerStyleCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.SlicerStyleData:interface'
+ - 'excel!Excel.Interfaces.SlicerStyleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.SlicerStyleUpdateData:interface'
+ - 'excel!Excel.Interfaces.SlicerUpdateData:interface'
+ - 'excel!Excel.Interfaces.StyleCollectionData:interface'
+ - 'excel!Excel.Interfaces.StyleCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.StyleCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.StyleData:interface'
+ - 'excel!Excel.Interfaces.StyleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.StyleUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableCollectionData:interface'
+ - 'excel!Excel.Interfaces.TableCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableColumnCollectionData:interface'
+ - 'excel!Excel.Interfaces.TableColumnCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableColumnCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableColumnData:interface'
+ - 'excel!Excel.Interfaces.TableColumnLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableColumnUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableData:interface'
+ - 'excel!Excel.Interfaces.TableLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableRowCollectionData:interface'
+ - 'excel!Excel.Interfaces.TableRowCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableRowCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableRowData:interface'
+ - 'excel!Excel.Interfaces.TableRowLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableRowUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableScopedCollectionData:interface'
+ - 'excel!Excel.Interfaces.TableScopedCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableScopedCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableSortData:interface'
+ - 'excel!Excel.Interfaces.TableSortLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableStyleCollectionData:interface'
+ - 'excel!Excel.Interfaces.TableStyleCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableStyleCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableStyleData:interface'
+ - 'excel!Excel.Interfaces.TableStyleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TableStyleUpdateData:interface'
+ - 'excel!Excel.Interfaces.TableUpdateData:interface'
+ - 'excel!Excel.Interfaces.TextConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.TextConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TextConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.TextFrameData:interface'
+ - 'excel!Excel.Interfaces.TextFrameLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TextFrameUpdateData:interface'
+ - 'excel!Excel.Interfaces.TextRangeData:interface'
+ - 'excel!Excel.Interfaces.TextRangeLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TextRangeUpdateData:interface'
+ - 'excel!Excel.Interfaces.TimelineStyleCollectionData:interface'
+ - 'excel!Excel.Interfaces.TimelineStyleCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TimelineStyleCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.TimelineStyleData:interface'
+ - 'excel!Excel.Interfaces.TimelineStyleLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TimelineStyleUpdateData:interface'
+ - 'excel!Excel.Interfaces.TopBottomConditionalFormatData:interface'
+ - 'excel!Excel.Interfaces.TopBottomConditionalFormatLoadOptions:interface'
+ - 'excel!Excel.Interfaces.TopBottomConditionalFormatUpdateData:interface'
+ - 'excel!Excel.Interfaces.WorkbookCreatedData:interface'
+ - 'excel!Excel.Interfaces.WorkbookData:interface'
+ - 'excel!Excel.Interfaces.WorkbookLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorkbookProtectionData:interface'
+ - 'excel!Excel.Interfaces.WorkbookProtectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorkbookRangeAreasData:interface'
+ - 'excel!Excel.Interfaces.WorkbookRangeAreasLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorkbookUpdateData:interface'
+ - 'excel!Excel.Interfaces.WorksheetCollectionData:interface'
+ - 'excel!Excel.Interfaces.WorksheetCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorksheetCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.WorksheetCustomPropertyCollectionData:interface'
+ - 'excel!Excel.Interfaces.WorksheetCustomPropertyCollectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorksheetCustomPropertyCollectionUpdateData:interface'
+ - 'excel!Excel.Interfaces.WorksheetCustomPropertyData:interface'
+ - 'excel!Excel.Interfaces.WorksheetCustomPropertyLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorksheetCustomPropertyUpdateData:interface'
+ - 'excel!Excel.Interfaces.WorksheetData:interface'
+ - 'excel!Excel.Interfaces.WorksheetLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorksheetProtectionData:interface'
+ - 'excel!Excel.Interfaces.WorksheetProtectionLoadOptions:interface'
+ - 'excel!Excel.Interfaces.WorksheetUpdateData:interface'
+ - 'excel!Excel.LinkedEntityCellValue:interface'
+ - 'excel!Excel.LinkedEntityId:interface'
+ - 'excel!Excel.ListDataValidation:interface'
+ - 'excel!Excel.NameErrorCellValue:interface'
+ - 'excel!Excel.NotAvailableErrorCellValue:interface'
+ - 'excel!Excel.NullErrorCellValue:interface'
+ - 'excel!Excel.NumErrorCellValue:interface'
+ - 'excel!Excel.PageLayoutMarginOptions:interface'
+ - 'excel!Excel.PageLayoutZoomOptions:interface'
+ - 'excel!Excel.PivotDateFilter:interface'
+ - 'excel!Excel.PivotFilters:interface'
+ - 'excel!Excel.PivotLabelFilter:interface'
+ - 'excel!Excel.PivotManualFilter:interface'
+ - 'excel!Excel.PivotValueFilter:interface'
+ - 'excel!Excel.PlaceholderErrorCellValue:interface'
+ - 'excel!Excel.RangeHyperlink:interface'
+ - 'excel!Excel.RangeReference:interface'
+ - 'excel!Excel.ReferenceCellValue:interface'
+ - 'excel!Excel.RefErrorCellValue:interface'
+ - 'excel!Excel.ReplaceCriteria:interface'
+ - 'excel!Excel.RootReferenceCellValue:interface'
+ - 'excel!Excel.RowProperties:interface'
+ - 'excel!Excel.RowPropertiesLoadOptions:interface'
+ - 'excel!Excel.RunOptions:interface'
+ - 'excel!Excel.SearchCriteria:interface'
+ - 'excel!Excel.SelectionChangedEventArgs:interface'
+ - 'excel!Excel.Session:interface'
+ - 'excel!Excel.SettableCellProperties:interface'
+ - 'excel!Excel.SettableColumnProperties:interface'
+ - 'excel!Excel.SettableRowProperties:interface'
+ - 'excel!Excel.SettingsChangedEventArgs:interface'
+ - 'excel!Excel.ShapeActivatedEventArgs:interface'
+ - 'excel!Excel.ShapeDeactivatedEventArgs:interface'
+ - 'excel!Excel.ShowAsRule:interface'
+ - 'excel!Excel.SortField:interface'
+ - 'excel!Excel.SpillErrorCellValue:interface'
+ - 'excel!Excel.StringCellValue:interface'
+ - 'excel!Excel.Subtotals:interface'
+ - 'excel!Excel.TableAddedEventArgs:interface'
+ - 'excel!Excel.TableChangedEventArgs:interface'
+ - 'excel!Excel.TableDeletedEventArgs:interface'
+ - 'excel!Excel.TableSelectionChangedEventArgs:interface'
+ - 'excel!Excel.ThreeArrowsGraySet:interface'
+ - 'excel!Excel.ThreeArrowsSet:interface'
+ - 'excel!Excel.ThreeFlagsSet:interface'
+ - 'excel!Excel.ThreeSignsSet:interface'
+ - 'excel!Excel.ThreeStarsSet:interface'
+ - 'excel!Excel.ThreeSymbols2Set:interface'
+ - 'excel!Excel.ThreeSymbolsSet:interface'
+ - 'excel!Excel.ThreeTrafficLights1Set:interface'
+ - 'excel!Excel.ThreeTrafficLights2Set:interface'
+ - 'excel!Excel.ThreeTrianglesSet:interface'
+ - 'excel!Excel.ValueErrorCellValue:interface'
+ - 'excel!Excel.ValueTypeNotAvailableCellValue:interface'
+ - 'excel!Excel.WebImageCellValue:interface'
+ - 'excel!Excel.WorkbookActivatedEventArgs:interface'
+ - 'excel!Excel.WorkbookAutoSaveSettingChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetActivatedEventArgs:interface'
+ - 'excel!Excel.WorksheetAddedEventArgs:interface'
+ - 'excel!Excel.WorksheetCalculatedEventArgs:interface'
+ - 'excel!Excel.WorksheetChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetColumnSortedEventArgs:interface'
+ - 'excel!Excel.WorksheetDeactivatedEventArgs:interface'
+ - 'excel!Excel.WorksheetDeletedEventArgs:interface'
+ - 'excel!Excel.WorksheetFormatChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetFormulaChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetMovedEventArgs:interface'
+ - 'excel!Excel.WorksheetNameChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetProtectionChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetProtectionOptions:interface'
+ - 'excel!Excel.WorksheetRowHiddenChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetRowSortedEventArgs:interface'
+ - 'excel!Excel.WorksheetSearchCriteria:interface'
+ - 'excel!Excel.WorksheetSelectionChangedEventArgs:interface'
+ - 'excel!Excel.WorksheetSingleClickedEventArgs:interface'
+ - 'excel!Excel.WorksheetVisibilityChangedEventArgs:interface'
+typeAliases:
+ - 'excel!Excel.CardLayout:type'
+ - 'excel!Excel.CardLayoutSection:type'
+ - 'excel!Excel.CellValue:type'
+ - 'excel!Excel.CellValueAndPropertyMetadata:type'
+ - 'excel!Excel.CompactLayout:type'
+ - 'excel!Excel.EntityPropertyType:type'
+ - 'excel!Excel.ErrorCellValue:type'
+ - 'excel!Excel.ReferencedValue:type'
+functions:
+ - name: Excel.createWorkbook(base64)
+ uid: 'excel!Excel.createWorkbook:function(1)'
+ package: excel!
+ summary: >-
+ Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a base64-encoded .xlsx file.
+ Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in
+ user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
+
+
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'export function createWorkbook(base64?: string): Promise;'
+ parameters:
+ - id: base64
+ description: ''
+ type: string
+ return:
+ type: Promise<void>
+ description: |-
+
+
+ #### Examples
+
+ ```javascript
+ const myFile = document.getElementById("file");
+ const reader = new FileReader();
+
+ reader.onload = (event) => {
+ Excel.run((context) => {
+ // Remove the metadata before the base64-encoded string.
+ const startIndex = reader.result.toString().indexOf("base64,");
+ const mybase64 = reader.result.toString().substr(startIndex + 7);
+
+ Excel.createWorkbook(mybase64);
+ return context.sync();
+ });
+ };
+
+ // Read in the file as a data URL so we can parse the base64-encoded string.
+ reader.readAsDataURL(myFile.files[0]);
+ ```
+ - name: 'Excel.getDataCommonPostprocess(response, callArgs)'
+ uid: 'excel!Excel.getDataCommonPostprocess:function(1)'
+ package: excel!
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'export function getDataCommonPostprocess(response: any, callArgs: any): any;'
+ parameters:
+ - id: response
+ description: ''
+ type: any
+ - id: callArgs
+ description: ''
+ type: any
+ return:
+ type: any
+ description: ''
+ - name: Excel.postprocessBindingDescriptor(response)
+ uid: 'excel!Excel.postprocessBindingDescriptor:function(1)'
+ package: excel!
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'export function postprocessBindingDescriptor(response: any): any;'
+ parameters:
+ - id: response
+ description: ''
+ type: any
+ return:
+ type: any
+ description: ''
+ - name: Excel.run(batch)
+ uid: 'excel!Excel.run:function(1)'
+ package: excel!
+ summary: >-
+ Executes a batch script that performs actions on the Excel object model, using a new RequestContext. When the
+ promise is resolved, any tracked objects that were automatically allocated during execution will be released.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'export function run(batch: (context: Excel.RequestContext) => Promise): Promise;'
+ parameters:
+ - id: batch
+ description: >-
+ A function that takes in a RequestContext and returns a promise (typically, just the result of
+ "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office
+ add-in and the Excel application run in two different processes, the RequestContext is required to get
+ access to the Excel object model from the add-in.
+ type: '(context: ) => Promise<T>'
+ return:
+ type: Promise<T>
+ description: ''
+ - name: 'Excel.run(object, batch)'
+ uid: 'excel!Excel.run:function(2)'
+ package: excel!
+ summary: >-
+ Executes a batch script that performs actions on the Excel object model, using the RequestContext of a
+ previously-created API object. When the promise is resolved, any tracked objects that were automatically allocated
+ during execution will be released.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ export function run(object: OfficeExtension.ClientObject, batch: (context: Excel.RequestContext) =>
+ Promise): Promise;
+ parameters:
+ - id: object
+ description: >-
+ A previously-created API object. The batch will use the same RequestContext as the passed-in object, which
+ means that any changes applied to the object will be picked up by "context.sync()".
+ type: ''
+ - id: batch
+ description: >-
+ A function that takes in a RequestContext and returns a promise (typically, just the result of
+ "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office
+ add-in and the Excel application run in two different processes, the RequestContext is required to get
+ access to the Excel object model from the add-in.
+ type: '(context: ) => Promise<T>'
+ return:
+ type: Promise<T>
+ description: ''
+ - name: 'Excel.run(objects, batch)'
+ uid: 'excel!Excel.run:function(3)'
+ package: excel!
+ summary: >-
+ Executes a batch script that performs actions on the Excel object model, using the RequestContext of
+ previously-created API objects.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ export function run(objects: OfficeExtension.ClientObject[], batch: (context: Excel.RequestContext) =>
+ Promise): Promise;
+ parameters:
+ - id: objects
+ description: >-
+ An array of previously-created API objects. The array will be validated to make sure that all of the objects
+ share the same context. The batch will use this shared RequestContext, which means that any changes applied
+ to these objects will be picked up by "context.sync()".
+ type: '[]'
+ - id: batch
+ description: >-
+ A function that takes in a RequestContext and returns a promise (typically, just the result of
+ "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office
+ add-in and the Excel application run in two different processes, the RequestContext is required to get
+ access to the Excel object model from the add-in.
+ type: '(context: ) => Promise<T>'
+ return:
+ type: Promise<T>
+ description: ''
+ - name: 'Excel.run(options, batch)'
+ uid: 'excel!Excel.run:function(4)'
+ package: excel!
+ summary: >-
+ Executes a batch script that performs actions on the Excel object model, using the RequestContext of a
+ previously-created API object. When the promise is resolved, any tracked objects that were automatically allocated
+ during execution will be released.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ export function run(options: Excel.RunOptions, batch: (context: Excel.RequestContext) => Promise):
+ Promise;
+ parameters:
+ - id: options
+ description: >-
+ The additional options for this Excel.run which specify previous objects, whether to delay the request for
+ cell edit, session info, etc.
+ type: ''
+ - id: batch
+ description: >-
+ A function that takes in a RequestContext and returns a promise (typically, just the result of
+ "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office
+ add-in and the Excel application run in two different processes, the RequestContext is required to get
+ access to the Excel object model from the add-in.
+ type: '(context: ) => Promise<T>'
+ return:
+ type: Promise<T>
+ description: ''
+ - name: 'Excel.run(context, batch)'
+ uid: 'excel!Excel.run:function(5)'
+ package: excel!
+ summary: >-
+ Executes a batch script that performs actions on the Excel object model, using the RequestContext of a
+ previously-created object. When the promise is resolved, any tracked objects that were automatically allocated
+ during execution will be released.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ export function run(context: OfficeExtension.ClientRequestContext, batch: (context: Excel.RequestContext) =>
+ Promise): Promise;
+ parameters:
+ - id: context
+ description: >-
+ A previously-created object. The batch will use the same RequestContext as the passed-in object, which means
+ that any changes applied to the object will be picked up by "context.sync()".
+ type: ''
+ - id: batch
+ description: >-
+ A function that takes in a RequestContext and returns a promise (typically, just the result of
+ "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office
+ add-in and the Excel application run in two different processes, the RequestContext is required to get
+ access to the Excel object model from the add-in.
+ type: '(context: ) => Promise<T>'
+ return:
+ type: Promise<T>
+ description: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.aggregationfunction.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.aggregationfunction.yml
new file mode 100644
index 0000000000..4f205719a5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.aggregationfunction.yml
@@ -0,0 +1,138 @@
+### YamlMime:TSEnum
+name: Excel.AggregationFunction
+uid: 'excel!Excel.AggregationFunction:enum'
+package: excel!
+fullName: Excel.AggregationFunction
+summary: Aggregation function for the `DataPivotHierarchy`.
+remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-filters-and-summaries.yaml
+
+ async function genericFunctionSwitch(functionType: Excel.AggregationFunction) {
+ await Excel.run(async (context) => {
+ const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");
+ pivotTable.dataHierarchies.load("no-properties-needed");
+ await context.sync();
+
+ pivotTable.dataHierarchies.items[0].summarizeBy = functionType;
+ pivotTable.dataHierarchies.items[1].summarizeBy = functionType;
+ await context.sync();
+ });
+ }
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.AggregationFunction.automatic:member'
+ package: excel!
+ summary: |-
+ Excel will automatically select the aggregation based on the data items.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Automatic"'
+ - name: average
+ uid: 'excel!Excel.AggregationFunction.average:member'
+ package: excel!
+ summary: |-
+ Aggregate using the average of the data, equivalent to the AVERAGE function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Average"'
+ - name: count
+ uid: 'excel!Excel.AggregationFunction.count:member'
+ package: excel!
+ summary: |-
+ Aggregate using the count of items in the data, equivalent to the COUNTA function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Count"'
+ - name: countNumbers
+ uid: 'excel!Excel.AggregationFunction.countNumbers:member'
+ package: excel!
+ summary: |-
+ Aggregate using the count of numbers in the data, equivalent to the COUNT function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CountNumbers"'
+ - name: max
+ uid: 'excel!Excel.AggregationFunction.max:member'
+ package: excel!
+ summary: |-
+ Aggregate using the maximum value of the data, equivalent to the MAX function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Max"'
+ - name: min
+ uid: 'excel!Excel.AggregationFunction.min:member'
+ package: excel!
+ summary: |-
+ Aggregate using the minimum value of the data, equivalent to the MIN function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Min"'
+ - name: product
+ uid: 'excel!Excel.AggregationFunction.product:member'
+ package: excel!
+ summary: |-
+ Aggregate using the product of the data, equivalent to the PRODUCT function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Product"'
+ - name: standardDeviation
+ uid: 'excel!Excel.AggregationFunction.standardDeviation:member'
+ package: excel!
+ summary: |-
+ Aggregate using the standard deviation of the data, equivalent to the STDEV function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StandardDeviation"'
+ - name: standardDeviationP
+ uid: 'excel!Excel.AggregationFunction.standardDeviationP:member'
+ package: excel!
+ summary: |-
+ Aggregate using the standard deviation of the data, equivalent to the STDEVP function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StandardDeviationP"'
+ - name: sum
+ uid: 'excel!Excel.AggregationFunction.sum:member'
+ package: excel!
+ summary: |-
+ Aggregate using the sum of the data, equivalent to the SUM function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Sum"'
+ - name: unknown
+ uid: 'excel!Excel.AggregationFunction.unknown:member'
+ package: excel!
+ summary: |-
+ Aggregation function is unknown or unsupported.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
+ - name: variance
+ uid: 'excel!Excel.AggregationFunction.variance:member'
+ package: excel!
+ summary: |-
+ Aggregate using the variance of the data, equivalent to the VAR function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Variance"'
+ - name: varianceP
+ uid: 'excel!Excel.AggregationFunction.varianceP:member'
+ package: excel!
+ summary: |-
+ Aggregate using the variance of the data, equivalent to the VARP function.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VarianceP"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.application.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.application.yml
new file mode 100644
index 0000000000..07e44fa000
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.application.yml
@@ -0,0 +1,447 @@
+### YamlMime:TSType
+name: Excel.Application
+uid: 'excel!Excel.Application:class'
+package: excel!
+fullName: Excel.Application
+summary: Represents the Excel application that manages the workbook.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: calculationEngineVersion
+ uid: 'excel!Excel.Application#calculationEngineVersion:member'
+ package: excel!
+ fullName: calculationEngineVersion
+ summary: Returns the Excel calculation engine version used for the last full recalculation.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly calculationEngineVersion: number;'
+ return:
+ type: number
+ - name: calculationMode
+ uid: 'excel!Excel.Application#calculationMode:member'
+ package: excel!
+ fullName: calculationMode
+ summary: >-
+ Returns the calculation mode used in the workbook, as defined by the constants in `Excel.CalculationMode`.
+ Possible values are: `Automatic`, where Excel controls recalculation; `AutomaticExceptTables`,
+ where Excel controls recalculation but ignores changes in tables; `Manual`, where calculation is done when
+ the user requests it.
+ remarks: >-
+ \[ [API set: ExcelApi 1.1 for get, 1.8 for set](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
+ \]
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'calculationMode: Excel.CalculationMode | "Automatic" | "AutomaticExceptTables" | "Manual";'
+ return:
+ type: ' | "Automatic" | "AutomaticExceptTables" | "Manual"'
+ - name: calculationState
+ uid: 'excel!Excel.Application#calculationState:member'
+ package: excel!
+ fullName: calculationState
+ summary: Returns the calculation state of the application. See `Excel.CalculationState` for details.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly calculationState: Excel.CalculationState | "Done" | "Calculating" | "Pending";'
+ return:
+ type: ' | "Done" | "Calculating" | "Pending"'
+ - name: context
+ uid: 'excel!Excel.Application#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: cultureInfo
+ uid: 'excel!Excel.Application#cultureInfo:member'
+ package: excel!
+ fullName: cultureInfo
+ summary: >-
+ Provides information based on current system culture settings. This includes the culture names, number formatting,
+ and other culturally dependent settings.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly cultureInfo: Excel.CultureInfo;'
+ return:
+ type: ''
+ - name: decimalSeparator
+ uid: 'excel!Excel.Application#decimalSeparator:member'
+ package: excel!
+ fullName: decimalSeparator
+ summary: Gets the string used as the decimal separator for numeric values. This is based on the local Excel settings.
+ remarks: >-
+ \[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/culture-info.yaml
+
+ await Excel.run(async (context) => {
+ context.application.load("decimalSeparator,thousandsSeparator");
+ context.application.cultureInfo.numberFormat.load("numberDecimalSeparator,numberGroupSeparator");
+ await context.sync();
+
+ // Local settings are set under the "Options > Advanced" menu.
+ const localDecimalSeparator = context.application.decimalSeparator;
+ const localThousandsSeparator = context.application.thousandsSeparator;
+
+ const systemDecimalSeparator = context.application.cultureInfo.numberFormat.numberDecimalSeparator;
+ const systemThousandsSeparator = context.application.cultureInfo.numberFormat.numberGroupSeparator;
+
+ console.log("Local character settings: ");
+ console.log(` Local decimal separator: ${localDecimalSeparator}`);
+ console.log(` Local thousands separator: ${localThousandsSeparator}`);
+
+ console.log("System culture settings: ");
+ console.log(` System decimal separator: ${systemDecimalSeparator}`);
+ console.log(` System thousands separator: ${systemThousandsSeparator}`);
+ console.log(` `);
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly decimalSeparator: string;'
+ return:
+ type: string
+ - name: iterativeCalculation
+ uid: 'excel!Excel.Application#iterativeCalculation:member'
+ package: excel!
+ fullName: iterativeCalculation
+ summary: >-
+ Returns the iterative calculation settings. In Excel on Windows and Mac, the settings will apply to the Excel
+ Application. In Excel on the web and other platforms, the settings will apply to the active workbook.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly iterativeCalculation: Excel.IterativeCalculation;'
+ return:
+ type: ''
+ - name: thousandsSeparator
+ uid: 'excel!Excel.Application#thousandsSeparator:member'
+ package: excel!
+ fullName: thousandsSeparator
+ summary: >-
+ Gets the string used to separate groups of digits to the left of the decimal for numeric values. This is based on
+ the local Excel settings.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly thousandsSeparator: string;'
+ return:
+ type: string
+ - name: useSystemSeparators
+ uid: 'excel!Excel.Application#useSystemSeparators:member'
+ package: excel!
+ fullName: useSystemSeparators
+ summary: >-
+ Specifies if the system separators of Excel are enabled. System separators include the decimal separator and
+ thousands separator.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly useSystemSeparators: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: calculate(calculationType)
+ uid: 'excel!Excel.Application#calculate:member(1)'
+ package: excel!
+ fullName: calculate(calculationType)
+ summary: Recalculate all currently opened workbooks in Excel.
+ remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/90-scenarios/performance-optimization.yaml
+
+ await Excel.run(async (context) => {
+ context.application.calculate(Excel.CalculationType.full);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'calculate(calculationType: Excel.CalculationType): void;'
+ parameters:
+ - id: calculationType
+ description: Specifies the calculation type to use. See `Excel.CalculationType` for details.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: calculate(calculationTypeString)
+ uid: 'excel!Excel.Application#calculate:member(2)'
+ package: excel!
+ fullName: calculate(calculationTypeString)
+ summary: Recalculate all currently opened workbooks in Excel.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ context.workbook.application.calculate('Full');
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'calculate(calculationTypeString: "Recalculate" | "Full" | "FullRebuild"): void;'
+ parameters:
+ - id: calculationTypeString
+ description: Specifies the calculation type to use. See `Excel.CalculationType` for details.
+ type: '"Recalculate" | "Full" | "FullRebuild"'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.Application#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ApplicationLoadOptions): Excel.Application;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.Application#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.Application;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const application = context.workbook.application;
+ application.load('calculationMode');
+ await context.sync();
+
+ console.log(application.calculationMode);
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.Application#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.Application;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.Application#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ApplicationUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.Application#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.Application): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: suspendApiCalculationUntilNextSync()
+ uid: 'excel!Excel.Application#suspendApiCalculationUntilNextSync:member(1)'
+ package: excel!
+ fullName: suspendApiCalculationUntilNextSync()
+ summary: >-
+ Suspends calculation until the next `context.sync()` is called. Once set, it is the developer's responsibility to
+ re-calc the workbook, to ensure that any dependencies are propagated.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'suspendApiCalculationUntilNextSync(): void;'
+ return:
+ type: void
+ description: ''
+ - name: suspendScreenUpdatingUntilNextSync()
+ uid: 'excel!Excel.Application#suspendScreenUpdatingUntilNextSync:member(1)'
+ package: excel!
+ fullName: suspendScreenUpdatingUntilNextSync()
+ summary: >-
+ Suspends screen updating until the next `context.sync()` is called.
+
+
+ *Note**: Don't call `suspendScreenUpdatingUntilNextSync` repeatedly (such as in a loop). Repeated calls will cause
+ the Excel window to flicker.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/90-scenarios/performance-optimization.yaml
+
+ await Excel.run(async (context) => {
+ // Recreate the data in the worksheet with random data.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ const startTime = Date.now();
+ console.log("Starting...");
+
+ // If other parts of the sample have toggled screen painting off, this will stop screen updating until context.sync is called.
+ if (pauseScreenPainting) {
+ context.application.suspendScreenUpdatingUntilNextSync();
+ }
+
+ for (let i = 1; i < ROW_COUNT; i++) {
+ for (let j = 1; j < COLUMN_COUNT; j++) {
+ let cell = sheet.getCell(i, j);
+ cell.values = [[i * j * Math.random()]];
+
+ // If other parts of the sample have toggled tracking off, we will avoid tracking this range and having to manage the proxy objects.
+ // For more information, see https://learn.microsoft.com/office/dev/add-ins/concepts/resource-limits-and-performance-optimization#untrack-unneeded-proxy-objects
+ if (untrack) {
+ cell.untrack();
+ }
+ }
+ }
+
+ await context.sync();
+
+ console.log(`Ending. Adding ${ROW_COUNT * COLUMN_COUNT} cells took ${Date.now() - startTime} milliseconds`);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'suspendScreenUpdatingUntilNextSync(): void;'
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.Application#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.Application object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ApplicationData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ApplicationData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.arraycellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.arraycellvalue.yml
new file mode 100644
index 0000000000..c2e4b1595c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.arraycellvalue.yml
@@ -0,0 +1,76 @@
+### YamlMime:TSType
+name: Excel.ArrayCellValue
+uid: 'excel!Excel.ArrayCellValue:interface'
+package: excel!
+fullName: Excel.ArrayCellValue
+summary: Represents a 2D array of cell values.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.ArrayCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.ArrayCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#VALUE!" | string;'
+ return:
+ type: '"#VALUE!" | string'
+ - name: elements
+ uid: 'excel!Excel.ArrayCellValue#elements:member'
+ package: excel!
+ fullName: elements
+ summary: Represents the elements of the array. May not directly contain an `ArrayCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'elements: CellValue[][];'
+ return:
+ type: '[][]'
+ - name: referencedValues
+ uid: 'excel!Excel.ArrayCellValue#referencedValues:member'
+ package: excel!
+ fullName: referencedValues
+ summary: Represents the cell values which are referenced within `ArrayCellValue.elements`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'referencedValues?: ReferencedValue[];'
+ return:
+ type: '[]'
+ - name: type
+ uid: 'excel!Excel.ArrayCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.array | ReferenceValueType.array | "Array";'
+ return:
+ type: >-
+ | | "Array"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadlength.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadlength.yml
new file mode 100644
index 0000000000..1c7108127f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadlength.yml
@@ -0,0 +1,51 @@
+### YamlMime:TSEnum
+name: Excel.ArrowheadLength
+uid: 'excel!Excel.ArrowheadLength:enum'
+package: excel!
+fullName: Excel.ArrowheadLength
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml
+
+ await Excel.run(async (context) => {
+ const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
+ const line = shapes.getItem("StraightLine").line;
+ line.beginArrowheadLength = Excel.ArrowheadLength.long;
+ line.beginArrowheadWidth = Excel.ArrowheadWidth.wide;
+ line.beginArrowheadStyle = Excel.ArrowheadStyle.oval;
+
+ line.endArrowheadLength = Excel.ArrowheadLength.long;
+ line.endArrowheadWidth = Excel.ArrowheadWidth.wide;
+ line.endArrowheadStyle = Excel.ArrowheadStyle.triangle;
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: long
+ uid: 'excel!Excel.ArrowheadLength.long:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Long"'
+ - name: medium
+ uid: 'excel!Excel.ArrowheadLength.medium:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Medium"'
+ - name: short
+ uid: 'excel!Excel.ArrowheadLength.short:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Short"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadstyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadstyle.yml
new file mode 100644
index 0000000000..6f76898461
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadstyle.yml
@@ -0,0 +1,66 @@
+### YamlMime:TSEnum
+name: Excel.ArrowheadStyle
+uid: 'excel!Excel.ArrowheadStyle:enum'
+package: excel!
+fullName: Excel.ArrowheadStyle
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml
+
+ await Excel.run(async (context) => {
+ const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
+ const line = shapes.getItem("StraightLine").line;
+ line.beginArrowheadLength = Excel.ArrowheadLength.long;
+ line.beginArrowheadWidth = Excel.ArrowheadWidth.wide;
+ line.beginArrowheadStyle = Excel.ArrowheadStyle.oval;
+
+ line.endArrowheadLength = Excel.ArrowheadLength.long;
+ line.endArrowheadWidth = Excel.ArrowheadWidth.wide;
+ line.endArrowheadStyle = Excel.ArrowheadStyle.triangle;
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: diamond
+ uid: 'excel!Excel.ArrowheadStyle.diamond:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Diamond"'
+ - name: none
+ uid: 'excel!Excel.ArrowheadStyle.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: open
+ uid: 'excel!Excel.ArrowheadStyle.open:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Open"'
+ - name: oval
+ uid: 'excel!Excel.ArrowheadStyle.oval:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Oval"'
+ - name: stealth
+ uid: 'excel!Excel.ArrowheadStyle.stealth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Stealth"'
+ - name: triangle
+ uid: 'excel!Excel.ArrowheadStyle.triangle:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Triangle"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadwidth.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadwidth.yml
new file mode 100644
index 0000000000..3856826fd0
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.arrowheadwidth.yml
@@ -0,0 +1,51 @@
+### YamlMime:TSEnum
+name: Excel.ArrowheadWidth
+uid: 'excel!Excel.ArrowheadWidth:enum'
+package: excel!
+fullName: Excel.ArrowheadWidth
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml
+
+ await Excel.run(async (context) => {
+ const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
+ const line = shapes.getItem("StraightLine").line;
+ line.beginArrowheadLength = Excel.ArrowheadLength.long;
+ line.beginArrowheadWidth = Excel.ArrowheadWidth.wide;
+ line.beginArrowheadStyle = Excel.ArrowheadStyle.oval;
+
+ line.endArrowheadLength = Excel.ArrowheadLength.long;
+ line.endArrowheadWidth = Excel.ArrowheadWidth.wide;
+ line.endArrowheadStyle = Excel.ArrowheadStyle.triangle;
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: medium
+ uid: 'excel!Excel.ArrowheadWidth.medium:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Medium"'
+ - name: narrow
+ uid: 'excel!Excel.ArrowheadWidth.narrow:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Narrow"'
+ - name: wide
+ uid: 'excel!Excel.ArrowheadWidth.wide:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Wide"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.autofilltype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.autofilltype.yml
new file mode 100644
index 0000000000..0b778bdc9b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.autofilltype.yml
@@ -0,0 +1,134 @@
+### YamlMime:TSEnum
+name: Excel.AutoFillType
+uid: 'excel!Excel.AutoFillType:enum'
+package: excel!
+fullName: Excel.AutoFillType
+summary: The behavior types when AutoFill is used on a range in the workbook.
+remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-auto-fill.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+ const sumCell = sheet.getRange("K4");
+
+ // Copy only the formatting, not the values and formulas.
+ sumCell.autoFill("K4:K7", Excel.AutoFillType.fillFormats);
+ sumCell.format.autofitColumns();
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: fillCopy
+ uid: 'excel!Excel.AutoFillType.fillCopy:member'
+ package: excel!
+ summary: |-
+ Populates the adjacent cells with data based on the selected data.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillCopy"'
+ - name: fillDays
+ uid: 'excel!Excel.AutoFillType.fillDays:member'
+ package: excel!
+ summary: >-
+ A version of "FillSeries" for dates that bases the pattern on either the day of the month or the day of the week,
+ depending on the context.
+
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillDays"'
+ - name: fillDefault
+ uid: 'excel!Excel.AutoFillType.fillDefault:member'
+ package: excel!
+ summary: |-
+ Populates the adjacent cells based on the surrounding data (the standard AutoFill behavior).
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillDefault"'
+ - name: fillFormats
+ uid: 'excel!Excel.AutoFillType.fillFormats:member'
+ package: excel!
+ summary: |-
+ Populates the adjacent cells with the selected formulas.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillFormats"'
+ - name: fillMonths
+ uid: 'excel!Excel.AutoFillType.fillMonths:member'
+ package: excel!
+ summary: |-
+ A version of "FillSeries" for dates that bases the pattern on the month.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillMonths"'
+ - name: fillSeries
+ uid: 'excel!Excel.AutoFillType.fillSeries:member'
+ package: excel!
+ summary: |-
+ Populates the adjacent cells with data that follows a pattern in the copied cells.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillSeries"'
+ - name: fillValues
+ uid: 'excel!Excel.AutoFillType.fillValues:member'
+ package: excel!
+ summary: |-
+ Populates the adjacent cells with the selected values.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillValues"'
+ - name: fillWeekdays
+ uid: 'excel!Excel.AutoFillType.fillWeekdays:member'
+ package: excel!
+ summary: |-
+ A version of "FillSeries" for dates that bases the pattern on the day of the week and only includes weekdays.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillWeekdays"'
+ - name: fillYears
+ uid: 'excel!Excel.AutoFillType.fillYears:member'
+ package: excel!
+ summary: |-
+ A version of "FillSeries" for dates that bases the pattern on the year.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FillYears"'
+ - name: flashFill
+ uid: 'excel!Excel.AutoFillType.flashFill:member'
+ package: excel!
+ summary: |-
+ Populates the adjacent cells by using Excel's Flash Fill feature.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FlashFill"'
+ - name: growthTrend
+ uid: 'excel!Excel.AutoFillType.growthTrend:member'
+ package: excel!
+ summary: >-
+ A version of "FillSeries" for numbers that fills out the values in the adjacent cells according to a growth trend
+ model.
+
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GrowthTrend"'
+ - name: linearTrend
+ uid: 'excel!Excel.AutoFillType.linearTrend:member'
+ package: excel!
+ summary: >-
+ A version of "FillSeries" for numbers that fills out the values in the adjacent cells according to a linear trend
+ model.
+
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LinearTrend"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.autofilter.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.autofilter.yml
new file mode 100644
index 0000000000..16566bb13e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.autofilter.yml
@@ -0,0 +1,362 @@
+### YamlMime:TSType
+name: Excel.AutoFilter
+uid: 'excel!Excel.AutoFilter:class'
+package: excel!
+fullName: Excel.AutoFilter
+summary: >-
+ Represents the `AutoFilter` object. AutoFilter turns the values in Excel column into specific filters based on the
+ cell contents.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.AutoFilter#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: criteria
+ uid: 'excel!Excel.AutoFilter#criteria:member'
+ package: excel!
+ fullName: criteria
+ summary: An array that holds all the filter criteria in the autofiltered range.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly criteria: Excel.FilterCriteria[];'
+ return:
+ type: '[]'
+ - name: enabled
+ uid: 'excel!Excel.AutoFilter#enabled:member'
+ package: excel!
+ fullName: enabled
+ summary: Specifies if the AutoFilter is enabled.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly enabled: boolean;'
+ return:
+ type: boolean
+ - name: isDataFiltered
+ uid: 'excel!Excel.AutoFilter#isDataFiltered:member'
+ package: excel!
+ fullName: isDataFiltered
+ summary: Specifies if the AutoFilter has filter criteria.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly isDataFiltered: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: 'apply(range, columnIndex, criteria)'
+ uid: 'excel!Excel.AutoFilter#apply:member(1)'
+ package: excel!
+ fullName: 'apply(range, columnIndex, criteria)'
+ summary: Applies the AutoFilter to a range. This filters the column if column index and filter criteria are specified.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml
+
+ // This function adds a percentage AutoFilter to the active worksheet
+
+ // and applies the filter to a column of the used range.
+
+ await Excel.run(async (context) => {
+ // Retrieve the active worksheet and the used range on that worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+ const farmData = sheet.getUsedRange();
+
+ // Add a filter that will only show the rows with the top 50% of values in column 3.
+ sheet.autoFilter.apply(farmData, 3, {
+ criterion1: "50",
+ filterOn: Excel.FilterOn.topPercent
+ });
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'apply(range: Range | string, columnIndex?: number, criteria?: Excel.FilterCriteria): void;'
+ parameters:
+ - id: range
+ description: The range on which the AutoFilter will apply.
+ type: ' | string'
+ - id: columnIndex
+ description: The zero-based column index to which the AutoFilter is applied.
+ type: number
+ - id: criteria
+ description: The filter criteria.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: clearColumnCriteria(columnIndex)
+ uid: 'excel!Excel.AutoFilter#clearColumnCriteria:member(1)'
+ package: excel!
+ fullName: clearColumnCriteria(columnIndex)
+ summary: Clears the column filter criteria of the AutoFilter.
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml
+
+ // This function clears the AutoFilter setting from one column.
+
+ await Excel.run(async (context) => {
+ // Retrieve the active worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Clear the filter from only column 3.
+ sheet.autoFilter.clearColumnCriteria(3);
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clearColumnCriteria(columnIndex: number): void;'
+ parameters:
+ - id: columnIndex
+ description: >-
+ The zero-based column index, which represents which column filter needs to be cleared. If the index value is
+ not supported (for example, if the value is a negative number, or if the value is greater than the number of
+ available columns in the range), then an `InvalidArgument` error will be thrown.
+ type: number
+ return:
+ type: void
+ description: ''
+ - name: clearCriteria()
+ uid: 'excel!Excel.AutoFilter#clearCriteria:member(1)'
+ package: excel!
+ fullName: clearCriteria()
+ summary: Clears the filter criteria and sort state of the AutoFilter.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clearCriteria(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getRange()
+ uid: 'excel!Excel.AutoFilter#getRange:member(1)'
+ package: excel!
+ fullName: getRange()
+ summary: Returns the `Range` object that represents the range to which the AutoFilter applies.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getRange(): Excel.Range;'
+ return:
+ type: ''
+ description: ''
+ - name: getRangeOrNullObject()
+ uid: 'excel!Excel.AutoFilter#getRangeOrNullObject:member(1)'
+ package: excel!
+ fullName: getRangeOrNullObject()
+ summary: >-
+ Returns the `Range` object that represents the range to which the AutoFilter applies. If there is no `Range`
+ object associated with the AutoFilter, then this method returns an object with its `isNullObject` property set to
+ `true`. For further information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getRangeOrNullObject(): Excel.Range;'
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.AutoFilter#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.AutoFilterLoadOptions): Excel.AutoFilter;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.AutoFilter#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.AutoFilter;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.AutoFilter#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.AutoFilter;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: reapply()
+ uid: 'excel!Excel.AutoFilter#reapply:member(1)'
+ package: excel!
+ fullName: reapply()
+ summary: Applies the specified AutoFilter object currently on the range.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml
+
+ // This function refreshes the AutoFilter to ensure that changes are captured.
+
+ await Excel.run(async (context) => {
+ // Retrieve the active worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Reapply the filter to capture changes.
+ sheet.autoFilter.reapply();
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'reapply(): void;'
+ return:
+ type: void
+ description: ''
+ - name: remove()
+ uid: 'excel!Excel.AutoFilter#remove:member(1)'
+ package: excel!
+ fullName: remove()
+ summary: Removes the AutoFilter for the range.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml
+
+ // This function removes all AutoFilters from the active worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the active worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Remove all filters.
+ sheet.autoFilter.remove();
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'remove(): void;'
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.AutoFilter#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.AutoFilter object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.AutoFilterData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.AutoFilterData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.basicdatavalidation.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.basicdatavalidation.yml
new file mode 100644
index 0000000000..a2e93b5bff
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.basicdatavalidation.yml
@@ -0,0 +1,63 @@
+### YamlMime:TSType
+name: Excel.BasicDataValidation
+uid: 'excel!Excel.BasicDataValidation:interface'
+package: excel!
+fullName: Excel.BasicDataValidation
+summary: Represents the basic type data validation criteria.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: formula1
+ uid: 'excel!Excel.BasicDataValidation#formula1:member'
+ package: excel!
+ fullName: formula1
+ summary: >-
+ Specifies the right-hand operand when the operator property is set to a binary operator such as GreaterThan (the
+ left-hand operand is the value the user tries to enter in the cell). With the ternary operators Between and
+ NotBetween, specifies the lower bound operand. For example, setting formula1 to 10 and operator to GreaterThan
+ means that valid data for the range must be greater than 10. When setting the value, it can be passed in as a
+ number, a range object, or a string formula (where the string is either a stringified number, a cell reference
+ like "=A1", or a formula like "=MIN(A1, B1)"). When retrieving the value, it will always be returned as a string
+ formula, for example: "=10", "=A1", "=SUM(A1:B5)", etc.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula1: string | number | Range;'
+ return:
+ type: 'string | number | '
+ - name: formula2
+ uid: 'excel!Excel.BasicDataValidation#formula2:member'
+ package: excel!
+ fullName: formula2
+ summary: >-
+ With the ternary operators Between and NotBetween, specifies the upper bound operand. Is not used with the binary
+ operators, such as GreaterThan. When setting the value, it can be passed in as a number, a range object, or a
+ string formula (where the string is either a stringified number, a cell reference like "=A1", or a formula like
+ "=MIN(A1, B1)"). When retrieving the value, it will always be returned as a string formula, for example: "=10",
+ "=A1", "=SUM(A1:B5)", etc.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula2?: string | number | Range;'
+ return:
+ type: 'string | number | '
+ - name: operator
+ uid: 'excel!Excel.BasicDataValidation#operator:member'
+ package: excel!
+ fullName: operator
+ summary: The operator to use for validating the data.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ operator: Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" |
+ "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo";
+ return:
+ type: >-
+ | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" |
+ "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.binding.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.binding.yml
new file mode 100644
index 0000000000..4d40ac8a87
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.binding.yml
@@ -0,0 +1,300 @@
+### YamlMime:TSType
+name: Excel.Binding
+uid: 'excel!Excel.Binding:class'
+package: excel!
+fullName: Excel.Binding
+summary: Represents an Office.js binding that is defined in the workbook.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.Binding#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: id
+ uid: 'excel!Excel.Binding#id:member'
+ package: excel!
+ fullName: id
+ summary: Represents the binding identifier.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.Binding#type:member'
+ package: excel!
+ fullName: type
+ summary: Returns the type of the binding. See `Excel.BindingType` for details.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly type: Excel.BindingType | "Range" | "Table" | "Text";'
+ return:
+ type: ' | "Range" | "Table" | "Text"'
+methods:
+ - name: delete()
+ uid: 'excel!Excel.Binding#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes the binding.
+ remarks: '\[ [API set: ExcelApi 1.3](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getRange()
+ uid: 'excel!Excel.Binding#getRange:member(1)'
+ package: excel!
+ fullName: getRange()
+ summary: Returns the range represented by the binding. Will throw an error if the binding is not of the correct type.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const binding = context.workbook.bindings.getItemAt(0);
+ const range = binding.getRange();
+ range.load('cellCount');
+ await context.sync();
+
+ console.log(range.cellCount);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getRange(): Excel.Range;'
+ return:
+ type: ''
+ description: ''
+ - name: getTable()
+ uid: 'excel!Excel.Binding#getTable:member(1)'
+ package: excel!
+ fullName: getTable()
+ summary: Returns the table represented by the binding. Will throw an error if the binding is not of the correct type.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const binding = context.workbook.bindings.getItemAt(0);
+ const table = binding.getTable();
+ table.load('name');
+ await context.sync();
+
+ console.log(table.name);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getTable(): Excel.Table;'
+ return:
+ type: ''
+ description: ''
+ - name: getText()
+ uid: 'excel!Excel.Binding#getText:member(1)'
+ package: excel!
+ fullName: getText()
+ summary: Returns the text represented by the binding. Will throw an error if the binding is not of the correct type.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const binding = context.workbook.bindings.getItemAt(0);
+ const text = binding.getText();
+ binding.load('text');
+ await context.sync();
+
+ console.log(text);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getText(): OfficeExtension.ClientResult;'
+ return:
+ type: '<string>'
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.Binding#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.BindingLoadOptions): Excel.Binding;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.Binding#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.Binding;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const binding = context.workbook.bindings.getItemAt(0);
+ binding.load('type');
+ await context.sync();
+
+ console.log(binding.type);
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.Binding#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.Binding;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.Binding#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.Binding object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.BindingData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.BindingData;'
+ return:
+ type: ''
+ description: ''
+events:
+ - name: onDataChanged
+ uid: 'excel!Excel.Binding#onDataChanged:member'
+ package: excel!
+ fullName: onDataChanged
+ summary: Occurs when data or formatting within the binding is changed.
+ remarks: >-
+ \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/data-changed.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const salesTable = sheet.tables.getItem("SalesTable");
+ const salesByQuarterBinding = context.workbook.bindings.add(salesTable.getRange(), "Table", "SalesByQuarter");
+ salesByQuarterBinding.onDataChanged.add(onSalesDataChanged);
+
+ console.log("The data changed handler is registered.");
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onDataChanged: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+ - name: onSelectionChanged
+ uid: 'excel!Excel.Binding#onSelectionChanged:member'
+ package: excel!
+ fullName: onSelectionChanged
+ summary: >-
+ Occurs when the selected content in the binding is changed.
+
+
+ *Note**: If multiple, discontiguous cells are selected, `Binding.onSelectionChanged` only reports row and column
+ information for one selection. Use `Worksheet.onSelectionChanged` for multiple selected ranges.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onSelectionChanged: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingcollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingcollection.yml
new file mode 100644
index 0000000000..a3861cbf2f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingcollection.yml
@@ -0,0 +1,388 @@
+### YamlMime:TSType
+name: Excel.BindingCollection
+uid: 'excel!Excel.BindingCollection:class'
+package: excel!
+fullName: Excel.BindingCollection
+summary: Represents the collection of all the binding objects that are part of the workbook.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.BindingCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: count
+ uid: 'excel!Excel.BindingCollection#count:member'
+ package: excel!
+ fullName: count
+ summary: Returns the number of bindings in the collection.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly count: number;'
+ return:
+ type: number
+ - name: items
+ uid: 'excel!Excel.BindingCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.Binding[];'
+ return:
+ type: '[]'
+methods:
+ - name: 'add(range, bindingType, id)'
+ uid: 'excel!Excel.BindingCollection#add:member(1)'
+ package: excel!
+ fullName: 'add(range, bindingType, id)'
+ summary: Add a new binding to a particular Range.
+ remarks: '\[ [API set: ExcelApi 1.3](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(range: Range | string, bindingType: Excel.BindingType, id: string): Excel.Binding;'
+ parameters:
+ - id: range
+ description: >-
+ Range to bind the binding to. May be a `Range` object or a string. If string, must contain the full address,
+ including the sheet name
+ type: ' | string'
+ - id: bindingType
+ description: Type of binding. See `Excel.BindingType`.
+ type: ''
+ - id: id
+ description: Name of the binding.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: 'add(range, bindingTypeString, id)'
+ uid: 'excel!Excel.BindingCollection#add:member(2)'
+ package: excel!
+ fullName: 'add(range, bindingTypeString, id)'
+ summary: Add a new binding to a particular Range.
+ remarks: '\[ [API set: ExcelApi 1.3](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(range: Range | string, bindingTypeString: "Range" | "Table" | "Text", id: string): Excel.Binding;'
+ parameters:
+ - id: range
+ description: >-
+ Range to bind the binding to. May be a `Range` object or a string. If string, must contain the full address,
+ including the sheet name
+ type: ' | string'
+ - id: bindingTypeString
+ description: Type of binding. See `Excel.BindingType`.
+ type: '"Range" | "Table" | "Text"'
+ - id: id
+ description: Name of the binding.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: 'addFromNamedItem(name, bindingType, id)'
+ uid: 'excel!Excel.BindingCollection#addFromNamedItem:member(1)'
+ package: excel!
+ fullName: 'addFromNamedItem(name, bindingType, id)'
+ summary: >-
+ Add a new binding based on a named item in the workbook. If the named item references to multiple areas, the
+ `InvalidReference` error will be returned.
+ remarks: '\[ [API set: ExcelApi 1.3](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'addFromNamedItem(name: string, bindingType: Excel.BindingType, id: string): Excel.Binding;'
+ parameters:
+ - id: name
+ description: Name from which to create binding.
+ type: string
+ - id: bindingType
+ description: Type of binding. See `Excel.BindingType`.
+ type: ''
+ - id: id
+ description: Name of the binding.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: 'addFromNamedItem(name, bindingTypeString, id)'
+ uid: 'excel!Excel.BindingCollection#addFromNamedItem:member(2)'
+ package: excel!
+ fullName: 'addFromNamedItem(name, bindingTypeString, id)'
+ summary: >-
+ Add a new binding based on a named item in the workbook. If the named item references to multiple areas, the
+ `InvalidReference` error will be returned.
+ remarks: '\[ [API set: ExcelApi 1.3](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'addFromNamedItem(name: string, bindingTypeString: "Range" | "Table" | "Text", id: string): Excel.Binding;'
+ parameters:
+ - id: name
+ description: Name from which to create binding.
+ type: string
+ - id: bindingTypeString
+ description: Type of binding. See `Excel.BindingType`.
+ type: '"Range" | "Table" | "Text"'
+ - id: id
+ description: Name of the binding.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: 'addFromSelection(bindingType, id)'
+ uid: 'excel!Excel.BindingCollection#addFromSelection:member(1)'
+ package: excel!
+ fullName: 'addFromSelection(bindingType, id)'
+ summary: >-
+ Add a new binding based on the current selection. If the selection has multiple areas, the `InvalidReference`
+ error will be returned.
+ remarks: '\[ [API set: ExcelApi 1.3](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'addFromSelection(bindingType: Excel.BindingType, id: string): Excel.Binding;'
+ parameters:
+ - id: bindingType
+ description: Type of binding. See `Excel.BindingType`.
+ type: ''
+ - id: id
+ description: Name of the binding.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: 'addFromSelection(bindingTypeString, id)'
+ uid: 'excel!Excel.BindingCollection#addFromSelection:member(2)'
+ package: excel!
+ fullName: 'addFromSelection(bindingTypeString, id)'
+ summary: >-
+ Add a new binding based on the current selection. If the selection has multiple areas, the `InvalidReference`
+ error will be returned.
+ remarks: '\[ [API set: ExcelApi 1.3](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'addFromSelection(bindingTypeString: "Range" | "Table" | "Text", id: string): Excel.Binding;'
+ parameters:
+ - id: bindingTypeString
+ description: Type of binding. See `Excel.BindingType`.
+ type: '"Range" | "Table" | "Text"'
+ - id: id
+ description: Name of the binding.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.BindingCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the number of bindings in the collection.
+ remarks: '\[ [API set: ExcelApi 1.4](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(id)
+ uid: 'excel!Excel.BindingCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(id)
+ summary: Gets a binding object by ID.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ async function onBindingDataChanged(eventArgs) {
+ await Excel.run(async (context) => {
+ // Highlight the table related to the binding in orange to indicate data has been changed.
+ context.workbook.bindings.getItem(eventArgs.binding.id).getTable().getDataBodyRange().format.fill.color = "Orange";
+ await context.sync();
+
+ console.log("The value in this table got changed!");
+ });
+ }
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(id: string): Excel.Binding;'
+ parameters:
+ - id: id
+ description: ID of the binding object to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.BindingCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Gets a binding object based on its position in the items array.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const lastPosition = context.workbook.bindings.count - 1;
+ const binding = context.workbook.bindings.getItemAt(lastPosition);
+ binding.load('type')
+ await context.sync();
+
+ console.log(binding.type);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.Binding;'
+ parameters:
+ - id: index
+ description: Index value of the object to be retrieved. Zero-indexed.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(id)
+ uid: 'excel!Excel.BindingCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(id)
+ summary: >-
+ Gets a binding object by ID. If the binding object does not exist, then this method returns an object with its
+ `isNullObject` property set to `true`. For further information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.4](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(id: string): Excel.Binding;'
+ parameters:
+ - id: id
+ description: ID of the binding object to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.BindingCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.BindingCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.BindingCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.BindingCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.BindingCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const bindings = context.workbook.bindings;
+ bindings.load('items');
+ await context.sync();
+
+ for (let i = 0; i < bindings.items.length; i++) {
+ console.log(bindings.items[i].id);
+ }
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.BindingCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.BindingCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.BindingCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.BindingCollection` object is an API object, the `toJSON` method returns
+ a plain JavaScript object (typed as `Excel.Interfaces.BindingCollectionData`) that contains an "items"
+ array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.BindingCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingdatachangedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingdatachangedeventargs.yml
new file mode 100644
index 0000000000..bde0f15e53
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingdatachangedeventargs.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSType
+name: Excel.BindingDataChangedEventArgs
+uid: 'excel!Excel.BindingDataChangedEventArgs:interface'
+package: excel!
+fullName: Excel.BindingDataChangedEventArgs
+summary: Provides information about the binding that raised the data changed event.
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: binding
+ uid: 'excel!Excel.BindingDataChangedEventArgs#binding:member'
+ package: excel!
+ fullName: binding
+ summary: >-
+ Gets a temporary `Binding` object that contains the ID of the `Binding` object that raised the event. Use that ID
+ with `BindingCollection.getItem(id)` to get the binding.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'binding: Excel.Binding;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingselectionchangedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingselectionchangedeventargs.yml
new file mode 100644
index 0000000000..63d5efd4bb
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingselectionchangedeventargs.yml
@@ -0,0 +1,78 @@
+### YamlMime:TSType
+name: Excel.BindingSelectionChangedEventArgs
+uid: 'excel!Excel.BindingSelectionChangedEventArgs:interface'
+package: excel!
+fullName: Excel.BindingSelectionChangedEventArgs
+summary: >-
+ Provides information about the selection that raised the selection changed event.
+
+
+ *Note**: If multiple, discontiguous cells are selected, `Binding.onSelectionChanged` only reports row and column
+ information for one selection. Use `Worksheet.onSelectionChanged` for multiple selected ranges.
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: binding
+ uid: 'excel!Excel.BindingSelectionChangedEventArgs#binding:member'
+ package: excel!
+ fullName: binding
+ summary: >-
+ Gets a temporary `Binding` object that contains the ID of the `Binding` object that raised the event. Use that ID
+ with `BindingCollection.getItem(id)` to get the binding.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'binding: Excel.Binding;'
+ return:
+ type: ''
+ - name: columnCount
+ uid: 'excel!Excel.BindingSelectionChangedEventArgs#columnCount:member'
+ package: excel!
+ fullName: columnCount
+ summary: Gets the number of columns selected.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'columnCount: number;'
+ return:
+ type: number
+ - name: rowCount
+ uid: 'excel!Excel.BindingSelectionChangedEventArgs#rowCount:member'
+ package: excel!
+ fullName: rowCount
+ summary: Gets the number of rows selected.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'rowCount: number;'
+ return:
+ type: number
+ - name: startColumn
+ uid: 'excel!Excel.BindingSelectionChangedEventArgs#startColumn:member'
+ package: excel!
+ fullName: startColumn
+ summary: Gets the index of the first column of the selection (zero-based).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'startColumn: number;'
+ return:
+ type: number
+ - name: startRow
+ uid: 'excel!Excel.BindingSelectionChangedEventArgs#startRow:member'
+ package: excel!
+ fullName: startRow
+ summary: Gets the index of the first row of the selection (zero-based).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'startRow: number;'
+ return:
+ type: number
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingtype.yml
new file mode 100644
index 0000000000..2aa886ba7b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.bindingtype.yml
@@ -0,0 +1,51 @@
+### YamlMime:TSEnum
+name: Excel.BindingType
+uid: 'excel!Excel.BindingType:enum'
+package: excel!
+fullName: Excel.BindingType
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-disable-events.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const sumRange = sheet.getRange("B20:P20");
+ sumRange.load("columnCount");
+ await context.sync();
+
+ // add an event handler to each cell in the sum range
+ for (let i = 0; i < sumRange.columnCount; i++) {
+ let sumBinding = context.workbook.bindings.add(sumRange.getCell(0,i), Excel.BindingType.range, "SumBinding" + i);
+ sumBinding.onDataChanged.add(onSumChanged);
+ }
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: range
+ uid: 'excel!Excel.BindingType.range:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Range"'
+ - name: table
+ uid: 'excel!Excel.BindingType.table:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Table"'
+ - name: text
+ uid: 'excel!Excel.BindingType.text:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Text"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.blockederrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.blockederrorcellvalue.yml
new file mode 100644
index 0000000000..3c9242116c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.blockederrorcellvalue.yml
@@ -0,0 +1,79 @@
+### YamlMime:TSType
+name: Excel.BlockedErrorCellValue
+uid: 'excel!Excel.BlockedErrorCellValue:interface'
+package: excel!
+fullName: Excel.BlockedErrorCellValue
+summary: 'Represents the value of a cell containing a \#BLOCKED! error.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.BlockedErrorCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.BlockedErrorCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#BLOCKED!" | string;'
+ return:
+ type: '"#BLOCKED!" | string'
+ - name: errorSubType
+ uid: 'excel!Excel.BlockedErrorCellValue#errorSubType:member'
+ package: excel!
+ fullName: errorSubType
+ summary: Represents the type of `BlockedErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ errorSubType?: BlockedErrorCellValueSubType | "Unknown" | "DataTypeRestrictedDomain" | "DataTypePrivacySetting"
+ | "DataTypeUnsupportedApp" | "ExternalLinksGeneric" | "RichDataLinkDisabled" | "SignInError" | "NoLicense";
+ return:
+ type: >-
+ | "Unknown" | "DataTypeRestrictedDomain" |
+ "DataTypePrivacySetting" | "DataTypeUnsupportedApp" | "ExternalLinksGeneric" | "RichDataLinkDisabled" |
+ "SignInError" | "NoLicense"
+ - name: errorType
+ uid: 'excel!Excel.BlockedErrorCellValue#errorType:member'
+ package: excel!
+ fullName: errorType
+ summary: Represents the type of `ErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorType?: ErrorCellValueType.blocked | "Blocked";'
+ return:
+ type: ' | "Blocked"'
+ - name: type
+ uid: 'excel!Excel.BlockedErrorCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.blockederrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.blockederrorcellvaluesubtype.yml
new file mode 100644
index 0000000000..8f2537eba8
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.blockederrorcellvaluesubtype.yml
@@ -0,0 +1,74 @@
+### YamlMime:TSEnum
+name: Excel.BlockedErrorCellValueSubType
+uid: 'excel!Excel.BlockedErrorCellValueSubType:enum'
+package: excel!
+fullName: Excel.BlockedErrorCellValueSubType
+summary: 'Represents types of \#BLOCKED! errors.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: dataTypePrivacySetting
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.dataTypePrivacySetting:member'
+ package: excel!
+ summary: |-
+ An error caused by privacy settings. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataTypePrivacySetting"'
+ - name: dataTypeRestrictedDomain
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.dataTypeRestrictedDomain:member'
+ package: excel!
+ summary: |-
+ An error caused by a service not supporting a linked data type. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataTypeRestrictedDomain"'
+ - name: dataTypeUnsupportedApp
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.dataTypeUnsupportedApp:member'
+ package: excel!
+ summary: |-
+ An error caused by an unsupported data type. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataTypeUnsupportedApp"'
+ - name: externalLinksGeneric
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.externalLinksGeneric:member'
+ package: excel!
+ summary: |-
+ An error caused by external links. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksGeneric"'
+ - name: noLicense
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.noLicense:member'
+ package: excel!
+ summary: |-
+ An error caused by a license verification failure. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NoLicense"'
+ - name: richDataLinkDisabled
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.richDataLinkDisabled:member'
+ package: excel!
+ summary: |-
+ An error caused by disabled rich data links. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RichDataLinkDisabled"'
+ - name: signInError
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.signInError:member'
+ package: excel!
+ summary: |-
+ An error caused by sign in failure. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SignInError"'
+ - name: unknown
+ uid: 'excel!Excel.BlockedErrorCellValueSubType.unknown:member'
+ package: excel!
+ summary: |-
+ An unknown type of error. Displays as error type \#BLOCKED! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.booleancellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.booleancellvalue.yml
new file mode 100644
index 0000000000..ed1a3d73b0
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.booleancellvalue.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.BooleanCellValue
+uid: 'excel!Excel.BooleanCellValue:interface'
+package: excel!
+fullName: Excel.BooleanCellValue
+summary: Represents the value of a cell containing a boolean.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.BooleanCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.boolean | "Boolean";'
+ return:
+ type: ' | "Boolean"'
+ - name: basicValue
+ uid: 'excel!Excel.BooleanCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: Represents the value that would be returned by `Range.values` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue: boolean;'
+ return:
+ type: boolean
+ - name: type
+ uid: 'excel!Excel.BooleanCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.boolean | "Boolean";'
+ return:
+ type: ' | "Boolean"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.borderindex.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.borderindex.yml
new file mode 100644
index 0000000000..5fad6515ed
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.borderindex.yml
@@ -0,0 +1,50 @@
+### YamlMime:TSEnum
+name: Excel.BorderIndex
+uid: 'excel!Excel.BorderIndex:enum'
+package: excel!
+fullName: Excel.BorderIndex
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: diagonalDown
+ uid: 'excel!Excel.BorderIndex.diagonalDown:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DiagonalDown"'
+ - name: diagonalUp
+ uid: 'excel!Excel.BorderIndex.diagonalUp:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DiagonalUp"'
+ - name: edgeBottom
+ uid: 'excel!Excel.BorderIndex.edgeBottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeBottom"'
+ - name: edgeLeft
+ uid: 'excel!Excel.BorderIndex.edgeLeft:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeLeft"'
+ - name: edgeRight
+ uid: 'excel!Excel.BorderIndex.edgeRight:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeRight"'
+ - name: edgeTop
+ uid: 'excel!Excel.BorderIndex.edgeTop:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeTop"'
+ - name: insideHorizontal
+ uid: 'excel!Excel.BorderIndex.insideHorizontal:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"InsideHorizontal"'
+ - name: insideVertical
+ uid: 'excel!Excel.BorderIndex.insideVertical:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"InsideVertical"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.borderlinestyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.borderlinestyle.yml
new file mode 100644
index 0000000000..b1c3806a48
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.borderlinestyle.yml
@@ -0,0 +1,134 @@
+### YamlMime:TSEnum
+name: Excel.BorderLineStyle
+uid: 'excel!Excel.BorderLineStyle:enum'
+package: excel!
+fullName: Excel.BorderLineStyle
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Creating the SettableCellProperties objects to use for the range.
+ // In your add-in, these should be created once, outside the function.
+ const topHeaderProps: Excel.SettableCellProperties = {
+ // The style property takes a string matching the name of an Excel style.
+ // Built-in style names are listed in the `BuiltInStyle` enum.
+ // Note that a style will overwrite any formatting,
+ // so do not use the format property with the style property.
+ style: "Heading1"
+ };
+
+ const headerProps: Excel.SettableCellProperties = {
+ // Any subproperties of format that are not set will not be changed when these cell properties are set.
+ format: {
+ fill: {
+ color: "Blue"
+ },
+ font: {
+ color: "White",
+ bold: true
+ }
+ }
+ };
+
+ const nonApplicableProps: Excel.SettableCellProperties = {
+ format: {
+ fill: {
+ pattern: Excel.FillPattern.gray25
+ },
+ font: {
+ color: "Gray",
+ italic: true
+ }
+ }
+ };
+
+ const matchupScoreProps: Excel.SettableCellProperties = {
+ format: {
+ borders: {
+ bottom: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ left: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ right: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ top: {
+ style: Excel.BorderLineStyle.continuous
+ }
+ }
+ }
+ };
+
+ const range = sheet.getRange("A1:E5");
+
+ // You can use empty JSON objects to avoid changing a cell's properties.
+ range.setCellProperties([
+ [topHeaderProps, {}, {}, {}, {}],
+ [{}, {}, headerProps, headerProps, headerProps],
+ [{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
+ ]);
+
+ sheet.getUsedRange().format.autofitColumns();
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: continuous
+ uid: 'excel!Excel.BorderLineStyle.continuous:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Continuous"'
+ - name: dash
+ uid: 'excel!Excel.BorderLineStyle.dash:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dash"'
+ - name: dashDot
+ uid: 'excel!Excel.BorderLineStyle.dashDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DashDot"'
+ - name: dashDotDot
+ uid: 'excel!Excel.BorderLineStyle.dashDotDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DashDotDot"'
+ - name: dot
+ uid: 'excel!Excel.BorderLineStyle.dot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dot"'
+ - name: double
+ uid: 'excel!Excel.BorderLineStyle.double:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Double"'
+ - name: none
+ uid: 'excel!Excel.BorderLineStyle.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: slantDashDot
+ uid: 'excel!Excel.BorderLineStyle.slantDashDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SlantDashDot"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.borderweight.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.borderweight.yml
new file mode 100644
index 0000000000..0791300857
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.borderweight.yml
@@ -0,0 +1,30 @@
+### YamlMime:TSEnum
+name: Excel.BorderWeight
+uid: 'excel!Excel.BorderWeight:enum'
+package: excel!
+fullName: Excel.BorderWeight
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: hairline
+ uid: 'excel!Excel.BorderWeight.hairline:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Hairline"'
+ - name: medium
+ uid: 'excel!Excel.BorderWeight.medium:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Medium"'
+ - name: thick
+ uid: 'excel!Excel.BorderWeight.thick:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Thick"'
+ - name: thin
+ uid: 'excel!Excel.BorderWeight.thin:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Thin"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.builtinstyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.builtinstyle.yml
new file mode 100644
index 0000000000..46b1687d33
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.builtinstyle.yml
@@ -0,0 +1,354 @@
+### YamlMime:TSEnum
+name: Excel.BuiltInStyle
+uid: 'excel!Excel.BuiltInStyle:enum'
+package: excel!
+fullName: Excel.BuiltInStyle
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Creating the SettableCellProperties objects to use for the range.
+ // In your add-in, these should be created once, outside the function.
+ const topHeaderProps: Excel.SettableCellProperties = {
+ // The style property takes a string matching the name of an Excel style.
+ // Built-in style names are listed in the `BuiltInStyle` enum.
+ // Note that a style will overwrite any formatting,
+ // so do not use the format property with the style property.
+ style: "Heading1"
+ };
+
+ const headerProps: Excel.SettableCellProperties = {
+ // Any subproperties of format that are not set will not be changed when these cell properties are set.
+ format: {
+ fill: {
+ color: "Blue"
+ },
+ font: {
+ color: "White",
+ bold: true
+ }
+ }
+ };
+
+ const nonApplicableProps: Excel.SettableCellProperties = {
+ format: {
+ fill: {
+ pattern: Excel.FillPattern.gray25
+ },
+ font: {
+ color: "Gray",
+ italic: true
+ }
+ }
+ };
+
+ const matchupScoreProps: Excel.SettableCellProperties = {
+ format: {
+ borders: {
+ bottom: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ left: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ right: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ top: {
+ style: Excel.BorderLineStyle.continuous
+ }
+ }
+ }
+ };
+
+ const range = sheet.getRange("A1:E5");
+
+ // You can use empty JSON objects to avoid changing a cell's properties.
+ range.setCellProperties([
+ [topHeaderProps, {}, {}, {}, {}],
+ [{}, {}, headerProps, headerProps, headerProps],
+ [{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
+ ]);
+
+ sheet.getUsedRange().format.autofitColumns();
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: accent1
+ uid: 'excel!Excel.BuiltInStyle.accent1:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent1"'
+ - name: accent1_20
+ uid: 'excel!Excel.BuiltInStyle.accent1_20:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent1_20"'
+ - name: accent1_40
+ uid: 'excel!Excel.BuiltInStyle.accent1_40:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent1_40"'
+ - name: accent1_60
+ uid: 'excel!Excel.BuiltInStyle.accent1_60:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent1_60"'
+ - name: accent2
+ uid: 'excel!Excel.BuiltInStyle.accent2:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent2"'
+ - name: accent2_20
+ uid: 'excel!Excel.BuiltInStyle.accent2_20:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent2_20"'
+ - name: accent2_40
+ uid: 'excel!Excel.BuiltInStyle.accent2_40:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent2_40"'
+ - name: accent2_60
+ uid: 'excel!Excel.BuiltInStyle.accent2_60:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent2_60"'
+ - name: accent3
+ uid: 'excel!Excel.BuiltInStyle.accent3:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent3"'
+ - name: accent3_20
+ uid: 'excel!Excel.BuiltInStyle.accent3_20:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent3_20"'
+ - name: accent3_40
+ uid: 'excel!Excel.BuiltInStyle.accent3_40:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent3_40"'
+ - name: accent3_60
+ uid: 'excel!Excel.BuiltInStyle.accent3_60:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent3_60"'
+ - name: accent4
+ uid: 'excel!Excel.BuiltInStyle.accent4:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent4"'
+ - name: accent4_20
+ uid: 'excel!Excel.BuiltInStyle.accent4_20:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent4_20"'
+ - name: accent4_40
+ uid: 'excel!Excel.BuiltInStyle.accent4_40:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent4_40"'
+ - name: accent4_60
+ uid: 'excel!Excel.BuiltInStyle.accent4_60:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent4_60"'
+ - name: accent5
+ uid: 'excel!Excel.BuiltInStyle.accent5:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent5"'
+ - name: accent5_20
+ uid: 'excel!Excel.BuiltInStyle.accent5_20:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent5_20"'
+ - name: accent5_40
+ uid: 'excel!Excel.BuiltInStyle.accent5_40:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent5_40"'
+ - name: accent5_60
+ uid: 'excel!Excel.BuiltInStyle.accent5_60:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent5_60"'
+ - name: accent6
+ uid: 'excel!Excel.BuiltInStyle.accent6:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent6"'
+ - name: accent6_20
+ uid: 'excel!Excel.BuiltInStyle.accent6_20:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent6_20"'
+ - name: accent6_40
+ uid: 'excel!Excel.BuiltInStyle.accent6_40:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent6_40"'
+ - name: accent6_60
+ uid: 'excel!Excel.BuiltInStyle.accent6_60:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Accent6_60"'
+ - name: bad
+ uid: 'excel!Excel.BuiltInStyle.bad:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bad"'
+ - name: calculation
+ uid: 'excel!Excel.BuiltInStyle.calculation:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Calculation"'
+ - name: checkCell
+ uid: 'excel!Excel.BuiltInStyle.checkCell:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CheckCell"'
+ - name: comma
+ uid: 'excel!Excel.BuiltInStyle.comma:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Comma"'
+ - name: currency
+ uid: 'excel!Excel.BuiltInStyle.currency:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Currency"'
+ - name: emphasis1
+ uid: 'excel!Excel.BuiltInStyle.emphasis1:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Emphasis1"'
+ - name: emphasis2
+ uid: 'excel!Excel.BuiltInStyle.emphasis2:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Emphasis2"'
+ - name: emphasis3
+ uid: 'excel!Excel.BuiltInStyle.emphasis3:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Emphasis3"'
+ - name: explanatoryText
+ uid: 'excel!Excel.BuiltInStyle.explanatoryText:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ExplanatoryText"'
+ - name: good
+ uid: 'excel!Excel.BuiltInStyle.good:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Good"'
+ - name: heading1
+ uid: 'excel!Excel.BuiltInStyle.heading1:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Heading1"'
+ - name: heading2
+ uid: 'excel!Excel.BuiltInStyle.heading2:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Heading2"'
+ - name: heading3
+ uid: 'excel!Excel.BuiltInStyle.heading3:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Heading3"'
+ - name: heading4
+ uid: 'excel!Excel.BuiltInStyle.heading4:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Heading4"'
+ - name: hlink
+ uid: 'excel!Excel.BuiltInStyle.hlink:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Hlink"'
+ - name: hlinkTrav
+ uid: 'excel!Excel.BuiltInStyle.hlinkTrav:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"HlinkTrav"'
+ - name: input
+ uid: 'excel!Excel.BuiltInStyle.input:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Input"'
+ - name: linkedCell
+ uid: 'excel!Excel.BuiltInStyle.linkedCell:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LinkedCell"'
+ - name: neutral
+ uid: 'excel!Excel.BuiltInStyle.neutral:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Neutral"'
+ - name: normal
+ uid: 'excel!Excel.BuiltInStyle.normal:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Normal"'
+ - name: note
+ uid: 'excel!Excel.BuiltInStyle.note:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Note"'
+ - name: output
+ uid: 'excel!Excel.BuiltInStyle.output:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Output"'
+ - name: percent
+ uid: 'excel!Excel.BuiltInStyle.percent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percent"'
+ - name: sheetTitle
+ uid: 'excel!Excel.BuiltInStyle.sheetTitle:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SheetTitle"'
+ - name: total
+ uid: 'excel!Excel.BuiltInStyle.total:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Total"'
+ - name: warningText
+ uid: 'excel!Excel.BuiltInStyle.warningText:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"WarningText"'
+ - name: wholeComma
+ uid: 'excel!Excel.BuiltInStyle.wholeComma:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"WholeComma"'
+ - name: wholeDollar
+ uid: 'excel!Excel.BuiltInStyle.wholeDollar:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"WholeDollar"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.busyerrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.busyerrorcellvalue.yml
new file mode 100644
index 0000000000..e9af6591fd
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.busyerrorcellvalue.yml
@@ -0,0 +1,76 @@
+### YamlMime:TSType
+name: Excel.BusyErrorCellValue
+uid: 'excel!Excel.BusyErrorCellValue:interface'
+package: excel!
+fullName: Excel.BusyErrorCellValue
+summary: 'Represents the value of a cell containing a \#BUSY! error.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.BusyErrorCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.BusyErrorCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#BUSY!" | string;'
+ return:
+ type: '"#BUSY!" | string'
+ - name: errorSubType
+ uid: 'excel!Excel.BusyErrorCellValue#errorSubType:member'
+ package: excel!
+ fullName: errorSubType
+ summary: Represents the type of `BusyErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorSubType?: BusyErrorCellValueSubType | "Unknown" | "ExternalLinksGeneric" | "LoadingImage";'
+ return:
+ type: >-
+ | "Unknown" | "ExternalLinksGeneric" |
+ "LoadingImage"
+ - name: errorType
+ uid: 'excel!Excel.BusyErrorCellValue#errorType:member'
+ package: excel!
+ fullName: errorType
+ summary: Represents the type of `ErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorType?: ErrorCellValueType.busy | "Busy";'
+ return:
+ type: ' | "Busy"'
+ - name: type
+ uid: 'excel!Excel.BusyErrorCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.busyerrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.busyerrorcellvaluesubtype.yml
new file mode 100644
index 0000000000..76c10a436a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.busyerrorcellvaluesubtype.yml
@@ -0,0 +1,34 @@
+### YamlMime:TSEnum
+name: Excel.BusyErrorCellValueSubType
+uid: 'excel!Excel.BusyErrorCellValueSubType:enum'
+package: excel!
+fullName: Excel.BusyErrorCellValueSubType
+summary: 'Represents types of \#BUSY! errors.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: externalLinksGeneric
+ uid: 'excel!Excel.BusyErrorCellValueSubType.externalLinksGeneric:member'
+ package: excel!
+ summary: |-
+ An error caused by external links. Displays as error type \#BUSY! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksGeneric"'
+ - name: loadingImage
+ uid: 'excel!Excel.BusyErrorCellValueSubType.loadingImage:member'
+ package: excel!
+ summary: |-
+ An error that displays while an image is loading. Displays as error type \#BUSY! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LoadingImage"'
+ - name: unknown
+ uid: 'excel!Excel.BusyErrorCellValueSubType.unknown:member'
+ package: excel!
+ summary: |-
+ An unknown type of error. Displays as error type \#BUSY! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.calcerrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.calcerrorcellvalue.yml
new file mode 100644
index 0000000000..98340736b5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.calcerrorcellvalue.yml
@@ -0,0 +1,92 @@
+### YamlMime:TSType
+name: Excel.CalcErrorCellValue
+uid: 'excel!Excel.CalcErrorCellValue:interface'
+package: excel!
+fullName: Excel.CalcErrorCellValue
+summary: 'Represents the value of a cell containing a \#CALC! error.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.CalcErrorCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.CalcErrorCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#CALC!" | string;'
+ return:
+ type: '"#CALC!" | string'
+ - name: errorSubType
+ uid: 'excel!Excel.CalcErrorCellValue#errorSubType:member'
+ package: excel!
+ fullName: errorSubType
+ summary: Represents the type of `CalcErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ errorSubType?: CalcErrorCellValueSubType | "Unknown" | "ArrayOfArrays" | "ArrayOfRanges" | "EmptyArray" |
+ "UnsupportedLifting" | "DataTableReferencedPendingFormula" | "TooManyCells" | "LambdaInCell" | "TooDeeplyNested"
+ | "TextOverflow";
+ return:
+ type: >-
+ | "Unknown" | "ArrayOfArrays" | "ArrayOfRanges" |
+ "EmptyArray" | "UnsupportedLifting" | "DataTableReferencedPendingFormula" | "TooManyCells" | "LambdaInCell" |
+ "TooDeeplyNested" | "TextOverflow"
+ - name: errorType
+ uid: 'excel!Excel.CalcErrorCellValue#errorType:member'
+ package: excel!
+ fullName: errorType
+ summary: Represents the type of `ErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorType?: ErrorCellValueType.calc | "Calc";'
+ return:
+ type: ' | "Calc"'
+ - name: functionName
+ uid: 'excel!Excel.CalcErrorCellValue#functionName:member'
+ package: excel!
+ fullName: functionName
+ summary: Represents the name of the function causing the error.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'functionName?: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.CalcErrorCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.calcerrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.calcerrorcellvaluesubtype.yml
new file mode 100644
index 0000000000..fd9c0b6673
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.calcerrorcellvaluesubtype.yml
@@ -0,0 +1,100 @@
+### YamlMime:TSEnum
+name: Excel.CalcErrorCellValueSubType
+uid: 'excel!Excel.CalcErrorCellValueSubType:enum'
+package: excel!
+fullName: Excel.CalcErrorCellValueSubType
+summary: 'Represents types of \#CALC! errors.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: arrayOfArrays
+ uid: 'excel!Excel.CalcErrorCellValueSubType.arrayOfArrays:member'
+ package: excel!
+ summary: |-
+ An error caused by including an array in an array. Displays as error type \#CALC! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ArrayOfArrays"'
+ - name: arrayOfRanges
+ uid: 'excel!Excel.CalcErrorCellValueSubType.arrayOfRanges:member'
+ package: excel!
+ summary: |-
+ An error caused by including a range in an array. Displays as error type \#CALC! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ArrayOfRanges"'
+ - name: dataTableReferencedPendingFormula
+ uid: 'excel!Excel.CalcErrorCellValueSubType.dataTableReferencedPendingFormula:member'
+ package: excel!
+ summary: >-
+ An error caused by a data table referencing a pending formula. The pending formula is likely asynchronous.
+ Displays as error type \#CALC! in Excel.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataTableReferencedPendingFormula"'
+ - name: emptyArray
+ uid: 'excel!Excel.CalcErrorCellValueSubType.emptyArray:member'
+ package: excel!
+ summary: |-
+ An error caused by an empty array. Displays as error type \#CALC! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmptyArray"'
+ - name: lambdaInCell
+ uid: 'excel!Excel.CalcErrorCellValueSubType.lambdaInCell:member'
+ package: excel!
+ summary: |-
+ An error caused by a cell's formula evaluating to a lambda value. Displays as error type \#CALC! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LambdaInCell"'
+ - name: textOverflow
+ uid: 'excel!Excel.CalcErrorCellValueSubType.textOverflow:member'
+ package: excel!
+ summary: >-
+ An error caused by a cell's formula returning a string that exceeds the maximum of 32767 characters. Displays as
+ error type \#CALC! in Excel. Some characters, like emoji, may appear to be one character in the Excel UI but are
+ actually processed as surrogate characters. A surrogate character counts as multiple characters toward the maximum
+ character limit.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TextOverflow"'
+ - name: tooDeeplyNested
+ uid: 'excel!Excel.CalcErrorCellValueSubType.tooDeeplyNested:member'
+ package: excel!
+ summary: >-
+ An error caused by a `CellValue` object that is too deeply nested within another `CellValue`. Displays as
+ error type \#CALC! in Excel.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TooDeeplyNested"'
+ - name: tooManyCells
+ uid: 'excel!Excel.CalcErrorCellValueSubType.tooManyCells:member'
+ package: excel!
+ summary: |-
+ An error caused by a function referencing too many cells. Displays as error type \#CALC! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TooManyCells"'
+ - name: unknown
+ uid: 'excel!Excel.CalcErrorCellValueSubType.unknown:member'
+ package: excel!
+ summary: |-
+ An unknown type of error. Displays as error type \#CALC! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
+ - name: unsupportedLifting
+ uid: 'excel!Excel.CalcErrorCellValueSubType.unsupportedLifting:member'
+ package: excel!
+ summary: >-
+ An error caused by attempting to lift an unsupported formula (such as a Dynamic UDF) over an array. Displays as
+ error type \#CALC! in Excel.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"UnsupportedLifting"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationmode.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationmode.yml
new file mode 100644
index 0000000000..1565806cd5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationmode.yml
@@ -0,0 +1,56 @@
+### YamlMime:TSEnum
+name: Excel.CalculationMode
+uid: 'excel!Excel.CalculationMode:enum'
+package: excel!
+fullName: Excel.CalculationMode
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/workbook-calculation.yaml
+
+ await Excel.run(async (context) => {
+ context.application.calculationMode = Excel.CalculationMode.manual;
+ context.application.load("calculationMode");
+ await context.sync();
+
+ console.log("Current calculation mode: " + context.application.calculationMode);
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.CalculationMode.automatic:member'
+ package: excel!
+ summary: >-
+ The default recalculation behavior where Excel calculates new formula results every time the relevant data is
+ changed.
+
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Automatic"'
+ - name: automaticExceptTables
+ uid: 'excel!Excel.CalculationMode.automaticExceptTables:member'
+ package: excel!
+ summary: |-
+ Calculates new formula results every time the relevant data is changed, unless the formula is in a data table.
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AutomaticExceptTables"'
+ - name: manual
+ uid: 'excel!Excel.CalculationMode.manual:member'
+ package: excel!
+ summary: |-
+ Calculations only occur when the user or add-in requests them.
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Manual"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationstate.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationstate.yml
new file mode 100644
index 0000000000..464c92fc80
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationstate.yml
@@ -0,0 +1,34 @@
+### YamlMime:TSEnum
+name: Excel.CalculationState
+uid: 'excel!Excel.CalculationState:enum'
+package: excel!
+fullName: Excel.CalculationState
+summary: Represents the state of calculation across the entire Excel application.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: calculating
+ uid: 'excel!Excel.CalculationState.calculating:member'
+ package: excel!
+ summary: |-
+ Calculations in progress.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Calculating"'
+ - name: done
+ uid: 'excel!Excel.CalculationState.done:member'
+ package: excel!
+ summary: |-
+ Calculations complete.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Done"'
+ - name: pending
+ uid: 'excel!Excel.CalculationState.pending:member'
+ package: excel!
+ summary: |-
+ Changes that trigger calculation have been made, but a recalculation has not yet been performed.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pending"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationtype.yml
new file mode 100644
index 0000000000..d575320090
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.calculationtype.yml
@@ -0,0 +1,53 @@
+### YamlMime:TSEnum
+name: Excel.CalculationType
+uid: 'excel!Excel.CalculationType:enum'
+package: excel!
+fullName: Excel.CalculationType
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/workbook-calculation.yaml
+
+ await Excel.run(async (context) => {
+ context.application.calculate(Excel.CalculationType.recalculate);
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: full
+ uid: 'excel!Excel.CalculationType.full:member'
+ package: excel!
+ summary: |-
+ This will mark all cells as dirty and then recalculate them.
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Full"'
+ - name: fullRebuild
+ uid: 'excel!Excel.CalculationType.fullRebuild:member'
+ package: excel!
+ summary: |-
+ This will rebuild the full dependency chain, mark all cells as dirty and then recalculate them.
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FullRebuild"'
+ - name: recalculate
+ uid: 'excel!Excel.CalculationType.recalculate:member'
+ package: excel!
+ summary: >-
+ Recalculates all cells that Excel has marked as dirty, that is, dependents of volatile or changed data, and cells
+ programmatically marked as dirty.
+
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Recalculate"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayout.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayout.yml
new file mode 100644
index 0000000000..d8bae9a84e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayout.yml
@@ -0,0 +1,10 @@
+### YamlMime:TSTypeAlias
+name: Excel.CardLayout
+uid: 'excel!Excel.CardLayout:type'
+package: excel!
+fullName: Excel.CardLayout
+summary: Represents the layout of a card in card view.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+syntax: export type CardLayout = EntityCardLayout;
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutlistsection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutlistsection.yml
new file mode 100644
index 0000000000..c9ac1b5874
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutlistsection.yml
@@ -0,0 +1,24 @@
+### YamlMime:TSType
+name: Excel.CardLayoutListSection
+uid: 'excel!Excel.CardLayoutListSection:interface'
+package: excel!
+fullName: Excel.CardLayoutListSection
+summary: Represents a section of a card that is arranged as a list in card view.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: layout
+ uid: 'excel!Excel.CardLayoutListSection#layout:member'
+ package: excel!
+ fullName: layout
+ summary: Represents the type of layout for this section.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'layout: "List";'
+ return:
+ type: '"List"'
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutpropertyreference.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutpropertyreference.yml
new file mode 100644
index 0000000000..cc797c64c6
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutpropertyreference.yml
@@ -0,0 +1,23 @@
+### YamlMime:TSType
+name: Excel.CardLayoutPropertyReference
+uid: 'excel!Excel.CardLayoutPropertyReference:interface'
+package: excel!
+fullName: Excel.CardLayoutPropertyReference
+summary: Represents a reference to a property used by the card layout.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: property
+ uid: 'excel!Excel.CardLayoutPropertyReference#property:member'
+ package: excel!
+ fullName: property
+ summary: Represents the name of the property referenced by the card layout.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'property: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsection.yml
new file mode 100644
index 0000000000..193631e53a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsection.yml
@@ -0,0 +1,10 @@
+### YamlMime:TSTypeAlias
+name: Excel.CardLayoutSection
+uid: 'excel!Excel.CardLayoutSection:type'
+package: excel!
+fullName: Excel.CardLayoutSection
+summary: Represents the layout of a section of a card in card view.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+syntax: export type CardLayoutSection = CardLayoutListSection | CardLayoutTableSection;
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsectionstandardproperties.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsectionstandardproperties.yml
new file mode 100644
index 0000000000..eea162a954
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsectionstandardproperties.yml
@@ -0,0 +1,61 @@
+### YamlMime:TSType
+name: Excel.CardLayoutSectionStandardProperties
+uid: 'excel!Excel.CardLayoutSectionStandardProperties:interface'
+package: excel!
+fullName: Excel.CardLayoutSectionStandardProperties
+summary: Properties of a card layout relevant to most card layouts.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: collapsed
+ uid: 'excel!Excel.CardLayoutSectionStandardProperties#collapsed:member'
+ package: excel!
+ fullName: collapsed
+ summary: Represents whether this section of the card is initially collapsed.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'collapsed?: boolean;'
+ return:
+ type: boolean
+ - name: collapsible
+ uid: 'excel!Excel.CardLayoutSectionStandardProperties#collapsible:member'
+ package: excel!
+ fullName: collapsible
+ summary: >-
+ Represents whether this section of the card is collapsible. If the card section has a title, the default value is
+ `true`. If the card section doesn't have a title, the default value is `false`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'collapsible?: boolean;'
+ return:
+ type: boolean
+ - name: properties
+ uid: 'excel!Excel.CardLayoutSectionStandardProperties#properties:member'
+ package: excel!
+ fullName: properties
+ summary: Represents the names of the properties in this section.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'properties: string[];'
+ return:
+ type: 'string[]'
+ - name: title
+ uid: 'excel!Excel.CardLayoutSectionStandardProperties#title:member'
+ package: excel!
+ fullName: title
+ summary: Represents the title of this section of the card.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'title?: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutstandardproperties.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutstandardproperties.yml
new file mode 100644
index 0000000000..3d3abd181c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutstandardproperties.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.CardLayoutStandardProperties
+uid: 'excel!Excel.CardLayoutStandardProperties:interface'
+package: excel!
+fullName: Excel.CardLayoutStandardProperties
+summary: Properties of a card layout relevant to most card layouts.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: mainImage
+ uid: 'excel!Excel.CardLayoutStandardProperties#mainImage:member'
+ package: excel!
+ fullName: mainImage
+ summary: Specifies a property which will be used as the main image of the card.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'mainImage?: CardLayoutPropertyReference;'
+ return:
+ type: ''
+ - name: sections
+ uid: 'excel!Excel.CardLayoutStandardProperties#sections:member'
+ package: excel!
+ fullName: sections
+ summary: Represents the sections of the card.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'sections?: CardLayoutSection[];'
+ return:
+ type: '[]'
+ - name: subTitle
+ uid: 'excel!Excel.CardLayoutStandardProperties#subTitle:member'
+ package: excel!
+ fullName: subTitle
+ summary: Represents a specification of which property contains the subtitle of the card.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'subTitle?: CardLayoutPropertyReference;'
+ return:
+ type: ''
+ - name: title
+ uid: 'excel!Excel.CardLayoutStandardProperties#title:member'
+ package: excel!
+ fullName: title
+ summary: Represents the title of the card or the specification of which property contains the title of the card.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'title?: string | CardLayoutPropertyReference;'
+ return:
+ type: 'string | '
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayouttablesection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayouttablesection.yml
new file mode 100644
index 0000000000..53711c00a7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayouttablesection.yml
@@ -0,0 +1,24 @@
+### YamlMime:TSType
+name: Excel.CardLayoutTableSection
+uid: 'excel!Excel.CardLayoutTableSection:interface'
+package: excel!
+fullName: Excel.CardLayoutTableSection
+summary: Represents a section of a card that is arranged as a table in card view.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: layout
+ uid: 'excel!Excel.CardLayoutTableSection#layout:member'
+ package: excel!
+ fullName: layout
+ summary: Represents the type of layout for this section.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'layout: "Table";'
+ return:
+ type: '"Table"'
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellborder.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellborder.yml
new file mode 100644
index 0000000000..d0c21d0911
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellborder.yml
@@ -0,0 +1,66 @@
+### YamlMime:TSType
+name: Excel.CellBorder
+uid: 'excel!Excel.CellBorder:interface'
+package: excel!
+fullName: Excel.CellBorder
+summary: >-
+ Represents the properties of a single border returned by `getCellProperties`, `getRowProperties`, and
+ `getColumnProperties`, or the border property input parameter of `setCellProperties`,
+ `setRowProperties`, and `setColumnProperties`.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: color
+ uid: 'excel!Excel.CellBorder#color:member'
+ package: excel!
+ fullName: color
+ summary: Represents the `color` property of a single border.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: string;'
+ return:
+ type: string
+ - name: style
+ uid: 'excel!Excel.CellBorder#style:member'
+ package: excel!
+ fullName: style
+ summary: Represents the `style` property of a single border.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ style?: Excel.BorderLineStyle | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" | "Dot" | "Double" |
+ "SlantDashDot";
+ return:
+ type: >-
+ | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" |
+ "Dot" | "Double" | "SlantDashDot"
+ - name: tintAndShade
+ uid: 'excel!Excel.CellBorder#tintAndShade:member'
+ package: excel!
+ fullName: tintAndShade
+ summary: Represents the `tintAndShade` property of a single border.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tintAndShade?: number;'
+ return:
+ type: number
+ - name: weight
+ uid: 'excel!Excel.CellBorder#weight:member'
+ package: excel!
+ fullName: weight
+ summary: Represents the `weight` property of a single border.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'weight?: Excel.BorderWeight | "Hairline" | "Thin" | "Medium" | "Thick";'
+ return:
+ type: ' | "Hairline" | "Thin" | "Medium" | "Thick"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellbordercollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellbordercollection.yml
new file mode 100644
index 0000000000..ada91db4db
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellbordercollection.yml
@@ -0,0 +1,110 @@
+### YamlMime:TSType
+name: Excel.CellBorderCollection
+uid: 'excel!Excel.CellBorderCollection:interface'
+package: excel!
+fullName: Excel.CellBorderCollection
+summary: >-
+ Represents the `format.borders` properties of `getCellProperties`, `getRowProperties`, and
+ `getColumnProperties`, or the `format.borders` input parameter of `setCellProperties`,
+ `setRowProperties`, and `setColumnProperties`.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: bottom
+ uid: 'excel!Excel.CellBorderCollection#bottom:member'
+ package: excel!
+ fullName: bottom
+ summary: Represents the `format.borders.bottom` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'bottom?: Excel.CellBorder;'
+ return:
+ type: ''
+ - name: diagonalDown
+ uid: 'excel!Excel.CellBorderCollection#diagonalDown:member'
+ package: excel!
+ fullName: diagonalDown
+ summary: Represents the `format.borders.diagonalDown` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'diagonalDown?: Excel.CellBorder;'
+ return:
+ type: ''
+ - name: diagonalUp
+ uid: 'excel!Excel.CellBorderCollection#diagonalUp:member'
+ package: excel!
+ fullName: diagonalUp
+ summary: Represents the `format.borders.diagonalUp` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'diagonalUp?: Excel.CellBorder;'
+ return:
+ type: ''
+ - name: horizontal
+ uid: 'excel!Excel.CellBorderCollection#horizontal:member'
+ package: excel!
+ fullName: horizontal
+ summary: Represents the `format.borders.horizontal` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'horizontal?: Excel.CellBorder;'
+ return:
+ type: ''
+ - name: left
+ uid: 'excel!Excel.CellBorderCollection#left:member'
+ package: excel!
+ fullName: left
+ summary: Represents the `format.borders.left` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'left?: Excel.CellBorder;'
+ return:
+ type: ''
+ - name: right
+ uid: 'excel!Excel.CellBorderCollection#right:member'
+ package: excel!
+ fullName: right
+ summary: Represents the `format.borders.right` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'right?: Excel.CellBorder;'
+ return:
+ type: ''
+ - name: top
+ uid: 'excel!Excel.CellBorderCollection#top:member'
+ package: excel!
+ fullName: top
+ summary: Represents the `format.borders.top` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'top?: Excel.CellBorder;'
+ return:
+ type: ''
+ - name: vertical
+ uid: 'excel!Excel.CellBorderCollection#vertical:member'
+ package: excel!
+ fullName: vertical
+ summary: Represents the `format.borders.vertical` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'vertical?: Excel.CellBorder;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellproperties.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellproperties.yml
new file mode 100644
index 0000000000..4dd00a192a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellproperties.yml
@@ -0,0 +1,60 @@
+### YamlMime:TSType
+name: Excel.CellProperties
+uid: 'excel!Excel.CellProperties:interface'
+package: excel!
+fullName: Excel.CellProperties
+summary: |-
+ Represents the returned properties of getCellProperties.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: address
+ uid: 'excel!Excel.CellProperties#address:member'
+ package: excel!
+ fullName: address
+ summary: |-
+ Represents the `address` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'address?: string;'
+ return:
+ type: string
+ - name: addressLocal
+ uid: 'excel!Excel.CellProperties#addressLocal:member'
+ package: excel!
+ fullName: addressLocal
+ summary: |-
+ Represents the `addressLocal` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'addressLocal?: string;'
+ return:
+ type: string
+ - name: hidden
+ uid: 'excel!Excel.CellProperties#hidden:member'
+ package: excel!
+ fullName: hidden
+ summary: |-
+ Represents the `hidden` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'hidden?: boolean;'
+ return:
+ type: boolean
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesborderloadoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesborderloadoptions.yml
new file mode 100644
index 0000000000..c917c0f5f2
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesborderloadoptions.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesBorderLoadOptions
+uid: 'excel!Excel.CellPropertiesBorderLoadOptions:interface'
+package: excel!
+fullName: Excel.CellPropertiesBorderLoadOptions
+summary: Specifies which properties to load on the `format.borders` object.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: color
+ uid: 'excel!Excel.CellPropertiesBorderLoadOptions#color:member'
+ package: excel!
+ fullName: color
+ summary: Specifies whether to load the `color` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: boolean;'
+ return:
+ type: boolean
+ - name: style
+ uid: 'excel!Excel.CellPropertiesBorderLoadOptions#style:member'
+ package: excel!
+ fullName: style
+ summary: Specifies whether to load the `style` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'style?: boolean;'
+ return:
+ type: boolean
+ - name: tintAndShade
+ uid: 'excel!Excel.CellPropertiesBorderLoadOptions#tintAndShade:member'
+ package: excel!
+ fullName: tintAndShade
+ summary: Specifies whether to load the `tintAndShade` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tintAndShade?: boolean;'
+ return:
+ type: boolean
+ - name: weight
+ uid: 'excel!Excel.CellPropertiesBorderLoadOptions#weight:member'
+ package: excel!
+ fullName: weight
+ summary: Specifies whether to load the `weight` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'weight?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfill.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfill.yml
new file mode 100644
index 0000000000..ef04e17a8e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfill.yml
@@ -0,0 +1,164 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesFill
+uid: 'excel!Excel.CellPropertiesFill:interface'
+package: excel!
+fullName: Excel.CellPropertiesFill
+summary: >-
+ Represents the `format.fill` properties of `getCellProperties`, `getRowProperties`, and
+ `getColumnProperties` or the `format.fill` input parameter of `setCellProperties`, `setRowProperties`,
+ and `setColumnProperties`.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: color
+ uid: 'excel!Excel.CellPropertiesFill#color:member'
+ package: excel!
+ fullName: color
+ summary: Represents the `format.fill.color` property.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Creating the SettableCellProperties objects to use for the range.
+ // In your add-in, these should be created once, outside the function.
+ const topHeaderProps: Excel.SettableCellProperties = {
+ // The style property takes a string matching the name of an Excel style.
+ // Built-in style names are listed in the `BuiltInStyle` enum.
+ // Note that a style will overwrite any formatting,
+ // so do not use the format property with the style property.
+ style: "Heading1"
+ };
+
+ const headerProps: Excel.SettableCellProperties = {
+ // Any subproperties of format that are not set will not be changed when these cell properties are set.
+ format: {
+ fill: {
+ color: "Blue"
+ },
+ font: {
+ color: "White",
+ bold: true
+ }
+ }
+ };
+
+ const nonApplicableProps: Excel.SettableCellProperties = {
+ format: {
+ fill: {
+ pattern: Excel.FillPattern.gray25
+ },
+ font: {
+ color: "Gray",
+ italic: true
+ }
+ }
+ };
+
+ const matchupScoreProps: Excel.SettableCellProperties = {
+ format: {
+ borders: {
+ bottom: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ left: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ right: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ top: {
+ style: Excel.BorderLineStyle.continuous
+ }
+ }
+ }
+ };
+
+ const range = sheet.getRange("A1:E5");
+
+ // You can use empty JSON objects to avoid changing a cell's properties.
+ range.setCellProperties([
+ [topHeaderProps, {}, {}, {}, {}],
+ [{}, {}, headerProps, headerProps, headerProps],
+ [{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
+ ]);
+
+ sheet.getUsedRange().format.autofitColumns();
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: string;'
+ return:
+ type: string
+ - name: pattern
+ uid: 'excel!Excel.CellPropertiesFill#pattern:member'
+ package: excel!
+ fullName: pattern
+ summary: Represents the `format.fill.pattern` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ pattern?: Excel.FillPattern | "None" | "Solid" | "Gray50" | "Gray75" | "Gray25" | "Horizontal" | "Vertical" |
+ "Down" | "Up" | "Checker" | "SemiGray75" | "LightHorizontal" | "LightVertical" | "LightDown" | "LightUp" |
+ "Grid" | "CrissCross" | "Gray16" | "Gray8" | "LinearGradient" | "RectangularGradient";
+ return:
+ type: >-
+ | "None" | "Solid" | "Gray50" | "Gray75" | "Gray25" | "Horizontal"
+ | "Vertical" | "Down" | "Up" | "Checker" | "SemiGray75" | "LightHorizontal" | "LightVertical" | "LightDown" |
+ "LightUp" | "Grid" | "CrissCross" | "Gray16" | "Gray8" | "LinearGradient" | "RectangularGradient"
+ - name: patternColor
+ uid: 'excel!Excel.CellPropertiesFill#patternColor:member'
+ package: excel!
+ fullName: patternColor
+ summary: Represents the `format.fill.patternColor` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'patternColor?: string;'
+ return:
+ type: string
+ - name: patternTintAndShade
+ uid: 'excel!Excel.CellPropertiesFill#patternTintAndShade:member'
+ package: excel!
+ fullName: patternTintAndShade
+ summary: Represents the `format.fill.patternTintAndShade` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'patternTintAndShade?: number;'
+ return:
+ type: number
+ - name: tintAndShade
+ uid: 'excel!Excel.CellPropertiesFill#tintAndShade:member'
+ package: excel!
+ fullName: tintAndShade
+ summary: Represents the `format.fill.tintAndShade` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tintAndShade?: number;'
+ return:
+ type: number
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfillloadoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfillloadoptions.yml
new file mode 100644
index 0000000000..0b8067dc43
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfillloadoptions.yml
@@ -0,0 +1,107 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesFillLoadOptions
+uid: 'excel!Excel.CellPropertiesFillLoadOptions:interface'
+package: excel!
+fullName: Excel.CellPropertiesFillLoadOptions
+summary: Specifies which properties to load on the `format.fill` object.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: color
+ uid: 'excel!Excel.CellPropertiesFillLoadOptions#color:member'
+ package: excel!
+ fullName: color
+ summary: Specifies whether to load the `color` property.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const cell = context.workbook.getActiveCell();
+
+ // Define the cell properties to get by setting the matching LoadOptions to true.
+ const propertiesToGet = cell.getCellProperties({
+ address: true,
+ format: {
+ fill: {
+ color: true
+ },
+ font: {
+ color: true
+ }
+ },
+ style: true
+ });
+
+ // Sync to get the data from the workbook.
+ await context.sync();
+ const cellProperties = propertiesToGet.value[0][0];
+ console.log(
+ `Address: ${cellProperties.address}\nStyle: ${cellProperties.style}\nFill Color: ${cellProperties.format.fill.color}\nFont Color: ${cellProperties.format.font.color}`);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: boolean;'
+ return:
+ type: boolean
+ - name: pattern
+ uid: 'excel!Excel.CellPropertiesFillLoadOptions#pattern:member'
+ package: excel!
+ fullName: pattern
+ summary: Specifies whether to load the `pattern` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'pattern?: boolean;'
+ return:
+ type: boolean
+ - name: patternColor
+ uid: 'excel!Excel.CellPropertiesFillLoadOptions#patternColor:member'
+ package: excel!
+ fullName: patternColor
+ summary: Specifies whether to load the `patternColor` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'patternColor?: boolean;'
+ return:
+ type: boolean
+ - name: patternTintAndShade
+ uid: 'excel!Excel.CellPropertiesFillLoadOptions#patternTintAndShade:member'
+ package: excel!
+ fullName: patternTintAndShade
+ summary: Specifies whether to load the `patternTintAndShade` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'patternTintAndShade?: boolean;'
+ return:
+ type: boolean
+ - name: tintAndShade
+ uid: 'excel!Excel.CellPropertiesFillLoadOptions#tintAndShade:member'
+ package: excel!
+ fullName: tintAndShade
+ summary: Specifies whether to load the `tintAndShade` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tintAndShade?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfont.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfont.yml
new file mode 100644
index 0000000000..261bd20df0
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfont.yml
@@ -0,0 +1,220 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesFont
+uid: 'excel!Excel.CellPropertiesFont:interface'
+package: excel!
+fullName: Excel.CellPropertiesFont
+summary: >-
+ Represents the `format.font` properties of `getCellProperties`, `getRowProperties`, and
+ `getColumnProperties`, or the `format.font` input parameter of `setCellProperties`,
+ `setRowProperties`, and `setColumnProperties`.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: bold
+ uid: 'excel!Excel.CellPropertiesFont#bold:member'
+ package: excel!
+ fullName: bold
+ summary: Represents the `format.font.bold` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'bold?: boolean;'
+ return:
+ type: boolean
+ - name: color
+ uid: 'excel!Excel.CellPropertiesFont#color:member'
+ package: excel!
+ fullName: color
+ summary: Represents the `format.font.color` property.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Creating the SettableCellProperties objects to use for the range.
+ // In your add-in, these should be created once, outside the function.
+ const topHeaderProps: Excel.SettableCellProperties = {
+ // The style property takes a string matching the name of an Excel style.
+ // Built-in style names are listed in the `BuiltInStyle` enum.
+ // Note that a style will overwrite any formatting,
+ // so do not use the format property with the style property.
+ style: "Heading1"
+ };
+
+ const headerProps: Excel.SettableCellProperties = {
+ // Any subproperties of format that are not set will not be changed when these cell properties are set.
+ format: {
+ fill: {
+ color: "Blue"
+ },
+ font: {
+ color: "White",
+ bold: true
+ }
+ }
+ };
+
+ const nonApplicableProps: Excel.SettableCellProperties = {
+ format: {
+ fill: {
+ pattern: Excel.FillPattern.gray25
+ },
+ font: {
+ color: "Gray",
+ italic: true
+ }
+ }
+ };
+
+ const matchupScoreProps: Excel.SettableCellProperties = {
+ format: {
+ borders: {
+ bottom: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ left: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ right: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ top: {
+ style: Excel.BorderLineStyle.continuous
+ }
+ }
+ }
+ };
+
+ const range = sheet.getRange("A1:E5");
+
+ // You can use empty JSON objects to avoid changing a cell's properties.
+ range.setCellProperties([
+ [topHeaderProps, {}, {}, {}, {}],
+ [{}, {}, headerProps, headerProps, headerProps],
+ [{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
+ ]);
+
+ sheet.getUsedRange().format.autofitColumns();
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: string;'
+ return:
+ type: string
+ - name: italic
+ uid: 'excel!Excel.CellPropertiesFont#italic:member'
+ package: excel!
+ fullName: italic
+ summary: Represents the `format.font.italic` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'italic?: boolean;'
+ return:
+ type: boolean
+ - name: name
+ uid: 'excel!Excel.CellPropertiesFont#name:member'
+ package: excel!
+ fullName: name
+ summary: Represents the `format.font.name` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name?: string;'
+ return:
+ type: string
+ - name: size
+ uid: 'excel!Excel.CellPropertiesFont#size:member'
+ package: excel!
+ fullName: size
+ summary: Represents the `format.font.size` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'size?: number;'
+ return:
+ type: number
+ - name: strikethrough
+ uid: 'excel!Excel.CellPropertiesFont#strikethrough:member'
+ package: excel!
+ fullName: strikethrough
+ summary: Represents the `format.font.strikethrough` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'strikethrough?: boolean;'
+ return:
+ type: boolean
+ - name: subscript
+ uid: 'excel!Excel.CellPropertiesFont#subscript:member'
+ package: excel!
+ fullName: subscript
+ summary: Represents the `format.font.subscript` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'subscript?: boolean;'
+ return:
+ type: boolean
+ - name: superscript
+ uid: 'excel!Excel.CellPropertiesFont#superscript:member'
+ package: excel!
+ fullName: superscript
+ summary: Represents the `format.font.superscript` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'superscript?: boolean;'
+ return:
+ type: boolean
+ - name: tintAndShade
+ uid: 'excel!Excel.CellPropertiesFont#tintAndShade:member'
+ package: excel!
+ fullName: tintAndShade
+ summary: Represents the `format.font.tintAndShade` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tintAndShade?: number;'
+ return:
+ type: number
+ - name: underline
+ uid: 'excel!Excel.CellPropertiesFont#underline:member'
+ package: excel!
+ fullName: underline
+ summary: Represents the `format.font.underline` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'underline?: Excel.RangeUnderlineStyle | "None" | "Single" | "Double" | "SingleAccountant" | "DoubleAccountant";'
+ return:
+ type: >-
+ | "None" | "Single" | "Double" | "SingleAccountant" |
+ "DoubleAccountant"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfontloadoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfontloadoptions.yml
new file mode 100644
index 0000000000..5db498ffbc
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesfontloadoptions.yml
@@ -0,0 +1,167 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesFontLoadOptions
+uid: 'excel!Excel.CellPropertiesFontLoadOptions:interface'
+package: excel!
+fullName: Excel.CellPropertiesFontLoadOptions
+summary: Specifies which properties to load on the `format.font` object.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: bold
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#bold:member'
+ package: excel!
+ fullName: bold
+ summary: Specifies whether to load the `bold` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'bold?: boolean;'
+ return:
+ type: boolean
+ - name: color
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#color:member'
+ package: excel!
+ fullName: color
+ summary: Specifies whether to load the `color` property.
+ remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const cell = context.workbook.getActiveCell();
+
+ // Define the cell properties to get by setting the matching LoadOptions to true.
+ const propertiesToGet = cell.getCellProperties({
+ address: true,
+ format: {
+ fill: {
+ color: true
+ },
+ font: {
+ color: true
+ }
+ },
+ style: true
+ });
+
+ // Sync to get the data from the workbook.
+ await context.sync();
+ const cellProperties = propertiesToGet.value[0][0];
+ console.log(
+ `Address: ${cellProperties.address}\nStyle: ${cellProperties.style}\nFill Color: ${cellProperties.format.fill.color}\nFont Color: ${cellProperties.format.font.color}`);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: boolean;'
+ return:
+ type: boolean
+ - name: italic
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#italic:member'
+ package: excel!
+ fullName: italic
+ summary: Specifies whether to load the `italic` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'italic?: boolean;'
+ return:
+ type: boolean
+ - name: name
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#name:member'
+ package: excel!
+ fullName: name
+ summary: Specifies whether to load the `name` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name?: boolean;'
+ return:
+ type: boolean
+ - name: size
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#size:member'
+ package: excel!
+ fullName: size
+ summary: Specifies whether to load the `size` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'size?: boolean;'
+ return:
+ type: boolean
+ - name: strikethrough
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#strikethrough:member'
+ package: excel!
+ fullName: strikethrough
+ summary: Specifies whether to load the `strikethrough` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'strikethrough?: boolean;'
+ return:
+ type: boolean
+ - name: subscript
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#subscript:member'
+ package: excel!
+ fullName: subscript
+ summary: Specifies whether to load the `subscript` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'subscript?: boolean;'
+ return:
+ type: boolean
+ - name: superscript
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#superscript:member'
+ package: excel!
+ fullName: superscript
+ summary: Specifies whether to load the `superscript` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'superscript?: boolean;'
+ return:
+ type: boolean
+ - name: tintAndShade
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#tintAndShade:member'
+ package: excel!
+ fullName: tintAndShade
+ summary: Specifies whether to load the `tintAndShade` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tintAndShade?: boolean;'
+ return:
+ type: boolean
+ - name: underline
+ uid: 'excel!Excel.CellPropertiesFontLoadOptions#underline:member'
+ package: excel!
+ fullName: underline
+ summary: Specifies whether to load the `underline` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'underline?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesformat.yml
new file mode 100644
index 0000000000..f4ec83869e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesformat.yml
@@ -0,0 +1,228 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesFormat
+uid: 'excel!Excel.CellPropertiesFormat:interface'
+package: excel!
+fullName: Excel.CellPropertiesFormat
+summary: |-
+ Represents the returned format properties of getCellProperties or format input parameter of setCellProperties.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: autoIndent
+ uid: 'excel!Excel.CellPropertiesFormat#autoIndent:member'
+ package: excel!
+ fullName: autoIndent
+ summary: |-
+ Represents the `autoIndent` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'autoIndent?: boolean;'
+ return:
+ type: boolean
+ - name: borders
+ uid: 'excel!Excel.CellPropertiesFormat#borders:member'
+ package: excel!
+ fullName: borders
+ summary: |-
+ Represents the `borders` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'borders?: Excel.CellBorderCollection;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.CellPropertiesFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: |-
+ Represents the `fill` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fill?: Excel.CellPropertiesFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.CellPropertiesFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: |-
+ Represents the `font` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'font?: Excel.CellPropertiesFont;'
+ return:
+ type: ''
+ - name: horizontalAlignment
+ uid: 'excel!Excel.CellPropertiesFormat#horizontalAlignment:member'
+ package: excel!
+ fullName: horizontalAlignment
+ summary: |-
+ Represents the `horizontalAlignment` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ horizontalAlignment?: Excel.HorizontalAlignment | "General" | "Left" | "Center" | "Right" | "Fill" | "Justify" |
+ "CenterAcrossSelection" | "Distributed";
+ return:
+ type: >-
+ | "General" | "Left" | "Center" | "Right" | "Fill" |
+ "Justify" | "CenterAcrossSelection" | "Distributed"
+ - name: indentLevel
+ uid: 'excel!Excel.CellPropertiesFormat#indentLevel:member'
+ package: excel!
+ fullName: indentLevel
+ summary: |-
+ Represents the `indentLevel` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'indentLevel?: number;'
+ return:
+ type: number
+ - name: protection
+ uid: 'excel!Excel.CellPropertiesFormat#protection:member'
+ package: excel!
+ fullName: protection
+ summary: |-
+ Represents the `protection` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'protection?: Excel.CellPropertiesProtection;'
+ return:
+ type: ''
+ - name: readingOrder
+ uid: 'excel!Excel.CellPropertiesFormat#readingOrder:member'
+ package: excel!
+ fullName: readingOrder
+ summary: |-
+ Represents the `readingOrder` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readingOrder?: Excel.ReadingOrder | "Context" | "LeftToRight" | "RightToLeft";'
+ return:
+ type: ' | "Context" | "LeftToRight" | "RightToLeft"'
+ - name: shrinkToFit
+ uid: 'excel!Excel.CellPropertiesFormat#shrinkToFit:member'
+ package: excel!
+ fullName: shrinkToFit
+ summary: |-
+ Represents the `shrinkToFit` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'shrinkToFit?: boolean;'
+ return:
+ type: boolean
+ - name: textOrientation
+ uid: 'excel!Excel.CellPropertiesFormat#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: |-
+ Represents the `textOrientation` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation?: number;'
+ return:
+ type: number
+ - name: useStandardHeight
+ uid: 'excel!Excel.CellPropertiesFormat#useStandardHeight:member'
+ package: excel!
+ fullName: useStandardHeight
+ summary: |-
+ Represents the `useStandardHeight` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'useStandardHeight?: boolean;'
+ return:
+ type: boolean
+ - name: useStandardWidth
+ uid: 'excel!Excel.CellPropertiesFormat#useStandardWidth:member'
+ package: excel!
+ fullName: useStandardWidth
+ summary: |-
+ Represents the `useStandardWidth` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'useStandardWidth?: boolean;'
+ return:
+ type: boolean
+ - name: verticalAlignment
+ uid: 'excel!Excel.CellPropertiesFormat#verticalAlignment:member'
+ package: excel!
+ fullName: verticalAlignment
+ summary: |-
+ Represents the `verticalAlignment` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'verticalAlignment?: Excel.VerticalAlignment | "Top" | "Center" | "Bottom" | "Justify" | "Distributed";'
+ return:
+ type: ' | "Top" | "Center" | "Bottom" | "Justify" | "Distributed"'
+ - name: wrapText
+ uid: 'excel!Excel.CellPropertiesFormat#wrapText:member'
+ package: excel!
+ fullName: wrapText
+ summary: |-
+ Represents the `wrapText` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'wrapText?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesformatloadoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesformatloadoptions.yml
new file mode 100644
index 0000000000..6f920a941d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesformatloadoptions.yml
@@ -0,0 +1,224 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesFormatLoadOptions
+uid: 'excel!Excel.CellPropertiesFormatLoadOptions:interface'
+package: excel!
+fullName: Excel.CellPropertiesFormatLoadOptions
+summary: |-
+ Represents which properties to load on the format object.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: autoIndent
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#autoIndent:member'
+ package: excel!
+ fullName: autoIndent
+ summary: |-
+ Specifies whether to load on the `autoIndent` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'autoIndent?: boolean;'
+ return:
+ type: boolean
+ - name: borders
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#borders:member'
+ package: excel!
+ fullName: borders
+ summary: |-
+ Specifies whether to load on the `borders` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'borders?: Excel.CellPropertiesBorderLoadOptions;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#fill:member'
+ package: excel!
+ fullName: fill
+ summary: |-
+ Specifies whether to load on the `fill` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fill?: Excel.CellPropertiesFillLoadOptions;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#font:member'
+ package: excel!
+ fullName: font
+ summary: |-
+ Specifies whether to load on the `font` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'font?: Excel.CellPropertiesFontLoadOptions;'
+ return:
+ type: ''
+ - name: horizontalAlignment
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#horizontalAlignment:member'
+ package: excel!
+ fullName: horizontalAlignment
+ summary: |-
+ Specifies whether to load on the `horizontalAlignment` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'horizontalAlignment?: boolean;'
+ return:
+ type: boolean
+ - name: indentLevel
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#indentLevel:member'
+ package: excel!
+ fullName: indentLevel
+ summary: |-
+ Specifies whether to load on the `indentLevel` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'indentLevel?: boolean;'
+ return:
+ type: boolean
+ - name: protection
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#protection:member'
+ package: excel!
+ fullName: protection
+ summary: |-
+ Specifies whether to load on the `protection` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'protection?: boolean;'
+ return:
+ type: boolean
+ - name: readingOrder
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#readingOrder:member'
+ package: excel!
+ fullName: readingOrder
+ summary: |-
+ Specifies whether to load on the `readingOrder` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readingOrder?: boolean;'
+ return:
+ type: boolean
+ - name: shrinkToFit
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#shrinkToFit:member'
+ package: excel!
+ fullName: shrinkToFit
+ summary: |-
+ Specifies whether to load on the `shrinkToFit` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'shrinkToFit?: boolean;'
+ return:
+ type: boolean
+ - name: textOrientation
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: |-
+ Specifies whether to load on the `textOrientation` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation?: boolean;'
+ return:
+ type: boolean
+ - name: useStandardHeight
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#useStandardHeight:member'
+ package: excel!
+ fullName: useStandardHeight
+ summary: |-
+ Specifies whether to load on the `useStandardHeight` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'useStandardHeight?: boolean;'
+ return:
+ type: boolean
+ - name: useStandardWidth
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#useStandardWidth:member'
+ package: excel!
+ fullName: useStandardWidth
+ summary: |-
+ Specifies whether to load on the `useStandardWidth` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'useStandardWidth?: boolean;'
+ return:
+ type: boolean
+ - name: verticalAlignment
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#verticalAlignment:member'
+ package: excel!
+ fullName: verticalAlignment
+ summary: |-
+ Specifies whether to load on the `verticalAlignment` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'verticalAlignment?: boolean;'
+ return:
+ type: boolean
+ - name: wrapText
+ uid: 'excel!Excel.CellPropertiesFormatLoadOptions#wrapText:member'
+ package: excel!
+ fullName: wrapText
+ summary: |-
+ Specifies whether to load on the `wrapText` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'wrapText?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesloadoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesloadoptions.yml
new file mode 100644
index 0000000000..e94827cc8f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesloadoptions.yml
@@ -0,0 +1,140 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesLoadOptions
+uid: 'excel!Excel.CellPropertiesLoadOptions:interface'
+package: excel!
+fullName: Excel.CellPropertiesLoadOptions
+summary: |-
+ Represents which cell properties to load, when used as part of a "range.getCellProperties" method.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: address
+ uid: 'excel!Excel.CellPropertiesLoadOptions#address:member'
+ package: excel!
+ fullName: address
+ summary: |-
+ Specifies whether to load on the `address` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'address?: boolean;'
+ return:
+ type: boolean
+ description: >-
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const cell = context.workbook.getActiveCell();
+
+ // Define the cell properties to get by setting the matching LoadOptions to true.
+ const propertiesToGet = cell.getCellProperties({
+ address: true,
+ format: {
+ fill: {
+ color: true
+ },
+ font: {
+ color: true
+ }
+ },
+ style: true
+ });
+
+ // Sync to get the data from the workbook.
+ await context.sync();
+ const cellProperties = propertiesToGet.value[0][0];
+ console.log(
+ `Address: ${cellProperties.address}\nStyle: ${cellProperties.style}\nFill Color: ${cellProperties.format.fill.color}\nFont Color: ${cellProperties.format.font.color}`);
+ });
+
+ ```
+ - name: addressLocal
+ uid: 'excel!Excel.CellPropertiesLoadOptions#addressLocal:member'
+ package: excel!
+ fullName: addressLocal
+ summary: |-
+ Specifies whether to load on the `addressLocal` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'addressLocal?: boolean;'
+ return:
+ type: boolean
+ - name: format
+ uid: 'excel!Excel.CellPropertiesLoadOptions#format:member'
+ package: excel!
+ fullName: format
+ summary: |-
+ Specifies whether to load on the `format` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'format?: Excel.CellPropertiesFormatLoadOptions;'
+ return:
+ type: ''
+ - name: hidden
+ uid: 'excel!Excel.CellPropertiesLoadOptions#hidden:member'
+ package: excel!
+ fullName: hidden
+ summary: |-
+ Specifies whether to load on the `hidden` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'hidden?: boolean;'
+ return:
+ type: boolean
+ - name: hyperlink
+ uid: 'excel!Excel.CellPropertiesLoadOptions#hyperlink:member'
+ package: excel!
+ fullName: hyperlink
+ summary: |-
+ Specifies whether to load on the `hyperlink` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'hyperlink?: boolean;'
+ return:
+ type: boolean
+ - name: style
+ uid: 'excel!Excel.CellPropertiesLoadOptions#style:member'
+ package: excel!
+ fullName: style
+ summary: |-
+ Specifies whether to load on the `style` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'style?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesprotection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesprotection.yml
new file mode 100644
index 0000000000..eef44e23c7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellpropertiesprotection.yml
@@ -0,0 +1,38 @@
+### YamlMime:TSType
+name: Excel.CellPropertiesProtection
+uid: 'excel!Excel.CellPropertiesProtection:interface'
+package: excel!
+fullName: Excel.CellPropertiesProtection
+summary: >-
+ Represents the `format.protection` properties of `getCellProperties`, `getRowProperties`, and
+ `getColumnProperties`, or the `format.protection` input parameter of `setCellProperties`,
+ `setRowProperties`, and `setColumnProperties`.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: formulaHidden
+ uid: 'excel!Excel.CellPropertiesProtection#formulaHidden:member'
+ package: excel!
+ fullName: formulaHidden
+ summary: Represents the `format.protection.formulaHidden` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formulaHidden?: boolean;'
+ return:
+ type: boolean
+ - name: locked
+ uid: 'excel!Excel.CellPropertiesProtection#locked:member'
+ package: excel!
+ fullName: locked
+ summary: Represents the `format.protection.locked` property.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'locked?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalue.yml
new file mode 100644
index 0000000000..0dafb9523e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalue.yml
@@ -0,0 +1,13 @@
+### YamlMime:TSTypeAlias
+name: Excel.CellValue
+uid: 'excel!Excel.CellValue:type'
+package: excel!
+fullName: Excel.CellValue
+summary: Represents the value in a cell.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+syntax: >-
+ export type CellValue = (ArrayCellValue | BooleanCellValue | DoubleCellValue | EntityCellValue | EmptyCellValue |
+ ErrorCellValue | FormattedNumberCellValue | LinkedEntityCellValue | ReferenceCellValue | StringCellValue |
+ ValueTypeNotAvailableCellValue | WebImageCellValue) & CellValueExtraProperties;
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueandpropertymetadata.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueandpropertymetadata.yml
new file mode 100644
index 0000000000..5ccb91bbf1
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueandpropertymetadata.yml
@@ -0,0 +1,12 @@
+### YamlMime:TSTypeAlias
+name: Excel.CellValueAndPropertyMetadata
+uid: 'excel!Excel.CellValueAndPropertyMetadata:type'
+package: excel!
+fullName: Excel.CellValueAndPropertyMetadata
+summary: >-
+ Represents the value and metadata of a property. The metadata applies to the property (and not the value), but it is
+ combined with the value in this type.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+syntax: export type CellValueAndPropertyMetadata = (CellValue) & EntityPropertyExtraProperties;
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueattributionattributes.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueattributionattributes.yml
new file mode 100644
index 0000000000..7034d98c96
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueattributionattributes.yml
@@ -0,0 +1,61 @@
+### YamlMime:TSType
+name: Excel.CellValueAttributionAttributes
+uid: 'excel!Excel.CellValueAttributionAttributes:interface'
+package: excel!
+fullName: Excel.CellValueAttributionAttributes
+summary: >-
+ The attribution attributes object represents the set of details that can be used to describe where information came
+ from, if the information comes from a public source.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: licenseAddress
+ uid: 'excel!Excel.CellValueAttributionAttributes#licenseAddress:member'
+ package: excel!
+ fullName: licenseAddress
+ summary: Represents a URL to a license or source that describes how this property can be used.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'licenseAddress?: string;'
+ return:
+ type: string
+ - name: licenseText
+ uid: 'excel!Excel.CellValueAttributionAttributes#licenseText:member'
+ package: excel!
+ fullName: licenseText
+ summary: Represents a name for the license that governs this property.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'licenseText?: string;'
+ return:
+ type: string
+ - name: sourceAddress
+ uid: 'excel!Excel.CellValueAttributionAttributes#sourceAddress:member'
+ package: excel!
+ fullName: sourceAddress
+ summary: Represents a URL to the source of the `CellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'sourceAddress?: string;'
+ return:
+ type: string
+ - name: sourceText
+ uid: 'excel!Excel.CellValueAttributionAttributes#sourceText:member'
+ package: excel!
+ fullName: sourceText
+ summary: Represents a name for the source of the `CellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'sourceText?: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueconditionalformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueconditionalformat.yml
new file mode 100644
index 0000000000..669f852730
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueconditionalformat.yml
@@ -0,0 +1,223 @@
+### YamlMime:TSType
+name: Excel.CellValueConditionalFormat
+uid: 'excel!Excel.CellValueConditionalFormat:class'
+package: excel!
+fullName: Excel.CellValueConditionalFormat
+summary: Represents a cell value conditional format.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CellValueConditionalFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.CellValueConditionalFormat#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Returns a format object, encapsulating the conditional formats font, fill, borders, and other properties.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B21:E23");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.cellValue);
+ conditionalFormat.cellValue.format.font.color = "red";
+ conditionalFormat.cellValue.rule = { formula1: "=0", operator: "LessThan" };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ConditionalRangeFormat;'
+ return:
+ type: ''
+ - name: rule
+ uid: 'excel!Excel.CellValueConditionalFormat#rule:member'
+ package: excel!
+ fullName: rule
+ summary: Specifies the rule object on this conditional format.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B21:E23");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.cellValue);
+ conditionalFormat.cellValue.format.font.color = "red";
+ conditionalFormat.cellValue.rule = { formula1: "=0", operator: "LessThan" };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'rule: Excel.ConditionalCellValueRule;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.CellValueConditionalFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.CellValueConditionalFormatLoadOptions): Excel.CellValueConditionalFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CellValueConditionalFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CellValueConditionalFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CellValueConditionalFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.CellValueConditionalFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.CellValueConditionalFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.CellValueConditionalFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.CellValueConditionalFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.CellValueConditionalFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CellValueConditionalFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.CellValueConditionalFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.CellValueConditionalFormatData`) that
+ contains shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CellValueConditionalFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueextraproperties.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueextraproperties.yml
new file mode 100644
index 0000000000..a4a20237aa
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueextraproperties.yml
@@ -0,0 +1,42 @@
+### YamlMime:TSType
+name: Excel.CellValueExtraProperties
+uid: 'excel!Excel.CellValueExtraProperties:interface'
+package: excel!
+fullName: Excel.CellValueExtraProperties
+summary: >-
+ These extra properties may appear on a `CellValue` and provide information about that `CellValue`, but the
+ extra properties are not part of the value in the cell.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: writable
+ uid: 'excel!Excel.CellValueExtraProperties#writable:member'
+ package: excel!
+ fullName: writable
+ summary: >-
+ Represents whether this `CellValue` will be used to overwrite a cell. When false, APIs which would use this
+ `CellValue` to overwrite a cell will instead ignore this value without throwing an error. The default value is
+ true.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'writable?: boolean;'
+ return:
+ type: boolean
+ - name: writableNote
+ uid: 'excel!Excel.CellValueExtraProperties#writableNote:member'
+ package: excel!
+ fullName: writableNote
+ summary: >-
+ Represents an explanation about why `CellValue.writable` is specified as false. Note: This string is only
+ available if `writable` is specified as false.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'writableNote?: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluepropertymetadata.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluepropertymetadata.yml
new file mode 100644
index 0000000000..0d1a0034c2
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluepropertymetadata.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.CellValuePropertyMetadata
+uid: 'excel!Excel.CellValuePropertyMetadata:interface'
+package: excel!
+fullName: Excel.CellValuePropertyMetadata
+summary: Metadata about a property in `EntityCellValue.properties`.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: attribution
+ uid: 'excel!Excel.CellValuePropertyMetadata#attribution:member'
+ package: excel!
+ fullName: attribution
+ summary: Represents attribution information to describe the source and license requirements for using this property.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'attribution?: CellValueAttributionAttributes[];'
+ return:
+ type: '[]'
+ - name: excludeFrom
+ uid: 'excel!Excel.CellValuePropertyMetadata#excludeFrom:member'
+ package: excel!
+ fullName: excludeFrom
+ summary: Represents which features this property is excluded from.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'excludeFrom?: CellValuePropertyMetadataExclusions;'
+ return:
+ type: ''
+ - name: sublabel
+ uid: 'excel!Excel.CellValuePropertyMetadata#sublabel:member'
+ package: excel!
+ fullName: sublabel
+ summary: Represents the sublabel for this property shown in card view.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'sublabel?: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluepropertymetadataexclusions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluepropertymetadataexclusions.yml
new file mode 100644
index 0000000000..e2c98e9343
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluepropertymetadataexclusions.yml
@@ -0,0 +1,67 @@
+### YamlMime:TSType
+name: Excel.CellValuePropertyMetadataExclusions
+uid: 'excel!Excel.CellValuePropertyMetadataExclusions:interface'
+package: excel!
+fullName: Excel.CellValuePropertyMetadataExclusions
+summary: Represents the exclusion of a property in `EntityCellValue.properties` from features of Excel.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: autoComplete
+ uid: 'excel!Excel.CellValuePropertyMetadataExclusions#autoComplete:member'
+ package: excel!
+ fullName: autoComplete
+ summary: >-
+ True represents that the property is excluded from the properties shown by auto complete. False and undefined
+ represent the default behavior of including the property.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'autoComplete?: boolean;'
+ return:
+ type: boolean
+ - name: calcCompare
+ uid: 'excel!Excel.CellValuePropertyMetadataExclusions#calcCompare:member'
+ package: excel!
+ fullName: calcCompare
+ summary: >-
+ True represents that the property is excluded from the properties used to compare cell values during recalc. False
+ and undefined represent the default behavior of including the property.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'calcCompare?: boolean;'
+ return:
+ type: boolean
+ - name: cardView
+ uid: 'excel!Excel.CellValuePropertyMetadataExclusions#cardView:member'
+ package: excel!
+ fullName: cardView
+ summary: >-
+ True represents that the property is excluded from the properties shown by card view. False and undefined
+ represent the default behavior of including the property.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'cardView?: boolean;'
+ return:
+ type: boolean
+ - name: dotNotation
+ uid: 'excel!Excel.CellValuePropertyMetadataExclusions#dotNotation:member'
+ package: excel!
+ fullName: dotNotation
+ summary: >-
+ True represents that the property is excluded from the properties which can be accessed via the FIELDVALUE
+ function. False and undefined represent the default behavior of including the property.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'dotNotation?: boolean;'
+ return:
+ type: boolean
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueproviderattributes.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueproviderattributes.yml
new file mode 100644
index 0000000000..e259ac27ca
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueproviderattributes.yml
@@ -0,0 +1,51 @@
+### YamlMime:TSType
+name: Excel.CellValueProviderAttributes
+uid: 'excel!Excel.CellValueProviderAttributes:interface'
+package: excel!
+fullName: Excel.CellValueProviderAttributes
+summary: >-
+ The provider attributes object represents the set of details used in card view to provide specified branding
+ information for a `CellValue` type that supports provider attributes.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: description
+ uid: 'excel!Excel.CellValueProviderAttributes#description:member'
+ package: excel!
+ fullName: description
+ summary: >-
+ Represents the provider description property that is used in card view if no logo is specified. If a logo is
+ specified, this will be used as tooltip text.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'description?: string;'
+ return:
+ type: string
+ - name: logoSourceAddress
+ uid: 'excel!Excel.CellValueProviderAttributes#logoSourceAddress:member'
+ package: excel!
+ fullName: logoSourceAddress
+ summary: Represents a URL used to download an image that will be used as a logo in card view.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'logoSourceAddress?: string;'
+ return:
+ type: string
+ - name: logoTargetAddress
+ uid: 'excel!Excel.CellValueProviderAttributes#logoTargetAddress:member'
+ package: excel!
+ fullName: logoTargetAddress
+ summary: Represents a URL that is the navigation target if the user clicks on the logo element in card view.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'logoTargetAddress?: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluetype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluetype.yml
new file mode 100644
index 0000000000..b46b087d1d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvaluetype.yml
@@ -0,0 +1,144 @@
+### YamlMime:TSEnum
+name: Excel.CellValueType
+uid: 'excel!Excel.CellValueType:enum'
+package: excel!
+fullName: Excel.CellValueType
+summary: Represents the types of the `CellValue` object.
+remarks: >-
+ \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: array
+ uid: 'excel!Excel.CellValueType.array:member'
+ package: excel!
+ summary: |-
+ Represents an `ArrayCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Array"'
+ - name: boolean
+ uid: 'excel!Excel.CellValueType.boolean:member'
+ package: excel!
+ summary: |-
+ Represents a `BooleanCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Boolean"'
+ - name: double
+ uid: 'excel!Excel.CellValueType.double:member'
+ package: excel!
+ summary: |-
+ Represents a `DoubleCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Double"'
+ - name: empty
+ uid: 'excel!Excel.CellValueType.empty:member'
+ package: excel!
+ summary: |-
+ Represents an `EmptyCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Empty"'
+ - name: entity
+ uid: 'excel!Excel.CellValueType.entity:member'
+ package: excel!
+ summary: |-
+ Represents an `EntityCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Entity"'
+ - name: error
+ uid: 'excel!Excel.CellValueType.error:member'
+ package: excel!
+ summary: |-
+ Represents an `ErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Error"'
+ - name: formattedNumber
+ uid: 'excel!Excel.CellValueType.formattedNumber:member'
+ package: excel!
+ summary: |-
+ Represents a `FormattedNumberCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FormattedNumber"'
+ - name: linkedEntity
+ uid: 'excel!Excel.CellValueType.linkedEntity:member'
+ package: excel!
+ summary: |-
+ Represents a `LinkedEntityCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LinkedEntity"'
+ - name: localImage
+ uid: 'excel!Excel.CellValueType.localImage:member'
+ package: excel!
+ summary: |-
+ Represents a `LocalImageCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LocalImage"'
+ - name: notAvailable
+ uid: 'excel!Excel.CellValueType.notAvailable:member'
+ package: excel!
+ summary: |-
+ Represents a `ValueTypeNotAvailableCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NotAvailable"'
+ - name: reference
+ uid: 'excel!Excel.CellValueType.reference:member'
+ package: excel!
+ summary: |-
+ Represents a `ReferenceCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Reference"'
+ - name: string
+ uid: 'excel!Excel.CellValueType.string:member'
+ package: excel!
+ summary: |-
+ Represents a `StringCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"String"'
+ - name: webImage
+ uid: 'excel!Excel.CellValueType.webImage:member'
+ package: excel!
+ summary: |-
+ Represents a `WebImageCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WebImage"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.changedeventdetail.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.changedeventdetail.yml
new file mode 100644
index 0000000000..59c10c9c35
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.changedeventdetail.yml
@@ -0,0 +1,99 @@
+### YamlMime:TSType
+name: Excel.ChangedEventDetail
+uid: 'excel!Excel.ChangedEventDetail:interface'
+package: excel!
+fullName: Excel.ChangedEventDetail
+summary: Provides information about the details of a `WorksheetChangedEvent` or `TableChangedEvent`.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: valueAfter
+ uid: 'excel!Excel.ChangedEventDetail#valueAfter:member'
+ package: excel!
+ fullName: valueAfter
+ summary: >-
+ Represents the value after the change. The data returned could be a string, number, or boolean. Cells that contain
+ an error will return the error string.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'valueAfter: any;'
+ return:
+ type: any
+ - name: valueAsJsonAfter
+ uid: 'excel!Excel.ChangedEventDetail#valueAsJsonAfter:member'
+ package: excel!
+ fullName: valueAsJsonAfter
+ summary: >-
+ Represents the type of value after the change. Unlike `valueAfter`, `valueAsJsonAfter` can represent all
+ cell values, such as formatted number, web image, and entity data types.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'valueAsJsonAfter: CellValue;'
+ return:
+ type: ''
+ - name: valueAsJsonBefore
+ uid: 'excel!Excel.ChangedEventDetail#valueAsJsonBefore:member'
+ package: excel!
+ fullName: valueAsJsonBefore
+ summary: >-
+ Represents the type of value before the change. Unlike `valueBefore`, `valueAsJsonBefore` can represent
+ all cell values, such as formatted number, web image, and entity data types.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'valueAsJsonBefore: CellValue;'
+ return:
+ type: ''
+ - name: valueBefore
+ uid: 'excel!Excel.ChangedEventDetail#valueBefore:member'
+ package: excel!
+ fullName: valueBefore
+ summary: >-
+ Represents the value before the change. The data returned could be a string, number, or boolean. Cells that
+ contain an error will return the error string.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'valueBefore: any;'
+ return:
+ type: any
+ - name: valueTypeAfter
+ uid: 'excel!Excel.ChangedEventDetail#valueTypeAfter:member'
+ package: excel!
+ fullName: valueTypeAfter
+ summary: Represents the type of value after the change.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ valueTypeAfter: Excel.RangeValueType | "Unknown" | "Empty" | "String" | "Integer" | "Double" | "Boolean" |
+ "Error" | "RichValue";
+ return:
+ type: >-
+ | "Unknown" | "Empty" | "String" | "Integer" | "Double" |
+ "Boolean" | "Error" | "RichValue"
+ - name: valueTypeBefore
+ uid: 'excel!Excel.ChangedEventDetail#valueTypeBefore:member'
+ package: excel!
+ fullName: valueTypeBefore
+ summary: Represents the type of value before the change.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ valueTypeBefore: Excel.RangeValueType | "Unknown" | "Empty" | "String" | "Integer" | "Double" | "Boolean" |
+ "Error" | "RichValue";
+ return:
+ type: >-
+ | "Unknown" | "Empty" | "String" | "Integer" | "Double" |
+ "Boolean" | "Error" | "RichValue"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.changedirectionstate.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.changedirectionstate.yml
new file mode 100644
index 0000000000..a1710f77ca
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.changedirectionstate.yml
@@ -0,0 +1,43 @@
+### YamlMime:TSType
+name: Excel.ChangeDirectionState
+uid: 'excel!Excel.ChangeDirectionState:interface'
+package: excel!
+fullName: Excel.ChangeDirectionState
+summary: >-
+ Represents the direction that existing or remaining cells in a worksheet will shift when cells are inserted into or
+ deleted from a worksheet.
+remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: deleteShiftDirection
+ uid: 'excel!Excel.ChangeDirectionState#deleteShiftDirection:member'
+ package: excel!
+ fullName: deleteShiftDirection
+ summary: >-
+ Represents the direction (such as up or to the left) that the remaining cells will shift when a cell or cells are
+ deleted. Note:`insertShiftDirection` and `deleteShiftDirection` are exclusive and both enums can't have a value at
+ the same time. If one has a value, then the other will return `undefined`.
+ remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'deleteShiftDirection: Excel.DeleteShiftDirection | "Up" | "Left";'
+ return:
+ type: ' | "Up" | "Left"'
+ - name: insertShiftDirection
+ uid: 'excel!Excel.ChangeDirectionState#insertShiftDirection:member'
+ package: excel!
+ fullName: insertShiftDirection
+ summary: >-
+ Represents the direction (such as down or to the right) that the existing cells will shift when a new cell or
+ cells are inserted. Note:`insertShiftDirection` and `deleteShiftDirection` are exclusive and both enums can't have
+ a value at the same time. If one has a value, then the other will return `undefined`.
+ remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'insertShiftDirection: Excel.InsertShiftDirection | "Down" | "Right";'
+ return:
+ type: ' | "Down" | "Right"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chart.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chart.yml
new file mode 100644
index 0000000000..4344578c53
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chart.yml
@@ -0,0 +1,889 @@
+### YamlMime:TSType
+name: Excel.Chart
+uid: 'excel!Excel.Chart:class'
+package: excel!
+fullName: Excel.Chart
+summary: >-
+ Represents a chart object in a workbook. To learn more about the chart object model, see [Work with charts using the
+ Excel JavaScript API](https://docs.microsoft.com/office/dev/add-ins/excel/excel-add-ins-charts).
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: axes
+ uid: 'excel!Excel.Chart#axes:member'
+ package: excel!
+ fullName: axes
+ summary: Represents chart axes.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly axes: Excel.ChartAxes;'
+ return:
+ type: ''
+ - name: categoryLabelLevel
+ uid: 'excel!Excel.Chart#categoryLabelLevel:member'
+ package: excel!
+ fullName: categoryLabelLevel
+ summary: 'Specifies a chart category label level enumeration constant, referring to the level of the source category labels.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'categoryLabelLevel: number;'
+ return:
+ type: number
+ - name: chartType
+ uid: 'excel!Excel.Chart#chartType:member'
+ package: excel!
+ fullName: chartType
+ summary: Specifies the type of the chart. See `Excel.ChartType` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ chartType: Excel.ChartType | "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" |
+ "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100"
+ | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" |
+ "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" |
+ "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" |
+ "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" |
+ "Surface" | "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" |
+ "StockHLC" | "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" |
+ "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" |
+ "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" |
+ "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" |
+ "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" |
+ "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" |
+ "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel";
+ return:
+ type: >-
+ | "Invalid" | "ColumnClustered" | "ColumnStacked" |
+ "ColumnStacked100" | "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" |
+ "BarStacked" | "BarStacked100" | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" |
+ "LineStacked100" | "LineMarkers" | "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded"
+ | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" |
+ "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" |
+ "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" |
+ "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" |
+ "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" |
+ "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered" |
+ "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" |
+ "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" |
+ "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie"
+ | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap"
+ | "Treemap" | "Waterfall" | "Sunburst" | "Funnel"
+ - name: context
+ uid: 'excel!Excel.Chart#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: dataLabels
+ uid: 'excel!Excel.Chart#dataLabels:member'
+ package: excel!
+ fullName: dataLabels
+ summary: Represents the data labels on the chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly dataLabels: Excel.ChartDataLabels;'
+ return:
+ type: ''
+ - name: displayBlanksAs
+ uid: 'excel!Excel.Chart#displayBlanksAs:member'
+ package: excel!
+ fullName: displayBlanksAs
+ summary: Specifies the way that blank cells are plotted on a chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'displayBlanksAs: Excel.ChartDisplayBlanksAs | "NotPlotted" | "Zero" | "Interplotted";'
+ return:
+ type: ' | "NotPlotted" | "Zero" | "Interplotted"'
+ - name: format
+ uid: 'excel!Excel.Chart#format:member'
+ package: excel!
+ fullName: format
+ summary: Encapsulates the format properties for the chart area.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartAreaFormat;'
+ return:
+ type: ''
+ - name: height
+ uid: 'excel!Excel.Chart#height:member'
+ package: excel!
+ fullName: height
+ summary: 'Specifies the height, in points, of the chart object.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'height: number;'
+ return:
+ type: number
+ - name: id
+ uid: 'excel!Excel.Chart#id:member'
+ package: excel!
+ fullName: id
+ summary: The unique ID of chart.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: left
+ uid: 'excel!Excel.Chart#left:member'
+ package: excel!
+ fullName: left
+ summary: 'The distance, in points, from the left side of the chart to the worksheet origin.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'left: number;'
+ return:
+ type: number
+ - name: legend
+ uid: 'excel!Excel.Chart#legend:member'
+ package: excel!
+ fullName: legend
+ summary: Represents the legend for the chart.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Set to show legend of Chart1 and make it on top of the chart.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.legend.visible = true;
+ chart.legend.position = "Top";
+ chart.legend.overlay = false;
+ await context.sync()
+
+ console.log("Legend Shown ");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly legend: Excel.ChartLegend;'
+ return:
+ type: ''
+ - name: name
+ uid: 'excel!Excel.Chart#name:member'
+ package: excel!
+ fullName: name
+ summary: Specifies the name of a chart object.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Rename the chart to new name, resize the chart to 200 points in both height and weight.
+ // Move Chart1 to 100 points to the top and left.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.name = "New Name";
+ chart.top = 100;
+ chart.left = 100;
+ chart.height = 200;
+ chart.width = 200;
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name: string;'
+ return:
+ type: string
+ - name: pivotOptions
+ uid: 'excel!Excel.Chart#pivotOptions:member'
+ package: excel!
+ fullName: pivotOptions
+ summary: Encapsulates the options for a pivot chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly pivotOptions: Excel.ChartPivotOptions;'
+ return:
+ type: ''
+ - name: plotArea
+ uid: 'excel!Excel.Chart#plotArea:member'
+ package: excel!
+ fullName: plotArea
+ summary: Represents the plot area for the chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly plotArea: Excel.ChartPlotArea;'
+ return:
+ type: ''
+ - name: plotBy
+ uid: 'excel!Excel.Chart#plotBy:member'
+ package: excel!
+ fullName: plotBy
+ summary: Specifies the way columns or rows are used as data series on the chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'plotBy: Excel.ChartPlotBy | "Rows" | "Columns";'
+ return:
+ type: ' | "Rows" | "Columns"'
+ - name: plotVisibleOnly
+ uid: 'excel!Excel.Chart#plotVisibleOnly:member'
+ package: excel!
+ fullName: plotVisibleOnly
+ summary: True if only visible cells are plotted. False if both visible and hidden cells are plotted.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'plotVisibleOnly: boolean;'
+ return:
+ type: boolean
+ - name: series
+ uid: 'excel!Excel.Chart#series:member'
+ package: excel!
+ fullName: series
+ summary: Represents either a single series or collection of series in the chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly series: Excel.ChartSeriesCollection;'
+ return:
+ type: ''
+ - name: seriesNameLevel
+ uid: 'excel!Excel.Chart#seriesNameLevel:member'
+ package: excel!
+ fullName: seriesNameLevel
+ summary: 'Specifies a chart series name level enumeration constant, referring to the level of the source series names.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'seriesNameLevel: number;'
+ return:
+ type: number
+ - name: showAllFieldButtons
+ uid: 'excel!Excel.Chart#showAllFieldButtons:member'
+ package: excel!
+ fullName: showAllFieldButtons
+ summary: Specifies whether to display all field buttons on a PivotChart.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showAllFieldButtons: boolean;'
+ return:
+ type: boolean
+ - name: showDataLabelsOverMaximum
+ uid: 'excel!Excel.Chart#showDataLabelsOverMaximum:member'
+ package: excel!
+ fullName: showDataLabelsOverMaximum
+ summary: >-
+ Specifies whether to show the data labels when the value is greater than the maximum value on the value axis. If
+ the value axis becomes smaller than the size of the data points, you can use this property to set whether to show
+ the data labels. This property applies to 2-D charts only.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showDataLabelsOverMaximum: boolean;'
+ return:
+ type: boolean
+ - name: style
+ uid: 'excel!Excel.Chart#style:member'
+ package: excel!
+ fullName: style
+ summary: Specifies the chart style for the chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'style: number;'
+ return:
+ type: number
+ - name: title
+ uid: 'excel!Excel.Chart#title:member'
+ package: excel!
+ fullName: title
+ summary: >-
+ Represents the title of the specified chart, including the text, visibility, position, and formatting of the
+ title.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly title: Excel.ChartTitle;'
+ return:
+ type: ''
+ - name: top
+ uid: 'excel!Excel.Chart#top:member'
+ package: excel!
+ fullName: top
+ summary: >-
+ Specifies the distance, in points, from the top edge of the object to the top of row 1 (on a worksheet) or the top
+ of the chart area (on a chart).
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'top: number;'
+ return:
+ type: number
+ - name: width
+ uid: 'excel!Excel.Chart#width:member'
+ package: excel!
+ fullName: width
+ summary: 'Specifies the width, in points, of the chart object.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'width: number;'
+ return:
+ type: number
+ - name: worksheet
+ uid: 'excel!Excel.Chart#worksheet:member'
+ package: excel!
+ fullName: worksheet
+ summary: The worksheet containing the current chart.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly worksheet: Excel.Worksheet;'
+ return:
+ type: ''
+methods:
+ - name: activate()
+ uid: 'excel!Excel.Chart#activate:member(1)'
+ package: excel!
+ fullName: activate()
+ summary: Activates the chart in the Excel UI.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'activate(): void;'
+ return:
+ type: void
+ description: ''
+ - name: delete()
+ uid: 'excel!Excel.Chart#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes the chart object.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.delete();
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getDataTable()
+ uid: 'excel!Excel.Chart#getDataTable:member(1)'
+ package: excel!
+ fullName: getDataTable()
+ summary: 'Gets the data table on the chart. If the chart doesn''t allow a data table, it will throw an exception.'
+ remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getDataTable(): Excel.ChartDataTable;'
+ return:
+ type: ''
+ description: ''
+ - name: getDataTableOrNullObject()
+ uid: 'excel!Excel.Chart#getDataTableOrNullObject:member(1)'
+ package: excel!
+ fullName: getDataTableOrNullObject()
+ summary: >-
+ Gets the data table on the chart. If the chart doesn't allow a data table, then this method returns an object with
+ its `isNullObject` property set to `true`. For further information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adds a data table to a chart that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the data table object for the chart and set it to visible.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load("visible");
+ chartDataTable.visible = true;
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getDataTableOrNullObject(): Excel.ChartDataTable;'
+ return:
+ type: ''
+ description: ''
+ - name: 'getImage(width, height, fittingMode)'
+ uid: 'excel!Excel.Chart#getImage:member(1)'
+ package: excel!
+ fullName: 'getImage(width, height, fittingMode)'
+ summary: >-
+ Renders the chart as a base64-encoded image by scaling the chart to fit the specified dimensions. The aspect ratio
+ is preserved as part of the resizing.
+ remarks: |-
+ \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ const image = chart.getImage();
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ getImage(width?: number, height?: number, fittingMode?: Excel.ImageFittingMode):
+ OfficeExtension.ClientResult;
+ parameters:
+ - id: width
+ description: Optional. The desired width of the resulting image.
+ type: number
+ - id: height
+ description: Optional. The desired height of the resulting image.
+ type: number
+ - id: fittingMode
+ description: Optional. The method used to scale the chart to the specified dimensions (if both height and width are set).
+ type: ''
+ return:
+ type: '<string>'
+ description: ''
+ - name: 'getImage(width, height, fittingModeString)'
+ uid: 'excel!Excel.Chart#getImage:member(2)'
+ package: excel!
+ fullName: 'getImage(width, height, fittingModeString)'
+ summary: >-
+ Renders the chart as a base64-encoded image by scaling the chart to fit the specified dimensions. The aspect ratio
+ is preserved as part of the resizing.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ getImage(width?: number, height?: number, fittingModeString?: "Fit" | "FitAndCenter" | "Fill"):
+ OfficeExtension.ClientResult;
+ parameters:
+ - id: width
+ description: Optional. The desired width of the resulting image.
+ type: number
+ - id: height
+ description: Optional. The desired height of the resulting image.
+ type: number
+ - id: fittingModeString
+ description: Optional. The method used to scale the chart to the specified dimensions (if both height and width are set).
+ type: '"Fit" | "FitAndCenter" | "Fill"'
+ return:
+ type: '<string>'
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.Chart#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartLoadOptions): Excel.Chart;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.Chart#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.Chart;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Get a chart named "Chart1".
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.load('name');
+ await context.sync();
+
+ console.log(chart.name);
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.Chart#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.Chart;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.Chart#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.Chart#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.Chart): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: 'setData(sourceData, seriesBy)'
+ uid: 'excel!Excel.Chart#setData:member(1)'
+ package: excel!
+ fullName: 'setData(sourceData, seriesBy)'
+ summary: Resets the source data for the chart.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Set the sourceData to be the range at "A1:B4" and seriesBy to be "Columns".
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sheet1");
+ const chart = sheet.charts.getItem("Chart1");
+ const sourceData = sheet.getRange("A1:B4");
+ chart.setData(sourceData, "Columns");
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setData(sourceData: Range, seriesBy?: Excel.ChartSeriesBy): void;'
+ parameters:
+ - id: sourceData
+ description: The range object corresponding to the source data.
+ type: ''
+ - id: seriesBy
+ description: >-
+ Specifies the way columns or rows are used as data series on the chart. Can be one of the following: Auto
+ (default), Rows, and Columns. See `Excel.ChartSeriesBy` for details.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: 'setData(sourceData, seriesByString)'
+ uid: 'excel!Excel.Chart#setData:member(2)'
+ package: excel!
+ fullName: 'setData(sourceData, seriesByString)'
+ summary: Resets the source data for the chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setData(sourceData: Range, seriesByString?: "Auto" | "Columns" | "Rows"): void;'
+ parameters:
+ - id: sourceData
+ description: The range object corresponding to the source data.
+ type: ''
+ - id: seriesByString
+ description: >-
+ Specifies the way columns or rows are used as data series on the chart. Can be one of the following: Auto
+ (default), Rows, and Columns. See `Excel.ChartSeriesBy` for details.
+ type: '"Auto" | "Columns" | "Rows"'
+ return:
+ type: void
+ description: ''
+ - name: 'setPosition(startCell, endCell)'
+ uid: 'excel!Excel.Chart#setPosition:member(1)'
+ package: excel!
+ fullName: 'setPosition(startCell, endCell)'
+ summary: Positions the chart relative to cells on the worksheet.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const sheetName = "Charts";
+ const rangeSelection = "A1:B4";
+ const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeSelection);
+ const sourceData = sheetName + "!" + "A1:B4";
+ const chart = context.workbook.worksheets.getItem(sheetName).charts.add("pie", range, "auto");
+ chart.width = 500;
+ chart.height = 300;
+ chart.setPosition("C2", null);
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setPosition(startCell: Range | string, endCell?: Range | string): void;'
+ parameters:
+ - id: startCell
+ description: >-
+ The start cell. This is where the chart will be moved to. The start cell is the top-left or top-right cell,
+ depending on the user's right-to-left display settings.
+ type: ' | string'
+ - id: endCell
+ description: >-
+ Optional. The end cell. If specified, the chart's width and height will be set to fully cover up this
+ cell/range.
+ type: ' | string'
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.Chart#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.Chart object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartData`) that contains shallow copies of any loaded child
+ properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartData;'
+ return:
+ type: ''
+ description: ''
+events:
+ - name: onActivated
+ uid: 'excel!Excel.Chart#onActivated:member'
+ package: excel!
+ fullName: onActivated
+ summary: Occurs when the chart is activated.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-chart-activated.yaml
+
+ await Excel.run(async (context) => {
+
+ const pieChart = context.workbook.worksheets.getActiveWorksheet().charts.getItem("Pie");
+
+ // Register the onActivated and onDeactivated event handlers.
+ pieChart.onActivated.add(chartActivated);
+ pieChart.onDeactivated.add(chartDeactivated);
+
+ await context.sync();
+
+ console.log("Added handlers for Chart onActivated and onDeactivated events.");
+ });
+
+
+ ...
+
+ async function chartActivated(event) {
+ await Excel.run(async (context) => {
+ // Retrieve the worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Retrieve the activated chart by ID and load the name of the chart.
+ const activatedChart = sheet.charts.getItem(event.chartId);
+ activatedChart.load(["name"]);
+ await context.sync();
+
+ // Print out the activated chart's data.
+ console.log(`A chart was activated. ID: ${event.chartId}. Chart name: ${activatedChart.name}.`);
+ });
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onActivated: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+ - name: onDeactivated
+ uid: 'excel!Excel.Chart#onDeactivated:member'
+ package: excel!
+ fullName: onDeactivated
+ summary: Occurs when the chart is deactivated.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-chart-activated.yaml
+
+ await Excel.run(async (context) => {
+
+ const pieChart = context.workbook.worksheets.getActiveWorksheet().charts.getItem("Pie");
+
+ // Register the onActivated and onDeactivated event handlers.
+ pieChart.onActivated.add(chartActivated);
+ pieChart.onDeactivated.add(chartDeactivated);
+
+ await context.sync();
+
+ console.log("Added handlers for Chart onActivated and onDeactivated events.");
+ });
+
+
+ ...
+
+ async function chartDeactivated(event) {
+ await Excel.run(async (context) => {
+ // Callback function for when the chart is deactivated.
+ console.log("The pie chart is NOT active.");
+ });
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onDeactivated: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartactivatedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartactivatedeventargs.yml
new file mode 100644
index 0000000000..388957ca26
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartactivatedeventargs.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.ChartActivatedEventArgs
+uid: 'excel!Excel.ChartActivatedEventArgs:interface'
+package: excel!
+fullName: Excel.ChartActivatedEventArgs
+summary: Provides information about the chart that raised the activated event.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: chartId
+ uid: 'excel!Excel.ChartActivatedEventArgs#chartId:member'
+ package: excel!
+ fullName: chartId
+ summary: Gets the ID of the chart that is activated.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'chartId: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.ChartActivatedEventArgs#type:member'
+ package: excel!
+ fullName: type
+ summary: Gets the type of the event. See `Excel.EventType` for details.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: "ChartActivated";'
+ return:
+ type: '"ChartActivated"'
+ - name: worksheetId
+ uid: 'excel!Excel.ChartActivatedEventArgs#worksheetId:member'
+ package: excel!
+ fullName: worksheetId
+ summary: Gets the ID of the worksheet in which the chart is activated.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'worksheetId: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaddedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaddedeventargs.yml
new file mode 100644
index 0000000000..463e07fed1
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaddedeventargs.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.ChartAddedEventArgs
+uid: 'excel!Excel.ChartAddedEventArgs:interface'
+package: excel!
+fullName: Excel.ChartAddedEventArgs
+summary: Provides information about the chart that raised the added event.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: chartId
+ uid: 'excel!Excel.ChartAddedEventArgs#chartId:member'
+ package: excel!
+ fullName: chartId
+ summary: Gets the ID of the chart that is added to the worksheet.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'chartId: string;'
+ return:
+ type: string
+ - name: source
+ uid: 'excel!Excel.ChartAddedEventArgs#source:member'
+ package: excel!
+ fullName: source
+ summary: Gets the source of the event. See `Excel.EventSource` for details.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'source: Excel.EventSource | "Local" | "Remote";'
+ return:
+ type: ' | "Local" | "Remote"'
+ - name: type
+ uid: 'excel!Excel.ChartAddedEventArgs#type:member'
+ package: excel!
+ fullName: type
+ summary: Gets the type of the event. See `Excel.EventType` for details.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: "ChartAdded";'
+ return:
+ type: '"ChartAdded"'
+ - name: worksheetId
+ uid: 'excel!Excel.ChartAddedEventArgs#worksheetId:member'
+ package: excel!
+ fullName: worksheetId
+ summary: Gets the ID of the worksheet in which the chart is added.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'worksheetId: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartareaformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartareaformat.yml
new file mode 100644
index 0000000000..8dd3413e3d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartareaformat.yml
@@ -0,0 +1,223 @@
+### YamlMime:TSType
+name: Excel.ChartAreaFormat
+uid: 'excel!Excel.ChartAreaFormat:class'
+package: excel!
+fullName: Excel.ChartAreaFormat
+summary: Encapsulates the format properties for the overall chart area.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartAreaFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Represents the border format of chart area, which includes color, linestyle, and weight.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: colorScheme
+ uid: 'excel!Excel.ChartAreaFormat#colorScheme:member'
+ package: excel!
+ fullName: colorScheme
+ summary: Specifies the color scheme of the chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ colorScheme: Excel.ChartColorScheme | "ColorfulPalette1" | "ColorfulPalette2" | "ColorfulPalette3" |
+ "ColorfulPalette4" | "MonochromaticPalette1" | "MonochromaticPalette2" | "MonochromaticPalette3" |
+ "MonochromaticPalette4" | "MonochromaticPalette5" | "MonochromaticPalette6" | "MonochromaticPalette7" |
+ "MonochromaticPalette8" | "MonochromaticPalette9" | "MonochromaticPalette10" | "MonochromaticPalette11" |
+ "MonochromaticPalette12" | "MonochromaticPalette13";
+ return:
+ type: >-
+ | "ColorfulPalette1" | "ColorfulPalette2" |
+ "ColorfulPalette3" | "ColorfulPalette4" | "MonochromaticPalette1" | "MonochromaticPalette2" |
+ "MonochromaticPalette3" | "MonochromaticPalette4" | "MonochromaticPalette5" | "MonochromaticPalette6" |
+ "MonochromaticPalette7" | "MonochromaticPalette8" | "MonochromaticPalette9" | "MonochromaticPalette10" |
+ "MonochromaticPalette11" | "MonochromaticPalette12" | "MonochromaticPalette13"
+ - name: context
+ uid: 'excel!Excel.ChartAreaFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartAreaFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: 'Represents the fill format of an object, which includes background formatting information.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartAreaFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Represents the font attributes (font name, font size, color, etc.) for the current object.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+ - name: roundedCorners
+ uid: 'excel!Excel.ChartAreaFormat#roundedCorners:member'
+ package: excel!
+ fullName: roundedCorners
+ summary: Specifies if the chart area of the chart has rounded corners.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'roundedCorners: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartAreaFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartAreaFormatLoadOptions): Excel.ChartAreaFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartAreaFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartAreaFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartAreaFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartAreaFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartAreaFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartAreaFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartAreaFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartAreaFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartAreaFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartAreaFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartAreaFormatData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartAreaFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxes.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxes.yml
new file mode 100644
index 0000000000..3e72eb2baf
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxes.yml
@@ -0,0 +1,248 @@
+### YamlMime:TSType
+name: Excel.ChartAxes
+uid: 'excel!Excel.ChartAxes:class'
+package: excel!
+fullName: Excel.ChartAxes
+summary: Represents the chart axes.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: categoryAxis
+ uid: 'excel!Excel.ChartAxes#categoryAxis:member'
+ package: excel!
+ fullName: categoryAxis
+ summary: Represents the category axis in a chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly categoryAxis: Excel.ChartAxis;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartAxes#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: seriesAxis
+ uid: 'excel!Excel.ChartAxes#seriesAxis:member'
+ package: excel!
+ fullName: seriesAxis
+ summary: Represents the series axis of a 3-D chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly seriesAxis: Excel.ChartAxis;'
+ return:
+ type: ''
+ - name: valueAxis
+ uid: 'excel!Excel.ChartAxes#valueAxis:member'
+ package: excel!
+ fullName: valueAxis
+ summary: Represents the value axis in an axis.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Set the maximum, minimum, majorUnit, minorUnit of valueAxis.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.axes.valueAxis.maximum = 5;
+ chart.axes.valueAxis.minimum = 0;
+ chart.axes.valueAxis.majorUnit = 1;
+ chart.axes.valueAxis.minorUnit = 0.2;
+ await context.sync();
+
+ console.log("Axis Settings Changed");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly valueAxis: Excel.ChartAxis;'
+ return:
+ type: ''
+methods:
+ - name: 'getItem(type, group)'
+ uid: 'excel!Excel.ChartAxes#getItem:member(1)'
+ package: excel!
+ fullName: 'getItem(type, group)'
+ summary: Returns the specific axis identified by type and group.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(type: Excel.ChartAxisType, group?: Excel.ChartAxisGroup): Excel.ChartAxis;'
+ parameters:
+ - id: type
+ description: Specifies the axis type. See `Excel.ChartAxisType` for details.
+ type: ''
+ - id: group
+ description: Optional. Specifies the axis group. See `Excel.ChartAxisGroup` for details.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: 'getItem(typeString, group)'
+ uid: 'excel!Excel.ChartAxes#getItem:member(2)'
+ package: excel!
+ fullName: 'getItem(typeString, group)'
+ summary: Returns the specific axis identified by type and group.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ getItem(typeString: "Invalid" | "Category" | "Value" | "Series", group?: "Primary" | "Secondary"):
+ Excel.ChartAxis;
+ parameters:
+ - id: typeString
+ description: Specifies the axis type. See `Excel.ChartAxisType` for details.
+ type: '"Invalid" | "Category" | "Value" | "Series"'
+ - id: group
+ description: Optional. Specifies the axis group. See `Excel.ChartAxisGroup` for details.
+ type: '"Primary" | "Secondary"'
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartAxes#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartAxesLoadOptions): Excel.ChartAxes;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartAxes#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartAxes;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartAxes#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartAxes;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartAxes#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartAxesUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartAxes#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartAxes): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartAxes#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartAxes object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartAxesData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartAxesData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxis.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxis.yml
new file mode 100644
index 0000000000..af0c7544ec
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxis.yml
@@ -0,0 +1,771 @@
+### YamlMime:TSType
+name: Excel.ChartAxis
+uid: 'excel!Excel.ChartAxis:class'
+package: excel!
+fullName: Excel.ChartAxis
+summary: Represents a single axis in a chart.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: alignment
+ uid: 'excel!Excel.ChartAxis#alignment:member'
+ package: excel!
+ fullName: alignment
+ summary: Specifies the alignment for the specified axis tick label. See `Excel.ChartTextHorizontalAlignment` for detail.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'alignment: Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right";'
+ return:
+ type: ' | "Center" | "Left" | "Right"'
+ - name: axisGroup
+ uid: 'excel!Excel.ChartAxis#axisGroup:member'
+ package: excel!
+ fullName: axisGroup
+ summary: Specifies the group for the specified axis. See `Excel.ChartAxisGroup` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";'
+ return:
+ type: ' | "Primary" | "Secondary"'
+ - name: baseTimeUnit
+ uid: 'excel!Excel.ChartAxis#baseTimeUnit:member'
+ package: excel!
+ fullName: baseTimeUnit
+ summary: Specifies the base unit for the specified category axis.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'baseTimeUnit: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";'
+ return:
+ type: ' | "Days" | "Months" | "Years"'
+ - name: categoryType
+ uid: 'excel!Excel.ChartAxis#categoryType:member'
+ package: excel!
+ fullName: categoryType
+ summary: Specifies the category axis type.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'categoryType: Excel.ChartAxisCategoryType | "Automatic" | "TextAxis" | "DateAxis";'
+ return:
+ type: ' | "Automatic" | "TextAxis" | "DateAxis"'
+ - name: context
+ uid: 'excel!Excel.ChartAxis#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: customDisplayUnit
+ uid: 'excel!Excel.ChartAxis#customDisplayUnit:member'
+ package: excel!
+ fullName: customDisplayUnit
+ summary: >-
+ Specifies the custom axis display unit value. To set this property, please use the `SetCustomDisplayUnit(double)`
+ method.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly customDisplayUnit: number;'
+ return:
+ type: number
+ - name: displayUnit
+ uid: 'excel!Excel.ChartAxis#displayUnit:member'
+ package: excel!
+ fullName: displayUnit
+ summary: Represents the axis display unit. See `Excel.ChartAxisDisplayUnit` for details.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-axis.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ let chart = sheet.charts.getItemAt(0);
+ let categoryAxis = chart.axes.categoryAxis;
+ let valueAxis = chart.axes.valueAxis;
+
+ // Load to get display unit.
+ valueAxis.load("displayUnit");
+
+ await context.sync();
+
+ console.log("The vertical axis display unit is: " + valueAxis.displayUnit);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ displayUnit: Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" |
+ "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom";
+ return:
+ type: >-
+ | "None" | "Hundreds" | "Thousands" | "TenThousands" |
+ "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom"
+ - name: format
+ uid: 'excel!Excel.ChartAxis#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Represents the formatting of a chart object, which includes line and font formatting.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartAxisFormat;'
+ return:
+ type: ''
+ - name: height
+ uid: 'excel!Excel.ChartAxis#height:member'
+ package: excel!
+ fullName: height
+ summary: 'Specifies the height, in points, of the chart axis. Returns `null` if the axis is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly height: number;'
+ return:
+ type: number
+ - name: isBetweenCategories
+ uid: 'excel!Excel.ChartAxis#isBetweenCategories:member'
+ package: excel!
+ fullName: isBetweenCategories
+ summary: Specifies if the value axis crosses the category axis between categories.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'isBetweenCategories: boolean;'
+ return:
+ type: boolean
+ - name: left
+ uid: 'excel!Excel.ChartAxis#left:member'
+ package: excel!
+ fullName: left
+ summary: >-
+ Specifies the distance, in points, from the left edge of the axis to the left of chart area. Returns `null` if the
+ axis is not visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly left: number;'
+ return:
+ type: number
+ - name: linkNumberFormat
+ uid: 'excel!Excel.ChartAxis#linkNumberFormat:member'
+ package: excel!
+ fullName: linkNumberFormat
+ summary: >-
+ Specifies if the number format is linked to the cells. If `true`, the number format will change in the
+ labels when it changes in the cells.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'linkNumberFormat: boolean;'
+ return:
+ type: boolean
+ - name: logBase
+ uid: 'excel!Excel.ChartAxis#logBase:member'
+ package: excel!
+ fullName: logBase
+ summary: Specifies the base of the logarithm when using logarithmic scales.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'logBase: number;'
+ return:
+ type: number
+ - name: majorGridlines
+ uid: 'excel!Excel.ChartAxis#majorGridlines:member'
+ package: excel!
+ fullName: majorGridlines
+ summary: Returns an object that represents the major gridlines for the specified axis.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly majorGridlines: Excel.ChartGridlines;'
+ return:
+ type: ''
+ - name: majorTickMark
+ uid: 'excel!Excel.ChartAxis#majorTickMark:member'
+ package: excel!
+ fullName: majorTickMark
+ summary: Specifies the type of major tick mark for the specified axis. See `Excel.ChartAxisTickMark` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'majorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";'
+ return:
+ type: ' | "None" | "Cross" | "Inside" | "Outside"'
+ - name: majorTimeUnitScale
+ uid: 'excel!Excel.ChartAxis#majorTimeUnitScale:member'
+ package: excel!
+ fullName: majorTimeUnitScale
+ summary: >-
+ Specifies the major unit scale value for the category axis when the `categoryType` property is set to
+ `dateAxis`.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'majorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";'
+ return:
+ type: ' | "Days" | "Months" | "Years"'
+ - name: majorUnit
+ uid: 'excel!Excel.ChartAxis#majorUnit:member'
+ package: excel!
+ fullName: majorUnit
+ summary: >-
+ Represents the interval between two major tick marks. Can be set to a numeric value or an empty string. The
+ returned value is always a number.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'majorUnit: any;'
+ return:
+ type: any
+ - name: maximum
+ uid: 'excel!Excel.ChartAxis#maximum:member'
+ package: excel!
+ fullName: maximum
+ summary: >-
+ Represents the maximum value on the value axis. Can be set to a numeric value or an empty string (for automatic
+ axis values). The returned value is always a number.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'maximum: any;'
+ return:
+ type: any
+ - name: minimum
+ uid: 'excel!Excel.ChartAxis#minimum:member'
+ package: excel!
+ fullName: minimum
+ summary: >-
+ Represents the minimum value on the value axis. Can be set to a numeric value or an empty string (for automatic
+ axis values). The returned value is always a number.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'minimum: any;'
+ return:
+ type: any
+ - name: minorGridlines
+ uid: 'excel!Excel.ChartAxis#minorGridlines:member'
+ package: excel!
+ fullName: minorGridlines
+ summary: Returns an object that represents the minor gridlines for the specified axis.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly minorGridlines: Excel.ChartGridlines;'
+ return:
+ type: ''
+ - name: minorTickMark
+ uid: 'excel!Excel.ChartAxis#minorTickMark:member'
+ package: excel!
+ fullName: minorTickMark
+ summary: Specifies the type of minor tick mark for the specified axis. See `Excel.ChartAxisTickMark` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'minorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";'
+ return:
+ type: ' | "None" | "Cross" | "Inside" | "Outside"'
+ - name: minorTimeUnitScale
+ uid: 'excel!Excel.ChartAxis#minorTimeUnitScale:member'
+ package: excel!
+ fullName: minorTimeUnitScale
+ summary: >-
+ Specifies the minor unit scale value for the category axis when the `categoryType` property is set to
+ `dateAxis`.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'minorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";'
+ return:
+ type: ' | "Days" | "Months" | "Years"'
+ - name: minorUnit
+ uid: 'excel!Excel.ChartAxis#minorUnit:member'
+ package: excel!
+ fullName: minorUnit
+ summary: >-
+ Represents the interval between two minor tick marks. Can be set to a numeric value or an empty string (for
+ automatic axis values). The returned value is always a number.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'minorUnit: any;'
+ return:
+ type: any
+ - name: multiLevel
+ uid: 'excel!Excel.ChartAxis#multiLevel:member'
+ package: excel!
+ fullName: multiLevel
+ summary: Specifies if an axis is multilevel.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'multiLevel: boolean;'
+ return:
+ type: boolean
+ - name: numberFormat
+ uid: 'excel!Excel.ChartAxis#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: Specifies the format code for the axis tick label.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'numberFormat: string;'
+ return:
+ type: string
+ - name: offset
+ uid: 'excel!Excel.ChartAxis#offset:member'
+ package: excel!
+ fullName: offset
+ summary: >-
+ Specifies the distance between the levels of labels, and the distance between the first level and the axis line.
+ The value should be an integer from 0 to 1000.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'offset: number;'
+ return:
+ type: number
+ - name: position
+ uid: 'excel!Excel.ChartAxis#position:member'
+ package: excel!
+ fullName: position
+ summary: Specifies the specified axis position where the other axis crosses. See `Excel.ChartAxisPosition` for details.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'position: Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom";'
+ return:
+ type: ' | "Automatic" | "Maximum" | "Minimum" | "Custom"'
+ - name: positionAt
+ uid: 'excel!Excel.ChartAxis#positionAt:member'
+ package: excel!
+ fullName: positionAt
+ summary: >-
+ Specifies the axis position where the other axis crosses. You should use the `SetPositionAt(double)` method to set
+ this property.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly positionAt: number;'
+ return:
+ type: number
+ - name: reversePlotOrder
+ uid: 'excel!Excel.ChartAxis#reversePlotOrder:member'
+ package: excel!
+ fullName: reversePlotOrder
+ summary: Specifies if Excel plots data points from last to first.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'reversePlotOrder: boolean;'
+ return:
+ type: boolean
+ - name: scaleType
+ uid: 'excel!Excel.ChartAxis#scaleType:member'
+ package: excel!
+ fullName: scaleType
+ summary: Specifies the value axis scale type. See `Excel.ChartAxisScaleType` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'scaleType: Excel.ChartAxisScaleType | "Linear" | "Logarithmic";'
+ return:
+ type: ' | "Linear" | "Logarithmic"'
+ - name: showDisplayUnitLabel
+ uid: 'excel!Excel.ChartAxis#showDisplayUnitLabel:member'
+ package: excel!
+ fullName: showDisplayUnitLabel
+ summary: Specifies if the axis display unit label is visible.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-axis.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ let chart = sheet.charts.getItemAt(0);
+ let axis = chart.axes.valueAxis;
+
+ // Remove display unit.
+ axis.showDisplayUnitLabel = false;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showDisplayUnitLabel: boolean;'
+ return:
+ type: boolean
+ - name: textOrientation
+ uid: 'excel!Excel.ChartAxis#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: >-
+ Specifies the angle to which the text is oriented for the chart axis tick label. The value should either be an
+ integer from -90 to 90 or the integer 180 for vertically-oriented text.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation: any;'
+ return:
+ type: any
+ - name: tickLabelPosition
+ uid: 'excel!Excel.ChartAxis#tickLabelPosition:member'
+ package: excel!
+ fullName: tickLabelPosition
+ summary: >-
+ Specifies the position of tick-mark labels on the specified axis. See `Excel.ChartAxisTickLabelPosition` for
+ details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tickLabelPosition: Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None";'
+ return:
+ type: ' | "NextToAxis" | "High" | "Low" | "None"'
+ - name: tickLabelSpacing
+ uid: 'excel!Excel.ChartAxis#tickLabelSpacing:member'
+ package: excel!
+ fullName: tickLabelSpacing
+ summary: >-
+ Specifies the number of categories or series between tick-mark labels. Can be a value from 1 through 31999 or an
+ empty string for automatic setting. The returned value is always a number.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tickLabelSpacing: any;'
+ return:
+ type: any
+ - name: tickMarkSpacing
+ uid: 'excel!Excel.ChartAxis#tickMarkSpacing:member'
+ package: excel!
+ fullName: tickMarkSpacing
+ summary: Specifies the number of categories or series between tick marks.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'tickMarkSpacing: number;'
+ return:
+ type: number
+ - name: title
+ uid: 'excel!Excel.ChartAxis#title:member'
+ package: excel!
+ fullName: title
+ summary: Represents the axis title.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly title: Excel.ChartAxisTitle;'
+ return:
+ type: ''
+ - name: top
+ uid: 'excel!Excel.ChartAxis#top:member'
+ package: excel!
+ fullName: top
+ summary: >-
+ Specifies the distance, in points, from the top edge of the axis to the top of chart area. Returns `null` if the
+ axis is not visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly top: number;'
+ return:
+ type: number
+ - name: type
+ uid: 'excel!Excel.ChartAxis#type:member'
+ package: excel!
+ fullName: type
+ summary: Specifies the axis type. See `Excel.ChartAxisType` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly type: Excel.ChartAxisType | "Invalid" | "Category" | "Value" | "Series";'
+ return:
+ type: ' | "Invalid" | "Category" | "Value" | "Series"'
+ - name: visible
+ uid: 'excel!Excel.ChartAxis#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Specifies if the axis is visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+ - name: width
+ uid: 'excel!Excel.ChartAxis#width:member'
+ package: excel!
+ fullName: width
+ summary: 'Specifies the width, in points, of the chart axis. Returns `null` if the axis is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly width: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartAxis#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartAxisLoadOptions): Excel.ChartAxis;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartAxis#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartAxis;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Get the maximum of Chart Axis from Chart1.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ const axis = chart.axes.valueAxis;
+ axis.load('maximum');
+ await context.sync();
+
+ console.log(axis.maximum);
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartAxis#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartAxis;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartAxis#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartAxisUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartAxis#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartAxis): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setCategoryNames(sourceData)
+ uid: 'excel!Excel.ChartAxis#setCategoryNames:member(1)'
+ package: excel!
+ fullName: setCategoryNames(sourceData)
+ summary: Sets all the category names for the specified axis.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setCategoryNames(sourceData: Range): void;'
+ parameters:
+ - id: sourceData
+ description: The `Range` object corresponding to the source data.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setCustomDisplayUnit(value)
+ uid: 'excel!Excel.ChartAxis#setCustomDisplayUnit:member(1)'
+ package: excel!
+ fullName: setCustomDisplayUnit(value)
+ summary: Sets the axis display unit to a custom value.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setCustomDisplayUnit(value: number): void;'
+ parameters:
+ - id: value
+ description: Custom value of the display unit.
+ type: number
+ return:
+ type: void
+ description: ''
+ - name: setPositionAt(value)
+ uid: 'excel!Excel.ChartAxis#setPositionAt:member(1)'
+ package: excel!
+ fullName: setPositionAt(value)
+ summary: Sets the specified axis position where the other axis crosses.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setPositionAt(value: number): void;'
+ parameters:
+ - id: value
+ description: Custom value of the crossing point.
+ type: number
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartAxis#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartAxis object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartAxisData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartAxisData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxiscategorytype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxiscategorytype.yml
new file mode 100644
index 0000000000..868c0aa6ad
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxiscategorytype.yml
@@ -0,0 +1,34 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisCategoryType
+uid: 'excel!Excel.ChartAxisCategoryType:enum'
+package: excel!
+fullName: Excel.ChartAxisCategoryType
+summary: Specifies the type of the category axis.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ChartAxisCategoryType.automatic:member'
+ package: excel!
+ summary: |-
+ Excel controls the axis type.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Automatic"'
+ - name: dateAxis
+ uid: 'excel!Excel.ChartAxisCategoryType.dateAxis:member'
+ package: excel!
+ summary: |-
+ Axis groups data on a time scale.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DateAxis"'
+ - name: textAxis
+ uid: 'excel!Excel.ChartAxisCategoryType.textAxis:member'
+ package: excel!
+ summary: |-
+ Axis groups data by an arbitrary set of categories.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TextAxis"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisdisplayunit.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisdisplayunit.yml
new file mode 100644
index 0000000000..eff504d14f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisdisplayunit.yml
@@ -0,0 +1,98 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisDisplayUnit
+uid: 'excel!Excel.ChartAxisDisplayUnit:enum'
+package: excel!
+fullName: Excel.ChartAxisDisplayUnit
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: billions
+ uid: 'excel!Excel.ChartAxisDisplayUnit.billions:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of billions.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Billions"'
+ - name: custom
+ uid: 'excel!Excel.ChartAxisDisplayUnit.custom:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of custom value.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Custom"'
+ - name: hundredMillions
+ uid: 'excel!Excel.ChartAxisDisplayUnit.hundredMillions:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of hundreds of millions.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HundredMillions"'
+ - name: hundreds
+ uid: 'excel!Excel.ChartAxisDisplayUnit.hundreds:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of hundreds.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Hundreds"'
+ - name: hundredThousands
+ uid: 'excel!Excel.ChartAxisDisplayUnit.hundredThousands:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of hundreds of thousands.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HundredThousands"'
+ - name: millions
+ uid: 'excel!Excel.ChartAxisDisplayUnit.millions:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of millions.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Millions"'
+ - name: none
+ uid: 'excel!Excel.ChartAxisDisplayUnit.none:member'
+ package: excel!
+ summary: |-
+ Default option. This will reset display unit to the axis, and set unit label invisible.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"None"'
+ - name: tenMillions
+ uid: 'excel!Excel.ChartAxisDisplayUnit.tenMillions:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of tens of millions.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TenMillions"'
+ - name: tenThousands
+ uid: 'excel!Excel.ChartAxisDisplayUnit.tenThousands:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of tens of thousands.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TenThousands"'
+ - name: thousands
+ uid: 'excel!Excel.ChartAxisDisplayUnit.thousands:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of thousands.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Thousands"'
+ - name: trillions
+ uid: 'excel!Excel.ChartAxisDisplayUnit.trillions:member'
+ package: excel!
+ summary: |-
+ This will set the axis in units of trillions.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Trillions"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisformat.yml
new file mode 100644
index 0000000000..715b33d1c5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisformat.yml
@@ -0,0 +1,189 @@
+### YamlMime:TSType
+name: Excel.ChartAxisFormat
+uid: 'excel!Excel.ChartAxisFormat:class'
+package: excel!
+fullName: Excel.ChartAxisFormat
+summary: Encapsulates the format properties for the chart axis.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartAxisFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartAxisFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: Specifies chart fill formatting.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartAxisFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Specifies the font attributes (font name, font size, color, etc.) for a chart axis element.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+ - name: line
+ uid: 'excel!Excel.ChartAxisFormat#line:member'
+ package: excel!
+ fullName: line
+ summary: Specifies chart line formatting.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly line: Excel.ChartLineFormat;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartAxisFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartAxisFormatLoadOptions): Excel.ChartAxisFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartAxisFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartAxisFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartAxisFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartAxisFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartAxisFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartAxisFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartAxisFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartAxisFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartAxisFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartAxisFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartAxisFormatData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartAxisFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisgroup.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisgroup.yml
new file mode 100644
index 0000000000..00538219fa
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisgroup.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisGroup
+uid: 'excel!Excel.ChartAxisGroup:enum'
+package: excel!
+fullName: Excel.ChartAxisGroup
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: primary
+ uid: 'excel!Excel.ChartAxisGroup.primary:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Primary"'
+ - name: secondary
+ uid: 'excel!Excel.ChartAxisGroup.secondary:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Secondary"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisposition.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisposition.yml
new file mode 100644
index 0000000000..b8716df3a1
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisposition.yml
@@ -0,0 +1,30 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisPosition
+uid: 'excel!Excel.ChartAxisPosition:enum'
+package: excel!
+fullName: Excel.ChartAxisPosition
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ChartAxisPosition.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: custom
+ uid: 'excel!Excel.ChartAxisPosition.custom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Custom"'
+ - name: maximum
+ uid: 'excel!Excel.ChartAxisPosition.maximum:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Maximum"'
+ - name: minimum
+ uid: 'excel!Excel.ChartAxisPosition.minimum:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Minimum"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisscaletype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisscaletype.yml
new file mode 100644
index 0000000000..81fd075b39
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisscaletype.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisScaleType
+uid: 'excel!Excel.ChartAxisScaleType:enum'
+package: excel!
+fullName: Excel.ChartAxisScaleType
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: linear
+ uid: 'excel!Excel.ChartAxisScaleType.linear:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Linear"'
+ - name: logarithmic
+ uid: 'excel!Excel.ChartAxisScaleType.logarithmic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Logarithmic"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisticklabelposition.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisticklabelposition.yml
new file mode 100644
index 0000000000..81ccd8cc82
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxisticklabelposition.yml
@@ -0,0 +1,30 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisTickLabelPosition
+uid: 'excel!Excel.ChartAxisTickLabelPosition:enum'
+package: excel!
+fullName: Excel.ChartAxisTickLabelPosition
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: high
+ uid: 'excel!Excel.ChartAxisTickLabelPosition.high:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"High"'
+ - name: low
+ uid: 'excel!Excel.ChartAxisTickLabelPosition.low:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Low"'
+ - name: nextToAxis
+ uid: 'excel!Excel.ChartAxisTickLabelPosition.nextToAxis:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NextToAxis"'
+ - name: none
+ uid: 'excel!Excel.ChartAxisTickLabelPosition.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistickmark.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistickmark.yml
new file mode 100644
index 0000000000..f22aa314cf
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistickmark.yml
@@ -0,0 +1,30 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisTickMark
+uid: 'excel!Excel.ChartAxisTickMark:enum'
+package: excel!
+fullName: Excel.ChartAxisTickMark
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: cross
+ uid: 'excel!Excel.ChartAxisTickMark.cross:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Cross"'
+ - name: inside
+ uid: 'excel!Excel.ChartAxisTickMark.inside:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Inside"'
+ - name: none
+ uid: 'excel!Excel.ChartAxisTickMark.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: outside
+ uid: 'excel!Excel.ChartAxisTickMark.outside:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Outside"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistimeunit.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistimeunit.yml
new file mode 100644
index 0000000000..7e7a45f6bf
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistimeunit.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisTimeUnit
+uid: 'excel!Excel.ChartAxisTimeUnit:enum'
+package: excel!
+fullName: Excel.ChartAxisTimeUnit
+summary: Specifies the unit of time for chart axes and data series.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: days
+ uid: 'excel!Excel.ChartAxisTimeUnit.days:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Days"'
+ - name: months
+ uid: 'excel!Excel.ChartAxisTimeUnit.months:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Months"'
+ - name: years
+ uid: 'excel!Excel.ChartAxisTimeUnit.years:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Years"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistitle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistitle.yml
new file mode 100644
index 0000000000..3343259307
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistitle.yml
@@ -0,0 +1,255 @@
+### YamlMime:TSType
+name: Excel.ChartAxisTitle
+uid: 'excel!Excel.ChartAxisTitle:class'
+package: excel!
+fullName: Excel.ChartAxisTitle
+summary: Represents the title of a chart axis.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartAxisTitle#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartAxisTitle#format:member'
+ package: excel!
+ fullName: format
+ summary: Specifies the formatting of the chart axis title.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartAxisTitleFormat;'
+ return:
+ type: ''
+ - name: text
+ uid: 'excel!Excel.ChartAxisTitle#text:member'
+ package: excel!
+ fullName: text
+ summary: Specifies the axis title.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'text: string;'
+ return:
+ type: string
+ - name: textOrientation
+ uid: 'excel!Excel.ChartAxisTitle#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: >-
+ Specifies the angle to which the text is oriented for the chart axis title. The value should either be an integer
+ from -90 to 90 or the integer 180 for vertically-oriented text.
+ remarks: |-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ // Get a chart named "Sales Chart" from the "Sample" worksheet.
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ let chart = sheet.charts.getItem("Sales Chart");
+
+ // Set the value axis title to "Profits".
+ chart.axes.valueAxis.title.text = "Profits";
+
+ /* Set the value axis text orientation to 0.
+ For charts with a y-axis, this makes the label on the y-axis horizontal,
+ instead of the default look of rotated-vertically.
+ */
+ chart.axes.valueAxis.title.textOrientation = 0;
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation: number;'
+ return:
+ type: number
+ - name: visible
+ uid: 'excel!Excel.ChartAxisTitle#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Specifies if the axis title is visibile.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartAxisTitle#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartAxisTitleLoadOptions): Excel.ChartAxisTitle;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartAxisTitle#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartAxisTitle;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Add "Values" as the title for the value Axis.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.axes.valueAxis.title.text = "Values";
+ await context.sync();
+
+ console.log("Axis Title Added ");
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartAxisTitle#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartAxisTitle;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartAxisTitle#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartAxisTitleUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartAxisTitle#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartAxisTitle): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setFormula(formula)
+ uid: 'excel!Excel.ChartAxisTitle#setFormula:member(1)'
+ package: excel!
+ fullName: setFormula(formula)
+ summary: A string value that represents the formula of chart axis title using A1-style notation.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setFormula(formula: string): void;'
+ parameters:
+ - id: formula
+ description: A string that represents the formula to set.
+ type: string
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartAxisTitle#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartAxisTitle object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartAxisTitleData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartAxisTitleData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistitleformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistitleformat.yml
new file mode 100644
index 0000000000..73d21dc737
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistitleformat.yml
@@ -0,0 +1,191 @@
+### YamlMime:TSType
+name: Excel.ChartAxisTitleFormat
+uid: 'excel!Excel.ChartAxisTitleFormat:class'
+package: excel!
+fullName: Excel.ChartAxisTitleFormat
+summary: Represents the chart axis title formatting.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartAxisTitleFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Specifies the chart axis title''s border format, which includes color, linestyle, and weight.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartAxisTitleFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartAxisTitleFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: Specifies the chart axis title's fill formatting.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartAxisTitleFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: >-
+ Specifies the chart axis title's font attributes, such as font name, font size, or color, of the chart axis title
+ object.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartAxisTitleFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartAxisTitleFormatLoadOptions): Excel.ChartAxisTitleFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartAxisTitleFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartAxisTitleFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartAxisTitleFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartAxisTitleFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartAxisTitleFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartAxisTitleFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartAxisTitleFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartAxisTitleFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartAxisTitleFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartAxisTitleFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartAxisTitleFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartAxisTitleFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistype.yml
new file mode 100644
index 0000000000..18369beee0
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartaxistype.yml
@@ -0,0 +1,39 @@
+### YamlMime:TSEnum
+name: Excel.ChartAxisType
+uid: 'excel!Excel.ChartAxisType:enum'
+package: excel!
+fullName: Excel.ChartAxisType
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: category
+ uid: 'excel!Excel.ChartAxisType.category:member'
+ package: excel!
+ summary: |-
+ Axis displays categories.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Category"'
+ - name: invalid
+ uid: 'excel!Excel.ChartAxisType.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: series
+ uid: 'excel!Excel.ChartAxisType.series:member'
+ package: excel!
+ summary: |-
+ Axis displays data series.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Series"'
+ - name: value
+ uid: 'excel!Excel.ChartAxisType.value:member'
+ package: excel!
+ summary: |-
+ Axis displays values.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Value"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartbinoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartbinoptions.yml
new file mode 100644
index 0000000000..21a3f16d7f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartbinoptions.yml
@@ -0,0 +1,237 @@
+### YamlMime:TSType
+name: Excel.ChartBinOptions
+uid: 'excel!Excel.ChartBinOptions:class'
+package: excel!
+fullName: Excel.ChartBinOptions
+summary: Encapsulates the bin options for histogram charts and pareto charts.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: allowOverflow
+ uid: 'excel!Excel.ChartBinOptions#allowOverflow:member'
+ package: excel!
+ fullName: allowOverflow
+ summary: Specifies if bin overflow is enabled in a histogram chart or pareto chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'allowOverflow: boolean;'
+ return:
+ type: boolean
+ - name: allowUnderflow
+ uid: 'excel!Excel.ChartBinOptions#allowUnderflow:member'
+ package: excel!
+ fullName: allowUnderflow
+ summary: Specifies if bin underflow is enabled in a histogram chart or pareto chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'allowUnderflow: boolean;'
+ return:
+ type: boolean
+ - name: context
+ uid: 'excel!Excel.ChartBinOptions#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: count
+ uid: 'excel!Excel.ChartBinOptions#count:member'
+ package: excel!
+ fullName: count
+ summary: Specifies the bin count of a histogram chart or pareto chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'count: number;'
+ return:
+ type: number
+ - name: overflowValue
+ uid: 'excel!Excel.ChartBinOptions#overflowValue:member'
+ package: excel!
+ fullName: overflowValue
+ summary: Specifies the bin overflow value of a histogram chart or pareto chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'overflowValue: number;'
+ return:
+ type: number
+ - name: type
+ uid: 'excel!Excel.ChartBinOptions#type:member'
+ package: excel!
+ fullName: type
+ summary: Specifies the bin's type for a histogram chart or pareto chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: Excel.ChartBinType | "Category" | "Auto" | "BinWidth" | "BinCount";'
+ return:
+ type: ' | "Category" | "Auto" | "BinWidth" | "BinCount"'
+ - name: underflowValue
+ uid: 'excel!Excel.ChartBinOptions#underflowValue:member'
+ package: excel!
+ fullName: underflowValue
+ summary: Specifies the bin underflow value of a histogram chart or pareto chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'underflowValue: number;'
+ return:
+ type: number
+ - name: width
+ uid: 'excel!Excel.ChartBinOptions#width:member'
+ package: excel!
+ fullName: width
+ summary: Specifies the bin width value of a histogram chart or pareto chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'width: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartBinOptions#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartBinOptionsLoadOptions): Excel.ChartBinOptions;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartBinOptions#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartBinOptions;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartBinOptions#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartBinOptions;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartBinOptions#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartBinOptionsUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartBinOptions#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartBinOptions): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartBinOptions#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartBinOptions object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartBinOptionsData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartBinOptionsData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartbintype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartbintype.yml
new file mode 100644
index 0000000000..bfe60ede8c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartbintype.yml
@@ -0,0 +1,30 @@
+### YamlMime:TSEnum
+name: Excel.ChartBinType
+uid: 'excel!Excel.ChartBinType:enum'
+package: excel!
+fullName: Excel.ChartBinType
+summary: Specifies the bin type of a histogram chart or pareto chart series.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: auto
+ uid: 'excel!Excel.ChartBinType.auto:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Auto"'
+ - name: binCount
+ uid: 'excel!Excel.ChartBinType.binCount:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BinCount"'
+ - name: binWidth
+ uid: 'excel!Excel.ChartBinType.binWidth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BinWidth"'
+ - name: category
+ uid: 'excel!Excel.ChartBinType.category:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Category"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartborder.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartborder.yml
new file mode 100644
index 0000000000..01f8fc3329
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartborder.yml
@@ -0,0 +1,206 @@
+### YamlMime:TSType
+name: Excel.ChartBorder
+uid: 'excel!Excel.ChartBorder:class'
+package: excel!
+fullName: Excel.ChartBorder
+summary: Represents the border formatting of a chart element.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: color
+ uid: 'excel!Excel.ChartBorder#color:member'
+ package: excel!
+ fullName: color
+ summary: HTML color code representing the color of borders in the chart.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ChartBorder#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: lineStyle
+ uid: 'excel!Excel.ChartBorder#lineStyle:member'
+ package: excel!
+ fullName: lineStyle
+ summary: Represents the line style of the border. See `Excel.ChartLineStyle` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ lineStyle: Excel.ChartLineStyle | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" | "Dot" | "Grey25" |
+ "Grey50" | "Grey75" | "Automatic" | "RoundDot";
+ return:
+ type: >-
+ | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" |
+ "Dot" | "Grey25" | "Grey50" | "Grey75" | "Automatic" | "RoundDot"
+ - name: weight
+ uid: 'excel!Excel.ChartBorder#weight:member'
+ package: excel!
+ fullName: weight
+ summary: 'Represents weight of the border, in points.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'weight: number;'
+ return:
+ type: number
+methods:
+ - name: clear()
+ uid: 'excel!Excel.ChartBorder#clear:member(1)'
+ package: excel!
+ fullName: clear()
+ summary: Clear the border format of a chart element.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clear(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartBorder#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartBorderLoadOptions): Excel.ChartBorder;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartBorder#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartBorder;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartBorder#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartBorder;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartBorder#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartBorderUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartBorder#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartBorder): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartBorder#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartBorder object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartBorderData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartBorderData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartboxquartilecalculation.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartboxquartilecalculation.yml
new file mode 100644
index 0000000000..bfa5b56529
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartboxquartilecalculation.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ChartBoxQuartileCalculation
+uid: 'excel!Excel.ChartBoxQuartileCalculation:enum'
+package: excel!
+fullName: Excel.ChartBoxQuartileCalculation
+summary: Represents the quartile calculation type of chart series layout. Only applies to a box and whisker chart.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: exclusive
+ uid: 'excel!Excel.ChartBoxQuartileCalculation.exclusive:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Exclusive"'
+ - name: inclusive
+ uid: 'excel!Excel.ChartBoxQuartileCalculation.inclusive:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Inclusive"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartboxwhiskeroptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartboxwhiskeroptions.yml
new file mode 100644
index 0000000000..bc4c6da1a4
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartboxwhiskeroptions.yml
@@ -0,0 +1,213 @@
+### YamlMime:TSType
+name: Excel.ChartBoxwhiskerOptions
+uid: 'excel!Excel.ChartBoxwhiskerOptions:class'
+package: excel!
+fullName: Excel.ChartBoxwhiskerOptions
+summary: Represents the properties of a box and whisker chart.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: quartileCalculation
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#quartileCalculation:member'
+ package: excel!
+ fullName: quartileCalculation
+ summary: Specifies if the quartile calculation type of a box and whisker chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'quartileCalculation: Excel.ChartBoxQuartileCalculation | "Inclusive" | "Exclusive";'
+ return:
+ type: ' | "Inclusive" | "Exclusive"'
+ - name: showInnerPoints
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#showInnerPoints:member'
+ package: excel!
+ fullName: showInnerPoints
+ summary: Specifies if inner points are shown in a box and whisker chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showInnerPoints: boolean;'
+ return:
+ type: boolean
+ - name: showMeanLine
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#showMeanLine:member'
+ package: excel!
+ fullName: showMeanLine
+ summary: Specifies if the mean line is shown in a box and whisker chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showMeanLine: boolean;'
+ return:
+ type: boolean
+ - name: showMeanMarker
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#showMeanMarker:member'
+ package: excel!
+ fullName: showMeanMarker
+ summary: Specifies if the mean marker is shown in a box and whisker chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showMeanMarker: boolean;'
+ return:
+ type: boolean
+ - name: showOutlierPoints
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#showOutlierPoints:member'
+ package: excel!
+ fullName: showOutlierPoints
+ summary: Specifies if outlier points are shown in a box and whisker chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showOutlierPoints: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartBoxwhiskerOptionsLoadOptions): Excel.ChartBoxwhiskerOptions;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartBoxwhiskerOptions;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartBoxwhiskerOptions;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartBoxwhiskerOptionsUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartBoxwhiskerOptions): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartBoxwhiskerOptions#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartBoxwhiskerOptions object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartBoxwhiskerOptionsData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartBoxwhiskerOptionsData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartcollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartcollection.yml
new file mode 100644
index 0000000000..4de33930e6
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartcollection.yml
@@ -0,0 +1,510 @@
+### YamlMime:TSType
+name: Excel.ChartCollection
+uid: 'excel!Excel.ChartCollection:class'
+package: excel!
+fullName: Excel.ChartCollection
+summary: A collection of all the chart objects on a worksheet.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: count
+ uid: 'excel!Excel.ChartCollection#count:member'
+ package: excel!
+ fullName: count
+ summary: Returns the number of charts in the worksheet.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly count: number;'
+ return:
+ type: number
+ - name: items
+ uid: 'excel!Excel.ChartCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.Chart[];'
+ return:
+ type: '[]'
+methods:
+ - name: 'add(type, sourceData, seriesBy)'
+ uid: 'excel!Excel.ChartCollection#add:member(1)'
+ package: excel!
+ fullName: 'add(type, sourceData, seriesBy)'
+ summary: Creates a new chart.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Add a chart of chartType "ColumnClustered" on worksheet "Charts"
+ // with sourceData from range "A1:B4" and seriesBy set to "auto".
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sheet1");
+ const rangeSelection = "A1:B4";
+ const range = sheet.getRange(rangeSelection);
+ const chart = sheet.charts.add(
+ Excel.ChartType.columnClustered,
+ range,
+ Excel.ChartSeriesBy.auto);
+ await context.sync();
+
+ console.log("New Chart Added");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(type: Excel.ChartType, sourceData: Range, seriesBy?: Excel.ChartSeriesBy): Excel.Chart;'
+ parameters:
+ - id: type
+ description: Represents the type of a chart. See `Excel.ChartType` for details.
+ type: ''
+ - id: sourceData
+ description: The `Range` object corresponding to the source data.
+ type: ''
+ - id: seriesBy
+ description: >-
+ Optional. Specifies the way columns or rows are used as data series on the chart. See `Excel.ChartSeriesBy`
+ for details.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: 'add(typeString, sourceData, seriesBy)'
+ uid: 'excel!Excel.ChartCollection#add:member(2)'
+ package: excel!
+ fullName: 'add(typeString, sourceData, seriesBy)'
+ summary: Creates a new chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ add(typeString: "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" | "3DColumnClustered" |
+ "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100" | "3DBarClustered" |
+ "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" | "LineMarkersStacked" |
+ "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" |
+ "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" |
+ "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" |
+ "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" |
+ "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" |
+ "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" |
+ "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" |
+ "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" |
+ "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" |
+ "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" |
+ "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel",
+ sourceData: Range, seriesBy?: "Auto" | "Columns" | "Rows"): Excel.Chart;
+ parameters:
+ - id: typeString
+ description: Represents the type of a chart. See `Excel.ChartType` for details.
+ type: >-
+ "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" | "3DColumnClustered" |
+ "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100" |
+ "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" |
+ "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" |
+ "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" |
+ "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" |
+ "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" |
+ "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" |
+ "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" |
+ "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered"
+ | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" |
+ "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" |
+ "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" |
+ "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" |
+ "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel"
+ - id: sourceData
+ description: The `Range` object corresponding to the source data.
+ type: ''
+ - id: seriesBy
+ description: >-
+ Optional. Specifies the way columns or rows are used as data series on the chart. See `Excel.ChartSeriesBy`
+ for details.
+ type: '"Auto" | "Columns" | "Rows"'
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.ChartCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Returns the number of charts in the worksheet.
+ remarks: '\[ [API set: ExcelApi 1.4](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(name)
+ uid: 'excel!Excel.ChartCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(name)
+ summary: 'Gets a chart using its name. If there are multiple charts with the same name, the first one will be returned.'
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Get the number of charts.
+ await Excel.run(async (context) => {
+ const charts = context.workbook.worksheets.getItem("Sheet1").charts;
+ charts.load('count');
+ await context.sync();
+
+ console.log("charts: Count= " + charts.count);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(name: string): Excel.Chart;'
+ parameters:
+ - id: name
+ description: Name of the chart to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.ChartCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Gets a chart based on its position in the collection.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const lastPosition = context.workbook.worksheets.getItem("Sheet1").charts.count - 1;
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItemAt(lastPosition);
+ await context.sync();
+
+ console.log(chart.name);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.Chart;'
+ parameters:
+ - id: index
+ description: Index value of the object to be retrieved. Zero-indexed.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(name)
+ uid: 'excel!Excel.ChartCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(name)
+ summary: >-
+ Gets a chart using its name. If there are multiple charts with the same name, the first one will be returned. If
+ the chart doesn't exist, then this method returns an object with its `isNullObject` property set to `true`. For further information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.4](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(name: string): Excel.Chart;'
+ parameters:
+ - id: name
+ description: Name of the chart to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ChartCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.ChartCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const charts = context.workbook.worksheets.getItem("Sheet1").charts;
+ charts.load('items');
+ await context.sync();
+
+ for (let i = 0; i < charts.items.length; i++) {
+ console.log(charts.items[i].name);
+ }
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.ChartCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.ChartCollection` object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartCollectionData`) that contains an "items" array
+ with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartCollectionData;'
+ return:
+ type: ''
+ description: ''
+events:
+ - name: onActivated
+ uid: 'excel!Excel.ChartCollection#onActivated:member'
+ package: excel!
+ fullName: onActivated
+ summary: Occurs when a chart is activated.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-chart-activated.yaml
+
+ await Excel.run(async (context) => {
+
+ const pieChart = context.workbook.worksheets.getActiveWorksheet().charts.getItem("Pie");
+
+ // Register the onActivated and onDeactivated event handlers.
+ pieChart.onActivated.add(chartActivated);
+ pieChart.onDeactivated.add(chartDeactivated);
+
+ await context.sync();
+
+ console.log("Added handlers for Chart onActivated and onDeactivated events.");
+ });
+
+
+ ...
+
+ async function chartActivated(event) {
+ await Excel.run(async (context) => {
+ // Retrieve the worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Retrieve the activated chart by ID and load the name of the chart.
+ const activatedChart = sheet.charts.getItem(event.chartId);
+ activatedChart.load(["name"]);
+ await context.sync();
+
+ // Print out the activated chart's data.
+ console.log(`A chart was activated. ID: ${event.chartId}. Chart name: ${activatedChart.name}.`);
+ });
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onActivated: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+ - name: onAdded
+ uid: 'excel!Excel.ChartCollection#onAdded:member'
+ package: excel!
+ fullName: onAdded
+ summary: Occurs when a new chart is added to the worksheet.
+ remarks: |-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ context.workbook.worksheets.getActiveWorksheet()
+ .charts.onAdded.add(function (event) {
+ return Excel.run(async (context) => {
+ console.log("A chart has been added with ID: " + event.chartId);
+ await context.sync();
+ });
+ });
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onAdded: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+ - name: onDeactivated
+ uid: 'excel!Excel.ChartCollection#onDeactivated:member'
+ package: excel!
+ fullName: onDeactivated
+ summary: Occurs when a chart is deactivated.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-chart-activated.yaml
+
+ await Excel.run(async (context) => {
+
+ const pieChart = context.workbook.worksheets.getActiveWorksheet().charts.getItem("Pie");
+
+ // Register the onActivated and onDeactivated event handlers.
+ pieChart.onActivated.add(chartActivated);
+ pieChart.onDeactivated.add(chartDeactivated);
+
+ await context.sync();
+
+ console.log("Added handlers for Chart onActivated and onDeactivated events.");
+ });
+
+
+ ...
+
+ async function chartDeactivated(event) {
+ await Excel.run(async (context) => {
+ // Callback function for when the chart is deactivated.
+ console.log("The pie chart is NOT active.");
+ });
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onDeactivated: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+ - name: onDeleted
+ uid: 'excel!Excel.ChartCollection#onDeleted:member'
+ package: excel!
+ fullName: onDeleted
+ summary: Occurs when a chart is deleted.
+ remarks: |-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ context.workbook.worksheets.getActiveWorksheet()
+ .charts.onDeleted.add(function (event) {
+ return Excel.run(async (context) => {
+ console.log("The chart with this ID was deleted: " + event.chartId);
+ await context.sync();
+ });
+ });
+ await context.sync();
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onDeleted: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartcolorscheme.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartcolorscheme.yml
new file mode 100644
index 0000000000..22dedfea90
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartcolorscheme.yml
@@ -0,0 +1,95 @@
+### YamlMime:TSEnum
+name: Excel.ChartColorScheme
+uid: 'excel!Excel.ChartColorScheme:enum'
+package: excel!
+fullName: Excel.ChartColorScheme
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: colorfulPalette1
+ uid: 'excel!Excel.ChartColorScheme.colorfulPalette1:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColorfulPalette1"'
+ - name: colorfulPalette2
+ uid: 'excel!Excel.ChartColorScheme.colorfulPalette2:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColorfulPalette2"'
+ - name: colorfulPalette3
+ uid: 'excel!Excel.ChartColorScheme.colorfulPalette3:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColorfulPalette3"'
+ - name: colorfulPalette4
+ uid: 'excel!Excel.ChartColorScheme.colorfulPalette4:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColorfulPalette4"'
+ - name: monochromaticPalette1
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette1:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette1"'
+ - name: monochromaticPalette10
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette10:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette10"'
+ - name: monochromaticPalette11
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette11:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette11"'
+ - name: monochromaticPalette12
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette12:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette12"'
+ - name: monochromaticPalette13
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette13:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette13"'
+ - name: monochromaticPalette2
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette2:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette2"'
+ - name: monochromaticPalette3
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette3:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette3"'
+ - name: monochromaticPalette4
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette4:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette4"'
+ - name: monochromaticPalette5
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette5:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette5"'
+ - name: monochromaticPalette6
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette6:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette6"'
+ - name: monochromaticPalette7
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette7:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette7"'
+ - name: monochromaticPalette8
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette8:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette8"'
+ - name: monochromaticPalette9
+ uid: 'excel!Excel.ChartColorScheme.monochromaticPalette9:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MonochromaticPalette9"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabel.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabel.yml
new file mode 100644
index 0000000000..ff7090f89f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabel.yml
@@ -0,0 +1,427 @@
+### YamlMime:TSType
+name: Excel.ChartDataLabel
+uid: 'excel!Excel.ChartDataLabel:class'
+package: excel!
+fullName: Excel.ChartDataLabel
+summary: Represents the data label of a chart point.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: autoText
+ uid: 'excel!Excel.ChartDataLabel#autoText:member'
+ package: excel!
+ fullName: autoText
+ summary: Specifies if the data label automatically generates appropriate text based on context.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'autoText: boolean;'
+ return:
+ type: boolean
+ - name: context
+ uid: 'excel!Excel.ChartDataLabel#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartDataLabel#format:member'
+ package: excel!
+ fullName: format
+ summary: Represents the format of chart data label.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartDataLabelFormat;'
+ return:
+ type: ''
+ - name: formula
+ uid: 'excel!Excel.ChartDataLabel#formula:member'
+ package: excel!
+ fullName: formula
+ summary: String value that represents the formula of chart data label using A1-style notation.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula: string;'
+ return:
+ type: string
+ - name: height
+ uid: 'excel!Excel.ChartDataLabel#height:member'
+ package: excel!
+ fullName: height
+ summary: 'Returns the height, in points, of the chart data label. Value is `null` if the chart data label is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly height: number;'
+ return:
+ type: number
+ - name: horizontalAlignment
+ uid: 'excel!Excel.ChartDataLabel#horizontalAlignment:member'
+ package: excel!
+ fullName: horizontalAlignment
+ summary: >-
+ Represents the horizontal alignment for chart data label. See `Excel.ChartTextHorizontalAlignment` for details.
+ This property is valid only when `TextOrientation` of data label is -90, 90, or 180.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ horizontalAlignment: Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed";
+ return:
+ type: >-
+ | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed"
+ - name: left
+ uid: 'excel!Excel.ChartDataLabel#left:member'
+ package: excel!
+ fullName: left
+ summary: >-
+ Represents the distance, in points, from the left edge of chart data label to the left edge of chart area. Value
+ is `null` if the chart data label is not visible.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'left: number;'
+ return:
+ type: number
+ - name: linkNumberFormat
+ uid: 'excel!Excel.ChartDataLabel#linkNumberFormat:member'
+ package: excel!
+ fullName: linkNumberFormat
+ summary: >-
+ Specifies if the number format is linked to the cells (so that the number format changes in the labels when it
+ changes in the cells).
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'linkNumberFormat: boolean;'
+ return:
+ type: boolean
+ - name: numberFormat
+ uid: 'excel!Excel.ChartDataLabel#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: String value that represents the format code for data label.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'numberFormat: string;'
+ return:
+ type: string
+ - name: position
+ uid: 'excel!Excel.ChartDataLabel#position:member'
+ package: excel!
+ fullName: position
+ summary: Value that represents the position of the data label. See `Excel.ChartDataLabelPosition` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ position: Excel.ChartDataLabelPosition | "Invalid" | "None" | "Center" | "InsideEnd" | "InsideBase" |
+ "OutsideEnd" | "Left" | "Right" | "Top" | "Bottom" | "BestFit" | "Callout";
+ return:
+ type: >-
+ | "Invalid" | "None" | "Center" | "InsideEnd" |
+ "InsideBase" | "OutsideEnd" | "Left" | "Right" | "Top" | "Bottom" | "BestFit" | "Callout"
+ - name: separator
+ uid: 'excel!Excel.ChartDataLabel#separator:member'
+ package: excel!
+ fullName: separator
+ summary: String representing the separator used for the data label on a chart.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'separator: string;'
+ return:
+ type: string
+ - name: showBubbleSize
+ uid: 'excel!Excel.ChartDataLabel#showBubbleSize:member'
+ package: excel!
+ fullName: showBubbleSize
+ summary: Specifies if the data label bubble size is visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showBubbleSize: boolean;'
+ return:
+ type: boolean
+ - name: showCategoryName
+ uid: 'excel!Excel.ChartDataLabel#showCategoryName:member'
+ package: excel!
+ fullName: showCategoryName
+ summary: Specifies if the data label category name is visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showCategoryName: boolean;'
+ return:
+ type: boolean
+ - name: showLegendKey
+ uid: 'excel!Excel.ChartDataLabel#showLegendKey:member'
+ package: excel!
+ fullName: showLegendKey
+ summary: Specifies if the data label legend key is visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showLegendKey: boolean;'
+ return:
+ type: boolean
+ - name: showPercentage
+ uid: 'excel!Excel.ChartDataLabel#showPercentage:member'
+ package: excel!
+ fullName: showPercentage
+ summary: Specifies if the data label percentage is visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showPercentage: boolean;'
+ return:
+ type: boolean
+ - name: showSeriesName
+ uid: 'excel!Excel.ChartDataLabel#showSeriesName:member'
+ package: excel!
+ fullName: showSeriesName
+ summary: Specifies if the data label series name is visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showSeriesName: boolean;'
+ return:
+ type: boolean
+ - name: showValue
+ uid: 'excel!Excel.ChartDataLabel#showValue:member'
+ package: excel!
+ fullName: showValue
+ summary: Specifies if the data label value is visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showValue: boolean;'
+ return:
+ type: boolean
+ - name: text
+ uid: 'excel!Excel.ChartDataLabel#text:member'
+ package: excel!
+ fullName: text
+ summary: String representing the text of the data label on a chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'text: string;'
+ return:
+ type: string
+ - name: textOrientation
+ uid: 'excel!Excel.ChartDataLabel#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: >-
+ Represents the angle to which the text is oriented for the chart data label. The value should either be an integer
+ from -90 to 90 or the integer 180 for vertically-oriented text.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation: number;'
+ return:
+ type: number
+ - name: top
+ uid: 'excel!Excel.ChartDataLabel#top:member'
+ package: excel!
+ fullName: top
+ summary: >-
+ Represents the distance, in points, from the top edge of chart data label to the top of chart area. Value is
+ `null` if the chart data label is not visible.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'top: number;'
+ return:
+ type: number
+ - name: verticalAlignment
+ uid: 'excel!Excel.ChartDataLabel#verticalAlignment:member'
+ package: excel!
+ fullName: verticalAlignment
+ summary: >-
+ Represents the vertical alignment of chart data label. See `Excel.ChartTextVerticalAlignment` for details. This
+ property is valid only when `TextOrientation` of data label is 0.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'verticalAlignment: Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed";'
+ return:
+ type: >-
+ | "Center" | "Bottom" | "Top" | "Justify" |
+ "Distributed"
+ - name: width
+ uid: 'excel!Excel.ChartDataLabel#width:member'
+ package: excel!
+ fullName: width
+ summary: 'Returns the width, in points, of the chart data label. Value is `null` if the chart data label is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly width: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartDataLabel#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartDataLabelLoadOptions): Excel.ChartDataLabel;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartDataLabel#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartDataLabel;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartDataLabel#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartDataLabel;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartDataLabel#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartDataLabelUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartDataLabel#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartDataLabel): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartDataLabel#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartDataLabel object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartDataLabelData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartDataLabelData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabelformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabelformat.yml
new file mode 100644
index 0000000000..7a5acfe2e7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabelformat.yml
@@ -0,0 +1,189 @@
+### YamlMime:TSType
+name: Excel.ChartDataLabelFormat
+uid: 'excel!Excel.ChartDataLabelFormat:class'
+package: excel!
+fullName: Excel.ChartDataLabelFormat
+summary: Encapsulates the format properties for the chart data labels.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartDataLabelFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Represents the border format, which includes color, linestyle, and weight.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartDataLabelFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartDataLabelFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: Represents the fill format of the current chart data label.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartDataLabelFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Represents the font attributes (such as font name, font size, and color) for a chart data label.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartDataLabelFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartDataLabelFormatLoadOptions): Excel.ChartDataLabelFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartDataLabelFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartDataLabelFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartDataLabelFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartDataLabelFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartDataLabelFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartDataLabelFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartDataLabelFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartDataLabelFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartDataLabelFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartDataLabelFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartDataLabelFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartDataLabelFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabelposition.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabelposition.yml
new file mode 100644
index 0000000000..dcad6842ce
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabelposition.yml
@@ -0,0 +1,70 @@
+### YamlMime:TSEnum
+name: Excel.ChartDataLabelPosition
+uid: 'excel!Excel.ChartDataLabelPosition:enum'
+package: excel!
+fullName: Excel.ChartDataLabelPosition
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bestFit
+ uid: 'excel!Excel.ChartDataLabelPosition.bestFit:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BestFit"'
+ - name: bottom
+ uid: 'excel!Excel.ChartDataLabelPosition.bottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bottom"'
+ - name: callout
+ uid: 'excel!Excel.ChartDataLabelPosition.callout:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Callout"'
+ - name: center
+ uid: 'excel!Excel.ChartDataLabelPosition.center:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Center"'
+ - name: insideBase
+ uid: 'excel!Excel.ChartDataLabelPosition.insideBase:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"InsideBase"'
+ - name: insideEnd
+ uid: 'excel!Excel.ChartDataLabelPosition.insideEnd:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"InsideEnd"'
+ - name: invalid
+ uid: 'excel!Excel.ChartDataLabelPosition.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: left
+ uid: 'excel!Excel.ChartDataLabelPosition.left:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Left"'
+ - name: none
+ uid: 'excel!Excel.ChartDataLabelPosition.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: outsideEnd
+ uid: 'excel!Excel.ChartDataLabelPosition.outsideEnd:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"OutsideEnd"'
+ - name: right
+ uid: 'excel!Excel.ChartDataLabelPosition.right:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Right"'
+ - name: top
+ uid: 'excel!Excel.ChartDataLabelPosition.top:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Top"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabels.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabels.yml
new file mode 100644
index 0000000000..7c42f436c5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatalabels.yml
@@ -0,0 +1,367 @@
+### YamlMime:TSType
+name: Excel.ChartDataLabels
+uid: 'excel!Excel.ChartDataLabels:class'
+package: excel!
+fullName: Excel.ChartDataLabels
+summary: Represents a collection of all the data labels on a chart point.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: autoText
+ uid: 'excel!Excel.ChartDataLabels#autoText:member'
+ package: excel!
+ fullName: autoText
+ summary: Specifies if data labels automatically generate appropriate text based on context.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'autoText: boolean;'
+ return:
+ type: boolean
+ - name: context
+ uid: 'excel!Excel.ChartDataLabels#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartDataLabels#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Specifies the format of chart data labels, which includes fill and font formatting.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartDataLabelFormat;'
+ return:
+ type: ''
+ - name: horizontalAlignment
+ uid: 'excel!Excel.ChartDataLabels#horizontalAlignment:member'
+ package: excel!
+ fullName: horizontalAlignment
+ summary: >-
+ Specifies the horizontal alignment for chart data label. See `Excel.ChartTextHorizontalAlignment` for details.
+ This property is valid only when the `TextOrientation` of data label is 0.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ horizontalAlignment: Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed";
+ return:
+ type: >-
+ | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed"
+ - name: linkNumberFormat
+ uid: 'excel!Excel.ChartDataLabels#linkNumberFormat:member'
+ package: excel!
+ fullName: linkNumberFormat
+ summary: >-
+ Specifies if the number format is linked to the cells. If `true`, the number format will change in the
+ labels when it changes in the cells.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'linkNumberFormat: boolean;'
+ return:
+ type: boolean
+ - name: numberFormat
+ uid: 'excel!Excel.ChartDataLabels#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: Specifies the format code for data labels.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'numberFormat: string;'
+ return:
+ type: string
+ - name: position
+ uid: 'excel!Excel.ChartDataLabels#position:member'
+ package: excel!
+ fullName: position
+ summary: Value that represents the position of the data label. See `Excel.ChartDataLabelPosition` for details.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ position: Excel.ChartDataLabelPosition | "Invalid" | "None" | "Center" | "InsideEnd" | "InsideBase" |
+ "OutsideEnd" | "Left" | "Right" | "Top" | "Bottom" | "BestFit" | "Callout";
+ return:
+ type: >-
+ | "Invalid" | "None" | "Center" | "InsideEnd" |
+ "InsideBase" | "OutsideEnd" | "Left" | "Right" | "Top" | "Bottom" | "BestFit" | "Callout"
+ - name: separator
+ uid: 'excel!Excel.ChartDataLabels#separator:member'
+ package: excel!
+ fullName: separator
+ summary: String representing the separator used for the data labels on a chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'separator: string;'
+ return:
+ type: string
+ - name: showBubbleSize
+ uid: 'excel!Excel.ChartDataLabels#showBubbleSize:member'
+ package: excel!
+ fullName: showBubbleSize
+ summary: Specifies if the data label bubble size is visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showBubbleSize: boolean;'
+ return:
+ type: boolean
+ - name: showCategoryName
+ uid: 'excel!Excel.ChartDataLabels#showCategoryName:member'
+ package: excel!
+ fullName: showCategoryName
+ summary: Specifies if the data label category name is visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showCategoryName: boolean;'
+ return:
+ type: boolean
+ - name: showLegendKey
+ uid: 'excel!Excel.ChartDataLabels#showLegendKey:member'
+ package: excel!
+ fullName: showLegendKey
+ summary: Specifies if the data label legend key is visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showLegendKey: boolean;'
+ return:
+ type: boolean
+ - name: showPercentage
+ uid: 'excel!Excel.ChartDataLabels#showPercentage:member'
+ package: excel!
+ fullName: showPercentage
+ summary: Specifies if the data label percentage is visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showPercentage: boolean;'
+ return:
+ type: boolean
+ - name: showSeriesName
+ uid: 'excel!Excel.ChartDataLabels#showSeriesName:member'
+ package: excel!
+ fullName: showSeriesName
+ summary: Specifies if the data label series name is visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showSeriesName: boolean;'
+ return:
+ type: boolean
+ - name: showValue
+ uid: 'excel!Excel.ChartDataLabels#showValue:member'
+ package: excel!
+ fullName: showValue
+ summary: Specifies if the data label value is visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showValue: boolean;'
+ return:
+ type: boolean
+ - name: textOrientation
+ uid: 'excel!Excel.ChartDataLabels#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: >-
+ Represents the angle to which the text is oriented for data labels. The value should either be an integer from -90
+ to 90 or the integer 180 for vertically-oriented text.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation: number;'
+ return:
+ type: number
+ - name: verticalAlignment
+ uid: 'excel!Excel.ChartDataLabels#verticalAlignment:member'
+ package: excel!
+ fullName: verticalAlignment
+ summary: >-
+ Represents the vertical alignment of chart data label. See `Excel.ChartTextVerticalAlignment` for details. This
+ property is valid only when `TextOrientation` of the data label is -90, 90, or 180.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'verticalAlignment: Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed";'
+ return:
+ type: >-
+ | "Center" | "Bottom" | "Top" | "Justify" |
+ "Distributed"
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartDataLabels#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartDataLabelsLoadOptions): Excel.ChartDataLabels;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartDataLabels#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartDataLabels;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Show the series name in data labels and set the position of the data labels to "top".
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.dataLabels.showValue = true;
+ chart.dataLabels.position = Excel.ChartDataLabelPosition.top;
+ chart.dataLabels.showSeriesName = true;
+ await context.sync();
+
+ console.log("Data labels shown");
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartDataLabels#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartDataLabels;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartDataLabels#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartDataLabelsUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartDataLabels#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartDataLabels): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartDataLabels#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartDataLabels object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartDataLabelsData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartDataLabelsData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatasourcetype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatasourcetype.yml
new file mode 100644
index 0000000000..d0eda39f75
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatasourcetype.yml
@@ -0,0 +1,42 @@
+### YamlMime:TSEnum
+name: Excel.ChartDataSourceType
+uid: 'excel!Excel.ChartDataSourceType:enum'
+package: excel!
+fullName: Excel.ChartDataSourceType
+summary: Specifies the data source type of the chart series.
+remarks: '\[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: externalRange
+ uid: 'excel!Excel.ChartDataSourceType.externalRange:member'
+ package: excel!
+ summary: |-
+ The data source type of the chart series is an external range.
+
+ * \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalRange"'
+ - name: list
+ uid: 'excel!Excel.ChartDataSourceType.list:member'
+ package: excel!
+ summary: |-
+ The data source type of the chart series is a list.
+
+ * \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"List"'
+ - name: localRange
+ uid: 'excel!Excel.ChartDataSourceType.localRange:member'
+ package: excel!
+ summary: |-
+ The data source type of the chart series is a local range.
+
+ * \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LocalRange"'
+ - name: unknown
+ uid: 'excel!Excel.ChartDataSourceType.unknown:member'
+ package: excel!
+ summary: |-
+ The data source type of the chart series is unknown or unsupported.
+
+ * \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatatable.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatatable.yml
new file mode 100644
index 0000000000..d283daf5c7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatatable.yml
@@ -0,0 +1,430 @@
+### YamlMime:TSType
+name: Excel.ChartDataTable
+uid: 'excel!Excel.ChartDataTable:class'
+package: excel!
+fullName: Excel.ChartDataTable
+summary: Represents the data table object of a chart.
+remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartDataTable#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartDataTable#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Represents the format of a chart data table, which includes fill, font, and border format.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adjusts the display and format of a chart data table that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the chart data table object and load its properties.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load();
+
+ // Set the display properties of the chart data table.
+ chartDataTable.showLegendKey = true;
+ chartDataTable.showHorizontalBorder = false;
+ chartDataTable.showVerticalBorder = true;
+ chartDataTable.showOutlineBorder = true;
+
+ // Retrieve the chart data table format object and set font and border properties.
+ const chartDataTableFormat = chartDataTable.format;
+ chartDataTableFormat.font.color = "#B76E79";
+ chartDataTableFormat.font.name = "Comic Sans";
+ chartDataTableFormat.border.color = "blue";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartDataTableFormat;'
+ return:
+ type: ''
+ - name: showHorizontalBorder
+ uid: 'excel!Excel.ChartDataTable#showHorizontalBorder:member'
+ package: excel!
+ fullName: showHorizontalBorder
+ summary: Specifies whether to display the horizontal border of the data table.
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adjusts the display and format of a chart data table that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the chart data table object and load its properties.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load();
+
+ // Set the display properties of the chart data table.
+ chartDataTable.showLegendKey = true;
+ chartDataTable.showHorizontalBorder = false;
+ chartDataTable.showVerticalBorder = true;
+ chartDataTable.showOutlineBorder = true;
+
+ // Retrieve the chart data table format object and set font and border properties.
+ const chartDataTableFormat = chartDataTable.format;
+ chartDataTableFormat.font.color = "#B76E79";
+ chartDataTableFormat.font.name = "Comic Sans";
+ chartDataTableFormat.border.color = "blue";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showHorizontalBorder: boolean;'
+ return:
+ type: boolean
+ - name: showLegendKey
+ uid: 'excel!Excel.ChartDataTable#showLegendKey:member'
+ package: excel!
+ fullName: showLegendKey
+ summary: Specifies whether to show the legend key of the data table.
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adjusts the display and format of a chart data table that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the chart data table object and load its properties.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load();
+
+ // Set the display properties of the chart data table.
+ chartDataTable.showLegendKey = true;
+ chartDataTable.showHorizontalBorder = false;
+ chartDataTable.showVerticalBorder = true;
+ chartDataTable.showOutlineBorder = true;
+
+ // Retrieve the chart data table format object and set font and border properties.
+ const chartDataTableFormat = chartDataTable.format;
+ chartDataTableFormat.font.color = "#B76E79";
+ chartDataTableFormat.font.name = "Comic Sans";
+ chartDataTableFormat.border.color = "blue";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showLegendKey: boolean;'
+ return:
+ type: boolean
+ - name: showOutlineBorder
+ uid: 'excel!Excel.ChartDataTable#showOutlineBorder:member'
+ package: excel!
+ fullName: showOutlineBorder
+ summary: Specifies whether to display the outline border of the data table.
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adjusts the display and format of a chart data table that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the chart data table object and load its properties.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load();
+
+ // Set the display properties of the chart data table.
+ chartDataTable.showLegendKey = true;
+ chartDataTable.showHorizontalBorder = false;
+ chartDataTable.showVerticalBorder = true;
+ chartDataTable.showOutlineBorder = true;
+
+ // Retrieve the chart data table format object and set font and border properties.
+ const chartDataTableFormat = chartDataTable.format;
+ chartDataTableFormat.font.color = "#B76E79";
+ chartDataTableFormat.font.name = "Comic Sans";
+ chartDataTableFormat.border.color = "blue";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showOutlineBorder: boolean;'
+ return:
+ type: boolean
+ - name: showVerticalBorder
+ uid: 'excel!Excel.ChartDataTable#showVerticalBorder:member'
+ package: excel!
+ fullName: showVerticalBorder
+ summary: Specifies whether to display the vertical border of the data table.
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adjusts the display and format of a chart data table that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the chart data table object and load its properties.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load();
+
+ // Set the display properties of the chart data table.
+ chartDataTable.showLegendKey = true;
+ chartDataTable.showHorizontalBorder = false;
+ chartDataTable.showVerticalBorder = true;
+ chartDataTable.showOutlineBorder = true;
+
+ // Retrieve the chart data table format object and set font and border properties.
+ const chartDataTableFormat = chartDataTable.format;
+ chartDataTableFormat.font.color = "#B76E79";
+ chartDataTableFormat.font.name = "Comic Sans";
+ chartDataTableFormat.border.color = "blue";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showVerticalBorder: boolean;'
+ return:
+ type: boolean
+ - name: visible
+ uid: 'excel!Excel.ChartDataTable#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Specifies whether to show the data table of the chart.
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adds a data table to a chart that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the data table object for the chart and set it to visible.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load("visible");
+ chartDataTable.visible = true;
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartDataTable#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartDataTableLoadOptions): Excel.ChartDataTable;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartDataTable#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartDataTable;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartDataTable#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartDataTable;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartDataTable#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartDataTableUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartDataTable#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartDataTable): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartDataTable#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartDataTable object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartDataTableData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartDataTableData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatatableformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatatableformat.yml
new file mode 100644
index 0000000000..515a7b2322
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdatatableformat.yml
@@ -0,0 +1,261 @@
+### YamlMime:TSType
+name: Excel.ChartDataTableFormat
+uid: 'excel!Excel.ChartDataTableFormat:class'
+package: excel!
+fullName: Excel.ChartDataTableFormat
+summary: Represents the format of a chart data table.
+remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartDataTableFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Represents the border format of chart data table, which includes color, line style, and weight.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adjusts the display and format of a chart data table that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the chart data table object and load its properties.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load();
+
+ // Set the display properties of the chart data table.
+ chartDataTable.showLegendKey = true;
+ chartDataTable.showHorizontalBorder = false;
+ chartDataTable.showVerticalBorder = true;
+ chartDataTable.showOutlineBorder = true;
+
+ // Retrieve the chart data table format object and set font and border properties.
+ const chartDataTableFormat = chartDataTable.format;
+ chartDataTableFormat.font.color = "#B76E79";
+ chartDataTableFormat.font.name = "Comic Sans";
+ chartDataTableFormat.border.color = "blue";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartDataTableFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartDataTableFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: 'Represents the fill format of an object, which includes background formatting information.'
+ remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartDataTableFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Represents the font attributes (such as font name, font size, and color) for the current object.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-table.yaml
+
+ // This function adjusts the display and format of a chart data table that already exists on the worksheet.
+
+ await Excel.run(async (context) => {
+ // Retrieve the chart named "SalesChart" from the "Sample" worksheet.
+ const chart = context.workbook.worksheets.getItem("Sample").charts.getItem("SalesChart");
+
+ // Get the chart data table object and load its properties.
+ const chartDataTable = chart.getDataTableOrNullObject();
+ chartDataTable.load();
+
+ // Set the display properties of the chart data table.
+ chartDataTable.showLegendKey = true;
+ chartDataTable.showHorizontalBorder = false;
+ chartDataTable.showVerticalBorder = true;
+ chartDataTable.showOutlineBorder = true;
+
+ // Retrieve the chart data table format object and set font and border properties.
+ const chartDataTableFormat = chartDataTable.format;
+ chartDataTableFormat.font.color = "#B76E79";
+ chartDataTableFormat.font.name = "Comic Sans";
+ chartDataTableFormat.border.color = "blue";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartDataTableFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartDataTableFormatLoadOptions): Excel.ChartDataTableFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartDataTableFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartDataTableFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartDataTableFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartDataTableFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartDataTableFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartDataTableFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartDataTableFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartDataTableFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartDataTableFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartDataTableFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartDataTableFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartDataTableFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdeactivatedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdeactivatedeventargs.yml
new file mode 100644
index 0000000000..9dea7f2df0
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdeactivatedeventargs.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.ChartDeactivatedEventArgs
+uid: 'excel!Excel.ChartDeactivatedEventArgs:interface'
+package: excel!
+fullName: Excel.ChartDeactivatedEventArgs
+summary: Provides information about the chart that raised the deactivated event.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: chartId
+ uid: 'excel!Excel.ChartDeactivatedEventArgs#chartId:member'
+ package: excel!
+ fullName: chartId
+ summary: Gets the ID of the chart that is deactivated.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'chartId: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.ChartDeactivatedEventArgs#type:member'
+ package: excel!
+ fullName: type
+ summary: Gets the type of the event. See `Excel.EventType` for details.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: "ChartDeactivated";'
+ return:
+ type: '"ChartDeactivated"'
+ - name: worksheetId
+ uid: 'excel!Excel.ChartDeactivatedEventArgs#worksheetId:member'
+ package: excel!
+ fullName: worksheetId
+ summary: Gets the ID of the worksheet in which the chart is deactivated.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'worksheetId: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdeletedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdeletedeventargs.yml
new file mode 100644
index 0000000000..6be70487ab
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdeletedeventargs.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.ChartDeletedEventArgs
+uid: 'excel!Excel.ChartDeletedEventArgs:interface'
+package: excel!
+fullName: Excel.ChartDeletedEventArgs
+summary: Provides information about the chart that raised the deleted event.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: chartId
+ uid: 'excel!Excel.ChartDeletedEventArgs#chartId:member'
+ package: excel!
+ fullName: chartId
+ summary: Gets the ID of the chart that is deleted from the worksheet.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'chartId: string;'
+ return:
+ type: string
+ - name: source
+ uid: 'excel!Excel.ChartDeletedEventArgs#source:member'
+ package: excel!
+ fullName: source
+ summary: Gets the source of the event. See `Excel.EventSource` for details.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'source: Excel.EventSource | "Local" | "Remote";'
+ return:
+ type: ' | "Local" | "Remote"'
+ - name: type
+ uid: 'excel!Excel.ChartDeletedEventArgs#type:member'
+ package: excel!
+ fullName: type
+ summary: Gets the type of the event. See `Excel.EventType` for details.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: "ChartDeleted";'
+ return:
+ type: '"ChartDeleted"'
+ - name: worksheetId
+ uid: 'excel!Excel.ChartDeletedEventArgs#worksheetId:member'
+ package: excel!
+ fullName: worksheetId
+ summary: Gets the ID of the worksheet in which the chart is deleted.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'worksheetId: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdisplayblanksas.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdisplayblanksas.yml
new file mode 100644
index 0000000000..6965f84087
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartdisplayblanksas.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ChartDisplayBlanksAs
+uid: 'excel!Excel.ChartDisplayBlanksAs:enum'
+package: excel!
+fullName: Excel.ChartDisplayBlanksAs
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: interplotted
+ uid: 'excel!Excel.ChartDisplayBlanksAs.interplotted:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Interplotted"'
+ - name: notPlotted
+ uid: 'excel!Excel.ChartDisplayBlanksAs.notPlotted:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NotPlotted"'
+ - name: zero
+ uid: 'excel!Excel.ChartDisplayBlanksAs.zero:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Zero"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbars.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbars.yml
new file mode 100644
index 0000000000..6223a94178
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbars.yml
@@ -0,0 +1,213 @@
+### YamlMime:TSType
+name: Excel.ChartErrorBars
+uid: 'excel!Excel.ChartErrorBars:class'
+package: excel!
+fullName: Excel.ChartErrorBars
+summary: This object represents the attributes for a chart's error bars.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartErrorBars#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: endStyleCap
+ uid: 'excel!Excel.ChartErrorBars#endStyleCap:member'
+ package: excel!
+ fullName: endStyleCap
+ summary: Specifies if error bars have an end style cap.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'endStyleCap: boolean;'
+ return:
+ type: boolean
+ - name: format
+ uid: 'excel!Excel.ChartErrorBars#format:member'
+ package: excel!
+ fullName: format
+ summary: Specifies the formatting type of the error bars.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartErrorBarsFormat;'
+ return:
+ type: ''
+ - name: include
+ uid: 'excel!Excel.ChartErrorBars#include:member'
+ package: excel!
+ fullName: include
+ summary: Specifies which parts of the error bars to include.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'include: Excel.ChartErrorBarsInclude | "Both" | "MinusValues" | "PlusValues";'
+ return:
+ type: ' | "Both" | "MinusValues" | "PlusValues"'
+ - name: type
+ uid: 'excel!Excel.ChartErrorBars#type:member'
+ package: excel!
+ fullName: type
+ summary: The type of range marked by the error bars.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: Excel.ChartErrorBarsType | "FixedValue" | "Percent" | "StDev" | "StError" | "Custom";'
+ return:
+ type: ' | "FixedValue" | "Percent" | "StDev" | "StError" | "Custom"'
+ - name: visible
+ uid: 'excel!Excel.ChartErrorBars#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Specifies whether the error bars are displayed.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartErrorBars#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartErrorBarsLoadOptions): Excel.ChartErrorBars;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartErrorBars#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartErrorBars;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartErrorBars#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartErrorBars;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartErrorBars#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartErrorBarsUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartErrorBars#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartErrorBars): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartErrorBars#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartErrorBars object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartErrorBarsData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartErrorBarsData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarsformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarsformat.yml
new file mode 100644
index 0000000000..58f17d948a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarsformat.yml
@@ -0,0 +1,165 @@
+### YamlMime:TSType
+name: Excel.ChartErrorBarsFormat
+uid: 'excel!Excel.ChartErrorBarsFormat:class'
+package: excel!
+fullName: Excel.ChartErrorBarsFormat
+summary: Encapsulates the format properties for chart error bars.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartErrorBarsFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: line
+ uid: 'excel!Excel.ChartErrorBarsFormat#line:member'
+ package: excel!
+ fullName: line
+ summary: Represents the chart line formatting.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly line: Excel.ChartLineFormat;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartErrorBarsFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartErrorBarsFormatLoadOptions): Excel.ChartErrorBarsFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartErrorBarsFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartErrorBarsFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartErrorBarsFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartErrorBarsFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartErrorBarsFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartErrorBarsFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartErrorBarsFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartErrorBarsFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartErrorBarsFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartErrorBarsFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartErrorBarsFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartErrorBarsFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarsinclude.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarsinclude.yml
new file mode 100644
index 0000000000..df3b3c8c28
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarsinclude.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ChartErrorBarsInclude
+uid: 'excel!Excel.ChartErrorBarsInclude:enum'
+package: excel!
+fullName: Excel.ChartErrorBarsInclude
+summary: Represents which parts of the error bar to include.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: both
+ uid: 'excel!Excel.ChartErrorBarsInclude.both:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Both"'
+ - name: minusValues
+ uid: 'excel!Excel.ChartErrorBarsInclude.minusValues:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MinusValues"'
+ - name: plusValues
+ uid: 'excel!Excel.ChartErrorBarsInclude.plusValues:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PlusValues"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarstype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarstype.yml
new file mode 100644
index 0000000000..68ffed664e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charterrorbarstype.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSEnum
+name: Excel.ChartErrorBarsType
+uid: 'excel!Excel.ChartErrorBarsType:enum'
+package: excel!
+fullName: Excel.ChartErrorBarsType
+summary: Represents the range type for error bars.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: custom
+ uid: 'excel!Excel.ChartErrorBarsType.custom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Custom"'
+ - name: fixedValue
+ uid: 'excel!Excel.ChartErrorBarsType.fixedValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"FixedValue"'
+ - name: percent
+ uid: 'excel!Excel.ChartErrorBarsType.percent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percent"'
+ - name: stDev
+ uid: 'excel!Excel.ChartErrorBarsType.stDev:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"StDev"'
+ - name: stError
+ uid: 'excel!Excel.ChartErrorBarsType.stError:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"StError"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartfill.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartfill.yml
new file mode 100644
index 0000000000..f818c82720
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartfill.yml
@@ -0,0 +1,134 @@
+### YamlMime:TSType
+name: Excel.ChartFill
+uid: 'excel!Excel.ChartFill:class'
+package: excel!
+fullName: Excel.ChartFill
+summary: Represents the fill formatting for a chart element.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartFill#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+methods:
+ - name: clear()
+ uid: 'excel!Excel.ChartFill#clear:member(1)'
+ package: excel!
+ fullName: clear()
+ summary: Clears the fill color of a chart element.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Clear the line format of the major gridlines on the value axis of the chart named "Chart1".
+ await Excel.run(async (context) => {
+ const gridlines = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").axes.valueAxis.majorGridlines;
+ gridlines.format.line.clear();
+ await context.sync();
+
+ console.log("Chart Major Gridlines Format Cleared");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clear(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getSolidColor()
+ uid: 'excel!Excel.ChartFill#getSolidColor:member(1)'
+ package: excel!
+ fullName: getSolidColor()
+ summary: Gets the uniform color fill formatting of a chart element.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getSolidColor(): OfficeExtension.ClientResult;'
+ return:
+ type: '<string>'
+ description: ''
+ - name: setSolidColor(color)
+ uid: 'excel!Excel.ChartFill#setSolidColor:member(1)'
+ package: excel!
+ fullName: setSolidColor(color)
+ summary: Sets the fill formatting of a chart element to a uniform color.
+ remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-point.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ let pointsCollection = sheet.charts.getItemAt(0).series.getItemAt(0).points;
+ let point = pointsCollection.getItemAt(2);
+
+ // Set color for chart point.
+ point.format.fill.setSolidColor('red');
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setSolidColor(color: string): void;'
+ parameters:
+ - id: color
+ description: >-
+ HTML color code representing the color of the background, in the form \#RRGGBB (e.g., "FFA500") or as a
+ named HTML color (e.g., "orange").
+ type: string
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartFill#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartFill object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartFillData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ toJSON(): {
+ [key: string]: string;
+ };
+ return:
+ type: |-
+ {
+ [key: string]: string;
+ }
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartfont.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartfont.yml
new file mode 100644
index 0000000000..635e94d59c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartfont.yml
@@ -0,0 +1,242 @@
+### YamlMime:TSType
+name: Excel.ChartFont
+uid: 'excel!Excel.ChartFont:class'
+package: excel!
+fullName: Excel.ChartFont
+summary: 'This object represents the font attributes (such as font name, font size, and color) for a chart object.'
+remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Set the chart title font to Calibri, size 10, bold, and the color red.
+ await Excel.run(async (context) => {
+ const title = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").title;
+ title.format.font.name = "Calibri";
+ title.format.font.size = 12;
+ title.format.font.color = "#FF0000";
+ title.format.font.italic = false;
+ title.format.font.bold = true;
+ title.format.font.underline = "None";
+ await context.sync();
+ });
+ ```
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: bold
+ uid: 'excel!Excel.ChartFont#bold:member'
+ package: excel!
+ fullName: bold
+ summary: Represents the bold status of font.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'bold: boolean;'
+ return:
+ type: boolean
+ - name: color
+ uid: 'excel!Excel.ChartFont#color:member'
+ package: excel!
+ fullName: color
+ summary: 'HTML color code representation of the text color (e.g., \#FF0000 represents Red).'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ChartFont#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: italic
+ uid: 'excel!Excel.ChartFont#italic:member'
+ package: excel!
+ fullName: italic
+ summary: Represents the italic status of the font.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'italic: boolean;'
+ return:
+ type: boolean
+ - name: name
+ uid: 'excel!Excel.ChartFont#name:member'
+ package: excel!
+ fullName: name
+ summary: 'Font name (e.g., "Calibri")'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name: string;'
+ return:
+ type: string
+ - name: size
+ uid: 'excel!Excel.ChartFont#size:member'
+ package: excel!
+ fullName: size
+ summary: 'Size of the font (e.g., 11)'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'size: number;'
+ return:
+ type: number
+ - name: underline
+ uid: 'excel!Excel.ChartFont#underline:member'
+ package: excel!
+ fullName: underline
+ summary: Type of underline applied to the font. See `Excel.ChartUnderlineStyle` for details.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'underline: Excel.ChartUnderlineStyle | "None" | "Single";'
+ return:
+ type: ' | "None" | "Single"'
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartFont#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartFontLoadOptions): Excel.ChartFont;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartFont#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartFont;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartFont#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartFont;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartFont#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartFontUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartFont#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartFont): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartFont#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartFont object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartFontData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartFontData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartformatstring.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartformatstring.yml
new file mode 100644
index 0000000000..f0711f6ded
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartformatstring.yml
@@ -0,0 +1,167 @@
+### YamlMime:TSType
+name: Excel.ChartFormatString
+uid: 'excel!Excel.ChartFormatString:class'
+package: excel!
+fullName: Excel.ChartFormatString
+summary: >-
+ Represents the substring in chart related objects that contain text, like a `ChartTitle` object or `ChartAxisTitle`
+ object.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartFormatString#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartFormatString#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Represents the font attributes, such as font name, font size, and color of a chart characters object.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartFormatString#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartFormatStringLoadOptions): Excel.ChartFormatString;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartFormatString#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartFormatString;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartFormatString#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartFormatString;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartFormatString#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartFormatStringUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartFormatString#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartFormatString): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartFormatString#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartFormatString object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartFormatStringData`) that contains shallow copies
+ of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartFormatStringData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgradientstyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgradientstyle.yml
new file mode 100644
index 0000000000..66bb60939a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgradientstyle.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ChartGradientStyle
+uid: 'excel!Excel.ChartGradientStyle:enum'
+package: excel!
+fullName: Excel.ChartGradientStyle
+summary: Represents the gradient style of a chart series. This is only applicable for region map charts.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: threePhaseColor
+ uid: 'excel!Excel.ChartGradientStyle.threePhaseColor:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThreePhaseColor"'
+ - name: twoPhaseColor
+ uid: 'excel!Excel.ChartGradientStyle.twoPhaseColor:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TwoPhaseColor"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgradientstyletype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgradientstyletype.yml
new file mode 100644
index 0000000000..748ffe5a88
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgradientstyletype.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ChartGradientStyleType
+uid: 'excel!Excel.ChartGradientStyleType:enum'
+package: excel!
+fullName: Excel.ChartGradientStyleType
+summary: Represents the gradient style type of a chart series. This is only applicable for region map charts.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: extremeValue
+ uid: 'excel!Excel.ChartGradientStyleType.extremeValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ExtremeValue"'
+ - name: number
+ uid: 'excel!Excel.ChartGradientStyleType.number:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Number"'
+ - name: percent
+ uid: 'excel!Excel.ChartGradientStyleType.percent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percent"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgridlines.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgridlines.yml
new file mode 100644
index 0000000000..2a419ca86b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgridlines.yml
@@ -0,0 +1,191 @@
+### YamlMime:TSType
+name: Excel.ChartGridlines
+uid: 'excel!Excel.ChartGridlines:class'
+package: excel!
+fullName: Excel.ChartGridlines
+summary: Represents major or minor gridlines on a chart axis.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartGridlines#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartGridlines#format:member'
+ package: excel!
+ fullName: format
+ summary: Represents the formatting of chart gridlines.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartGridlinesFormat;'
+ return:
+ type: ''
+ - name: visible
+ uid: 'excel!Excel.ChartGridlines#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Specifies if the axis gridlines are visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartGridlines#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartGridlinesLoadOptions): Excel.ChartGridlines;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartGridlines#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartGridlines;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Set the value axis of Chart1 to show the major gridlines.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.axes.valueAxis.majorGridlines.visible = true;
+ await context.sync();
+
+ console.log("Axis Gridlines Added ");
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartGridlines#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartGridlines;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartGridlines#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartGridlinesUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartGridlines#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartGridlines): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartGridlines#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartGridlines object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartGridlinesData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartGridlinesData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgridlinesformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgridlinesformat.yml
new file mode 100644
index 0000000000..a4a9daf3d6
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartgridlinesformat.yml
@@ -0,0 +1,165 @@
+### YamlMime:TSType
+name: Excel.ChartGridlinesFormat
+uid: 'excel!Excel.ChartGridlinesFormat:class'
+package: excel!
+fullName: Excel.ChartGridlinesFormat
+summary: Encapsulates the format properties for chart gridlines.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartGridlinesFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: line
+ uid: 'excel!Excel.ChartGridlinesFormat#line:member'
+ package: excel!
+ fullName: line
+ summary: Represents chart line formatting.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly line: Excel.ChartLineFormat;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartGridlinesFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartGridlinesFormatLoadOptions): Excel.ChartGridlinesFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartGridlinesFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartGridlinesFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartGridlinesFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartGridlinesFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartGridlinesFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartGridlinesFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartGridlinesFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartGridlinesFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartGridlinesFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartGridlinesFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartGridlinesFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartGridlinesFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegend.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegend.yml
new file mode 100644
index 0000000000..1c494f9343
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegend.yml
@@ -0,0 +1,290 @@
+### YamlMime:TSType
+name: Excel.ChartLegend
+uid: 'excel!Excel.ChartLegend:class'
+package: excel!
+fullName: Excel.ChartLegend
+summary: Represents the legend in a chart.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartLegend#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartLegend#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Represents the formatting of a chart legend, which includes fill and font formatting.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartLegendFormat;'
+ return:
+ type: ''
+ - name: height
+ uid: 'excel!Excel.ChartLegend#height:member'
+ package: excel!
+ fullName: height
+ summary: 'Specifies the height, in points, of the legend on the chart. Value is `null` if the legend is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'height: number;'
+ return:
+ type: number
+ - name: left
+ uid: 'excel!Excel.ChartLegend#left:member'
+ package: excel!
+ fullName: left
+ summary: 'Specifies the left value, in points, of the legend on the chart. Value is `null` if the legend is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'left: number;'
+ return:
+ type: number
+ - name: legendEntries
+ uid: 'excel!Excel.ChartLegend#legendEntries:member'
+ package: excel!
+ fullName: legendEntries
+ summary: Represents a collection of legendEntries in the legend.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly legendEntries: Excel.ChartLegendEntryCollection;'
+ return:
+ type: ''
+ - name: overlay
+ uid: 'excel!Excel.ChartLegend#overlay:member'
+ package: excel!
+ fullName: overlay
+ summary: Specifies if the chart legend should overlap with the main body of the chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'overlay: boolean;'
+ return:
+ type: boolean
+ - name: position
+ uid: 'excel!Excel.ChartLegend#position:member'
+ package: excel!
+ fullName: position
+ summary: Specifies the position of the legend on the chart. See `Excel.ChartLegendPosition` for details.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'position: Excel.ChartLegendPosition | "Invalid" | "Top" | "Bottom" | "Left" | "Right" | "Corner" | "Custom";'
+ return:
+ type: >-
+ | "Invalid" | "Top" | "Bottom" | "Left" | "Right" |
+ "Corner" | "Custom"
+ - name: showShadow
+ uid: 'excel!Excel.ChartLegend#showShadow:member'
+ package: excel!
+ fullName: showShadow
+ summary: Specifies if the legend has a shadow on the chart.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showShadow: boolean;'
+ return:
+ type: boolean
+ - name: top
+ uid: 'excel!Excel.ChartLegend#top:member'
+ package: excel!
+ fullName: top
+ summary: Specifies the top of a chart legend.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'top: number;'
+ return:
+ type: number
+ - name: visible
+ uid: 'excel!Excel.ChartLegend#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Specifies if the chart legend is visible.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+ - name: width
+ uid: 'excel!Excel.ChartLegend#width:member'
+ package: excel!
+ fullName: width
+ summary: 'Specifies the width, in points, of the legend on the chart. Value is `null` if the legend is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'width: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartLegend#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartLegendLoadOptions): Excel.ChartLegend;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartLegend#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartLegend;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Get the position of Chart Legend from Chart1.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ const legend = chart.legend;
+ legend.load('position');
+ await context.sync();
+
+ console.log(legend.position);
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartLegend#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartLegend;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartLegend#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartLegendUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartLegend#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartLegend): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartLegend#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartLegend object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartLegendData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartLegendData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendentry.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendentry.yml
new file mode 100644
index 0000000000..b31f1bbb38
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendentry.yml
@@ -0,0 +1,225 @@
+### YamlMime:TSType
+name: Excel.ChartLegendEntry
+uid: 'excel!Excel.ChartLegendEntry:class'
+package: excel!
+fullName: Excel.ChartLegendEntry
+summary: Represents the legend entry in `legendEntryCollection`.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartLegendEntry#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: height
+ uid: 'excel!Excel.ChartLegendEntry#height:member'
+ package: excel!
+ fullName: height
+ summary: Specifies the height of the legend entry on the chart legend.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly height: number;'
+ return:
+ type: number
+ - name: index
+ uid: 'excel!Excel.ChartLegendEntry#index:member'
+ package: excel!
+ fullName: index
+ summary: Specifies the index of the legend entry in the chart legend.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly index: number;'
+ return:
+ type: number
+ - name: left
+ uid: 'excel!Excel.ChartLegendEntry#left:member'
+ package: excel!
+ fullName: left
+ summary: Specifies the left value of a chart legend entry.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly left: number;'
+ return:
+ type: number
+ - name: top
+ uid: 'excel!Excel.ChartLegendEntry#top:member'
+ package: excel!
+ fullName: top
+ summary: Specifies the top of a chart legend entry.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly top: number;'
+ return:
+ type: number
+ - name: visible
+ uid: 'excel!Excel.ChartLegendEntry#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Represents the visibility of a chart legend entry.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+ - name: width
+ uid: 'excel!Excel.ChartLegendEntry#width:member'
+ package: excel!
+ fullName: width
+ summary: Represents the width of the legend entry on the chart Legend.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly width: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartLegendEntry#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartLegendEntryLoadOptions): Excel.ChartLegendEntry;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartLegendEntry#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartLegendEntry;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartLegendEntry#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartLegendEntry;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartLegendEntry#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartLegendEntryUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartLegendEntry#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartLegendEntry): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartLegendEntry#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartLegendEntry object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartLegendEntryData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartLegendEntryData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendentrycollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendentrycollection.yml
new file mode 100644
index 0000000000..473bcb6824
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendentrycollection.yml
@@ -0,0 +1,150 @@
+### YamlMime:TSType
+name: Excel.ChartLegendEntryCollection
+uid: 'excel!Excel.ChartLegendEntryCollection:class'
+package: excel!
+fullName: Excel.ChartLegendEntryCollection
+summary: Represents a collection of legend entries.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartLegendEntryCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.ChartLegendEntryCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.ChartLegendEntry[];'
+ return:
+ type: '[]'
+methods:
+ - name: getCount()
+ uid: 'excel!Excel.ChartLegendEntryCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Returns the number of legend entries in the collection.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.ChartLegendEntryCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Returns a legend entry at the given index.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.ChartLegendEntry;'
+ parameters:
+ - id: index
+ description: Index of the legend entry to be retrieved.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartLegendEntryCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ChartLegendEntryCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.ChartLegendEntryCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartLegendEntryCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartLegendEntryCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartLegendEntryCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.ChartLegendEntryCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartLegendEntryCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.ChartLegendEntryCollection` object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.ChartLegendEntryCollectionData`) that
+ contains an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartLegendEntryCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendformat.yml
new file mode 100644
index 0000000000..1cde385144
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendformat.yml
@@ -0,0 +1,219 @@
+### YamlMime:TSType
+name: Excel.ChartLegendFormat
+uid: 'excel!Excel.ChartLegendFormat:class'
+package: excel!
+fullName: Excel.ChartLegendFormat
+summary: Encapsulates the format properties of a chart legend.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartLegendFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Represents the border format, which includes color, linestyle, and weight.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartLegendFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartLegendFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: 'Represents the fill format of an object, which includes background formatting information.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartLegendFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Represents the font attributes such as font name, font size, and color of a chart legend.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-legend.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ let chart = sheet.charts.getItemAt(0);
+ chart.legend.visible = true;
+
+ // Format the legend font.
+ let font = chart.legend.format.font;
+ font.bold = true;
+ font.color = "red";
+ font.italic = true;
+ font.size = 15;
+ font.name = "Calibri";
+ font.underline = "Single";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartLegendFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartLegendFormatLoadOptions): Excel.ChartLegendFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartLegendFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartLegendFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartLegendFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartLegendFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartLegendFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartLegendFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartLegendFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartLegendFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartLegendFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartLegendFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartLegendFormatData`) that contains shallow copies
+ of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartLegendFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendposition.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendposition.yml
new file mode 100644
index 0000000000..470640e46f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlegendposition.yml
@@ -0,0 +1,45 @@
+### YamlMime:TSEnum
+name: Excel.ChartLegendPosition
+uid: 'excel!Excel.ChartLegendPosition:enum'
+package: excel!
+fullName: Excel.ChartLegendPosition
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bottom
+ uid: 'excel!Excel.ChartLegendPosition.bottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bottom"'
+ - name: corner
+ uid: 'excel!Excel.ChartLegendPosition.corner:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Corner"'
+ - name: custom
+ uid: 'excel!Excel.ChartLegendPosition.custom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Custom"'
+ - name: invalid
+ uid: 'excel!Excel.ChartLegendPosition.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: left
+ uid: 'excel!Excel.ChartLegendPosition.left:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Left"'
+ - name: right
+ uid: 'excel!Excel.ChartLegendPosition.right:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Right"'
+ - name: top
+ uid: 'excel!Excel.ChartLegendPosition.top:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Top"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlineformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlineformat.yml
new file mode 100644
index 0000000000..2f697edb3e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlineformat.yml
@@ -0,0 +1,234 @@
+### YamlMime:TSType
+name: Excel.ChartLineFormat
+uid: 'excel!Excel.ChartLineFormat:class'
+package: excel!
+fullName: Excel.ChartLineFormat
+summary: Encapsulates the formatting options for line elements.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: color
+ uid: 'excel!Excel.ChartLineFormat#color:member'
+ package: excel!
+ fullName: color
+ summary: HTML color code representing the color of lines in the chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ChartLineFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: lineStyle
+ uid: 'excel!Excel.ChartLineFormat#lineStyle:member'
+ package: excel!
+ fullName: lineStyle
+ summary: Represents the line style. See `Excel.ChartLineStyle` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ lineStyle: Excel.ChartLineStyle | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" | "Dot" | "Grey25" |
+ "Grey50" | "Grey75" | "Automatic" | "RoundDot";
+ return:
+ type: >-
+ | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" |
+ "Dot" | "Grey25" | "Grey50" | "Grey75" | "Automatic" | "RoundDot"
+ - name: weight
+ uid: 'excel!Excel.ChartLineFormat#weight:member'
+ package: excel!
+ fullName: weight
+ summary: 'Represents weight of the line, in points.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'weight: number;'
+ return:
+ type: number
+methods:
+ - name: clear()
+ uid: 'excel!Excel.ChartLineFormat#clear:member(1)'
+ package: excel!
+ fullName: clear()
+ summary: Clears the line format of a chart element.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Clear the format of the major gridlines on Chart1.
+ await Excel.run(async (context) => {
+ const gridlines = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").axes.valueAxis.majorGridlines;
+ gridlines.format.line.clear();
+ await context.sync();
+
+ console.log("Chart Major Gridlines Format Cleared");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clear(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartLineFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartLineFormatLoadOptions): Excel.ChartLineFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartLineFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartLineFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Set chart major gridlines on value axis to be red.
+ await Excel.run(async (context) => {
+ const gridlines = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").axes.valueAxis.majorGridlines;
+ gridlines.format.line.color = "#FF0000";
+ await context.sync()
+
+ console.log("Chart Gridlines Color Updated");
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartLineFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartLineFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartLineFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartLineFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartLineFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartLineFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartLineFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartLineFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartLineFormatData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartLineFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlinestyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlinestyle.yml
new file mode 100644
index 0000000000..c9c5a5d2d3
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartlinestyle.yml
@@ -0,0 +1,65 @@
+### YamlMime:TSEnum
+name: Excel.ChartLineStyle
+uid: 'excel!Excel.ChartLineStyle:enum'
+package: excel!
+fullName: Excel.ChartLineStyle
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ChartLineStyle.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: continuous
+ uid: 'excel!Excel.ChartLineStyle.continuous:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Continuous"'
+ - name: dash
+ uid: 'excel!Excel.ChartLineStyle.dash:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dash"'
+ - name: dashDot
+ uid: 'excel!Excel.ChartLineStyle.dashDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DashDot"'
+ - name: dashDotDot
+ uid: 'excel!Excel.ChartLineStyle.dashDotDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DashDotDot"'
+ - name: dot
+ uid: 'excel!Excel.ChartLineStyle.dot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dot"'
+ - name: grey25
+ uid: 'excel!Excel.ChartLineStyle.grey25:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Grey25"'
+ - name: grey50
+ uid: 'excel!Excel.ChartLineStyle.grey50:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Grey50"'
+ - name: grey75
+ uid: 'excel!Excel.ChartLineStyle.grey75:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Grey75"'
+ - name: none
+ uid: 'excel!Excel.ChartLineStyle.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: roundDot
+ uid: 'excel!Excel.ChartLineStyle.roundDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"RoundDot"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmaparealevel.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmaparealevel.yml
new file mode 100644
index 0000000000..8e0bebd802
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmaparealevel.yml
@@ -0,0 +1,50 @@
+### YamlMime:TSEnum
+name: Excel.ChartMapAreaLevel
+uid: 'excel!Excel.ChartMapAreaLevel:enum'
+package: excel!
+fullName: Excel.ChartMapAreaLevel
+summary: Represents the mapping level of a chart series. This only applies to region map charts.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ChartMapAreaLevel.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: city
+ uid: 'excel!Excel.ChartMapAreaLevel.city:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"City"'
+ - name: continent
+ uid: 'excel!Excel.ChartMapAreaLevel.continent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Continent"'
+ - name: country
+ uid: 'excel!Excel.ChartMapAreaLevel.country:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Country"'
+ - name: county
+ uid: 'excel!Excel.ChartMapAreaLevel.county:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"County"'
+ - name: dataOnly
+ uid: 'excel!Excel.ChartMapAreaLevel.dataOnly:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DataOnly"'
+ - name: state
+ uid: 'excel!Excel.ChartMapAreaLevel.state:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"State"'
+ - name: world
+ uid: 'excel!Excel.ChartMapAreaLevel.world:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"World"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmaplabelstrategy.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmaplabelstrategy.yml
new file mode 100644
index 0000000000..ec7740c1d2
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmaplabelstrategy.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ChartMapLabelStrategy
+uid: 'excel!Excel.ChartMapLabelStrategy:enum'
+package: excel!
+fullName: Excel.ChartMapLabelStrategy
+summary: Represents the region level of a chart series layout. This only applies to region map charts.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bestFit
+ uid: 'excel!Excel.ChartMapLabelStrategy.bestFit:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BestFit"'
+ - name: none
+ uid: 'excel!Excel.ChartMapLabelStrategy.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: showAll
+ uid: 'excel!Excel.ChartMapLabelStrategy.showAll:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ShowAll"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmapoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmapoptions.yml
new file mode 100644
index 0000000000..d25cd6d2d9
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmapoptions.yml
@@ -0,0 +1,195 @@
+### YamlMime:TSType
+name: Excel.ChartMapOptions
+uid: 'excel!Excel.ChartMapOptions:class'
+package: excel!
+fullName: Excel.ChartMapOptions
+summary: Encapsulates the properties for a region map chart.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartMapOptions#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: labelStrategy
+ uid: 'excel!Excel.ChartMapOptions#labelStrategy:member'
+ package: excel!
+ fullName: labelStrategy
+ summary: Specifies the series map labels strategy of a region map chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'labelStrategy: Excel.ChartMapLabelStrategy | "None" | "BestFit" | "ShowAll";'
+ return:
+ type: ' | "None" | "BestFit" | "ShowAll"'
+ - name: level
+ uid: 'excel!Excel.ChartMapOptions#level:member'
+ package: excel!
+ fullName: level
+ summary: Specifies the series mapping level of a region map chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ level: Excel.ChartMapAreaLevel | "Automatic" | "DataOnly" | "City" | "County" | "State" | "Country" |
+ "Continent" | "World";
+ return:
+ type: >-
+ | "Automatic" | "DataOnly" | "City" | "County" | "State" |
+ "Country" | "Continent" | "World"
+ - name: projectionType
+ uid: 'excel!Excel.ChartMapOptions#projectionType:member'
+ package: excel!
+ fullName: projectionType
+ summary: Specifies the series projection type of a region map chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'projectionType: Excel.ChartMapProjectionType | "Automatic" | "Mercator" | "Miller" | "Robinson" | "Albers";'
+ return:
+ type: >-
+ | "Automatic" | "Mercator" | "Miller" | "Robinson" |
+ "Albers"
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartMapOptions#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartMapOptionsLoadOptions): Excel.ChartMapOptions;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartMapOptions#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartMapOptions;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartMapOptions#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartMapOptions;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartMapOptions#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartMapOptionsUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartMapOptions#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartMapOptions): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartMapOptions#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartMapOptions object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartMapOptionsData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartMapOptionsData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmapprojectiontype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmapprojectiontype.yml
new file mode 100644
index 0000000000..330a9ce19c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmapprojectiontype.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSEnum
+name: Excel.ChartMapProjectionType
+uid: 'excel!Excel.ChartMapProjectionType:enum'
+package: excel!
+fullName: Excel.ChartMapProjectionType
+summary: Represents the region projection type of a chart series layout. This only applies to region map charts.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: albers
+ uid: 'excel!Excel.ChartMapProjectionType.albers:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Albers"'
+ - name: automatic
+ uid: 'excel!Excel.ChartMapProjectionType.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: mercator
+ uid: 'excel!Excel.ChartMapProjectionType.mercator:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Mercator"'
+ - name: miller
+ uid: 'excel!Excel.ChartMapProjectionType.miller:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Miller"'
+ - name: robinson
+ uid: 'excel!Excel.ChartMapProjectionType.robinson:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Robinson"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmarkerstyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmarkerstyle.yml
new file mode 100644
index 0000000000..90f90a26ef
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartmarkerstyle.yml
@@ -0,0 +1,75 @@
+### YamlMime:TSEnum
+name: Excel.ChartMarkerStyle
+uid: 'excel!Excel.ChartMarkerStyle:enum'
+package: excel!
+fullName: Excel.ChartMarkerStyle
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ChartMarkerStyle.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: circle
+ uid: 'excel!Excel.ChartMarkerStyle.circle:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Circle"'
+ - name: dash
+ uid: 'excel!Excel.ChartMarkerStyle.dash:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dash"'
+ - name: diamond
+ uid: 'excel!Excel.ChartMarkerStyle.diamond:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Diamond"'
+ - name: dot
+ uid: 'excel!Excel.ChartMarkerStyle.dot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dot"'
+ - name: invalid
+ uid: 'excel!Excel.ChartMarkerStyle.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: none
+ uid: 'excel!Excel.ChartMarkerStyle.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: picture
+ uid: 'excel!Excel.ChartMarkerStyle.picture:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Picture"'
+ - name: plus
+ uid: 'excel!Excel.ChartMarkerStyle.plus:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Plus"'
+ - name: square
+ uid: 'excel!Excel.ChartMarkerStyle.square:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Square"'
+ - name: star
+ uid: 'excel!Excel.ChartMarkerStyle.star:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Star"'
+ - name: triangle
+ uid: 'excel!Excel.ChartMarkerStyle.triangle:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Triangle"'
+ - name: x
+ uid: 'excel!Excel.ChartMarkerStyle.x:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"X"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartparentlabelstrategy.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartparentlabelstrategy.yml
new file mode 100644
index 0000000000..b3f7077759
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartparentlabelstrategy.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ChartParentLabelStrategy
+uid: 'excel!Excel.ChartParentLabelStrategy:enum'
+package: excel!
+fullName: Excel.ChartParentLabelStrategy
+summary: Represents the parent label strategy of the chart series layout. This only applies to treemap charts
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: banner
+ uid: 'excel!Excel.ChartParentLabelStrategy.banner:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Banner"'
+ - name: none
+ uid: 'excel!Excel.ChartParentLabelStrategy.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: overlapping
+ uid: 'excel!Excel.ChartParentLabelStrategy.overlapping:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Overlapping"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpivotoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpivotoptions.yml
new file mode 100644
index 0000000000..24c7de6254
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpivotoptions.yml
@@ -0,0 +1,204 @@
+### YamlMime:TSType
+name: Excel.ChartPivotOptions
+uid: 'excel!Excel.ChartPivotOptions:class'
+package: excel!
+fullName: Excel.ChartPivotOptions
+summary: Encapsulates the options for the pivot chart.
+remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartPivotOptions#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: showAxisFieldButtons
+ uid: 'excel!Excel.ChartPivotOptions#showAxisFieldButtons:member'
+ package: excel!
+ fullName: showAxisFieldButtons
+ summary: >-
+ Specifies whether to display the axis field buttons on a PivotChart. The `showAxisFieldButtons` property
+ corresponds to the "Show Axis Field Buttons" command on the "Field Buttons" drop-down list of the "Analyze" tab,
+ which is available when a PivotChart is selected.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showAxisFieldButtons: boolean;'
+ return:
+ type: boolean
+ - name: showLegendFieldButtons
+ uid: 'excel!Excel.ChartPivotOptions#showLegendFieldButtons:member'
+ package: excel!
+ fullName: showLegendFieldButtons
+ summary: Specifies whether to display the legend field buttons on a PivotChart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showLegendFieldButtons: boolean;'
+ return:
+ type: boolean
+ - name: showReportFilterFieldButtons
+ uid: 'excel!Excel.ChartPivotOptions#showReportFilterFieldButtons:member'
+ package: excel!
+ fullName: showReportFilterFieldButtons
+ summary: Specifies whether to display the report filter field buttons on a PivotChart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showReportFilterFieldButtons: boolean;'
+ return:
+ type: boolean
+ - name: showValueFieldButtons
+ uid: 'excel!Excel.ChartPivotOptions#showValueFieldButtons:member'
+ package: excel!
+ fullName: showValueFieldButtons
+ summary: Specifies whether to display the show value field buttons on a PivotChart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showValueFieldButtons: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartPivotOptions#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartPivotOptionsLoadOptions): Excel.ChartPivotOptions;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartPivotOptions#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartPivotOptions;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartPivotOptions#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartPivotOptions;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartPivotOptions#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartPivotOptionsUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartPivotOptions#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartPivotOptions): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartPivotOptions#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartPivotOptions object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartPivotOptionsData`) that contains shallow copies
+ of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartPivotOptionsData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotarea.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotarea.yml
new file mode 100644
index 0000000000..9662baa78a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotarea.yml
@@ -0,0 +1,273 @@
+### YamlMime:TSType
+name: Excel.ChartPlotArea
+uid: 'excel!Excel.ChartPlotArea:class'
+package: excel!
+fullName: Excel.ChartPlotArea
+summary: This object represents the attributes for a chart plot area.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartPlotArea#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartPlotArea#format:member'
+ package: excel!
+ fullName: format
+ summary: Specifies the formatting of a chart plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartPlotAreaFormat;'
+ return:
+ type: ''
+ - name: height
+ uid: 'excel!Excel.ChartPlotArea#height:member'
+ package: excel!
+ fullName: height
+ summary: Specifies the height value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'height: number;'
+ return:
+ type: number
+ - name: insideHeight
+ uid: 'excel!Excel.ChartPlotArea#insideHeight:member'
+ package: excel!
+ fullName: insideHeight
+ summary: Specifies the inside height value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'insideHeight: number;'
+ return:
+ type: number
+ - name: insideLeft
+ uid: 'excel!Excel.ChartPlotArea#insideLeft:member'
+ package: excel!
+ fullName: insideLeft
+ summary: Specifies the inside left value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'insideLeft: number;'
+ return:
+ type: number
+ - name: insideTop
+ uid: 'excel!Excel.ChartPlotArea#insideTop:member'
+ package: excel!
+ fullName: insideTop
+ summary: Specifies the inside top value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'insideTop: number;'
+ return:
+ type: number
+ - name: insideWidth
+ uid: 'excel!Excel.ChartPlotArea#insideWidth:member'
+ package: excel!
+ fullName: insideWidth
+ summary: Specifies the inside width value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'insideWidth: number;'
+ return:
+ type: number
+ - name: left
+ uid: 'excel!Excel.ChartPlotArea#left:member'
+ package: excel!
+ fullName: left
+ summary: Specifies the left value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'left: number;'
+ return:
+ type: number
+ - name: position
+ uid: 'excel!Excel.ChartPlotArea#position:member'
+ package: excel!
+ fullName: position
+ summary: Specifies the position of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'position: Excel.ChartPlotAreaPosition | "Automatic" | "Custom";'
+ return:
+ type: ' | "Automatic" | "Custom"'
+ - name: top
+ uid: 'excel!Excel.ChartPlotArea#top:member'
+ package: excel!
+ fullName: top
+ summary: Specifies the top value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'top: number;'
+ return:
+ type: number
+ - name: width
+ uid: 'excel!Excel.ChartPlotArea#width:member'
+ package: excel!
+ fullName: width
+ summary: Specifies the width value of a plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'width: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartPlotArea#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartPlotAreaLoadOptions): Excel.ChartPlotArea;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartPlotArea#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartPlotArea;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartPlotArea#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartPlotArea;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartPlotArea#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartPlotAreaUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartPlotArea#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartPlotArea): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartPlotArea#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartPlotArea object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartPlotAreaData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartPlotAreaData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotareaformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotareaformat.yml
new file mode 100644
index 0000000000..56d45fe77a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotareaformat.yml
@@ -0,0 +1,177 @@
+### YamlMime:TSType
+name: Excel.ChartPlotAreaFormat
+uid: 'excel!Excel.ChartPlotAreaFormat:class'
+package: excel!
+fullName: Excel.ChartPlotAreaFormat
+summary: Represents the format properties for a chart plot area.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartPlotAreaFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: Specifies the border attributes of a chart plot area.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartPlotAreaFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartPlotAreaFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: 'Specifies the fill format of an object, which includes background formatting information.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartPlotAreaFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartPlotAreaFormatLoadOptions): Excel.ChartPlotAreaFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartPlotAreaFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartPlotAreaFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartPlotAreaFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartPlotAreaFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartPlotAreaFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartPlotAreaFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartPlotAreaFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartPlotAreaFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartPlotAreaFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartPlotAreaFormat object is an API object, the `toJSON` method returns
+ a plain JavaScript object (typed as `Excel.Interfaces.ChartPlotAreaFormatData`) that contains shallow
+ copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartPlotAreaFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotareaposition.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotareaposition.yml
new file mode 100644
index 0000000000..b2fa43a943
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotareaposition.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ChartPlotAreaPosition
+uid: 'excel!Excel.ChartPlotAreaPosition:enum'
+package: excel!
+fullName: Excel.ChartPlotAreaPosition
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ChartPlotAreaPosition.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: custom
+ uid: 'excel!Excel.ChartPlotAreaPosition.custom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Custom"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotby.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotby.yml
new file mode 100644
index 0000000000..8183ab5f16
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartplotby.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ChartPlotBy
+uid: 'excel!Excel.ChartPlotBy:enum'
+package: excel!
+fullName: Excel.ChartPlotBy
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: columns
+ uid: 'excel!Excel.ChartPlotBy.columns:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Columns"'
+ - name: rows
+ uid: 'excel!Excel.ChartPlotBy.rows:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Rows"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpoint.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpoint.yml
new file mode 100644
index 0000000000..51f1158397
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpoint.yml
@@ -0,0 +1,253 @@
+### YamlMime:TSType
+name: Excel.ChartPoint
+uid: 'excel!Excel.ChartPoint:class'
+package: excel!
+fullName: Excel.ChartPoint
+summary: Represents a point of a series in a chart.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartPoint#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: dataLabel
+ uid: 'excel!Excel.ChartPoint#dataLabel:member'
+ package: excel!
+ fullName: dataLabel
+ summary: Returns the data label of a chart point.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly dataLabel: Excel.ChartDataLabel;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartPoint#format:member'
+ package: excel!
+ fullName: format
+ summary: Encapsulates the format properties chart point.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartPointFormat;'
+ return:
+ type: ''
+ - name: hasDataLabel
+ uid: 'excel!Excel.ChartPoint#hasDataLabel:member'
+ package: excel!
+ fullName: hasDataLabel
+ summary: Represents whether a data point has a data label. Not applicable for surface charts.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'hasDataLabel: boolean;'
+ return:
+ type: boolean
+ - name: markerBackgroundColor
+ uid: 'excel!Excel.ChartPoint#markerBackgroundColor:member'
+ package: excel!
+ fullName: markerBackgroundColor
+ summary: 'HTML color code representation of the marker background color of a data point (e.g., \#FF0000 represents Red).'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'markerBackgroundColor: string;'
+ return:
+ type: string
+ - name: markerForegroundColor
+ uid: 'excel!Excel.ChartPoint#markerForegroundColor:member'
+ package: excel!
+ fullName: markerForegroundColor
+ summary: 'HTML color code representation of the marker foreground color of a data point (e.g., \#FF0000 represents Red).'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'markerForegroundColor: string;'
+ return:
+ type: string
+ - name: markerSize
+ uid: 'excel!Excel.ChartPoint#markerSize:member'
+ package: excel!
+ fullName: markerSize
+ summary: Represents marker size of a data point.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'markerSize: number;'
+ return:
+ type: number
+ - name: markerStyle
+ uid: 'excel!Excel.ChartPoint#markerStyle:member'
+ package: excel!
+ fullName: markerStyle
+ summary: Represents marker style of a chart data point. See `Excel.ChartMarkerStyle` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ markerStyle: Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X"
+ | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture";
+ return:
+ type: >-
+ | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" |
+ "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture"
+ - name: value
+ uid: 'excel!Excel.ChartPoint#value:member'
+ package: excel!
+ fullName: value
+ summary: Returns the value of a chart point.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly value: any;'
+ return:
+ type: any
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartPoint#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartPointLoadOptions): Excel.ChartPoint;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartPoint#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartPoint;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartPoint#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartPoint;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartPoint#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartPointUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartPoint#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartPoint): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartPoint#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartPoint object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartPointData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartPointData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpointformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpointformat.yml
new file mode 100644
index 0000000000..22d3923c31
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpointformat.yml
@@ -0,0 +1,177 @@
+### YamlMime:TSType
+name: Excel.ChartPointFormat
+uid: 'excel!Excel.ChartPointFormat:class'
+package: excel!
+fullName: Excel.ChartPointFormat
+summary: Represents the formatting object for chart points.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartPointFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Represents the border format of a chart data point, which includes color, style, and weight information.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartPointFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartPointFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: 'Represents the fill format of a chart, which includes background formatting information.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartPointFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartPointFormatLoadOptions): Excel.ChartPointFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartPointFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartPointFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartPointFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartPointFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartPointFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartPointFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartPointFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartPointFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartPointFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartPointFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartPointFormatData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartPointFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpointscollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpointscollection.yml
new file mode 100644
index 0000000000..70aab9c180
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartpointscollection.yml
@@ -0,0 +1,190 @@
+### YamlMime:TSType
+name: Excel.ChartPointsCollection
+uid: 'excel!Excel.ChartPointsCollection:class'
+package: excel!
+fullName: Excel.ChartPointsCollection
+summary: A collection of all the chart points within a series inside a chart.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartPointsCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: count
+ uid: 'excel!Excel.ChartPointsCollection#count:member'
+ package: excel!
+ fullName: count
+ summary: Returns the number of chart points in the series.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly count: number;'
+ return:
+ type: number
+ - name: items
+ uid: 'excel!Excel.ChartPointsCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.ChartPoint[];'
+ return:
+ type: '[]'
+methods:
+ - name: getCount()
+ uid: 'excel!Excel.ChartPointsCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Returns the number of chart points in the series.
+ remarks: '\[ [API set: ExcelApi 1.4](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.ChartPointsCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Retrieve a point based on its position within the series.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Set the border color for the first points in the points collection.
+ await Excel.run(async (context) => {
+ const points = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").series.getItemAt(0).points;
+ points.getItemAt(0).format.fill.setSolidColor("8FBC8F");
+ await context.sync();
+
+ console.log("Point Border Color Changed");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.ChartPoint;'
+ parameters:
+ - id: index
+ description: Index value of the object to be retrieved. Zero-indexed.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartPointsCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ChartPointsCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.ChartPointsCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartPointsCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartPointsCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Get the number of points.
+ await Excel.run(async (context) => {
+ const pointsCollection =
+ context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").series.getItemAt(0).points;
+ pointsCollection.load('count');
+ await context.sync();
+ console.log("points: Count= " + pointsCollection.count);
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartPointsCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.ChartPointsCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartPointsCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.ChartPointsCollection` object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartPointsCollectionData`) that contains an
+ "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartPointsCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseries.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseries.yml
new file mode 100644
index 0000000000..4086ccc907
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseries.yml
@@ -0,0 +1,1327 @@
+### YamlMime:TSType
+name: Excel.ChartSeries
+uid: 'excel!Excel.ChartSeries:class'
+package: excel!
+fullName: Excel.ChartSeries
+summary: Represents a series in a chart.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: axisGroup
+ uid: 'excel!Excel.ChartSeries#axisGroup:member'
+ package: excel!
+ fullName: axisGroup
+ summary: Specifies the group for the specified series.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";'
+ return:
+ type: ' | "Primary" | "Secondary"'
+ - name: binOptions
+ uid: 'excel!Excel.ChartSeries#binOptions:member'
+ package: excel!
+ fullName: binOptions
+ summary: Encapsulates the bin options for histogram charts and pareto charts.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly binOptions: Excel.ChartBinOptions;'
+ return:
+ type: ''
+ - name: boxwhiskerOptions
+ uid: 'excel!Excel.ChartSeries#boxwhiskerOptions:member'
+ package: excel!
+ fullName: boxwhiskerOptions
+ summary: Encapsulates the options for the box and whisker charts.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly boxwhiskerOptions: Excel.ChartBoxwhiskerOptions;'
+ return:
+ type: ''
+ - name: bubbleScale
+ uid: 'excel!Excel.ChartSeries#bubbleScale:member'
+ package: excel!
+ fullName: bubbleScale
+ summary: >-
+ This can be an integer value from 0 (zero) to 300, representing the percentage of the default size. This property
+ only applies to bubble charts.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'bubbleScale: number;'
+ return:
+ type: number
+ - name: chartType
+ uid: 'excel!Excel.ChartSeries#chartType:member'
+ package: excel!
+ fullName: chartType
+ summary: Represents the chart type of a series. See `Excel.ChartType` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ chartType: Excel.ChartType | "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" |
+ "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100"
+ | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" |
+ "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" |
+ "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" |
+ "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" |
+ "Surface" | "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" |
+ "StockHLC" | "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" |
+ "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" |
+ "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" |
+ "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" |
+ "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" |
+ "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" |
+ "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel";
+ return:
+ type: >-
+ | "Invalid" | "ColumnClustered" | "ColumnStacked" |
+ "ColumnStacked100" | "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" |
+ "BarStacked" | "BarStacked100" | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" |
+ "LineStacked100" | "LineMarkers" | "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded"
+ | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" |
+ "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" |
+ "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" |
+ "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" |
+ "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" |
+ "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered" |
+ "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" |
+ "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" |
+ "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie"
+ | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap"
+ | "Treemap" | "Waterfall" | "Sunburst" | "Funnel"
+ - name: context
+ uid: 'excel!Excel.ChartSeries#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: dataLabels
+ uid: 'excel!Excel.ChartSeries#dataLabels:member'
+ package: excel!
+ fullName: dataLabels
+ summary: Represents a collection of all data labels in the series.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly dataLabels: Excel.ChartDataLabels;'
+ return:
+ type: ''
+ - name: doughnutHoleSize
+ uid: 'excel!Excel.ChartSeries#doughnutHoleSize:member'
+ package: excel!
+ fullName: doughnutHoleSize
+ summary: >-
+ Represents the doughnut hole size of a chart series. Only valid on doughnut and doughnut exploded charts. Throws
+ an `InvalidArgument` error on invalid charts.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'doughnutHoleSize: number;'
+ return:
+ type: number
+ - name: explosion
+ uid: 'excel!Excel.ChartSeries#explosion:member'
+ package: excel!
+ fullName: explosion
+ summary: >-
+ Specifies the explosion value for a pie-chart or doughnut-chart slice. Returns 0 (zero) if there's no explosion
+ (the tip of the slice is in the center of the pie).
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'explosion: number;'
+ return:
+ type: number
+ - name: filtered
+ uid: 'excel!Excel.ChartSeries#filtered:member'
+ package: excel!
+ fullName: filtered
+ summary: Specifies if the series is filtered. Not applicable for surface charts.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'filtered: boolean;'
+ return:
+ type: boolean
+ - name: firstSliceAngle
+ uid: 'excel!Excel.ChartSeries#firstSliceAngle:member'
+ package: excel!
+ fullName: firstSliceAngle
+ summary: >-
+ Specifies the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). Applies
+ only to pie, 3-D pie, and doughnut charts. Can be a value from 0 through 360.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'firstSliceAngle: number;'
+ return:
+ type: number
+ - name: format
+ uid: 'excel!Excel.ChartSeries#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Represents the formatting of a chart series, which includes fill and line formatting.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartSeriesFormat;'
+ return:
+ type: ''
+ - name: gapWidth
+ uid: 'excel!Excel.ChartSeries#gapWidth:member'
+ package: excel!
+ fullName: gapWidth
+ summary: >-
+ Represents the gap width of a chart series. Only valid on bar and column charts, as well as specific classes of
+ line and pie charts. Throws an invalid argument exception on invalid charts.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gapWidth: number;'
+ return:
+ type: number
+ - name: gradientMaximumColor
+ uid: 'excel!Excel.ChartSeries#gradientMaximumColor:member'
+ package: excel!
+ fullName: gradientMaximumColor
+ summary: Specifies the color for maximum value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMaximumColor: string;'
+ return:
+ type: string
+ - name: gradientMaximumType
+ uid: 'excel!Excel.ChartSeries#gradientMaximumType:member'
+ package: excel!
+ fullName: gradientMaximumType
+ summary: Specifies the type for maximum value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMaximumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";'
+ return:
+ type: ' | "ExtremeValue" | "Number" | "Percent"'
+ - name: gradientMaximumValue
+ uid: 'excel!Excel.ChartSeries#gradientMaximumValue:member'
+ package: excel!
+ fullName: gradientMaximumValue
+ summary: Specifies the maximum value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMaximumValue: number;'
+ return:
+ type: number
+ - name: gradientMidpointColor
+ uid: 'excel!Excel.ChartSeries#gradientMidpointColor:member'
+ package: excel!
+ fullName: gradientMidpointColor
+ summary: Specifies the color for the midpoint value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMidpointColor: string;'
+ return:
+ type: string
+ - name: gradientMidpointType
+ uid: 'excel!Excel.ChartSeries#gradientMidpointType:member'
+ package: excel!
+ fullName: gradientMidpointType
+ summary: Specifies the type for the midpoint value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMidpointType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";'
+ return:
+ type: ' | "ExtremeValue" | "Number" | "Percent"'
+ - name: gradientMidpointValue
+ uid: 'excel!Excel.ChartSeries#gradientMidpointValue:member'
+ package: excel!
+ fullName: gradientMidpointValue
+ summary: Specifies the midpoint value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMidpointValue: number;'
+ return:
+ type: number
+ - name: gradientMinimumColor
+ uid: 'excel!Excel.ChartSeries#gradientMinimumColor:member'
+ package: excel!
+ fullName: gradientMinimumColor
+ summary: Specifies the color for the minimum value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMinimumColor: string;'
+ return:
+ type: string
+ - name: gradientMinimumType
+ uid: 'excel!Excel.ChartSeries#gradientMinimumType:member'
+ package: excel!
+ fullName: gradientMinimumType
+ summary: Specifies the type for the minimum value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMinimumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";'
+ return:
+ type: ' | "ExtremeValue" | "Number" | "Percent"'
+ - name: gradientMinimumValue
+ uid: 'excel!Excel.ChartSeries#gradientMinimumValue:member'
+ package: excel!
+ fullName: gradientMinimumValue
+ summary: Specifies the minimum value of a region map chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientMinimumValue: number;'
+ return:
+ type: number
+ - name: gradientStyle
+ uid: 'excel!Excel.ChartSeries#gradientStyle:member'
+ package: excel!
+ fullName: gradientStyle
+ summary: Specifies the series gradient style of a region map chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientStyle: Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor";'
+ return:
+ type: ' | "TwoPhaseColor" | "ThreePhaseColor"'
+ - name: hasDataLabels
+ uid: 'excel!Excel.ChartSeries#hasDataLabels:member'
+ package: excel!
+ fullName: hasDataLabels
+ summary: Specifies if the series has data labels.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'hasDataLabels: boolean;'
+ return:
+ type: boolean
+ - name: invertColor
+ uid: 'excel!Excel.ChartSeries#invertColor:member'
+ package: excel!
+ fullName: invertColor
+ summary: Specifies the fill color for negative data points in a series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'invertColor: string;'
+ return:
+ type: string
+ - name: invertIfNegative
+ uid: 'excel!Excel.ChartSeries#invertIfNegative:member'
+ package: excel!
+ fullName: invertIfNegative
+ summary: True if Excel inverts the pattern in the item when it corresponds to a negative number.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'invertIfNegative: boolean;'
+ return:
+ type: boolean
+ - name: mapOptions
+ uid: 'excel!Excel.ChartSeries#mapOptions:member'
+ package: excel!
+ fullName: mapOptions
+ summary: Encapsulates the options for a region map chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly mapOptions: Excel.ChartMapOptions;'
+ return:
+ type: ''
+ - name: markerBackgroundColor
+ uid: 'excel!Excel.ChartSeries#markerBackgroundColor:member'
+ package: excel!
+ fullName: markerBackgroundColor
+ summary: Specifies the marker background color of a chart series.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
+
+ await Excel.run(async (context) => {
+ let sheet = context.workbook.worksheets.getItem("Sample");
+ let salesTable = sheet.tables.getItem("SalesTable");
+ let dataRange = sheet.getRange("A1:E7");
+
+ // Create an XY scatter chart.
+ let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
+ chart.title.text = "Bicycle Parts Quarterly Sales";
+
+ let series = chart.series;
+ let series0 = series.getItemAt(0);
+ let series1 = series.getItemAt(1);
+ let series2 = series.getItemAt(2);
+ let series3 = series.getItemAt(3);
+
+ // Set markers.
+ series0.markerStyle = "Dash";
+ series0.markerForegroundColor = "black";
+ series1.markerStyle = "Star";
+ series1.markerForegroundColor = "black";
+ series2.markerStyle = "X";
+ series2.markerSize = 12;
+ series3.markerStyle = "Triangle";
+ series3.markerBackgroundColor = "purple";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'markerBackgroundColor: string;'
+ return:
+ type: string
+ - name: markerForegroundColor
+ uid: 'excel!Excel.ChartSeries#markerForegroundColor:member'
+ package: excel!
+ fullName: markerForegroundColor
+ summary: Specifies the marker foreground color of a chart series.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
+
+ await Excel.run(async (context) => {
+ let sheet = context.workbook.worksheets.getItem("Sample");
+ let salesTable = sheet.tables.getItem("SalesTable");
+ let dataRange = sheet.getRange("A1:E7");
+
+ // Create an XY scatter chart.
+ let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
+ chart.title.text = "Bicycle Parts Quarterly Sales";
+
+ let series = chart.series;
+ let series0 = series.getItemAt(0);
+ let series1 = series.getItemAt(1);
+ let series2 = series.getItemAt(2);
+ let series3 = series.getItemAt(3);
+
+ // Set markers.
+ series0.markerStyle = "Dash";
+ series0.markerForegroundColor = "black";
+ series1.markerStyle = "Star";
+ series1.markerForegroundColor = "black";
+ series2.markerStyle = "X";
+ series2.markerSize = 12;
+ series3.markerStyle = "Triangle";
+ series3.markerBackgroundColor = "purple";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'markerForegroundColor: string;'
+ return:
+ type: string
+ - name: markerSize
+ uid: 'excel!Excel.ChartSeries#markerSize:member'
+ package: excel!
+ fullName: markerSize
+ summary: Specifies the marker size of a chart series.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
+
+ await Excel.run(async (context) => {
+ let sheet = context.workbook.worksheets.getItem("Sample");
+ let salesTable = sheet.tables.getItem("SalesTable");
+ let dataRange = sheet.getRange("A1:E7");
+
+ // Create an XY scatter chart.
+ let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
+ chart.title.text = "Bicycle Parts Quarterly Sales";
+
+ let series = chart.series;
+ let series0 = series.getItemAt(0);
+ let series1 = series.getItemAt(1);
+ let series2 = series.getItemAt(2);
+ let series3 = series.getItemAt(3);
+
+ // Set markers.
+ series0.markerStyle = "Dash";
+ series0.markerForegroundColor = "black";
+ series1.markerStyle = "Star";
+ series1.markerForegroundColor = "black";
+ series2.markerStyle = "X";
+ series2.markerSize = 12;
+ series3.markerStyle = "Triangle";
+ series3.markerBackgroundColor = "purple";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'markerSize: number;'
+ return:
+ type: number
+ - name: markerStyle
+ uid: 'excel!Excel.ChartSeries#markerStyle:member'
+ package: excel!
+ fullName: markerStyle
+ summary: Specifies the marker style of a chart series. See `Excel.ChartMarkerStyle` for details.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
+
+ await Excel.run(async (context) => {
+ let sheet = context.workbook.worksheets.getItem("Sample");
+ let salesTable = sheet.tables.getItem("SalesTable");
+ let dataRange = sheet.getRange("A1:E7");
+
+ // Create an XY scatter chart.
+ let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
+ chart.title.text = "Bicycle Parts Quarterly Sales";
+
+ let series = chart.series;
+ let series0 = series.getItemAt(0);
+ let series1 = series.getItemAt(1);
+ let series2 = series.getItemAt(2);
+ let series3 = series.getItemAt(3);
+
+ // Set markers.
+ series0.markerStyle = "Dash";
+ series0.markerForegroundColor = "black";
+ series1.markerStyle = "Star";
+ series1.markerForegroundColor = "black";
+ series2.markerStyle = "X";
+ series2.markerSize = 12;
+ series3.markerStyle = "Triangle";
+ series3.markerBackgroundColor = "purple";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ markerStyle: Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X"
+ | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture";
+ return:
+ type: >-
+ | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" |
+ "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture"
+ - name: name
+ uid: 'excel!Excel.ChartSeries#name:member'
+ package: excel!
+ fullName: name
+ summary: Specifies the name of a series in a chart. The name's length should not be greater than 255 characters.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name: string;'
+ return:
+ type: string
+ - name: overlap
+ uid: 'excel!Excel.ChartSeries#overlap:member'
+ package: excel!
+ fullName: overlap
+ summary: >-
+ Specifies how bars and columns are positioned. Can be a value between –100 and 100. Applies only to 2-D bar and
+ 2-D column charts.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'overlap: number;'
+ return:
+ type: number
+ - name: parentLabelStrategy
+ uid: 'excel!Excel.ChartSeries#parentLabelStrategy:member'
+ package: excel!
+ fullName: parentLabelStrategy
+ summary: Specifies the series parent label strategy area for a treemap chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'parentLabelStrategy: Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping";'
+ return:
+ type: ' | "None" | "Banner" | "Overlapping"'
+ - name: plotOrder
+ uid: 'excel!Excel.ChartSeries#plotOrder:member'
+ package: excel!
+ fullName: plotOrder
+ summary: Specifies the plot order of a chart series within the chart group.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'plotOrder: number;'
+ return:
+ type: number
+ - name: points
+ uid: 'excel!Excel.ChartSeries#points:member'
+ package: excel!
+ fullName: points
+ summary: Returns a collection of all points in the series.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly points: Excel.ChartPointsCollection;'
+ return:
+ type: ''
+ - name: secondPlotSize
+ uid: 'excel!Excel.ChartSeries#secondPlotSize:member'
+ package: excel!
+ fullName: secondPlotSize
+ summary: >-
+ Specifies the size of the secondary section of either a pie-of-pie chart or a bar-of-pie chart, as a percentage of
+ the size of the primary pie. Can be a value from 5 to 200.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'secondPlotSize: number;'
+ return:
+ type: number
+ - name: showConnectorLines
+ uid: 'excel!Excel.ChartSeries#showConnectorLines:member'
+ package: excel!
+ fullName: showConnectorLines
+ summary: Specifies whether connector lines are shown in waterfall charts.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showConnectorLines: boolean;'
+ return:
+ type: boolean
+ - name: showLeaderLines
+ uid: 'excel!Excel.ChartSeries#showLeaderLines:member'
+ package: excel!
+ fullName: showLeaderLines
+ summary: Specifies whether leader lines are displayed for each data label in the series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showLeaderLines: boolean;'
+ return:
+ type: boolean
+ - name: showShadow
+ uid: 'excel!Excel.ChartSeries#showShadow:member'
+ package: excel!
+ fullName: showShadow
+ summary: Specifies if the series has a shadow.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showShadow: boolean;'
+ return:
+ type: boolean
+ - name: smooth
+ uid: 'excel!Excel.ChartSeries#smooth:member'
+ package: excel!
+ fullName: smooth
+ summary: Specifies if the series is smooth. Only applicable to line and scatter charts.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'smooth: boolean;'
+ return:
+ type: boolean
+ - name: splitType
+ uid: 'excel!Excel.ChartSeries#splitType:member'
+ package: excel!
+ fullName: splitType
+ summary: Specifies the way the two sections of either a pie-of-pie chart or a bar-of-pie chart are split.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ splitType: Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" |
+ "SplitByCustomSplit";
+ return:
+ type: >-
+ | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" |
+ "SplitByCustomSplit"
+ - name: splitValue
+ uid: 'excel!Excel.ChartSeries#splitValue:member'
+ package: excel!
+ fullName: splitValue
+ summary: Specifies the threshold value that separates two sections of either a pie-of-pie chart or a bar-of-pie chart.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'splitValue: number;'
+ return:
+ type: number
+ - name: trendlines
+ uid: 'excel!Excel.ChartSeries#trendlines:member'
+ package: excel!
+ fullName: trendlines
+ summary: The collection of trendlines in the series.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly trendlines: Excel.ChartTrendlineCollection;'
+ return:
+ type: ''
+ - name: varyByCategories
+ uid: 'excel!Excel.ChartSeries#varyByCategories:member'
+ package: excel!
+ fullName: varyByCategories
+ summary: True if Excel assigns a different color or pattern to each data marker. The chart must contain only one series.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'varyByCategories: boolean;'
+ return:
+ type: boolean
+ - name: xErrorBars
+ uid: 'excel!Excel.ChartSeries#xErrorBars:member'
+ package: excel!
+ fullName: xErrorBars
+ summary: Represents the error bar object of a chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly xErrorBars: Excel.ChartErrorBars;'
+ return:
+ type: ''
+ - name: yErrorBars
+ uid: 'excel!Excel.ChartSeries#yErrorBars:member'
+ package: excel!
+ fullName: yErrorBars
+ summary: Represents the error bar object of a chart series.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly yErrorBars: Excel.ChartErrorBars;'
+ return:
+ type: ''
+methods:
+ - name: delete()
+ uid: 'excel!Excel.ChartSeries#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes the chart series.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const seriesCollection = sheet.charts.getItemAt(0).series;
+ seriesCollection.load("count");
+ await context.sync();
+
+ if (seriesCollection.count > 0) {
+ const series = seriesCollection.getItemAt(0);
+
+ // Delete the first series.
+ series.delete();
+ }
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getDimensionDataSourceString(dimension)
+ uid: 'excel!Excel.ChartSeries#getDimensionDataSourceString:member(1)'
+ package: excel!
+ fullName: getDimensionDataSourceString(dimension)
+ summary: >-
+ Gets the string representation of the data source of the chart series. The string representation could be
+ information such as a cell address.
+ remarks: >-
+ \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-source.yaml
+
+ // This function retrieves the data source information of a chart series in the Sample worksheet.
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ // Get the first chart series from the first chart on the worksheet.
+ const seriesCollection = sheet.charts.getItemAt(0).series;
+ const series = seriesCollection.getItemAt(0);
+
+ // Get the series data source string and type values.
+ const dataSourceString = series.getDimensionDataSourceString("Values");
+ const dataSourceType = series.getDimensionDataSourceType("Values");
+
+ series.load("name");
+ await context.sync();
+
+ // Log the data source information to the console.
+ console.log(series.name + " data source string: " + dataSourceString.value);
+ console.log(series.name + " data source type: " + dataSourceType.value);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getDimensionDataSourceString(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult;'
+ parameters:
+ - id: dimension
+ description: The dimension of the axis where the data is from.
+ type: ''
+ return:
+ type: '<string>'
+ description: ''
+ - name: getDimensionDataSourceString(dimensionString)
+ uid: 'excel!Excel.ChartSeries#getDimensionDataSourceString:member(2)'
+ package: excel!
+ fullName: getDimensionDataSourceString(dimensionString)
+ summary: >-
+ Gets the string representation of the data source of the chart series. The string representation could be
+ information such as a cell address.
+ remarks: '\[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ getDimensionDataSourceString(dimensionString: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"):
+ OfficeExtension.ClientResult;
+ parameters:
+ - id: dimensionString
+ description: The dimension of the axis where the data is from.
+ type: '"Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"'
+ return:
+ type: '<string>'
+ description: ''
+ - name: getDimensionDataSourceType(dimension)
+ uid: 'excel!Excel.ChartSeries#getDimensionDataSourceType:member(1)'
+ package: excel!
+ fullName: getDimensionDataSourceType(dimension)
+ summary: Gets the data source type of the chart series.
+ remarks: >-
+ \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-source.yaml
+
+ // This function retrieves the data source information of a chart series in the Sample worksheet.
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ // Get the first chart series from the first chart on the worksheet.
+ const seriesCollection = sheet.charts.getItemAt(0).series;
+ const series = seriesCollection.getItemAt(0);
+
+ // Get the series data source string and type values.
+ const dataSourceString = series.getDimensionDataSourceString("Values");
+ const dataSourceType = series.getDimensionDataSourceType("Values");
+
+ series.load("name");
+ await context.sync();
+
+ // Log the data source information to the console.
+ console.log(series.name + " data source string: " + dataSourceString.value);
+ console.log(series.name + " data source type: " + dataSourceType.value);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ getDimensionDataSourceType(dimension: Excel.ChartSeriesDimension):
+ OfficeExtension.ClientResult;
+ parameters:
+ - id: dimension
+ description: The dimension of the axis where the data is from.
+ type: ''
+ return:
+ type: >-
+ <>
+ description: ''
+ - name: getDimensionDataSourceType(dimensionString)
+ uid: 'excel!Excel.ChartSeries#getDimensionDataSourceType:member(2)'
+ package: excel!
+ fullName: getDimensionDataSourceType(dimensionString)
+ summary: Gets the data source type of the chart series.
+ remarks: '\[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ getDimensionDataSourceType(dimensionString: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"):
+ OfficeExtension.ClientResult;
+ parameters:
+ - id: dimensionString
+ description: The dimension of the axis where the data is from.
+ type: '"Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"'
+ return:
+ type: >-
+ <>
+ description: ''
+ - name: getDimensionValues(dimension)
+ uid: 'excel!Excel.ChartSeries#getDimensionValues:member(1)'
+ package: excel!
+ fullName: getDimensionValues(dimension)
+ summary: >-
+ Gets the values from a single dimension of the chart series. These could be either category values or data values,
+ depending on the dimension specified and how the data is mapped for the chart series.
+ remarks: >-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-bubble-chart.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ // The sample chart is of type `Excel.ChartType.bubble`.
+ const bubbleChart = sheet.charts.getItem("Product Chart");
+
+ // Get the first series in the chart.
+ const firstSeries = bubbleChart.series.getItemAt(0);
+
+ // Get the values for the dimensions we're interested in.
+ const bubbleSize = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.bubbleSizes);
+ const xValues = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.xvalues);
+ const yValues = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.yvalues);
+ const category = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.categories);
+
+ await context.sync();
+
+ // Log the information.
+ console.log(`Series ${category.value} - X:${xValues.value},Y:${yValues.value},Bubble:${bubbleSize.value}`);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getDimensionValues(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult;'
+ parameters:
+ - id: dimension
+ description: The dimension of the axis where the data is from.
+ type: ''
+ return:
+ type: '<string[]>'
+ description: ''
+ - name: getDimensionValues(dimensionString)
+ uid: 'excel!Excel.ChartSeries#getDimensionValues:member(2)'
+ package: excel!
+ fullName: getDimensionValues(dimensionString)
+ summary: >-
+ Gets the values from a single dimension of the chart series. These could be either category values or data values,
+ depending on the dimension specified and how the data is mapped for the chart series.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ getDimensionValues(dimensionString: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"):
+ OfficeExtension.ClientResult;
+ parameters:
+ - id: dimensionString
+ description: The dimension of the axis where the data is from.
+ type: '"Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"'
+ return:
+ type: '<string[]>'
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartSeries#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartSeriesLoadOptions): Excel.ChartSeries;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartSeries#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartSeries;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Rename the 1st series of Chart1 to "New Series Name".
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+ chart.series.getItemAt(0).name = "New Series Name";
+ await context.sync();
+
+ console.log("Series1 Renamed");
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartSeries#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartSeries;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartSeries#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartSeriesUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartSeries#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartSeries): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setBubbleSizes(sourceData)
+ uid: 'excel!Excel.ChartSeries#setBubbleSizes:member(1)'
+ package: excel!
+ fullName: setBubbleSizes(sourceData)
+ summary: Sets the bubble sizes for a chart series. Only works for bubble charts.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-bubble-chart.yaml
+
+ await Excel.run(async (context) => {
+ /*
+ The table is expected to look like this:
+ Product, Inventory, Price, Current Market Share
+ Calamansi, 2000, $2.45, 10%
+ ...
+
+ We want each bubble to represent a single row.
+ */
+
+ // Get the worksheet and table data.
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const table = sheet.tables.getItem("Sales");
+ const dataRange = table.getDataBodyRange();
+
+ // Get the table data without the row names.
+ const valueRange = dataRange.getOffsetRange(0, 1).getResizedRange(0, -1);
+
+ // Create the chart.
+ const bubbleChart = sheet.charts.add(Excel.ChartType.bubble, valueRange);
+ bubbleChart.name = "Product Chart";
+
+ // Remove the default series, since we want a unique series for each row.
+ bubbleChart.series.getItemAt(0).delete();
+
+ // Load the data necessary to make a chart series.
+ dataRange.load(["rowCount", "values"]);
+ await context.sync();
+
+ // For each row, create a chart series (a bubble).
+ for (let i = 0; i < dataRange.rowCount; i++) {
+ const newSeries = bubbleChart.series.add(dataRange.values[i][0], i);
+ newSeries.setXAxisValues(dataRange.getCell(i, 1));
+ newSeries.setValues(dataRange.getCell(i, 2));
+ newSeries.setBubbleSizes(dataRange.getCell(i, 3));
+
+ // Show the product name and market share percentage.
+ newSeries.dataLabels.showSeriesName = true;
+ newSeries.dataLabels.showBubbleSize = true;
+ newSeries.dataLabels.showValue = false;
+ }
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setBubbleSizes(sourceData: Range): void;'
+ parameters:
+ - id: sourceData
+ description: The `Range` object corresponding to the source data.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setValues(sourceData)
+ uid: 'excel!Excel.ChartSeries#setValues:member(1)'
+ package: excel!
+ fullName: setValues(sourceData)
+ summary: 'Sets the values for a chart series. For scatter charts, it refers to y-axis values.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ let seriesCollection = sheet.charts.getItemAt(0);
+ let rangeSelection = sheet.getRange("C2:C7");
+ let xRangeSelection = sheet.getRange("A1:A7");
+
+ // Add a series.
+ let newSeries = seriesCollection.series.add("Qtr2");
+ newSeries.setValues(rangeSelection);
+ newSeries.setXAxisValues(xRangeSelection);
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setValues(sourceData: Range): void;'
+ parameters:
+ - id: sourceData
+ description: The `Range` object corresponding to the source data.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setXAxisValues(sourceData)
+ uid: 'excel!Excel.ChartSeries#setXAxisValues:member(1)'
+ package: excel!
+ fullName: setXAxisValues(sourceData)
+ summary: Sets the values of the x-axis for a chart series. Only works for scatter charts.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setXAxisValues(sourceData: Range): void;'
+ parameters:
+ - id: sourceData
+ description: The `Range` object corresponding to the source data.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartSeries#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartSeries object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartSeriesData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartSeriesData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesby.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesby.yml
new file mode 100644
index 0000000000..1ca456ccba
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesby.yml
@@ -0,0 +1,80 @@
+### YamlMime:TSEnum
+name: Excel.ChartSeriesBy
+uid: 'excel!Excel.ChartSeriesBy:enum'
+package: excel!
+fullName: Excel.ChartSeriesBy
+summary: >-
+ Specifies whether the series are by rows or by columns. In Excel on desktop, the "auto" option will inspect the source
+ data shape to automatically guess whether the data is by rows or columns. In Excel on the web, "auto" will simply
+ default to "columns".
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-data-source.yaml
+
+ await Excel.run(async (context) => {
+ // Create a new worksheet called "Sample" and activate it.
+ context.workbook.worksheets.getItemOrNullObject("Sample").delete();
+ const sheet = context.workbook.worksheets.add("Sample");
+
+ // Create an a table named SalesTable on the Sample worksheet.
+ let expensesTable = sheet.tables.add("A1:E1", true);
+ expensesTable.name = "SalesTable";
+
+ expensesTable.getHeaderRowRange().values = [["Product", "Qtr1", "Qtr2", "Qtr3", "Qtr4"]];
+ expensesTable.rows.add(null, [
+ ["Frames", 5000, 7000, 6544, 4377],
+ ["Saddles", 400, 323, 276, 651],
+ ["Brake levers", 12000, 8766, 8456, 9812],
+ ["Chains", 1550, 1088, 692, 853],
+ ["Mirrors", 225, 600, 923, 544],
+ ["Spokes", 6005, 7634, 4589, 8765]
+ ]);
+
+ sheet.getUsedRange().format.autofitColumns();
+ sheet.getUsedRange().format.autofitRows();
+ sheet.activate();
+
+ // Create a line chart based on data from SalesTable.
+ let dataRange = sheet.getRange("A1:E7");
+ let chart = sheet.charts.add("Line", dataRange, Excel.ChartSeriesBy.rows);
+
+ // Position and style the chart.
+ chart.setPosition("A15", "E30");
+ chart.legend.position = "Right";
+ chart.legend.format.fill.setSolidColor("white");
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: auto
+ uid: 'excel!Excel.ChartSeriesBy.auto:member'
+ package: excel!
+ summary: >-
+ In Excel on desktop, the "auto" option will inspect the source data shape to automatically guess whether the data
+ is by rows or columns. In Excel on the web, "auto" will simply default to "columns".
+
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Auto"'
+ - name: columns
+ uid: 'excel!Excel.ChartSeriesBy.columns:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Columns"'
+ - name: rows
+ uid: 'excel!Excel.ChartSeriesBy.rows:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Rows"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriescollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriescollection.yml
new file mode 100644
index 0000000000..afc087ac76
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriescollection.yml
@@ -0,0 +1,212 @@
+### YamlMime:TSType
+name: Excel.ChartSeriesCollection
+uid: 'excel!Excel.ChartSeriesCollection:class'
+package: excel!
+fullName: Excel.ChartSeriesCollection
+summary: Represents a collection of chart series.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartSeriesCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: count
+ uid: 'excel!Excel.ChartSeriesCollection#count:member'
+ package: excel!
+ fullName: count
+ summary: Returns the number of series in the collection.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly count: number;'
+ return:
+ type: number
+ - name: items
+ uid: 'excel!Excel.ChartSeriesCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.ChartSeries[];'
+ return:
+ type: '[]'
+methods:
+ - name: 'add(name, index)'
+ uid: 'excel!Excel.ChartSeriesCollection#add:member(1)'
+ package: excel!
+ fullName: 'add(name, index)'
+ summary: >-
+ Add a new series to the collection. The new added series is not visible until values, x-axis values, or bubble
+ sizes for it are set (depending on chart type).
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(name?: string, index?: number): Excel.ChartSeries;'
+ parameters:
+ - id: name
+ description: Optional. Name of the series.
+ type: string
+ - id: index
+ description: Optional. Index value of the series to be added. Zero-indexed.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.ChartSeriesCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Returns the number of series in the collection.
+ remarks: '\[ [API set: ExcelApi 1.4](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.ChartSeriesCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Retrieves a series based on its position in the collection.
+ remarks: |-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // Get the name of the first series in the series collection.
+ await Excel.run(async (context) => {
+ const seriesCollection = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").series;
+ seriesCollection.load('items');
+ await context.sync();
+
+ console.log(seriesCollection.items[0].name);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.ChartSeries;'
+ parameters:
+ - id: index
+ description: Index value of the object to be retrieved. Zero-indexed.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartSeriesCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ChartSeriesCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.ChartSeriesCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartSeriesCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartSeriesCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Get the number of chart series in the collection.
+ await Excel.run(async (context) => {
+ const seriesCollection = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1").series;
+ seriesCollection.load('count');
+ await context.sync();
+
+ console.log("series: Count= " + seriesCollection.count);
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartSeriesCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.ChartSeriesCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartSeriesCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.ChartSeriesCollection` object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartSeriesCollectionData`) that contains an
+ "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartSeriesCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesdimension.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesdimension.yml
new file mode 100644
index 0000000000..902a2694bf
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesdimension.yml
@@ -0,0 +1,83 @@
+### YamlMime:TSEnum
+name: Excel.ChartSeriesDimension
+uid: 'excel!Excel.ChartSeriesDimension:enum'
+package: excel!
+fullName: Excel.ChartSeriesDimension
+summary: Represents the dimensions when getting values from chart series.
+remarks: >-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-bubble-chart.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ // The sample chart is of type `Excel.ChartType.bubble`.
+ const bubbleChart = sheet.charts.getItem("Product Chart");
+
+ // Get the first series in the chart.
+ const firstSeries = bubbleChart.series.getItemAt(0);
+
+ // Get the values for the dimensions we're interested in.
+ const bubbleSize = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.bubbleSizes);
+ const xValues = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.xvalues);
+ const yValues = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.yvalues);
+ const category = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.categories);
+
+ await context.sync();
+
+ // Log the information.
+ console.log(`Series ${category.value} - X:${xValues.value},Y:${yValues.value},Bubble:${bubbleSize.value}`);
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bubbleSizes
+ uid: 'excel!Excel.ChartSeriesDimension.bubbleSizes:member'
+ package: excel!
+ summary: |-
+ The chart series axis for the bubble sizes in bubble charts.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BubbleSizes"'
+ - name: categories
+ uid: 'excel!Excel.ChartSeriesDimension.categories:member'
+ package: excel!
+ summary: |-
+ The chart series axis for the categories.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Categories"'
+ - name: values
+ uid: 'excel!Excel.ChartSeriesDimension.values:member'
+ package: excel!
+ summary: |-
+ The chart series axis for the values.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Values"'
+ - name: xvalues
+ uid: 'excel!Excel.ChartSeriesDimension.xvalues:member'
+ package: excel!
+ summary: |-
+ The chart series axis for the x-axis values in scatter and bubble charts.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"XValues"'
+ - name: yvalues
+ uid: 'excel!Excel.ChartSeriesDimension.yvalues:member'
+ package: excel!
+ summary: |-
+ The chart series axis for the y-axis values in scatter and bubble charts.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"YValues"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesformat.yml
new file mode 100644
index 0000000000..90c3b3926d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartseriesformat.yml
@@ -0,0 +1,177 @@
+### YamlMime:TSType
+name: Excel.ChartSeriesFormat
+uid: 'excel!Excel.ChartSeriesFormat:class'
+package: excel!
+fullName: Excel.ChartSeriesFormat
+summary: Encapsulates the format properties for the chart series
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartSeriesFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartSeriesFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: 'Represents the fill format of a chart series, which includes background formatting information.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: line
+ uid: 'excel!Excel.ChartSeriesFormat#line:member'
+ package: excel!
+ fullName: line
+ summary: Represents line formatting.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly line: Excel.ChartLineFormat;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartSeriesFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartSeriesFormatLoadOptions): Excel.ChartSeriesFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartSeriesFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartSeriesFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartSeriesFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartSeriesFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartSeriesFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartSeriesFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartSeriesFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartSeriesFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartSeriesFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartSeriesFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartSeriesFormatData`) that contains shallow copies
+ of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartSeriesFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartsplittype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartsplittype.yml
new file mode 100644
index 0000000000..b32b74dd0b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartsplittype.yml
@@ -0,0 +1,30 @@
+### YamlMime:TSEnum
+name: Excel.ChartSplitType
+uid: 'excel!Excel.ChartSplitType:enum'
+package: excel!
+fullName: Excel.ChartSplitType
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: splitByCustomSplit
+ uid: 'excel!Excel.ChartSplitType.splitByCustomSplit:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SplitByCustomSplit"'
+ - name: splitByPercentValue
+ uid: 'excel!Excel.ChartSplitType.splitByPercentValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SplitByPercentValue"'
+ - name: splitByPosition
+ uid: 'excel!Excel.ChartSplitType.splitByPosition:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SplitByPosition"'
+ - name: splitByValue
+ uid: 'excel!Excel.ChartSplitType.splitByValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SplitByValue"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttexthorizontalalignment.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttexthorizontalalignment.yml
new file mode 100644
index 0000000000..bffd7bd90a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttexthorizontalalignment.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSEnum
+name: Excel.ChartTextHorizontalAlignment
+uid: 'excel!Excel.ChartTextHorizontalAlignment:enum'
+package: excel!
+fullName: Excel.ChartTextHorizontalAlignment
+summary: Represents the horizontal alignment for the specified object.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: center
+ uid: 'excel!Excel.ChartTextHorizontalAlignment.center:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Center"'
+ - name: distributed
+ uid: 'excel!Excel.ChartTextHorizontalAlignment.distributed:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Distributed"'
+ - name: justify
+ uid: 'excel!Excel.ChartTextHorizontalAlignment.justify:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Justify"'
+ - name: left
+ uid: 'excel!Excel.ChartTextHorizontalAlignment.left:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Left"'
+ - name: right
+ uid: 'excel!Excel.ChartTextHorizontalAlignment.right:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Right"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttextverticalalignment.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttextverticalalignment.yml
new file mode 100644
index 0000000000..27bc924646
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttextverticalalignment.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSEnum
+name: Excel.ChartTextVerticalAlignment
+uid: 'excel!Excel.ChartTextVerticalAlignment:enum'
+package: excel!
+fullName: Excel.ChartTextVerticalAlignment
+summary: Represents the vertical alignment for the specified object.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bottom
+ uid: 'excel!Excel.ChartTextVerticalAlignment.bottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bottom"'
+ - name: center
+ uid: 'excel!Excel.ChartTextVerticalAlignment.center:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Center"'
+ - name: distributed
+ uid: 'excel!Excel.ChartTextVerticalAlignment.distributed:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Distributed"'
+ - name: justify
+ uid: 'excel!Excel.ChartTextVerticalAlignment.justify:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Justify"'
+ - name: top
+ uid: 'excel!Excel.ChartTextVerticalAlignment.top:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Top"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartticklabelalignment.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartticklabelalignment.yml
new file mode 100644
index 0000000000..2b1b681d9e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartticklabelalignment.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ChartTickLabelAlignment
+uid: 'excel!Excel.ChartTickLabelAlignment:enum'
+package: excel!
+fullName: Excel.ChartTickLabelAlignment
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: center
+ uid: 'excel!Excel.ChartTickLabelAlignment.center:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Center"'
+ - name: left
+ uid: 'excel!Excel.ChartTickLabelAlignment.left:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Left"'
+ - name: right
+ uid: 'excel!Excel.ChartTickLabelAlignment.right:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Right"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitle.yml
new file mode 100644
index 0000000000..1febfce6c5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitle.yml
@@ -0,0 +1,416 @@
+### YamlMime:TSType
+name: Excel.ChartTitle
+uid: 'excel!Excel.ChartTitle:class'
+package: excel!
+fullName: Excel.ChartTitle
+summary: Represents a chart title object of a chart.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartTitle#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartTitle#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Represents the formatting of a chart title, which includes fill and font formatting.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartTitleFormat;'
+ return:
+ type: ''
+ - name: height
+ uid: 'excel!Excel.ChartTitle#height:member'
+ package: excel!
+ fullName: height
+ summary: 'Returns the height, in points, of the chart title. Value is `null` if the chart title is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly height: number;'
+ return:
+ type: number
+ - name: horizontalAlignment
+ uid: 'excel!Excel.ChartTitle#horizontalAlignment:member'
+ package: excel!
+ fullName: horizontalAlignment
+ summary: Specifies the horizontal alignment for chart title.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ horizontalAlignment: Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed";
+ return:
+ type: >-
+ | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed"
+ - name: left
+ uid: 'excel!Excel.ChartTitle#left:member'
+ package: excel!
+ fullName: left
+ summary: >-
+ Specifies the distance, in points, from the left edge of chart title to the left edge of chart area. Value is
+ `null` if the chart title is not visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'left: number;'
+ return:
+ type: number
+ - name: overlay
+ uid: 'excel!Excel.ChartTitle#overlay:member'
+ package: excel!
+ fullName: overlay
+ summary: Specifies if the chart title will overlay the chart.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'overlay: boolean;'
+ return:
+ type: boolean
+ - name: position
+ uid: 'excel!Excel.ChartTitle#position:member'
+ package: excel!
+ fullName: position
+ summary: Represents the position of chart title. See `Excel.ChartTitlePosition` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'position: Excel.ChartTitlePosition | "Automatic" | "Top" | "Bottom" | "Left" | "Right";'
+ return:
+ type: ' | "Automatic" | "Top" | "Bottom" | "Left" | "Right"'
+ - name: showShadow
+ uid: 'excel!Excel.ChartTitle#showShadow:member'
+ package: excel!
+ fullName: showShadow
+ summary: Represents a boolean value that determines if the chart title has a shadow.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showShadow: boolean;'
+ return:
+ type: boolean
+ - name: text
+ uid: 'excel!Excel.ChartTitle#text:member'
+ package: excel!
+ fullName: text
+ summary: Specifies the chart's title text.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'text: string;'
+ return:
+ type: string
+ - name: textOrientation
+ uid: 'excel!Excel.ChartTitle#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: >-
+ Specifies the angle to which the text is oriented for the chart title. The value should either be an integer from
+ -90 to 90 or the integer 180 for vertically-oriented text.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-title-format.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const title = sheet.charts.getItemAt(0).title;
+ title.textOrientation = -45;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation: number;'
+ return:
+ type: number
+ - name: top
+ uid: 'excel!Excel.ChartTitle#top:member'
+ package: excel!
+ fullName: top
+ summary: >-
+ Specifies the distance, in points, from the top edge of chart title to the top of chart area. Value is `null` if
+ the chart title is not visible.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'top: number;'
+ return:
+ type: number
+ - name: verticalAlignment
+ uid: 'excel!Excel.ChartTitle#verticalAlignment:member'
+ package: excel!
+ fullName: verticalAlignment
+ summary: Specifies the vertical alignment of chart title. See `Excel.ChartTextVerticalAlignment` for details.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'verticalAlignment: Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed";'
+ return:
+ type: >-
+ | "Center" | "Bottom" | "Top" | "Justify" |
+ "Distributed"
+ - name: visible
+ uid: 'excel!Excel.ChartTitle#visible:member'
+ package: excel!
+ fullName: visible
+ summary: Specifies if the chart title is visibile.
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'visible: boolean;'
+ return:
+ type: boolean
+ - name: width
+ uid: 'excel!Excel.ChartTitle#width:member'
+ package: excel!
+ fullName: width
+ summary: 'Specifies the width, in points, of the chart title. Value is `null` if the chart title is not visible.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly width: number;'
+ return:
+ type: number
+methods:
+ - name: 'getSubstring(start, length)'
+ uid: 'excel!Excel.ChartTitle#getSubstring:member(1)'
+ package: excel!
+ fullName: 'getSubstring(start, length)'
+ summary: Get the substring of a chart title. Line break '\\n' counts one character.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-title-format.yaml
+
+ await Excel.run(async (context) => {
+ let sheet = context.workbook.worksheets.getItem("Sample");
+ let chart = sheet.charts.getItemAt(0);
+
+ // Get first seven characters of the title and color them green.
+ chart.title.getSubstring(0, 7).font.color = "Yellow";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getSubstring(start: number, length: number): Excel.ChartFormatString;'
+ parameters:
+ - id: start
+ description: Start position of substring to be retrieved. Zero-indexed.
+ type: number
+ - id: length
+ description: Length of the substring to be retrieved.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartTitle#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartTitleLoadOptions): Excel.ChartTitle;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartTitle#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartTitle;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: |-
+
+
+ #### Examples
+
+ ```typescript
+ // Set the text of the chart title to "My Chart" and display it as an overlay on the chart.
+ await Excel.run(async (context) => {
+ const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
+
+ chart.title.text= "My Chart";
+ chart.title.visible=true;
+ chart.title.overlay=true;
+
+ await context.sync();
+ console.log("Char Title Changed");
+ });
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartTitle#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartTitle;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartTitle#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartTitleUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartTitle#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartTitle): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setFormula(formula)
+ uid: 'excel!Excel.ChartTitle#setFormula:member(1)'
+ package: excel!
+ fullName: setFormula(formula)
+ summary: Sets a string value that represents the formula of chart title using A1-style notation.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setFormula(formula: string): void;'
+ parameters:
+ - id: formula
+ description: A string that represents the formula to set.
+ type: string
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartTitle#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartTitle object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.ChartTitleData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartTitleData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitleformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitleformat.yml
new file mode 100644
index 0000000000..2ccfd889ae
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitleformat.yml
@@ -0,0 +1,189 @@
+### YamlMime:TSType
+name: Excel.ChartTitleFormat
+uid: 'excel!Excel.ChartTitleFormat:class'
+package: excel!
+fullName: Excel.ChartTitleFormat
+summary: Provides access to the formatting options for a chart title.
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartTitleFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Represents the border format of chart title, which includes color, linestyle, and weight.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartTitleFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartTitleFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: 'Represents the fill format of an object, which includes background formatting information.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartTitleFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Represents the font attributes (such as font name, font size, and color) for an object.'
+ remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartTitleFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartTitleFormatLoadOptions): Excel.ChartTitleFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartTitleFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartTitleFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartTitleFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartTitleFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartTitleFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartTitleFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartTitleFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartTitleFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartTitleFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartTitleFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartTitleFormatData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartTitleFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitleposition.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitleposition.yml
new file mode 100644
index 0000000000..af5aa26bd7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttitleposition.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSEnum
+name: Excel.ChartTitlePosition
+uid: 'excel!Excel.ChartTitlePosition:enum'
+package: excel!
+fullName: Excel.ChartTitlePosition
+summary: Represents the position of the chart title.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ChartTitlePosition.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: bottom
+ uid: 'excel!Excel.ChartTitlePosition.bottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bottom"'
+ - name: left
+ uid: 'excel!Excel.ChartTitlePosition.left:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Left"'
+ - name: right
+ uid: 'excel!Excel.ChartTitlePosition.right:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Right"'
+ - name: top
+ uid: 'excel!Excel.ChartTitlePosition.top:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Top"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendline.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendline.yml
new file mode 100644
index 0000000000..2025291311
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendline.yml
@@ -0,0 +1,332 @@
+### YamlMime:TSType
+name: Excel.ChartTrendline
+uid: 'excel!Excel.ChartTrendline:class'
+package: excel!
+fullName: Excel.ChartTrendline
+summary: This object represents the attributes for a chart trendline object.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: backwardPeriod
+ uid: 'excel!Excel.ChartTrendline#backwardPeriod:member'
+ package: excel!
+ fullName: backwardPeriod
+ summary: Represents the number of periods that the trendline extends backward.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'backwardPeriod: number;'
+ return:
+ type: number
+ - name: context
+ uid: 'excel!Excel.ChartTrendline#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartTrendline#format:member'
+ package: excel!
+ fullName: format
+ summary: Represents the formatting of a chart trendline.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartTrendlineFormat;'
+ return:
+ type: ''
+ - name: forwardPeriod
+ uid: 'excel!Excel.ChartTrendline#forwardPeriod:member'
+ package: excel!
+ fullName: forwardPeriod
+ summary: Represents the number of periods that the trendline extends forward.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'forwardPeriod: number;'
+ return:
+ type: number
+ - name: intercept
+ uid: 'excel!Excel.ChartTrendline#intercept:member'
+ package: excel!
+ fullName: intercept
+ summary: >-
+ Represents the intercept value of the trendline. Can be set to a numeric value or an empty string (for automatic
+ values). The returned value is always a number.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'intercept: any;'
+ return:
+ type: any
+ - name: label
+ uid: 'excel!Excel.ChartTrendline#label:member'
+ package: excel!
+ fullName: label
+ summary: Represents the label of a chart trendline.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly label: Excel.ChartTrendlineLabel;'
+ return:
+ type: ''
+ - name: movingAveragePeriod
+ uid: 'excel!Excel.ChartTrendline#movingAveragePeriod:member'
+ package: excel!
+ fullName: movingAveragePeriod
+ summary: Represents the period of a chart trendline. Only applicable to trendlines with the type `MovingAverage`.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'movingAveragePeriod: number;'
+ return:
+ type: number
+ - name: name
+ uid: 'excel!Excel.ChartTrendline#name:member'
+ package: excel!
+ fullName: name
+ summary: >-
+ Represents the name of the trendline. Can be set to a string value, a `null` value represents automatic values.
+ The returned value is always a string
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name: string;'
+ return:
+ type: string
+ - name: polynomialOrder
+ uid: 'excel!Excel.ChartTrendline#polynomialOrder:member'
+ package: excel!
+ fullName: polynomialOrder
+ summary: Represents the order of a chart trendline. Only applicable to trendlines with the type `Polynomial`.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'polynomialOrder: number;'
+ return:
+ type: number
+ - name: showEquation
+ uid: 'excel!Excel.ChartTrendline#showEquation:member'
+ package: excel!
+ fullName: showEquation
+ summary: True if the equation for the trendline is displayed on the chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showEquation: boolean;'
+ return:
+ type: boolean
+ - name: showRSquared
+ uid: 'excel!Excel.ChartTrendline#showRSquared:member'
+ package: excel!
+ fullName: showRSquared
+ summary: True if the r-squared value for the trendline is displayed on the chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showRSquared: boolean;'
+ return:
+ type: boolean
+ - name: type
+ uid: 'excel!Excel.ChartTrendline#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of a chart trendline.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-trendlines.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ let seriesCollection = sheet.charts.getItemAt(0).series;
+
+ // Get the trendline for series 1 and load its type property.
+ let trendline = seriesCollection.getItemAt(0).trendlines.getItem(0);
+ trendline.load("type");
+
+ await context.sync();
+
+ console.log("The trendline type is:" + trendline.type);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ type: Excel.ChartTrendlineType | "Linear" | "Exponential" | "Logarithmic" | "MovingAverage" | "Polynomial" |
+ "Power";
+ return:
+ type: >-
+ | "Linear" | "Exponential" | "Logarithmic" |
+ "MovingAverage" | "Polynomial" | "Power"
+methods:
+ - name: delete()
+ uid: 'excel!Excel.ChartTrendline#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Delete the trendline object.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartTrendline#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartTrendlineLoadOptions): Excel.ChartTrendline;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartTrendline#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartTrendline;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartTrendline#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartTrendline;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartTrendline#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartTrendlineUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartTrendline#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartTrendline): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartTrendline#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartTrendline object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ChartTrendlineData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartTrendlineData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinecollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinecollection.yml
new file mode 100644
index 0000000000..7c31c3e2fb
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinecollection.yml
@@ -0,0 +1,209 @@
+### YamlMime:TSType
+name: Excel.ChartTrendlineCollection
+uid: 'excel!Excel.ChartTrendlineCollection:class'
+package: excel!
+fullName: Excel.ChartTrendlineCollection
+summary: Represents a collection of chart trendlines.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartTrendlineCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.ChartTrendlineCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.ChartTrendline[];'
+ return:
+ type: '[]'
+methods:
+ - name: add(type)
+ uid: 'excel!Excel.ChartTrendlineCollection#add:member(1)'
+ package: excel!
+ fullName: add(type)
+ summary: Adds a new trendline to trendline collection.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-trendlines.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ let seriesCollection = sheet.charts.getItemAt(0).series;
+
+ // Add a trendline.
+ seriesCollection.getItemAt(0).trendlines.add("Linear");
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(type?: Excel.ChartTrendlineType): Excel.ChartTrendline;'
+ parameters:
+ - id: type
+ description: Specifies the trendline type. The default value is "Linear". See `Excel.ChartTrendline` for details.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: add(typeString)
+ uid: 'excel!Excel.ChartTrendlineCollection#add:member(2)'
+ package: excel!
+ fullName: add(typeString)
+ summary: Adds a new trendline to trendline collection.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ add(typeString?: "Linear" | "Exponential" | "Logarithmic" | "MovingAverage" | "Polynomial" | "Power"):
+ Excel.ChartTrendline;
+ parameters:
+ - id: typeString
+ description: Specifies the trendline type. The default value is "Linear". See `Excel.ChartTrendline` for details.
+ type: '"Linear" | "Exponential" | "Logarithmic" | "MovingAverage" | "Polynomial" | "Power"'
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.ChartTrendlineCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Returns the number of trendlines in the collection.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(index)
+ uid: 'excel!Excel.ChartTrendlineCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(index)
+ summary: 'Gets a trendline object by index, which is the insertion order in the items array.'
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(index: number): Excel.ChartTrendline;'
+ parameters:
+ - id: index
+ description: Represents the insertion order in the items array.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ChartTrendlineCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ChartTrendlineCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.ChartTrendlineCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartTrendlineCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartTrendlineCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartTrendlineCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.ChartTrendlineCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartTrendlineCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.ChartTrendlineCollection` object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartTrendlineCollectionData`) that contains
+ an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartTrendlineCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlineformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlineformat.yml
new file mode 100644
index 0000000000..0a2724f8ee
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlineformat.yml
@@ -0,0 +1,192 @@
+### YamlMime:TSType
+name: Excel.ChartTrendlineFormat
+uid: 'excel!Excel.ChartTrendlineFormat:class'
+package: excel!
+fullName: Excel.ChartTrendlineFormat
+summary: Represents the format properties for the chart trendline.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ChartTrendlineFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: line
+ uid: 'excel!Excel.ChartTrendlineFormat#line:member'
+ package: excel!
+ fullName: line
+ summary: Represents chart line formatting.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-trendlines.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ let seriesCollection = sheet.charts.getItemAt(0).series;
+ let trendline = seriesCollection.getItemAt(0).trendlines.getItem(0);
+
+ // Set format of the trendline to a solid, red line.
+ let line = trendline.format.line;
+ line.color = '#FF0000';
+
+ await context.sync();
+
+ console.log("The trendline color has been set to:" + line.color);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly line: Excel.ChartLineFormat;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartTrendlineFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartTrendlineFormatLoadOptions): Excel.ChartTrendlineFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartTrendlineFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartTrendlineFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartTrendlineFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartTrendlineFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartTrendlineFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartTrendlineFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartTrendlineFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartTrendlineFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartTrendlineFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartTrendlineFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartTrendlineFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartTrendlineFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinelabel.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinelabel.yml
new file mode 100644
index 0000000000..9ab8f998c7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinelabel.yml
@@ -0,0 +1,331 @@
+### YamlMime:TSType
+name: Excel.ChartTrendlineLabel
+uid: 'excel!Excel.ChartTrendlineLabel:class'
+package: excel!
+fullName: Excel.ChartTrendlineLabel
+summary: This object represents the attributes for a chart trendline label object.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: autoText
+ uid: 'excel!Excel.ChartTrendlineLabel#autoText:member'
+ package: excel!
+ fullName: autoText
+ summary: Specifies if the trendline label automatically generates appropriate text based on context.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'autoText: boolean;'
+ return:
+ type: boolean
+ - name: context
+ uid: 'excel!Excel.ChartTrendlineLabel#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.ChartTrendlineLabel#format:member'
+ package: excel!
+ fullName: format
+ summary: The format of the chart trendline label.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ChartTrendlineLabelFormat;'
+ return:
+ type: ''
+ - name: formula
+ uid: 'excel!Excel.ChartTrendlineLabel#formula:member'
+ package: excel!
+ fullName: formula
+ summary: String value that represents the formula of the chart trendline label using A1-style notation.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula: string;'
+ return:
+ type: string
+ - name: height
+ uid: 'excel!Excel.ChartTrendlineLabel#height:member'
+ package: excel!
+ fullName: height
+ summary: >-
+ Returns the height, in points, of the chart trendline label. Value is `null` if the chart trendline label is not
+ visible.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly height: number;'
+ return:
+ type: number
+ - name: horizontalAlignment
+ uid: 'excel!Excel.ChartTrendlineLabel#horizontalAlignment:member'
+ package: excel!
+ fullName: horizontalAlignment
+ summary: >-
+ Represents the horizontal alignment of the chart trendline label. See `Excel.ChartTextHorizontalAlignment` for
+ details. This property is valid only when `TextOrientation` of a trendline label is -90, 90, or 180.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ horizontalAlignment: Excel.ChartTextHorizontalAlignment | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed";
+ return:
+ type: >-
+ | "Center" | "Left" | "Right" | "Justify" |
+ "Distributed"
+ - name: left
+ uid: 'excel!Excel.ChartTrendlineLabel#left:member'
+ package: excel!
+ fullName: left
+ summary: >-
+ Represents the distance, in points, from the left edge of the chart trendline label to the left edge of the chart
+ area. Value is `null` if the chart trendline label is not visible.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'left: number;'
+ return:
+ type: number
+ - name: linkNumberFormat
+ uid: 'excel!Excel.ChartTrendlineLabel#linkNumberFormat:member'
+ package: excel!
+ fullName: linkNumberFormat
+ summary: >-
+ Specifies if the number format is linked to the cells (so that the number format changes in the labels when it
+ changes in the cells).
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'linkNumberFormat: boolean;'
+ return:
+ type: boolean
+ - name: numberFormat
+ uid: 'excel!Excel.ChartTrendlineLabel#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: String value that represents the format code for the trendline label.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'numberFormat: string;'
+ return:
+ type: string
+ - name: text
+ uid: 'excel!Excel.ChartTrendlineLabel#text:member'
+ package: excel!
+ fullName: text
+ summary: String representing the text of the trendline label on a chart.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'text: string;'
+ return:
+ type: string
+ - name: textOrientation
+ uid: 'excel!Excel.ChartTrendlineLabel#textOrientation:member'
+ package: excel!
+ fullName: textOrientation
+ summary: >-
+ Represents the angle to which the text is oriented for the chart trendline label. The value should either be an
+ integer from -90 to 90 or the integer 180 for vertically-oriented text.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textOrientation: number;'
+ return:
+ type: number
+ - name: top
+ uid: 'excel!Excel.ChartTrendlineLabel#top:member'
+ package: excel!
+ fullName: top
+ summary: >-
+ Represents the distance, in points, from the top edge of the chart trendline label to the top of the chart area.
+ Value is `null` if the chart trendline label is not visible.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'top: number;'
+ return:
+ type: number
+ - name: verticalAlignment
+ uid: 'excel!Excel.ChartTrendlineLabel#verticalAlignment:member'
+ package: excel!
+ fullName: verticalAlignment
+ summary: >-
+ Represents the vertical alignment of the chart trendline label. See `Excel.ChartTextVerticalAlignment` for
+ details. This property is valid only when `TextOrientation` of a trendline label is 0.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'verticalAlignment: Excel.ChartTextVerticalAlignment | "Center" | "Bottom" | "Top" | "Justify" | "Distributed";'
+ return:
+ type: >-
+ | "Center" | "Bottom" | "Top" | "Justify" |
+ "Distributed"
+ - name: width
+ uid: 'excel!Excel.ChartTrendlineLabel#width:member'
+ package: excel!
+ fullName: width
+ summary: >-
+ Returns the width, in points, of the chart trendline label. Value is `null` if the chart trendline label is not
+ visible.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly width: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartTrendlineLabel#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartTrendlineLabelLoadOptions): Excel.ChartTrendlineLabel;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartTrendlineLabel#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartTrendlineLabel;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartTrendlineLabel#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartTrendlineLabel;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartTrendlineLabel#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartTrendlineLabelUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartTrendlineLabel#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartTrendlineLabel): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartTrendlineLabel#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartTrendlineLabel object is an API object, the `toJSON` method returns
+ a plain JavaScript object (typed as `Excel.Interfaces.ChartTrendlineLabelData`) that contains shallow
+ copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartTrendlineLabelData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinelabelformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinelabelformat.yml
new file mode 100644
index 0000000000..8c3e7c22bb
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinelabelformat.yml
@@ -0,0 +1,189 @@
+### YamlMime:TSType
+name: Excel.ChartTrendlineLabelFormat
+uid: 'excel!Excel.ChartTrendlineLabelFormat:class'
+package: excel!
+fullName: Excel.ChartTrendlineLabelFormat
+summary: Encapsulates the format properties for the chart trendline label.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: border
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#border:member'
+ package: excel!
+ fullName: border
+ summary: 'Specifies the border format, which includes color, linestyle, and weight.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly border: Excel.ChartBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: Specifies the fill format of the current chart trendline label.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ChartFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: 'Specifies the font attributes (such as font name, font size, and color) for a chart trendline label.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ChartFont;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ChartTrendlineLabelFormatLoadOptions): Excel.ChartTrendlineLabelFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ChartTrendlineLabelFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ChartTrendlineLabelFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ChartTrendlineLabelFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ChartTrendlineLabelFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ChartTrendlineLabelFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ChartTrendlineLabelFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ChartTrendlineLabelFormatData`) that
+ contains shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ChartTrendlineLabelFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinetype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinetype.yml
new file mode 100644
index 0000000000..3c5826bed3
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttrendlinetype.yml
@@ -0,0 +1,40 @@
+### YamlMime:TSEnum
+name: Excel.ChartTrendlineType
+uid: 'excel!Excel.ChartTrendlineType:enum'
+package: excel!
+fullName: Excel.ChartTrendlineType
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: exponential
+ uid: 'excel!Excel.ChartTrendlineType.exponential:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Exponential"'
+ - name: linear
+ uid: 'excel!Excel.ChartTrendlineType.linear:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Linear"'
+ - name: logarithmic
+ uid: 'excel!Excel.ChartTrendlineType.logarithmic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Logarithmic"'
+ - name: movingAverage
+ uid: 'excel!Excel.ChartTrendlineType.movingAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"MovingAverage"'
+ - name: polynomial
+ uid: 'excel!Excel.ChartTrendlineType.polynomial:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Polynomial"'
+ - name: power
+ uid: 'excel!Excel.ChartTrendlineType.power:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Power"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.charttype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttype.yml
new file mode 100644
index 0000000000..066ec6b38f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.charttype.yml
@@ -0,0 +1,449 @@
+### YamlMime:TSEnum
+name: Excel.ChartType
+uid: 'excel!Excel.ChartType:enum'
+package: excel!
+fullName: Excel.ChartType
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-create-several-charts.yaml
+
+ await Excel.run(async (context) => {
+ let sheet = context.workbook.worksheets.getItem("Sample");
+ let salesTable = sheet.tables.getItem("SalesTable");
+
+ let dataRange = sheet.getRange("A1:E7");
+ let chart = sheet.charts.add(Excel.ChartType.line, dataRange, "Auto");
+
+ chart.setPosition("A22", "F35");
+ chart.legend.position = "Right";
+ chart.legend.format.fill.setSolidColor("white");
+ chart.dataLabels.format.font.size = 15;
+ chart.dataLabels.format.font.color = "black";
+ chart.title.text = "Bicycle Parts Quarterly Sales";
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: _3DArea
+ uid: 'excel!Excel.ChartType._3DArea:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DArea"'
+ - name: _3DAreaStacked
+ uid: 'excel!Excel.ChartType._3DAreaStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DAreaStacked"'
+ - name: _3DAreaStacked100
+ uid: 'excel!Excel.ChartType._3DAreaStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DAreaStacked100"'
+ - name: _3DBarClustered
+ uid: 'excel!Excel.ChartType._3DBarClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DBarClustered"'
+ - name: _3DBarStacked
+ uid: 'excel!Excel.ChartType._3DBarStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DBarStacked"'
+ - name: _3DBarStacked100
+ uid: 'excel!Excel.ChartType._3DBarStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DBarStacked100"'
+ - name: _3DColumn
+ uid: 'excel!Excel.ChartType._3DColumn:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DColumn"'
+ - name: _3DColumnClustered
+ uid: 'excel!Excel.ChartType._3DColumnClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DColumnClustered"'
+ - name: _3DColumnStacked
+ uid: 'excel!Excel.ChartType._3DColumnStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DColumnStacked"'
+ - name: _3DColumnStacked100
+ uid: 'excel!Excel.ChartType._3DColumnStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DColumnStacked100"'
+ - name: _3DLine
+ uid: 'excel!Excel.ChartType._3DLine:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DLine"'
+ - name: _3DPie
+ uid: 'excel!Excel.ChartType._3DPie:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DPie"'
+ - name: _3DPieExploded
+ uid: 'excel!Excel.ChartType._3DPieExploded:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"3DPieExploded"'
+ - name: area
+ uid: 'excel!Excel.ChartType.area:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Area"'
+ - name: areaStacked
+ uid: 'excel!Excel.ChartType.areaStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AreaStacked"'
+ - name: areaStacked100
+ uid: 'excel!Excel.ChartType.areaStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AreaStacked100"'
+ - name: barClustered
+ uid: 'excel!Excel.ChartType.barClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BarClustered"'
+ - name: barOfPie
+ uid: 'excel!Excel.ChartType.barOfPie:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BarOfPie"'
+ - name: barStacked
+ uid: 'excel!Excel.ChartType.barStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BarStacked"'
+ - name: barStacked100
+ uid: 'excel!Excel.ChartType.barStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BarStacked100"'
+ - name: boxwhisker
+ uid: 'excel!Excel.ChartType.boxwhisker:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Boxwhisker"'
+ - name: bubble
+ uid: 'excel!Excel.ChartType.bubble:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bubble"'
+ - name: bubble3DEffect
+ uid: 'excel!Excel.ChartType.bubble3DEffect:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bubble3DEffect"'
+ - name: columnClustered
+ uid: 'excel!Excel.ChartType.columnClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColumnClustered"'
+ - name: columnStacked
+ uid: 'excel!Excel.ChartType.columnStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColumnStacked"'
+ - name: columnStacked100
+ uid: 'excel!Excel.ChartType.columnStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColumnStacked100"'
+ - name: coneBarClustered
+ uid: 'excel!Excel.ChartType.coneBarClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ConeBarClustered"'
+ - name: coneBarStacked
+ uid: 'excel!Excel.ChartType.coneBarStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ConeBarStacked"'
+ - name: coneBarStacked100
+ uid: 'excel!Excel.ChartType.coneBarStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ConeBarStacked100"'
+ - name: coneCol
+ uid: 'excel!Excel.ChartType.coneCol:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ConeCol"'
+ - name: coneColClustered
+ uid: 'excel!Excel.ChartType.coneColClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ConeColClustered"'
+ - name: coneColStacked
+ uid: 'excel!Excel.ChartType.coneColStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ConeColStacked"'
+ - name: coneColStacked100
+ uid: 'excel!Excel.ChartType.coneColStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ConeColStacked100"'
+ - name: cylinderBarClustered
+ uid: 'excel!Excel.ChartType.cylinderBarClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CylinderBarClustered"'
+ - name: cylinderBarStacked
+ uid: 'excel!Excel.ChartType.cylinderBarStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CylinderBarStacked"'
+ - name: cylinderBarStacked100
+ uid: 'excel!Excel.ChartType.cylinderBarStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CylinderBarStacked100"'
+ - name: cylinderCol
+ uid: 'excel!Excel.ChartType.cylinderCol:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CylinderCol"'
+ - name: cylinderColClustered
+ uid: 'excel!Excel.ChartType.cylinderColClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CylinderColClustered"'
+ - name: cylinderColStacked
+ uid: 'excel!Excel.ChartType.cylinderColStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CylinderColStacked"'
+ - name: cylinderColStacked100
+ uid: 'excel!Excel.ChartType.cylinderColStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CylinderColStacked100"'
+ - name: doughnut
+ uid: 'excel!Excel.ChartType.doughnut:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Doughnut"'
+ - name: doughnutExploded
+ uid: 'excel!Excel.ChartType.doughnutExploded:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DoughnutExploded"'
+ - name: funnel
+ uid: 'excel!Excel.ChartType.funnel:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Funnel"'
+ - name: histogram
+ uid: 'excel!Excel.ChartType.histogram:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Histogram"'
+ - name: invalid
+ uid: 'excel!Excel.ChartType.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: line
+ uid: 'excel!Excel.ChartType.line:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Line"'
+ - name: lineMarkers
+ uid: 'excel!Excel.ChartType.lineMarkers:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LineMarkers"'
+ - name: lineMarkersStacked
+ uid: 'excel!Excel.ChartType.lineMarkersStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LineMarkersStacked"'
+ - name: lineMarkersStacked100
+ uid: 'excel!Excel.ChartType.lineMarkersStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LineMarkersStacked100"'
+ - name: lineStacked
+ uid: 'excel!Excel.ChartType.lineStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LineStacked"'
+ - name: lineStacked100
+ uid: 'excel!Excel.ChartType.lineStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LineStacked100"'
+ - name: pareto
+ uid: 'excel!Excel.ChartType.pareto:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Pareto"'
+ - name: pie
+ uid: 'excel!Excel.ChartType.pie:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Pie"'
+ - name: pieExploded
+ uid: 'excel!Excel.ChartType.pieExploded:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PieExploded"'
+ - name: pieOfPie
+ uid: 'excel!Excel.ChartType.pieOfPie:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PieOfPie"'
+ - name: pyramidBarClustered
+ uid: 'excel!Excel.ChartType.pyramidBarClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PyramidBarClustered"'
+ - name: pyramidBarStacked
+ uid: 'excel!Excel.ChartType.pyramidBarStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PyramidBarStacked"'
+ - name: pyramidBarStacked100
+ uid: 'excel!Excel.ChartType.pyramidBarStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PyramidBarStacked100"'
+ - name: pyramidCol
+ uid: 'excel!Excel.ChartType.pyramidCol:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PyramidCol"'
+ - name: pyramidColClustered
+ uid: 'excel!Excel.ChartType.pyramidColClustered:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PyramidColClustered"'
+ - name: pyramidColStacked
+ uid: 'excel!Excel.ChartType.pyramidColStacked:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PyramidColStacked"'
+ - name: pyramidColStacked100
+ uid: 'excel!Excel.ChartType.pyramidColStacked100:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PyramidColStacked100"'
+ - name: radar
+ uid: 'excel!Excel.ChartType.radar:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Radar"'
+ - name: radarFilled
+ uid: 'excel!Excel.ChartType.radarFilled:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"RadarFilled"'
+ - name: radarMarkers
+ uid: 'excel!Excel.ChartType.radarMarkers:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"RadarMarkers"'
+ - name: regionMap
+ uid: 'excel!Excel.ChartType.regionMap:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"RegionMap"'
+ - name: stockHLC
+ uid: 'excel!Excel.ChartType.stockHLC:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"StockHLC"'
+ - name: stockOHLC
+ uid: 'excel!Excel.ChartType.stockOHLC:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"StockOHLC"'
+ - name: stockVHLC
+ uid: 'excel!Excel.ChartType.stockVHLC:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"StockVHLC"'
+ - name: stockVOHLC
+ uid: 'excel!Excel.ChartType.stockVOHLC:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"StockVOHLC"'
+ - name: sunburst
+ uid: 'excel!Excel.ChartType.sunburst:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Sunburst"'
+ - name: surface
+ uid: 'excel!Excel.ChartType.surface:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Surface"'
+ - name: surfaceTopView
+ uid: 'excel!Excel.ChartType.surfaceTopView:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SurfaceTopView"'
+ - name: surfaceTopViewWireframe
+ uid: 'excel!Excel.ChartType.surfaceTopViewWireframe:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SurfaceTopViewWireframe"'
+ - name: surfaceWireframe
+ uid: 'excel!Excel.ChartType.surfaceWireframe:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SurfaceWireframe"'
+ - name: treemap
+ uid: 'excel!Excel.ChartType.treemap:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Treemap"'
+ - name: waterfall
+ uid: 'excel!Excel.ChartType.waterfall:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Waterfall"'
+ - name: xyscatter
+ uid: 'excel!Excel.ChartType.xyscatter:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"XYScatter"'
+ - name: xyscatterLines
+ uid: 'excel!Excel.ChartType.xyscatterLines:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"XYScatterLines"'
+ - name: xyscatterLinesNoMarkers
+ uid: 'excel!Excel.ChartType.xyscatterLinesNoMarkers:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"XYScatterLinesNoMarkers"'
+ - name: xyscatterSmooth
+ uid: 'excel!Excel.ChartType.xyscatterSmooth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"XYScatterSmooth"'
+ - name: xyscatterSmoothNoMarkers
+ uid: 'excel!Excel.ChartType.xyscatterSmoothNoMarkers:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"XYScatterSmoothNoMarkers"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.chartunderlinestyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartunderlinestyle.yml
new file mode 100644
index 0000000000..f17a850b4b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.chartunderlinestyle.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ChartUnderlineStyle
+uid: 'excel!Excel.ChartUnderlineStyle:enum'
+package: excel!
+fullName: Excel.ChartUnderlineStyle
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: none
+ uid: 'excel!Excel.ChartUnderlineStyle.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: single
+ uid: 'excel!Excel.ChartUnderlineStyle.single:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Single"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.clearapplyto.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.clearapplyto.yml
new file mode 100644
index 0000000000..46e59da5eb
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.clearapplyto.yml
@@ -0,0 +1,85 @@
+### YamlMime:TSEnum
+name: Excel.ClearApplyTo
+uid: 'excel!Excel.ClearApplyTo:enum'
+package: excel!
+fullName: Excel.ClearApplyTo
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-hyperlink.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Orders");
+
+ const productsRange = sheet.getRange("A3:A11");
+ productsRange.load("values");
+
+ await context.sync();
+
+ // Clear all hyperlinks.
+ for (let i = 0; i < productsRange.values.length; i++) {
+ let cellRange = productsRange.getCell(i, 0);
+
+ // Clear the hyperlink.
+ // This eliminates the hyperlink but does not update text format.
+ cellRange.clear(Excel.ClearApplyTo.hyperlinks);
+
+ // Update text format.
+ cellRange.format.font.underline = Excel.RangeUnderlineStyle.none;
+ cellRange.format.font.color = "#000000";
+ }
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: all
+ uid: 'excel!Excel.ClearApplyTo.all:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"All"'
+ - name: contents
+ uid: 'excel!Excel.ClearApplyTo.contents:member'
+ package: excel!
+ summary: |-
+ Clears the contents of the range.
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Contents"'
+ - name: formats
+ uid: 'excel!Excel.ClearApplyTo.formats:member'
+ package: excel!
+ summary: |-
+ Clears all formatting for the range.
+
+ * \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Formats"'
+ - name: hyperlinks
+ uid: 'excel!Excel.ClearApplyTo.hyperlinks:member'
+ package: excel!
+ summary: |-
+ Clears all hyperlinks, but leaves all content and formatting intact.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Hyperlinks"'
+ - name: removeHyperlinks
+ uid: 'excel!Excel.ClearApplyTo.removeHyperlinks:member'
+ package: excel!
+ summary: >-
+ Removes hyperlinks and formatting for the cell but leaves content, conditional formats, and data validation
+ intact.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RemoveHyperlinks"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.closebehavior.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.closebehavior.yml
new file mode 100644
index 0000000000..012354badd
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.closebehavior.yml
@@ -0,0 +1,42 @@
+### YamlMime:TSEnum
+name: Excel.CloseBehavior
+uid: 'excel!Excel.CloseBehavior:enum'
+package: excel!
+fullName: Excel.CloseBehavior
+summary: Specifies the close behavior for `Workbook.close`.
+remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/workbook-save-and-close.yaml
+
+ await Excel.run(async (context) => {
+ context.workbook.close(Excel.CloseBehavior.skipSave);
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: save
+ uid: 'excel!Excel.CloseBehavior.save:member'
+ package: excel!
+ summary: |-
+ Save the possible changes before closing the workbook.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Save"'
+ - name: skipSave
+ uid: 'excel!Excel.CloseBehavior.skipSave:member'
+ package: excel!
+ summary: |-
+ Discard the possible changes when closing the workbook.
+
+ * \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SkipSave"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.colorscaleconditionalformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.colorscaleconditionalformat.yml
new file mode 100644
index 0000000000..f08dbd4460
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.colorscaleconditionalformat.yml
@@ -0,0 +1,208 @@
+### YamlMime:TSType
+name: Excel.ColorScaleConditionalFormat
+uid: 'excel!Excel.ColorScaleConditionalFormat:class'
+package: excel!
+fullName: Excel.ColorScaleConditionalFormat
+summary: Represents the color scale criteria for conditional formatting.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ColorScaleConditionalFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: criteria
+ uid: 'excel!Excel.ColorScaleConditionalFormat#criteria:member'
+ package: excel!
+ fullName: criteria
+ summary: The criteria of the color scale. Midpoint is optional when using a two point color scale.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B2:M5");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.colorScale);
+ const criteria = {
+ minimum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.lowestValue, color: "blue" },
+ midpoint: { formula: "50", type: Excel.ConditionalFormatColorCriterionType.percent, color: "yellow" },
+ maximum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.highestValue, color: "red" }
+ };
+ conditionalFormat.colorScale.criteria = criteria;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'criteria: Excel.ConditionalColorScaleCriteria;'
+ return:
+ type: ''
+ - name: threeColorScale
+ uid: 'excel!Excel.ColorScaleConditionalFormat#threeColorScale:member'
+ package: excel!
+ fullName: threeColorScale
+ summary: >-
+ If `true`, the color scale will have three points (minimum, midpoint, maximum), otherwise it will have two
+ (minimum, maximum).
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly threeColorScale: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ColorScaleConditionalFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ColorScaleConditionalFormatLoadOptions): Excel.ColorScaleConditionalFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ColorScaleConditionalFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ColorScaleConditionalFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ColorScaleConditionalFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ColorScaleConditionalFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ColorScaleConditionalFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ set(properties: Interfaces.ColorScaleConditionalFormatUpdateData, options?: OfficeExtension.UpdateOptions):
+ void;
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ColorScaleConditionalFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ColorScaleConditionalFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ColorScaleConditionalFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ColorScaleConditionalFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ColorScaleConditionalFormatData`) that
+ contains shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ColorScaleConditionalFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.columnproperties.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.columnproperties.yml
new file mode 100644
index 0000000000..fdc549c178
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.columnproperties.yml
@@ -0,0 +1,60 @@
+### YamlMime:TSType
+name: Excel.ColumnProperties
+uid: 'excel!Excel.ColumnProperties:interface'
+package: excel!
+fullName: Excel.ColumnProperties
+summary: |-
+ Represents the returned properties of getColumnProperties.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: address
+ uid: 'excel!Excel.ColumnProperties#address:member'
+ package: excel!
+ fullName: address
+ summary: |-
+ Represents the `address` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'address?: string;'
+ return:
+ type: string
+ - name: addressLocal
+ uid: 'excel!Excel.ColumnProperties#addressLocal:member'
+ package: excel!
+ fullName: addressLocal
+ summary: |-
+ Represents the `addressLocal` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'addressLocal?: string;'
+ return:
+ type: string
+ - name: columnIndex
+ uid: 'excel!Excel.ColumnProperties#columnIndex:member'
+ package: excel!
+ fullName: columnIndex
+ summary: |-
+ Represents the `columnIndex` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'columnIndex?: number;'
+ return:
+ type: number
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.columnpropertiesloadoptions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.columnpropertiesloadoptions.yml
new file mode 100644
index 0000000000..5d0899829a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.columnpropertiesloadoptions.yml
@@ -0,0 +1,66 @@
+### YamlMime:TSType
+name: Excel.ColumnPropertiesLoadOptions
+uid: 'excel!Excel.ColumnPropertiesLoadOptions:interface'
+package: excel!
+fullName: Excel.ColumnPropertiesLoadOptions
+summary: |-
+ Represents which column properties to load, when used as part of a "range.getColumnProperties" method.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: columnHidden
+ uid: 'excel!Excel.ColumnPropertiesLoadOptions#columnHidden:member'
+ package: excel!
+ fullName: columnHidden
+ summary: |-
+ Specifies whether to load on the `columnHidden` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'columnHidden?: boolean;'
+ return:
+ type: boolean
+ - name: columnIndex
+ uid: 'excel!Excel.ColumnPropertiesLoadOptions#columnIndex:member'
+ package: excel!
+ fullName: columnIndex
+ summary: |-
+ Specifies whether to load on the `columnIndex` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'columnIndex?: boolean;'
+ return:
+ type: boolean
+ - name: format
+ uid: 'excel!Excel.ColumnPropertiesLoadOptions#format:member'
+ package: excel!
+ fullName: format
+ summary: |-
+ Specifies whether to load on the `format` property.
+
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ format?: Excel.CellPropertiesFormatLoadOptions & {
+ columnWidth?: boolean;
+ };
+ return:
+ type: |-
+ & {
+ columnWidth?: boolean;
+ }
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.comment.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.comment.yml
new file mode 100644
index 0000000000..8119a5de63
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.comment.yml
@@ -0,0 +1,396 @@
+### YamlMime:TSType
+name: Excel.Comment
+uid: 'excel!Excel.Comment:class'
+package: excel!
+fullName: Excel.Comment
+summary: Represents a comment in the workbook.
+remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: authorEmail
+ uid: 'excel!Excel.Comment#authorEmail:member'
+ package: excel!
+ fullName: authorEmail
+ summary: Gets the email of the comment's author.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly authorEmail: string;'
+ return:
+ type: string
+ - name: authorName
+ uid: 'excel!Excel.Comment#authorName:member'
+ package: excel!
+ fullName: authorName
+ summary: Gets the name of the comment's author.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly authorName: string;'
+ return:
+ type: string
+ - name: content
+ uid: 'excel!Excel.Comment#content:member'
+ package: excel!
+ fullName: content
+ summary: The comment's content. The string is plain text.
+ remarks: >-
+ \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-basics.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Comments");
+ const comment = sheet.comments.getItemAt(0);
+ comment.content = "PLEASE add headers here.";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'content: string;'
+ return:
+ type: string
+ - name: contentType
+ uid: 'excel!Excel.Comment#contentType:member'
+ package: excel!
+ fullName: contentType
+ summary: Gets the content type of the comment.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly contentType: Excel.ContentType | "Plain" | "Mention";'
+ return:
+ type: ' | "Plain" | "Mention"'
+ - name: context
+ uid: 'excel!Excel.Comment#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: creationDate
+ uid: 'excel!Excel.Comment#creationDate:member'
+ package: excel!
+ fullName: creationDate
+ summary: >-
+ Gets the creation time of the comment. Returns `null` if the comment was converted from a note, since the comment
+ does not have a creation date.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly creationDate: Date;'
+ return:
+ type: Date
+ - name: id
+ uid: 'excel!Excel.Comment#id:member'
+ package: excel!
+ fullName: id
+ summary: Specifies the comment identifier.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: mentions
+ uid: 'excel!Excel.Comment#mentions:member'
+ package: excel!
+ fullName: mentions
+ summary: 'Gets the entities (e.g., people) that are mentioned in comments.'
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly mentions: Excel.CommentMention[];'
+ return:
+ type: '[]'
+ - name: replies
+ uid: 'excel!Excel.Comment#replies:member'
+ package: excel!
+ fullName: replies
+ summary: Represents a collection of reply objects associated with the comment.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly replies: Excel.CommentReplyCollection;'
+ return:
+ type: ''
+ - name: resolved
+ uid: 'excel!Excel.Comment#resolved:member'
+ package: excel!
+ fullName: resolved
+ summary: The comment thread status. A value of `true` means that the comment thread is resolved.
+ remarks: >-
+ \[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-resolution.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Comments");
+ sheet.comments.getItemAt(0).resolved = true;
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'resolved: boolean;'
+ return:
+ type: boolean
+ - name: richContent
+ uid: 'excel!Excel.Comment#richContent:member'
+ package: excel!
+ fullName: richContent
+ summary: >-
+ Gets the rich comment content (e.g., mentions in comments). This string is not meant to be displayed to end-users.
+ Your add-in should only use this to parse rich comment content.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly richContent: string;'
+ return:
+ type: string
+methods:
+ - name: delete()
+ uid: 'excel!Excel.Comment#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes the comment and all the connected replies.
+ remarks: >-
+ \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-basics.yaml
+
+ await Excel.run(async (context) => {
+ context.workbook.comments.getItemByCell("Comments!A2").delete();
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getLocation()
+ uid: 'excel!Excel.Comment#getLocation:member(1)'
+ package: excel!
+ fullName: getLocation()
+ summary: Gets the cell where this comment is located.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getLocation(): Excel.Range;'
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.Comment#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.CommentLoadOptions): Excel.Comment;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.Comment#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.Comment;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: >-
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-basics.yaml
+
+ await Excel.run(async (context) => {
+ const comment = context.workbook.comments.getItemByCell("Comments!A2");
+ comment.load(["authorEmail", "authorName", "creationDate"]);
+ await context.sync();
+
+ console.log(`${comment.creationDate.toDateString()}: ${comment.authorName} (${comment.authorEmail})`);
+ await context.sync();
+ });
+
+ ```
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.Comment#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.Comment;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.Comment#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.CommentUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.Comment#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.Comment): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.Comment#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.Comment object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.CommentData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CommentData;'
+ return:
+ type: ''
+ description: ''
+ - name: updateMentions(contentWithMentions)
+ uid: 'excel!Excel.Comment#updateMentions:member(1)'
+ package: excel!
+ fullName: updateMentions(contentWithMentions)
+ summary: Updates the comment content with a specially formatted string and a list of mentions.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'updateMentions(contentWithMentions: Excel.CommentRichContent): void;'
+ parameters:
+ - id: contentWithMentions
+ description: >-
+ The content for the comment. This contains a specially formatted string and a list of mentions that will be
+ parsed into the string when displayed by Excel.
+ type: ''
+ return:
+ type: void
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentaddedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentaddedeventargs.yml
new file mode 100644
index 0000000000..4ea43ee373
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentaddedeventargs.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.CommentAddedEventArgs
+uid: 'excel!Excel.CommentAddedEventArgs:interface'
+package: excel!
+fullName: Excel.CommentAddedEventArgs
+summary: Provides information about the comments that raised the comment added event.
+remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: commentDetails
+ uid: 'excel!Excel.CommentAddedEventArgs#commentDetails:member'
+ package: excel!
+ fullName: commentDetails
+ summary: Gets the `CommentDetail` array that contains the comment ID and IDs of its related replies.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'commentDetails: Excel.CommentDetail[];'
+ return:
+ type: '[]'
+ - name: source
+ uid: 'excel!Excel.CommentAddedEventArgs#source:member'
+ package: excel!
+ fullName: source
+ summary: Specifies the source of the event. See `Excel.EventSource` for details.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'source: Excel.EventSource | "Local" | "Remote";'
+ return:
+ type: ' | "Local" | "Remote"'
+ - name: type
+ uid: 'excel!Excel.CommentAddedEventArgs#type:member'
+ package: excel!
+ fullName: type
+ summary: Gets the type of the event. See `Excel.EventType` for details.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: "CommentAdded";'
+ return:
+ type: '"CommentAdded"'
+ - name: worksheetId
+ uid: 'excel!Excel.CommentAddedEventArgs#worksheetId:member'
+ package: excel!
+ fullName: worksheetId
+ summary: Gets the ID of the worksheet in which the event happened.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'worksheetId: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentchangedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentchangedeventargs.yml
new file mode 100644
index 0000000000..29acd20420
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentchangedeventargs.yml
@@ -0,0 +1,75 @@
+### YamlMime:TSType
+name: Excel.CommentChangedEventArgs
+uid: 'excel!Excel.CommentChangedEventArgs:interface'
+package: excel!
+fullName: Excel.CommentChangedEventArgs
+summary: Occurs when existing comments are changed.
+remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: changeType
+ uid: 'excel!Excel.CommentChangedEventArgs#changeType:member'
+ package: excel!
+ fullName: changeType
+ summary: Gets the change type that represents how the changed event is triggered.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ changeType: Excel.CommentChangeType | "CommentEdited" | "CommentResolved" | "CommentReopened" | "ReplyAdded" |
+ "ReplyDeleted" | "ReplyEdited";
+ return:
+ type: >-
+ | "CommentEdited" | "CommentResolved" | "CommentReopened" |
+ "ReplyAdded" | "ReplyDeleted" | "ReplyEdited"
+ - name: commentDetails
+ uid: 'excel!Excel.CommentChangedEventArgs#commentDetails:member'
+ package: excel!
+ fullName: commentDetails
+ summary: Get the `CommentDetail` array which contains the comment ID and IDs of its related replies.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'commentDetails: Excel.CommentDetail[];'
+ return:
+ type: '[]'
+ - name: source
+ uid: 'excel!Excel.CommentChangedEventArgs#source:member'
+ package: excel!
+ fullName: source
+ summary: Specifies the source of the event. See `Excel.EventSource` for details.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'source: Excel.EventSource | "Local" | "Remote";'
+ return:
+ type: ' | "Local" | "Remote"'
+ - name: type
+ uid: 'excel!Excel.CommentChangedEventArgs#type:member'
+ package: excel!
+ fullName: type
+ summary: Gets the type of the event. See `Excel.EventType` for details.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: "CommentChanged";'
+ return:
+ type: '"CommentChanged"'
+ - name: worksheetId
+ uid: 'excel!Excel.CommentChangedEventArgs#worksheetId:member'
+ package: excel!
+ fullName: worksheetId
+ summary: Gets the ID of the worksheet in which the event happened.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'worksheetId: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentchangetype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentchangetype.yml
new file mode 100644
index 0000000000..ecf3e6ea39
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentchangetype.yml
@@ -0,0 +1,58 @@
+### YamlMime:TSEnum
+name: Excel.CommentChangeType
+uid: 'excel!Excel.CommentChangeType:enum'
+package: excel!
+fullName: Excel.CommentChangeType
+summary: Represents how the comments in the event were changed.
+remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: commentEdited
+ uid: 'excel!Excel.CommentChangeType.commentEdited:member'
+ package: excel!
+ summary: |-
+ Comments were edited.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CommentEdited"'
+ - name: commentReopened
+ uid: 'excel!Excel.CommentChangeType.commentReopened:member'
+ package: excel!
+ summary: |-
+ Comments were reopened.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CommentReopened"'
+ - name: commentResolved
+ uid: 'excel!Excel.CommentChangeType.commentResolved:member'
+ package: excel!
+ summary: |-
+ Comments were resolved.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CommentResolved"'
+ - name: replyAdded
+ uid: 'excel!Excel.CommentChangeType.replyAdded:member'
+ package: excel!
+ summary: |-
+ Replies were added.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ReplyAdded"'
+ - name: replyDeleted
+ uid: 'excel!Excel.CommentChangeType.replyDeleted:member'
+ package: excel!
+ summary: |-
+ Replies were deleted.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ReplyDeleted"'
+ - name: replyEdited
+ uid: 'excel!Excel.CommentChangeType.replyEdited:member'
+ package: excel!
+ summary: |-
+ Replies were edited.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ReplyEdited"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentcollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentcollection.yml
new file mode 100644
index 0000000000..4bd5c94f37
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentcollection.yml
@@ -0,0 +1,494 @@
+### YamlMime:TSType
+name: Excel.CommentCollection
+uid: 'excel!Excel.CommentCollection:class'
+package: excel!
+fullName: Excel.CommentCollection
+summary: Represents a collection of comment objects that are part of the workbook.
+remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CommentCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.CommentCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.Comment[];'
+ return:
+ type: '[]'
+methods:
+ - name: 'add(cellAddress, content, contentType)'
+ uid: 'excel!Excel.CommentCollection#add:member(1)'
+ package: excel!
+ fullName: 'add(cellAddress, content, contentType)'
+ summary: >-
+ Creates a new comment with the given content on the given cell. An `InvalidArgument` error is thrown if the
+ provided range is larger than one cell.
+ remarks: >-
+ \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-basics.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Comments");
+
+ // Note that an InvalidArgument error will be thrown if multiple cells passed to `comment.add`.
+ sheet.comments.add("A2", "TODO: add data.");
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ add(cellAddress: Range | string, content: CommentRichContent | string, contentType?: Excel.ContentType):
+ Excel.Comment;
+ parameters:
+ - id: cellAddress
+ description: >-
+ The cell to which the comment is added. This can be a `Range` object or a string. If it's a string, it must
+ contain the full address, including the sheet name. An `InvalidArgument` error is thrown if the provided
+ range is larger than one cell.
+ type: ' | string'
+ - id: content
+ description: >-
+ The comment's content. This can be either a string or `CommentRichContent` object. Strings are used for
+ plain text. `CommentRichContent` objects allow for other comment features, such as mentions. \[Api set:
+ ExcelApi 1.10 for string, 1.11 for CommentRichContent object\]
+ type: ' | string'
+ - id: contentType
+ description: >-
+ Optional. The type of content contained within the comment. The default value is enum
+ `ContentType.Plain`. \[Api set: ExcelApi 1.10 for Enum ContentType.Plain, 1.11 for Enum
+ ContentType.Mention\]
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: 'add(cellAddress, content, contentTypeString)'
+ uid: 'excel!Excel.CommentCollection#add:member(2)'
+ package: excel!
+ fullName: 'add(cellAddress, content, contentTypeString)'
+ summary: >-
+ Creates a new comment with the given content on the given cell. An `InvalidArgument` error is thrown if the
+ provided range is larger than one cell.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ add(cellAddress: Range | string, content: CommentRichContent | string, contentTypeString?: "Plain" | "Mention"):
+ Excel.Comment;
+ parameters:
+ - id: cellAddress
+ description: >-
+ The cell to which the comment is added. This can be a `Range` object or a string. If it's a string, it must
+ contain the full address, including the sheet name. An `InvalidArgument` error is thrown if the provided
+ range is larger than one cell.
+ type: ' | string'
+ - id: content
+ description: >-
+ The comment's content. This can be either a string or `CommentRichContent` object. Strings are used for
+ plain text. `CommentRichContent` objects allow for other comment features, such as mentions. \[Api set:
+ ExcelApi 1.10 for string, 1.11 for CommentRichContent object\]
+ type: ' | string'
+ - id: contentTypeString
+ description: >-
+ Optional. The type of content contained within the comment. The default value is enum
+ `ContentType.Plain`. \[Api set: ExcelApi 1.10 for Enum ContentType.Plain, 1.11 for Enum
+ ContentType.Mention\]
+ type: '"Plain" | "Mention"'
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.CommentCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the number of comments in the collection.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(commentId)
+ uid: 'excel!Excel.CommentCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(commentId)
+ summary: Gets a comment from the collection based on its ID.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(commentId: string): Excel.Comment;'
+ parameters:
+ - id: commentId
+ description: The identifier for the comment.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.CommentCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Gets a comment from the collection based on its position.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.Comment;'
+ parameters:
+ - id: index
+ description: Index value of the object to be retrieved. Zero-indexed.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: getItemByCell(cellAddress)
+ uid: 'excel!Excel.CommentCollection#getItemByCell:member(1)'
+ package: excel!
+ fullName: getItemByCell(cellAddress)
+ summary: Gets the comment from the specified cell.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemByCell(cellAddress: Range | string): Excel.Comment;'
+ parameters:
+ - id: cellAddress
+ description: >-
+ The cell which the comment is on. This can be a `Range` object or a string. If it's a string, it must
+ contain the full address, including the sheet name. An `InvalidArgument` error is thrown if the provided
+ range is larger than one cell.
+ type: ' | string'
+ return:
+ type: ''
+ description: ''
+ - name: getItemByReplyId(replyId)
+ uid: 'excel!Excel.CommentCollection#getItemByReplyId:member(1)'
+ package: excel!
+ fullName: getItemByReplyId(replyId)
+ summary: Gets the comment to which the given reply is connected.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemByReplyId(replyId: string): Excel.Comment;'
+ parameters:
+ - id: replyId
+ description: The identifier of comment reply.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(commentId)
+ uid: 'excel!Excel.CommentCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(commentId)
+ summary: >-
+ Gets a comment from the collection based on its ID. If the comment object does not exist, then this method returns
+ an object with its `isNullObject` property set to `true`. For further information, see [*OrNullObject
+ methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(commentId: string): Excel.Comment;'
+ parameters:
+ - id: commentId
+ description: The identifier for the comment.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CommentCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.CommentCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.CommentCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CommentCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CommentCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CommentCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.CommentCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CommentCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.CommentCollection` object is an API object, the `toJSON` method returns
+ a plain JavaScript object (typed as `Excel.Interfaces.CommentCollectionData`) that contains an "items"
+ array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CommentCollectionData;'
+ return:
+ type: ''
+ description: ''
+events:
+ - name: onAdded
+ uid: 'excel!Excel.CommentCollection#onAdded:member'
+ package: excel!
+ fullName: onAdded
+ summary: Occurs when the comments are added.
+ remarks: >-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-comment-event-handler.yaml
+
+ await Excel.run(async (context) => {
+ const comments = context.workbook.worksheets.getActiveWorksheet().comments;
+
+ // Register the onAdded, onChanged, and onDeleted comment event handlers.
+ comments.onAdded.add(commentAdded);
+ comments.onChanged.add(commentChanged);
+ comments.onDeleted.add(commentDeleted);
+
+ await context.sync();
+
+ console.log("Added event handlers for when comments are added, changed, or deleted.");
+ });
+
+
+ ...
+
+ async function commentAdded(event: Excel.CommentAddedEventArgs) {
+ // Retrieve the added comment using the comment ID.
+ // Note: This function assumes only a single comment is added at a time.
+ await Excel.run(async (context) => {
+ const addedComment = context.workbook.comments.getItem(event.commentDetails[0].commentId);
+
+ // Load the added comment's data.
+ addedComment.load(["content", "authorName", "creationDate"]);
+
+ await context.sync();
+
+ // Print out the added comment's data.
+ console.log(`A comment was added:`);
+ console.log(` ID: ${event.commentDetails[0].commentId}`);
+ console.log(` Comment content:${addedComment.content}`);
+ console.log(` Comment author:${addedComment.authorName}`);
+ console.log(` Creation date:${addedComment.creationDate}`);
+ });
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onAdded: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+ - name: onChanged
+ uid: 'excel!Excel.CommentCollection#onChanged:member'
+ package: excel!
+ fullName: onChanged
+ summary: 'Occurs when comments or replies in a comment collection are changed, including when replies are deleted.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-comment-event-handler.yaml
+
+ await Excel.run(async (context) => {
+ const comments = context.workbook.worksheets.getActiveWorksheet().comments;
+
+ // Register the onAdded, onChanged, and onDeleted comment event handlers.
+ comments.onAdded.add(commentAdded);
+ comments.onChanged.add(commentChanged);
+ comments.onDeleted.add(commentDeleted);
+
+ await context.sync();
+
+ console.log("Added event handlers for when comments are added, changed, or deleted.");
+ });
+
+
+ ...
+
+ async function commentChanged(event: Excel.CommentChangedEventArgs) {
+ // Retrieve the changed comment using the comment ID.
+ // Note: This function assumes only a single comment is changed at a time.
+ await Excel.run(async (context) => {
+ const changedComment = context.workbook.comments.getItem(event.commentDetails[0].commentId);
+
+ // Load the changed comment's data.
+ changedComment.load(["content", "authorName", "creationDate"]);
+
+ await context.sync();
+
+ // Print out the changed comment's data.
+ console.log(`A comment was changed:`);
+ console.log(` ID: ${event.commentDetails[0].commentId}`);
+ console.log(` Updated comment content: ${changedComment.content}`);
+ console.log(` Comment author: ${changedComment.authorName}`);
+ console.log(` Creation date: ${changedComment.creationDate}`);
+ });
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onChanged: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+ - name: onDeleted
+ uid: 'excel!Excel.CommentCollection#onDeleted:member'
+ package: excel!
+ fullName: onDeleted
+ summary: Occurs when comments are deleted in the comment collection.
+ remarks: >-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-comment-event-handler.yaml
+
+ await Excel.run(async (context) => {
+ const comments = context.workbook.worksheets.getActiveWorksheet().comments;
+
+ // Register the onAdded, onChanged, and onDeleted comment event handlers.
+ comments.onAdded.add(commentAdded);
+ comments.onChanged.add(commentChanged);
+ comments.onDeleted.add(commentDeleted);
+
+ await context.sync();
+
+ console.log("Added event handlers for when comments are added, changed, or deleted.");
+ });
+
+
+ ...
+
+ async function commentDeleted(event: Excel.CommentDeletedEventArgs) {
+ // Print out the deleted comment's ID.
+ // Note: This function assumes only a single comment is deleted at a time.
+ await Excel.run(async (context) => {
+ console.log(`A comment was deleted:`);
+ console.log(` ID: ${event.commentDetails[0].commentId}`);
+ });
+ }
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly onDeleted: OfficeExtension.EventHandlers;'
+ return:
+ type: >-
+ <>
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentdeletedeventargs.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentdeletedeventargs.yml
new file mode 100644
index 0000000000..9e3b408df1
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentdeletedeventargs.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.CommentDeletedEventArgs
+uid: 'excel!Excel.CommentDeletedEventArgs:interface'
+package: excel!
+fullName: Excel.CommentDeletedEventArgs
+summary: Provides information about the comments that raised the comment deleted event.
+remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: commentDetails
+ uid: 'excel!Excel.CommentDeletedEventArgs#commentDetails:member'
+ package: excel!
+ fullName: commentDetails
+ summary: Gets the `CommentDetail` array that contains the comment ID and IDs of its related replies.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'commentDetails: Excel.CommentDetail[];'
+ return:
+ type: '[]'
+ - name: source
+ uid: 'excel!Excel.CommentDeletedEventArgs#source:member'
+ package: excel!
+ fullName: source
+ summary: Specifies the source of the event. See `Excel.EventSource` for details.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'source: Excel.EventSource | "Local" | "Remote";'
+ return:
+ type: ' | "Local" | "Remote"'
+ - name: type
+ uid: 'excel!Excel.CommentDeletedEventArgs#type:member'
+ package: excel!
+ fullName: type
+ summary: Gets the type of the event. See `Excel.EventType` for details.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: "CommentDeleted";'
+ return:
+ type: '"CommentDeleted"'
+ - name: worksheetId
+ uid: 'excel!Excel.CommentDeletedEventArgs#worksheetId:member'
+ package: excel!
+ fullName: worksheetId
+ summary: Gets the ID of the worksheet in which the event happened.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'worksheetId: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentdetail.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentdetail.yml
new file mode 100644
index 0000000000..66c37da01d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentdetail.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSType
+name: Excel.CommentDetail
+uid: 'excel!Excel.CommentDetail:interface'
+package: excel!
+fullName: Excel.CommentDetail
+summary: A structure for the comment ID and IDs of its related replies.
+remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: commentId
+ uid: 'excel!Excel.CommentDetail#commentId:member'
+ package: excel!
+ fullName: commentId
+ summary: Represents the ID of the comment.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'commentId: string;'
+ return:
+ type: string
+ - name: replyIds
+ uid: 'excel!Excel.CommentDetail#replyIds:member'
+ package: excel!
+ fullName: replyIds
+ summary: Represents the IDs of the related replies that belong to the comment.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'replyIds: string[];'
+ return:
+ type: 'string[]'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentmention.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentmention.yml
new file mode 100644
index 0000000000..0cd7c81f34
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentmention.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.CommentMention
+uid: 'excel!Excel.CommentMention:interface'
+package: excel!
+fullName: Excel.CommentMention
+summary: Represents the entity that is mentioned in comments.
+remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: email
+ uid: 'excel!Excel.CommentMention#email:member'
+ package: excel!
+ fullName: email
+ summary: The email address of the entity that is mentioned in a comment.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'email: string;'
+ return:
+ type: string
+ - name: id
+ uid: 'excel!Excel.CommentMention#id:member'
+ package: excel!
+ fullName: id
+ summary: The ID of the entity. The ID matches one of the IDs in `CommentRichContent.richContent`.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'id: number;'
+ return:
+ type: number
+ - name: name
+ uid: 'excel!Excel.CommentMention#name:member'
+ package: excel!
+ fullName: name
+ summary: The name of the entity that is mentioned in a comment.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentreply.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentreply.yml
new file mode 100644
index 0000000000..6795b07720
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentreply.yml
@@ -0,0 +1,366 @@
+### YamlMime:TSType
+name: Excel.CommentReply
+uid: 'excel!Excel.CommentReply:class'
+package: excel!
+fullName: Excel.CommentReply
+summary: Represents a comment reply in the workbook.
+remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: authorEmail
+ uid: 'excel!Excel.CommentReply#authorEmail:member'
+ package: excel!
+ fullName: authorEmail
+ summary: Gets the email of the comment reply's author.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly authorEmail: string;'
+ return:
+ type: string
+ - name: authorName
+ uid: 'excel!Excel.CommentReply#authorName:member'
+ package: excel!
+ fullName: authorName
+ summary: Gets the name of the comment reply's author.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly authorName: string;'
+ return:
+ type: string
+ - name: content
+ uid: 'excel!Excel.CommentReply#content:member'
+ package: excel!
+ fullName: content
+ summary: The comment reply's content. The string is plain text.
+ remarks: >-
+ \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-replies.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Comments");
+ const comment = sheet.comments.getItemAt(0);
+ const reply = comment.replies.getItemAt(0);
+ reply.load("content");
+ // Sync to load the content of the comment reply.
+ await context.sync();
+
+ // Append "Please!" to the end of the comment reply.
+ reply.content += " Please!";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'content: string;'
+ return:
+ type: string
+ - name: contentType
+ uid: 'excel!Excel.CommentReply#contentType:member'
+ package: excel!
+ fullName: contentType
+ summary: The content type of the reply.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly contentType: Excel.ContentType | "Plain" | "Mention";'
+ return:
+ type: ' | "Plain" | "Mention"'
+ - name: context
+ uid: 'excel!Excel.CommentReply#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: creationDate
+ uid: 'excel!Excel.CommentReply#creationDate:member'
+ package: excel!
+ fullName: creationDate
+ summary: Gets the creation time of the comment reply.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly creationDate: Date;'
+ return:
+ type: Date
+ - name: id
+ uid: 'excel!Excel.CommentReply#id:member'
+ package: excel!
+ fullName: id
+ summary: Specifies the comment reply identifier.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: mentions
+ uid: 'excel!Excel.CommentReply#mentions:member'
+ package: excel!
+ fullName: mentions
+ summary: 'The entities (e.g., people) that are mentioned in comments.'
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly mentions: Excel.CommentMention[];'
+ return:
+ type: '[]'
+ - name: resolved
+ uid: 'excel!Excel.CommentReply#resolved:member'
+ package: excel!
+ fullName: resolved
+ summary: The comment reply status. A value of `true` means the reply is in the resolved state.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly resolved: boolean;'
+ return:
+ type: boolean
+ - name: richContent
+ uid: 'excel!Excel.CommentReply#richContent:member'
+ package: excel!
+ fullName: richContent
+ summary: >-
+ The rich comment content (e.g., mentions in comments). This string is not meant to be displayed to end-users. Your
+ add-in should only use this to parse rich comment content.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly richContent: string;'
+ return:
+ type: string
+methods:
+ - name: delete()
+ uid: 'excel!Excel.CommentReply#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes the comment reply.
+ remarks: >-
+ \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-replies.yaml
+
+ await Excel.run(async (context) => {
+ // Remove the first comment reply from this worksheet's first comment.
+ const sheet = context.workbook.worksheets.getItem("Comments");
+ const comment = sheet.comments.getItemAt(0);
+ comment.replies.getItemAt(0).delete();
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getLocation()
+ uid: 'excel!Excel.CommentReply#getLocation:member(1)'
+ package: excel!
+ fullName: getLocation()
+ summary: Gets the cell where this comment reply is located.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getLocation(): Excel.Range;'
+ return:
+ type: ''
+ description: ''
+ - name: getParentComment()
+ uid: 'excel!Excel.CommentReply#getParentComment:member(1)'
+ package: excel!
+ fullName: getParentComment()
+ summary: Gets the parent comment of this reply.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getParentComment(): Excel.Comment;'
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CommentReply#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.CommentReplyLoadOptions): Excel.CommentReply;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CommentReply#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CommentReply;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CommentReply#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.CommentReply;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.CommentReply#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.CommentReplyUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.CommentReply#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.CommentReply): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CommentReply#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.CommentReply object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.CommentReplyData`) that contains shallow copies of any
+ loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CommentReplyData;'
+ return:
+ type: ''
+ description: ''
+ - name: updateMentions(contentWithMentions)
+ uid: 'excel!Excel.CommentReply#updateMentions:member(1)'
+ package: excel!
+ fullName: updateMentions(contentWithMentions)
+ summary: Updates the comment content with a specially formatted string and a list of mentions.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'updateMentions(contentWithMentions: Excel.CommentRichContent): void;'
+ parameters:
+ - id: contentWithMentions
+ description: >-
+ The content for the comment. This contains a specially formatted string and a list of mentions that will be
+ parsed into the string when displayed by Excel.
+ type: ''
+ return:
+ type: void
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentreplycollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentreplycollection.yml
new file mode 100644
index 0000000000..e97ffeea17
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentreplycollection.yml
@@ -0,0 +1,259 @@
+### YamlMime:TSType
+name: Excel.CommentReplyCollection
+uid: 'excel!Excel.CommentReplyCollection:class'
+package: excel!
+fullName: Excel.CommentReplyCollection
+summary: Represents a collection of comment reply objects that are part of the comment.
+remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CommentReplyCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.CommentReplyCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.CommentReply[];'
+ return:
+ type: '[]'
+methods:
+ - name: 'add(content, contentType)'
+ uid: 'excel!Excel.CommentReplyCollection#add:member(1)'
+ package: excel!
+ fullName: 'add(content, contentType)'
+ summary: Creates a comment reply for a comment.
+ remarks: >-
+ \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-replies.yaml
+
+ await Excel.run(async (context) => {
+ // Adds a reply to the first comment in this worksheet.
+ const sheet = context.workbook.worksheets.getItem("Comments");
+ const comment = sheet.comments.getItemAt(0);
+ comment.replies.add("Add content to this worksheet.");
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(content: CommentRichContent | string, contentType?: Excel.ContentType): Excel.CommentReply;'
+ parameters:
+ - id: content
+ description: >-
+ The comment's content. This can be either a string or a `CommentRichContent` object (e.g., for comments with
+ mentions). \[Api set: ExcelApi 1.10 for string, 1.11 for CommentRichContent object\]
+ type: ' | string'
+ - id: contentType
+ description: >-
+ Optional. The type of content contained within the comment. The default value is enum
+ `ContentType.Plain`. \[Api set: ExcelApi 1.10 for Enum ContentType.Plain, 1.11 for Enum
+ ContentType.Mention\]
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: 'add(content, contentTypeString)'
+ uid: 'excel!Excel.CommentReplyCollection#add:member(2)'
+ package: excel!
+ fullName: 'add(content, contentTypeString)'
+ summary: Creates a comment reply for a comment.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(content: CommentRichContent | string, contentTypeString?: "Plain" | "Mention"): Excel.CommentReply;'
+ parameters:
+ - id: content
+ description: >-
+ The comment's content. This can be either a string or a `CommentRichContent` object (e.g., for comments with
+ mentions). \[Api set: ExcelApi 1.10 for string, 1.11 for CommentRichContent object\]
+ type: ' | string'
+ - id: contentTypeString
+ description: >-
+ Optional. The type of content contained within the comment. The default value is enum
+ `ContentType.Plain`. \[Api set: ExcelApi 1.10 for Enum ContentType.Plain, 1.11 for Enum
+ ContentType.Mention\]
+ type: '"Plain" | "Mention"'
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.CommentReplyCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the number of comment replies in the collection.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(commentReplyId)
+ uid: 'excel!Excel.CommentReplyCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(commentReplyId)
+ summary: Returns a comment reply identified by its ID.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(commentReplyId: string): Excel.CommentReply;'
+ parameters:
+ - id: commentReplyId
+ description: The identifier for the comment reply.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.CommentReplyCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Gets a comment reply based on its position in the collection.
+ remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.CommentReply;'
+ parameters:
+ - id: index
+ description: The index value of the comment reply to be retrieved. The collection uses zero-based indexing.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(commentReplyId)
+ uid: 'excel!Excel.CommentReplyCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(commentReplyId)
+ summary: >-
+ Returns a comment reply identified by its ID. If the comment reply object does not exist, then this method returns
+ an object with its `isNullObject` property set to `true`. For further information, see [*OrNullObject
+ methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(commentReplyId: string): Excel.CommentReply;'
+ parameters:
+ - id: commentReplyId
+ description: The identifier for the comment reply.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CommentReplyCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.CommentReplyCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.CommentReplyCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CommentReplyCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CommentReplyCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CommentReplyCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.CommentReplyCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CommentReplyCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.CommentReplyCollection` object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.CommentReplyCollectionData`) that contains
+ an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CommentReplyCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.commentrichcontent.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentrichcontent.yml
new file mode 100644
index 0000000000..60147a0bc9
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.commentrichcontent.yml
@@ -0,0 +1,71 @@
+### YamlMime:TSType
+name: Excel.CommentRichContent
+uid: 'excel!Excel.CommentRichContent:interface'
+package: excel!
+fullName: Excel.CommentRichContent
+summary: >-
+ Represents the content contained within a comment or comment reply. Rich content incudes the text string and any other
+ objects contained within the comment body, such as mentions.
+remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: mentions
+ uid: 'excel!Excel.CommentRichContent#mentions:member'
+ package: excel!
+ fullName: mentions
+ summary: 'An array containing all the entities (e.g., people) mentioned within the comment.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-mentions.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Comments");
+ const mention = {
+ email: "kakri@contoso.com",
+ id: 0,
+ name: "Kate Kristensen"
+ };
+
+ // This will tag the mention's name using the '@' syntax.
+ // They will be notified via email.
+ const commentBody = {
+ mentions: [mention],
+ richContent: '' + mention.name + " - Can you take a look?"
+ };
+
+ // Note that an InvalidArgument error will be thrown if multiple cells passed to `comment.add`.
+ sheet.comments.add("A1", commentBody, Excel.ContentType.mention);
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'mentions?: Excel.CommentMention[];'
+ return:
+ type: '[]'
+ - name: richContent
+ uid: 'excel!Excel.CommentRichContent#richContent:member'
+ package: excel!
+ fullName: richContent
+ summary: >-
+ Specifies the rich content of the comment (e.g., comment content with mentions, the first mentioned entity has an
+ ID attribute of 0, and the second mentioned entity has an ID attribute of 1).
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'richContent: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.compactlayout.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.compactlayout.yml
new file mode 100644
index 0000000000..fcf9893452
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.compactlayout.yml
@@ -0,0 +1,10 @@
+### YamlMime:TSTypeAlias
+name: Excel.CompactLayout
+uid: 'excel!Excel.CompactLayout:type'
+package: excel!
+fullName: Excel.CompactLayout
+summary: Represents the layout used when there is limited space to represent the entity.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+syntax: export type CompactLayout = EntityCompactLayout;
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcellvalueoperator.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcellvalueoperator.yml
new file mode 100644
index 0000000000..908fcb4661
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcellvalueoperator.yml
@@ -0,0 +1,55 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalCellValueOperator
+uid: 'excel!Excel.ConditionalCellValueOperator:enum'
+package: excel!
+fullName: Excel.ConditionalCellValueOperator
+summary: Represents the operator of the text conditional format type.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: between
+ uid: 'excel!Excel.ConditionalCellValueOperator.between:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Between"'
+ - name: equalTo
+ uid: 'excel!Excel.ConditionalCellValueOperator.equalTo:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EqualTo"'
+ - name: greaterThan
+ uid: 'excel!Excel.ConditionalCellValueOperator.greaterThan:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"GreaterThan"'
+ - name: greaterThanOrEqual
+ uid: 'excel!Excel.ConditionalCellValueOperator.greaterThanOrEqual:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"GreaterThanOrEqual"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalCellValueOperator.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: lessThan
+ uid: 'excel!Excel.ConditionalCellValueOperator.lessThan:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LessThan"'
+ - name: lessThanOrEqual
+ uid: 'excel!Excel.ConditionalCellValueOperator.lessThanOrEqual:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LessThanOrEqual"'
+ - name: notBetween
+ uid: 'excel!Excel.ConditionalCellValueOperator.notBetween:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NotBetween"'
+ - name: notEqualTo
+ uid: 'excel!Excel.ConditionalCellValueOperator.notEqualTo:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NotEqualTo"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcellvaluerule.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcellvaluerule.yml
new file mode 100644
index 0000000000..6cb25090af
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcellvaluerule.yml
@@ -0,0 +1,97 @@
+### YamlMime:TSType
+name: Excel.ConditionalCellValueRule
+uid: 'excel!Excel.ConditionalCellValueRule:interface'
+package: excel!
+fullName: Excel.ConditionalCellValueRule
+summary: Represents a cell value conditional format rule.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: formula1
+ uid: 'excel!Excel.ConditionalCellValueRule#formula1:member'
+ package: excel!
+ fullName: formula1
+ summary: 'The formula, if required, on which to evaluate the conditional format rule.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B21:E23");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.cellValue);
+ conditionalFormat.cellValue.format.font.color = "red";
+ conditionalFormat.cellValue.rule = { formula1: "=0", operator: "LessThan" };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula1: string;'
+ return:
+ type: string
+ - name: formula2
+ uid: 'excel!Excel.ConditionalCellValueRule#formula2:member'
+ package: excel!
+ fullName: formula2
+ summary: 'The formula, if required, on which to evaluate the conditional format rule.'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula2?: string;'
+ return:
+ type: string
+ - name: operator
+ uid: 'excel!Excel.ConditionalCellValueRule#operator:member'
+ package: excel!
+ fullName: operator
+ summary: The operator of the cell value conditional format.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B21:E23");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.cellValue);
+ conditionalFormat.cellValue.format.font.color = "red";
+ conditionalFormat.cellValue.rule = { formula1: "=0", operator: "LessThan" };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ operator: Excel.ConditionalCellValueOperator | "Invalid" | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" |
+ "GreaterThan" | "LessThan" | "GreaterThanOrEqual" | "LessThanOrEqual";
+ return:
+ type: >-
+ | "Invalid" | "Between" | "NotBetween" |
+ "EqualTo" | "NotEqualTo" | "GreaterThan" | "LessThan" | "GreaterThanOrEqual" | "LessThanOrEqual"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcolorscalecriteria.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcolorscalecriteria.yml
new file mode 100644
index 0000000000..94fd3074a9
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcolorscalecriteria.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.ConditionalColorScaleCriteria
+uid: 'excel!Excel.ConditionalColorScaleCriteria:interface'
+package: excel!
+fullName: Excel.ConditionalColorScaleCriteria
+summary: Represents the criteria of the color scale.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: maximum
+ uid: 'excel!Excel.ConditionalColorScaleCriteria#maximum:member'
+ package: excel!
+ fullName: maximum
+ summary: The maximum point of the color scale criterion.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'maximum: Excel.ConditionalColorScaleCriterion;'
+ return:
+ type: ''
+ - name: midpoint
+ uid: 'excel!Excel.ConditionalColorScaleCriteria#midpoint:member'
+ package: excel!
+ fullName: midpoint
+ summary: 'The midpoint of the color scale criterion, if the color scale is a 3-color scale.'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'midpoint?: Excel.ConditionalColorScaleCriterion;'
+ return:
+ type: ''
+ - name: minimum
+ uid: 'excel!Excel.ConditionalColorScaleCriteria#minimum:member'
+ package: excel!
+ fullName: minimum
+ summary: The minimum point of the color scale criterion.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'minimum: Excel.ConditionalColorScaleCriterion;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcolorscalecriterion.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcolorscalecriterion.yml
new file mode 100644
index 0000000000..5e3fa7eee8
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalcolorscalecriterion.yml
@@ -0,0 +1,51 @@
+### YamlMime:TSType
+name: Excel.ConditionalColorScaleCriterion
+uid: 'excel!Excel.ConditionalColorScaleCriterion:interface'
+package: excel!
+fullName: Excel.ConditionalColorScaleCriterion
+summary: 'Represents a color scale criterion which contains a type, value, and a color.'
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: color
+ uid: 'excel!Excel.ConditionalColorScaleCriterion#color:member'
+ package: excel!
+ fullName: color
+ summary: 'HTML color code representation of the color scale color (e.g., \#FF0000 represents Red).'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: string;'
+ return:
+ type: string
+ - name: formula
+ uid: 'excel!Excel.ConditionalColorScaleCriterion#formula:member'
+ package: excel!
+ fullName: formula
+ summary: 'A number, a formula, or `null` (if `type` is `lowestValue`).'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula?: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.ConditionalColorScaleCriterion#type:member'
+ package: excel!
+ fullName: type
+ summary: What the criterion conditional formula should be based on.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ type: Excel.ConditionalFormatColorCriterionType | "Invalid" | "LowestValue" | "HighestValue" | "Number" |
+ "Percent" | "Formula" | "Percentile";
+ return:
+ type: >-
+ | "Invalid" | "LowestValue" |
+ "HighestValue" | "Number" | "Percent" | "Formula" | "Percentile"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabaraxisformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabaraxisformat.yml
new file mode 100644
index 0000000000..5c7fd82cbc
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabaraxisformat.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalDataBarAxisFormat
+uid: 'excel!Excel.ConditionalDataBarAxisFormat:enum'
+package: excel!
+fullName: Excel.ConditionalDataBarAxisFormat
+summary: Represents the format options for a data bar axis.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ConditionalDataBarAxisFormat.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: cellMidPoint
+ uid: 'excel!Excel.ConditionalDataBarAxisFormat.cellMidPoint:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CellMidPoint"'
+ - name: none
+ uid: 'excel!Excel.ConditionalDataBarAxisFormat.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabardirection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabardirection.yml
new file mode 100644
index 0000000000..ecb40b5fec
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabardirection.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalDataBarDirection
+uid: 'excel!Excel.ConditionalDataBarDirection:enum'
+package: excel!
+fullName: Excel.ConditionalDataBarDirection
+summary: Represents the data bar direction within a cell.
+remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.dataBar);
+ conditionalFormat.dataBar.barDirection = Excel.ConditionalDataBarDirection.leftToRight;
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: context
+ uid: 'excel!Excel.ConditionalDataBarDirection.context:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Context"'
+ - name: leftToRight
+ uid: 'excel!Excel.ConditionalDataBarDirection.leftToRight:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LeftToRight"'
+ - name: rightToLeft
+ uid: 'excel!Excel.ConditionalDataBarDirection.rightToLeft:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"RightToLeft"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarnegativeformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarnegativeformat.yml
new file mode 100644
index 0000000000..cf8b16830d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarnegativeformat.yml
@@ -0,0 +1,209 @@
+### YamlMime:TSType
+name: Excel.ConditionalDataBarNegativeFormat
+uid: 'excel!Excel.ConditionalDataBarNegativeFormat:class'
+package: excel!
+fullName: Excel.ConditionalDataBarNegativeFormat
+summary: Represents a conditional format for the negative side of the data bar.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: borderColor
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#borderColor:member'
+ package: excel!
+ fullName: borderColor
+ summary: >-
+ HTML color code representing the color of the border line, in the form \#RRGGBB (e.g., "FFA500") or as a named
+ HTML color (e.g., "orange"). Value is "" (an empty string) if no border is present or set.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'borderColor: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fillColor
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#fillColor:member'
+ package: excel!
+ fullName: fillColor
+ summary: >-
+ HTML color code representing the fill color, in the form \#RRGGBB (e.g., "FFA500") or as a named HTML color (e.g.,
+ "orange").
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fillColor: string;'
+ return:
+ type: string
+ - name: matchPositiveBorderColor
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#matchPositiveBorderColor:member'
+ package: excel!
+ fullName: matchPositiveBorderColor
+ summary: Specifies if the negative data bar has the same border color as the positive data bar.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'matchPositiveBorderColor: boolean;'
+ return:
+ type: boolean
+ - name: matchPositiveFillColor
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#matchPositiveFillColor:member'
+ package: excel!
+ fullName: matchPositiveFillColor
+ summary: Specifies if the negative data bar has the same fill color as the positive data bar.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'matchPositiveFillColor: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ConditionalDataBarNegativeFormatLoadOptions):
+ Excel.ConditionalDataBarNegativeFormat;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalDataBarNegativeFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalDataBarNegativeFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ set(properties: Interfaces.ConditionalDataBarNegativeFormatUpdateData, options?: OfficeExtension.UpdateOptions):
+ void;
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalDataBarNegativeFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalDataBarNegativeFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalDataBarNegativeFormat object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalDataBarNegativeFormatData`) that contains shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalDataBarNegativeFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarpositiveformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarpositiveformat.yml
new file mode 100644
index 0000000000..8ade5ae03c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarpositiveformat.yml
@@ -0,0 +1,197 @@
+### YamlMime:TSType
+name: Excel.ConditionalDataBarPositiveFormat
+uid: 'excel!Excel.ConditionalDataBarPositiveFormat:class'
+package: excel!
+fullName: Excel.ConditionalDataBarPositiveFormat
+summary: Represents a conditional format for the positive side of the data bar.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: borderColor
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#borderColor:member'
+ package: excel!
+ fullName: borderColor
+ summary: >-
+ HTML color code representing the color of the border line, in the form \#RRGGBB (e.g., "FFA500") or as a named
+ HTML color (e.g., "orange"). Value is "" (an empty string) if no border is present or set.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'borderColor: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fillColor
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#fillColor:member'
+ package: excel!
+ fullName: fillColor
+ summary: >-
+ HTML color code representing the fill color, in the form \#RRGGBB (e.g., "FFA500") or as a named HTML color (e.g.,
+ "orange").
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fillColor: string;'
+ return:
+ type: string
+ - name: gradientFill
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#gradientFill:member'
+ package: excel!
+ fullName: gradientFill
+ summary: Specifies if the data bar has a gradient.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'gradientFill: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ConditionalDataBarPositiveFormatLoadOptions):
+ Excel.ConditionalDataBarPositiveFormat;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalDataBarPositiveFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalDataBarPositiveFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ set(properties: Interfaces.ConditionalDataBarPositiveFormatUpdateData, options?: OfficeExtension.UpdateOptions):
+ void;
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalDataBarPositiveFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalDataBarPositiveFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalDataBarPositiveFormat object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalDataBarPositiveFormatData`) that contains shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalDataBarPositiveFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarrule.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarrule.yml
new file mode 100644
index 0000000000..dfdc3c1867
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaldatabarrule.yml
@@ -0,0 +1,39 @@
+### YamlMime:TSType
+name: Excel.ConditionalDataBarRule
+uid: 'excel!Excel.ConditionalDataBarRule:interface'
+package: excel!
+fullName: Excel.ConditionalDataBarRule
+summary: Represents a rule-type for a data bar.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: formula
+ uid: 'excel!Excel.ConditionalDataBarRule#formula:member'
+ package: excel!
+ fullName: formula
+ summary: 'The formula, if required, on which to evaluate the data bar rule.'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula?: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.ConditionalDataBarRule#type:member'
+ package: excel!
+ fullName: type
+ summary: The type of rule for the data bar.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ type: Excel.ConditionalFormatRuleType | "Invalid" | "Automatic" | "LowestValue" | "HighestValue" | "Number" |
+ "Percent" | "Formula" | "Percentile";
+ return:
+ type: >-
+ | "Invalid" | "Automatic" | "LowestValue" |
+ "HighestValue" | "Number" | "Percent" | "Formula" | "Percentile"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformat.yml
new file mode 100644
index 0000000000..579e9b21f6
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformat.yml
@@ -0,0 +1,884 @@
+### YamlMime:TSType
+name: Excel.ConditionalFormat
+uid: 'excel!Excel.ConditionalFormat:class'
+package: excel!
+fullName: Excel.ConditionalFormat
+summary: >-
+ An object encapsulating a conditional format's range, format, rule, and other properties. To learn more about the
+ conditional formatting object model, read [Apply conditional formatting to Excel
+ ranges](https://docs.microsoft.com/office/dev/add-ins/excel/excel-add-ins-conditional-formatting).
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: cellValue
+ uid: 'excel!Excel.ConditionalFormat#cellValue:member'
+ package: excel!
+ fullName: cellValue
+ summary: Returns the cell value conditional format properties if the current conditional format is a `CellValue` type.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B21:E23");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.cellValue);
+ conditionalFormat.cellValue.format.font.color = "red";
+ conditionalFormat.cellValue.rule = { formula1: "=0", operator: "LessThan" };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly cellValue: Excel.CellValueConditionalFormat;'
+ return:
+ type: ''
+ - name: cellValueOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#cellValueOrNullObject:member'
+ package: excel!
+ fullName: cellValueOrNullObject
+ summary: Returns the cell value conditional format properties if the current conditional format is a `CellValue` type.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly cellValueOrNullObject: Excel.CellValueConditionalFormat;'
+ return:
+ type: ''
+ - name: colorScale
+ uid: 'excel!Excel.ConditionalFormat#colorScale:member'
+ package: excel!
+ fullName: colorScale
+ summary: Returns the color scale conditional format properties if the current conditional format is a `ColorScale` type.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B2:M5");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.colorScale);
+ const criteria = {
+ minimum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.lowestValue, color: "blue" },
+ midpoint: { formula: "50", type: Excel.ConditionalFormatColorCriterionType.percent, color: "yellow" },
+ maximum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.highestValue, color: "red" }
+ };
+ conditionalFormat.colorScale.criteria = criteria;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly colorScale: Excel.ColorScaleConditionalFormat;'
+ return:
+ type: ''
+ - name: colorScaleOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#colorScaleOrNullObject:member'
+ package: excel!
+ fullName: colorScaleOrNullObject
+ summary: Returns the color scale conditional format properties if the current conditional format is a `ColorScale` type.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly colorScaleOrNullObject: Excel.ColorScaleConditionalFormat;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ConditionalFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: custom
+ uid: 'excel!Excel.ConditionalFormat#custom:member'
+ package: excel!
+ fullName: custom
+ summary: Returns the custom conditional format properties if the current conditional format is a custom type.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats.add(Excel.ConditionalFormatType.custom);
+ conditionalFormat.custom.rule.formula = '=IF(B8>INDIRECT("RC[-1]",0),TRUE)';
+ conditionalFormat.custom.format.font.color = "green";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly custom: Excel.CustomConditionalFormat;'
+ return:
+ type: ''
+ - name: customOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#customOrNullObject:member'
+ package: excel!
+ fullName: customOrNullObject
+ summary: Returns the custom conditional format properties if the current conditional format is a custom type.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly customOrNullObject: Excel.CustomConditionalFormat;'
+ return:
+ type: ''
+ - name: dataBar
+ uid: 'excel!Excel.ConditionalFormat#dataBar:member'
+ package: excel!
+ fullName: dataBar
+ summary: Returns the data bar properties if the current conditional format is a data bar.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.dataBar);
+ conditionalFormat.dataBar.barDirection = Excel.ConditionalDataBarDirection.leftToRight;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly dataBar: Excel.DataBarConditionalFormat;'
+ return:
+ type: ''
+ - name: dataBarOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#dataBarOrNullObject:member'
+ package: excel!
+ fullName: dataBarOrNullObject
+ summary: Returns the data bar properties if the current conditional format is a data bar.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly dataBarOrNullObject: Excel.DataBarConditionalFormat;'
+ return:
+ type: ''
+ - name: iconSet
+ uid: 'excel!Excel.ConditionalFormat#iconSet:member'
+ package: excel!
+ fullName: iconSet
+ summary: Returns the icon set conditional format properties if the current conditional format is an `IconSet` type.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.iconSet);
+ const iconSetCF = conditionalFormat.iconSet;
+ iconSetCF.style = Excel.IconSet.threeTriangles;
+
+ /*
+ The iconSetCF.criteria array is automatically prepopulated with
+ criterion elements whose properties have been given default settings.
+ You can't write to each property of a criterion directly. Instead,
+ replace the whole criteria object.
+
+ With a "three*" icon set style, such as "threeTriangles", the third
+ element in the criteria array (criteria[2]) defines the "top" icon;
+ e.g., a green triangle. The second (criteria[1]) defines the "middle"
+ icon. The first (criteria[0]) defines the "low" icon, but it
+ can often be left empty as the following object shows, because every
+ cell that does not match the other two criteria always gets the low
+ icon.
+ */
+ iconSetCF.criteria = [
+ {} as any,
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=700"
+ },
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=1000",
+ }
+ ];
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly iconSet: Excel.IconSetConditionalFormat;'
+ return:
+ type: ''
+ - name: iconSetOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#iconSetOrNullObject:member'
+ package: excel!
+ fullName: iconSetOrNullObject
+ summary: Returns the icon set conditional format properties if the current conditional format is an `IconSet` type.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly iconSetOrNullObject: Excel.IconSetConditionalFormat;'
+ return:
+ type: ''
+ - name: id
+ uid: 'excel!Excel.ConditionalFormat#id:member'
+ package: excel!
+ fullName: id
+ summary: The priority of the conditional format in the current `ConditionalFormatCollection`.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: preset
+ uid: 'excel!Excel.ConditionalFormat#preset:member'
+ package: excel!
+ fullName: preset
+ summary: Returns the preset criteria conditional format. See `Excel.PresetCriteriaConditionalFormat` for more details.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B2:M5");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.presetCriteria);
+ conditionalFormat.preset.format.font.color = "white";
+ conditionalFormat.preset.rule = { criterion: Excel.ConditionalFormatPresetCriterion.oneStdDevAboveAverage };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly preset: Excel.PresetCriteriaConditionalFormat;'
+ return:
+ type: ''
+ - name: presetOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#presetOrNullObject:member'
+ package: excel!
+ fullName: presetOrNullObject
+ summary: Returns the preset criteria conditional format. See `Excel.PresetCriteriaConditionalFormat` for more details.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly presetOrNullObject: Excel.PresetCriteriaConditionalFormat;'
+ return:
+ type: ''
+ - name: priority
+ uid: 'excel!Excel.ConditionalFormat#priority:member'
+ package: excel!
+ fullName: priority
+ summary: >-
+ The priority (or index) within the conditional format collection that this conditional format currently exists in.
+ Changing this also changes other conditional formats' priorities, to allow for a contiguous priority order. Use a
+ negative priority to begin from the back. Priorities greater than the bounds will get and set to the maximum (or
+ minimum if negative) priority. Also note that if you change the priority, you have to re-fetch a new copy of the
+ object at that new priority location if you want to make further changes to it.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'priority: number;'
+ return:
+ type: number
+ - name: stopIfTrue
+ uid: 'excel!Excel.ConditionalFormat#stopIfTrue:member'
+ package: excel!
+ fullName: stopIfTrue
+ summary: >-
+ If the conditions of this conditional format are met, no lower-priority formats shall take effect on that cell.
+ Value is `null` on data bars, icon sets, and color scales as there's no concept of `StopIfTrue` for these.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'stopIfTrue: boolean;'
+ return:
+ type: boolean
+ - name: textComparison
+ uid: 'excel!Excel.ConditionalFormat#textComparison:member'
+ package: excel!
+ fullName: textComparison
+ summary: >-
+ Returns the specific text conditional format properties if the current conditional format is a text type. For
+ example, to format cells matching the word "Text".
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B16:D18");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.containsText);
+ conditionalFormat.textComparison.format.font.color = "red";
+ conditionalFormat.textComparison.rule = { operator: Excel.ConditionalTextOperator.contains, text: "Delayed" };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly textComparison: Excel.TextConditionalFormat;'
+ return:
+ type: ''
+ - name: textComparisonOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#textComparisonOrNullObject:member'
+ package: excel!
+ fullName: textComparisonOrNullObject
+ summary: >-
+ Returns the specific text conditional format properties if the current conditional format is a text type. For
+ example, to format cells matching the word "Text".
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly textComparisonOrNullObject: Excel.TextConditionalFormat;'
+ return:
+ type: ''
+ - name: topBottom
+ uid: 'excel!Excel.ConditionalFormat#topBottom:member'
+ package: excel!
+ fullName: topBottom
+ summary: >-
+ Returns the top/bottom conditional format properties if the current conditional format is a `TopBottom` type. For
+ example, to format the top 10% or bottom 10 items.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly topBottom: Excel.TopBottomConditionalFormat;'
+ return:
+ type: ''
+ - name: topBottomOrNullObject
+ uid: 'excel!Excel.ConditionalFormat#topBottomOrNullObject:member'
+ package: excel!
+ fullName: topBottomOrNullObject
+ summary: >-
+ Returns the top/bottom conditional format properties if the current conditional format is a `TopBottom` type. For
+ example, to format the top 10% or bottom 10 items.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly topBottomOrNullObject: Excel.TopBottomConditionalFormat;'
+ return:
+ type: ''
+ - name: type
+ uid: 'excel!Excel.ConditionalFormat#type:member'
+ package: excel!
+ fullName: type
+ summary: A type of conditional format. Only one can be set at a time.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const worksheetRange = sheet.getRange();
+ worksheetRange.conditionalFormats.load("type");
+
+ await context.sync();
+
+ let cfRangePairs: { cf: Excel.ConditionalFormat, range: Excel.Range }[] = [];
+ worksheetRange.conditionalFormats.items.forEach(item => {
+ cfRangePairs.push({
+ cf: item,
+ range: item.getRange().load("address")
+ });
+ });
+
+ await context.sync();
+
+ if (cfRangePairs.length > 0) {
+ cfRangePairs.forEach(item => {
+ console.log(item.cf.type);
+ });
+ } else {
+ console.log("No conditional formats applied.");
+ }
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ readonly type: Excel.ConditionalFormatType | "Custom" | "DataBar" | "ColorScale" | "IconSet" | "TopBottom" |
+ "PresetCriteria" | "ContainsText" | "CellValue";
+ return:
+ type: >-
+ | "Custom" | "DataBar" | "ColorScale" | "IconSet" |
+ "TopBottom" | "PresetCriteria" | "ContainsText" | "CellValue"
+methods:
+ - name: changeRuleToCellValue(properties)
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToCellValue:member(1)'
+ package: excel!
+ fullName: changeRuleToCellValue(properties)
+ summary: Change the conditional format rule type to cell value.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToCellValue(properties: Excel.ConditionalCellValueRule): void;'
+ parameters:
+ - id: properties
+ description: The properties to set for the cell value conditional format rule.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: changeRuleToColorScale()
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToColorScale:member(1)'
+ package: excel!
+ fullName: changeRuleToColorScale()
+ summary: Change the conditional format rule type to color scale.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToColorScale(): void;'
+ return:
+ type: void
+ description: ''
+ - name: changeRuleToContainsText(properties)
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToContainsText:member(1)'
+ package: excel!
+ fullName: changeRuleToContainsText(properties)
+ summary: Change the conditional format rule type to text comparison.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToContainsText(properties: Excel.ConditionalTextComparisonRule): void;'
+ parameters:
+ - id: properties
+ description: The properties to set for the text comparison conditional format rule.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: changeRuleToCustom(formula)
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToCustom:member(1)'
+ package: excel!
+ fullName: changeRuleToCustom(formula)
+ summary: Change the conditional format rule type to custom.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToCustom(formula: string): void;'
+ parameters:
+ - id: formula
+ description: The formula to set for the custom conditional format rule.
+ type: string
+ return:
+ type: void
+ description: ''
+ - name: changeRuleToDataBar()
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToDataBar:member(1)'
+ package: excel!
+ fullName: changeRuleToDataBar()
+ summary: Change the conditional format rule type to data bar.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToDataBar(): void;'
+ return:
+ type: void
+ description: ''
+ - name: changeRuleToIconSet()
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToIconSet:member(1)'
+ package: excel!
+ fullName: changeRuleToIconSet()
+ summary: Change the conditional format rule type to icon set.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToIconSet(): void;'
+ return:
+ type: void
+ description: ''
+ - name: changeRuleToPresetCriteria(properties)
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToPresetCriteria:member(1)'
+ package: excel!
+ fullName: changeRuleToPresetCriteria(properties)
+ summary: Change the conditional format rule type to preset criteria.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToPresetCriteria(properties: Excel.ConditionalPresetCriteriaRule): void;'
+ parameters:
+ - id: properties
+ description: The properties to set for the preset criteria conditional format rule.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: changeRuleToTopBottom(properties)
+ uid: 'excel!Excel.ConditionalFormat#changeRuleToTopBottom:member(1)'
+ package: excel!
+ fullName: changeRuleToTopBottom(properties)
+ summary: Change the conditional format rule type to top/bottom.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'changeRuleToTopBottom(properties: Excel.ConditionalTopBottomRule): void;'
+ parameters:
+ - id: properties
+ description: The properties to set for the top/bottom conditional format rule.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: delete()
+ uid: 'excel!Excel.ConditionalFormat#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes this conditional format.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getRange()
+ uid: 'excel!Excel.ConditionalFormat#getRange:member(1)'
+ package: excel!
+ fullName: getRange()
+ summary: >-
+ Returns the range the conditonal format is applied to. Throws an error if the conditional format is applied to
+ multiple ranges.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const worksheetRange = sheet.getRange();
+ worksheetRange.conditionalFormats.load("type");
+
+ await context.sync();
+
+ let cfRangePairs: { cf: Excel.ConditionalFormat, range: Excel.Range }[] = [];
+ worksheetRange.conditionalFormats.items.forEach(item => {
+ cfRangePairs.push({
+ cf: item,
+ range: item.getRange().load("address")
+ });
+ });
+
+ await context.sync();
+
+ if (cfRangePairs.length > 0) {
+ cfRangePairs.forEach(item => {
+ console.log(item.cf.type);
+ });
+ } else {
+ console.log("No conditional formats applied.");
+ }
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getRange(): Excel.Range;'
+ return:
+ type: ''
+ description: ''
+ - name: getRangeOrNullObject()
+ uid: 'excel!Excel.ConditionalFormat#getRangeOrNullObject:member(1)'
+ package: excel!
+ fullName: getRangeOrNullObject()
+ summary: >-
+ Returns the range to which the conditonal format is applied. If the conditional format is applied to multiple
+ ranges, then this method returns an object with its `isNullObject` property set to `true`. For further
+ information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getRangeOrNullObject(): Excel.Range;'
+ return:
+ type: ''
+ description: ''
+ - name: getRanges()
+ uid: 'excel!Excel.ConditionalFormat#getRanges:member(1)'
+ package: excel!
+ fullName: getRanges()
+ summary: >-
+ Returns the `RangeAreas`, comprising one or more rectangular ranges, to which the conditonal format is
+ applied.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getRanges(): Excel.RangeAreas;'
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ConditionalFormatLoadOptions): Excel.ConditionalFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ConditionalFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setRanges(ranges)
+ uid: 'excel!Excel.ConditionalFormat#setRanges:member(1)'
+ package: excel!
+ fullName: setRanges(ranges)
+ summary: Set the ranges that the conditonal format rule is applied to.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setRanges(ranges: Range | RangeAreas | string): void;'
+ parameters:
+ - id: ranges
+ description: Collection of one or more ranges for this rule to be applied to.
+ type: ' | | string'
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalFormat object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.ConditionalFormatData`) that contains shallow copies
+ of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatcollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatcollection.yml
new file mode 100644
index 0000000000..2082feaa6a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatcollection.yml
@@ -0,0 +1,360 @@
+### YamlMime:TSType
+name: Excel.ConditionalFormatCollection
+uid: 'excel!Excel.ConditionalFormatCollection:class'
+package: excel!
+fullName: Excel.ConditionalFormatCollection
+summary: Represents a collection of all the conditional formats that are overlap the range.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ConditionalFormatCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.ConditionalFormatCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.ConditionalFormat[];'
+ return:
+ type: '[]'
+methods:
+ - name: add(type)
+ uid: 'excel!Excel.ConditionalFormatCollection#add:member(1)'
+ package: excel!
+ fullName: add(type)
+ summary: Adds a new conditional format to the collection at the first/top priority.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B2:M5");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.colorScale);
+ const criteria = {
+ minimum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.lowestValue, color: "blue" },
+ midpoint: { formula: "50", type: Excel.ConditionalFormatColorCriterionType.percent, color: "yellow" },
+ maximum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.highestValue, color: "red" }
+ };
+ conditionalFormat.colorScale.criteria = criteria;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(type: Excel.ConditionalFormatType): Excel.ConditionalFormat;'
+ parameters:
+ - id: type
+ description: The type of conditional format being added. See `Excel.ConditionalFormatType` for details.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: add(typeString)
+ uid: 'excel!Excel.ConditionalFormatCollection#add:member(2)'
+ package: excel!
+ fullName: add(typeString)
+ summary: Adds a new conditional format to the collection at the first/top priority.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ add(typeString: "Custom" | "DataBar" | "ColorScale" | "IconSet" | "TopBottom" | "PresetCriteria" |
+ "ContainsText" | "CellValue"): Excel.ConditionalFormat;
+ parameters:
+ - id: typeString
+ description: The type of conditional format being added. See `Excel.ConditionalFormatType` for details.
+ type: >-
+ "Custom" | "DataBar" | "ColorScale" | "IconSet" | "TopBottom" | "PresetCriteria" | "ContainsText" |
+ "CellValue"
+ return:
+ type: ''
+ description: ''
+ - name: clearAll()
+ uid: 'excel!Excel.ConditionalFormatCollection#clearAll:member(1)'
+ package: excel!
+ fullName: clearAll()
+ summary: Clears all conditional formats active on the current specified range.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange();
+ range.conditionalFormats.clearAll();
+
+ await context.sync();
+
+ $(".conditional-formats").hide();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clearAll(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.ConditionalFormatCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Returns the number of conditional formats in the workbook.
+ remarks: |-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const sheetName = "Sheet1";
+ const rangeAddress = "A1:C3";
+ const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
+ const conditionalFormat = range.conditionalFormats.add(Excel.ConditionalFormatType.iconSet);
+ conditionalFormat.iconSetOrNullObject.style = Excel.IconSet.fourTrafficLights;
+ const cfCount = range.conditionalFormats.getCount();
+
+ await context.sync()
+ console.log("Count: " + cfCount.value);
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(id)
+ uid: 'excel!Excel.ConditionalFormatCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(id)
+ summary: Returns a conditional format for the given ID.
+ remarks: |-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const sheetName = "Sheet1";
+ const rangeAddress = "A1:C3";
+ const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
+ const conditionalFormats = range.conditionalFormats;
+ const conditionalFormat = conditionalFormats.getItemAt(3);
+ await context.sync()
+
+ console.log("Conditional Format at Item 3 Loaded");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(id: string): Excel.ConditionalFormat;'
+ parameters:
+ - id: id
+ description: The ID of the conditional format.
+ type: string
+ return:
+ type: ''
+ description: Conditional format object.
+ - name: getItemAt(index)
+ uid: 'excel!Excel.ConditionalFormatCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Returns a conditional format at the given index.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const worksheetRange = sheet.getRange();
+ worksheetRange.conditionalFormats.load("type");
+
+ await context.sync();
+
+ let cfRangePairs: { cf: Excel.ConditionalFormat, range: Excel.Range }[] = [];
+ worksheetRange.conditionalFormats.items.forEach(item => {
+ cfRangePairs.push({
+ cf: item,
+ range: item.getRange().load("address")
+ });
+ });
+
+ await context.sync();
+
+ if (cfRangePairs.length > 0) {
+ cfRangePairs.forEach(item => {
+ console.log(item.cf.type);
+ });
+ } else {
+ console.log("No conditional formats applied.");
+ }
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.ConditionalFormat;'
+ parameters:
+ - id: index
+ description: Index of the conditional formats to be retrieved.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(id)
+ uid: 'excel!Excel.ConditionalFormatCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(id)
+ summary: >-
+ Returns a conditional format identified by its ID. If the conditional format object does not exist, then this
+ method returns an object with its `isNullObject` property set to `true`. For further information, see
+ [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(id: string): Excel.ConditionalFormat;'
+ parameters:
+ - id: id
+ description: The ID of the conditional format.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalFormatCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ConditionalFormatCollectionLoadOptions &
+ Excel.Interfaces.CollectionLoadOptions): Excel.ConditionalFormatCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalFormatCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalFormatCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalFormatCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.ConditionalFormatCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalFormatCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.ConditionalFormatCollection` object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalFormatCollectionData`)
+ that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalFormatCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatcolorcriteriontype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatcolorcriteriontype.yml
new file mode 100644
index 0000000000..6a28c125e2
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatcolorcriteriontype.yml
@@ -0,0 +1,72 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalFormatColorCriterionType
+uid: 'excel!Excel.ConditionalFormatColorCriterionType:enum'
+package: excel!
+fullName: Excel.ConditionalFormatColorCriterionType
+summary: Represents the types of color criterion for conditional formatting.
+remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B2:M5");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.colorScale);
+ const criteria = {
+ minimum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.lowestValue, color: "blue" },
+ midpoint: { formula: "50", type: Excel.ConditionalFormatColorCriterionType.percent, color: "yellow" },
+ maximum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.highestValue, color: "red" }
+ };
+ conditionalFormat.colorScale.criteria = criteria;
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: formula
+ uid: 'excel!Excel.ConditionalFormatColorCriterionType.formula:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Formula"'
+ - name: highestValue
+ uid: 'excel!Excel.ConditionalFormatColorCriterionType.highestValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"HighestValue"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalFormatColorCriterionType.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: lowestValue
+ uid: 'excel!Excel.ConditionalFormatColorCriterionType.lowestValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LowestValue"'
+ - name: number
+ uid: 'excel!Excel.ConditionalFormatColorCriterionType.number:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Number"'
+ - name: percent
+ uid: 'excel!Excel.ConditionalFormatColorCriterionType.percent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percent"'
+ - name: percentile
+ uid: 'excel!Excel.ConditionalFormatColorCriterionType.percentile:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percentile"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatdirection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatdirection.yml
new file mode 100644
index 0000000000..f714bc2d61
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatdirection.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalFormatDirection
+uid: 'excel!Excel.ConditionalFormatDirection:enum'
+package: excel!
+fullName: Excel.ConditionalFormatDirection
+summary: Represents the direction for a selection.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bottom
+ uid: 'excel!Excel.ConditionalFormatDirection.bottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Bottom"'
+ - name: top
+ uid: 'excel!Excel.ConditionalFormatDirection.top:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Top"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformaticonruletype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformaticonruletype.yml
new file mode 100644
index 0000000000..1969ef5cbc
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformaticonruletype.yml
@@ -0,0 +1,86 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalFormatIconRuleType
+uid: 'excel!Excel.ConditionalFormatIconRuleType:enum'
+package: excel!
+fullName: Excel.ConditionalFormatIconRuleType
+summary: Represents the types of icon conditional format.
+remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.iconSet);
+ const iconSetCF = conditionalFormat.iconSet;
+ iconSetCF.style = Excel.IconSet.threeTriangles;
+
+ /*
+ The iconSetCF.criteria array is automatically prepopulated with
+ criterion elements whose properties have been given default settings.
+ You can't write to each property of a criterion directly. Instead,
+ replace the whole criteria object.
+
+ With a "three*" icon set style, such as "threeTriangles", the third
+ element in the criteria array (criteria[2]) defines the "top" icon;
+ e.g., a green triangle. The second (criteria[1]) defines the "middle"
+ icon. The first (criteria[0]) defines the "low" icon, but it
+ can often be left empty as the following object shows, because every
+ cell that does not match the other two criteria always gets the low
+ icon.
+ */
+ iconSetCF.criteria = [
+ {} as any,
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=700"
+ },
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=1000",
+ }
+ ];
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: formula
+ uid: 'excel!Excel.ConditionalFormatIconRuleType.formula:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Formula"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalFormatIconRuleType.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: number
+ uid: 'excel!Excel.ConditionalFormatIconRuleType.number:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Number"'
+ - name: percent
+ uid: 'excel!Excel.ConditionalFormatIconRuleType.percent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percent"'
+ - name: percentile
+ uid: 'excel!Excel.ConditionalFormatIconRuleType.percentile:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percentile"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatpresetcriterion.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatpresetcriterion.yml
new file mode 100644
index 0000000000..4eca83e7f8
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatpresetcriterion.yml
@@ -0,0 +1,191 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalFormatPresetCriterion
+uid: 'excel!Excel.ConditionalFormatPresetCriterion:enum'
+package: excel!
+fullName: Excel.ConditionalFormatPresetCriterion
+summary: Represents the criteria of the preset criteria conditional format type.
+remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-advanced.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ queueCommandsToClearAllConditionalFormats(sheet);
+
+ const temperatureDataRange = sheet.tables.getItem("TemperatureTable").getDataBodyRange();
+
+ /* When the priority property of ConditionalFormat objects
+ is not explicitly set, they are prioritized in the order
+ that they are added, with zero-based numbering: 0, 1, ...
+ Contradictions are resolved in favor of the format with
+ the lower priority number. In the example below, negative
+ numbers will get a green background, but NOT a blue font,
+ because priority goes to the format that gives them a red font.
+ */
+
+ // Set low numbers to bold, dark red font. This format will
+ // get priority 0.
+ const presetFormat = temperatureDataRange.conditionalFormats
+ .add(Excel.ConditionalFormatType.presetCriteria);
+ presetFormat.preset.format.font.color = "red";
+ presetFormat.preset.format.font.bold = true;
+ presetFormat.preset.rule = { criterion: Excel.ConditionalFormatPresetCriterion.oneStdDevBelowAverage };
+
+ // Set negative numbers to blue font with green background.
+ // This format will get priority 1.
+ const cellValueFormat = temperatureDataRange.conditionalFormats
+ .add(Excel.ConditionalFormatType.cellValue);
+ cellValueFormat.cellValue.format.font.color = "blue";
+ cellValueFormat.cellValue.format.fill.color = "lightgreen";
+ cellValueFormat.cellValue.rule = { formula1: "=0", operator: "LessThan" };
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: aboveAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.aboveAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AboveAverage"'
+ - name: belowAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.belowAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BelowAverage"'
+ - name: blanks
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.blanks:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Blanks"'
+ - name: duplicateValues
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.duplicateValues:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DuplicateValues"'
+ - name: equalOrAboveAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.equalOrAboveAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EqualOrAboveAverage"'
+ - name: equalOrBelowAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.equalOrBelowAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EqualOrBelowAverage"'
+ - name: errors
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.errors:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Errors"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: lastMonth
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.lastMonth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastMonth"'
+ - name: lastSevenDays
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.lastSevenDays:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastSevenDays"'
+ - name: lastWeek
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.lastWeek:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastWeek"'
+ - name: nextMonth
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.nextMonth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NextMonth"'
+ - name: nextWeek
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.nextWeek:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NextWeek"'
+ - name: nonBlanks
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.nonBlanks:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NonBlanks"'
+ - name: nonErrors
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.nonErrors:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NonErrors"'
+ - name: oneStdDevAboveAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.oneStdDevAboveAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"OneStdDevAboveAverage"'
+ - name: oneStdDevBelowAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.oneStdDevBelowAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"OneStdDevBelowAverage"'
+ - name: thisMonth
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.thisMonth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThisMonth"'
+ - name: thisWeek
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.thisWeek:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThisWeek"'
+ - name: threeStdDevAboveAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.threeStdDevAboveAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThreeStdDevAboveAverage"'
+ - name: threeStdDevBelowAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.threeStdDevBelowAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThreeStdDevBelowAverage"'
+ - name: today
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.today:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Today"'
+ - name: tomorrow
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.tomorrow:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Tomorrow"'
+ - name: twoStdDevAboveAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.twoStdDevAboveAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TwoStdDevAboveAverage"'
+ - name: twoStdDevBelowAverage
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.twoStdDevBelowAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TwoStdDevBelowAverage"'
+ - name: uniqueValues
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.uniqueValues:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"UniqueValues"'
+ - name: yesterday
+ uid: 'excel!Excel.ConditionalFormatPresetCriterion.yesterday:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Yesterday"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatrule.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatrule.yml
new file mode 100644
index 0000000000..dda859b1fe
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatrule.yml
@@ -0,0 +1,211 @@
+### YamlMime:TSType
+name: Excel.ConditionalFormatRule
+uid: 'excel!Excel.ConditionalFormatRule:class'
+package: excel!
+fullName: Excel.ConditionalFormatRule
+summary: 'Represents a rule, for all traditional rule/format pairings.'
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.ConditionalFormatRule#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: formula
+ uid: 'excel!Excel.ConditionalFormatRule#formula:member'
+ package: excel!
+ fullName: formula
+ summary: 'The formula, if required, on which to evaluate the conditional format rule.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats.add(Excel.ConditionalFormatType.custom);
+ conditionalFormat.custom.rule.formula = '=IF(B8>INDIRECT("RC[-1]",0),TRUE)';
+ conditionalFormat.custom.format.font.color = "green";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula: string;'
+ return:
+ type: string
+ - name: formulaLocal
+ uid: 'excel!Excel.ConditionalFormatRule#formulaLocal:member'
+ package: excel!
+ fullName: formulaLocal
+ summary: 'The formula, if required, on which to evaluate the conditional format rule in the user''s language.'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formulaLocal: string;'
+ return:
+ type: string
+ - name: formulaR1C1
+ uid: 'excel!Excel.ConditionalFormatRule#formulaR1C1:member'
+ package: excel!
+ fullName: formulaR1C1
+ summary: 'The formula, if required, on which to evaluate the conditional format rule in R1C1-style notation.'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formulaR1C1: string;'
+ return:
+ type: string
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalFormatRule#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ConditionalFormatRuleLoadOptions): Excel.ConditionalFormatRule;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalFormatRule#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalFormatRule;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalFormatRule#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalFormatRule;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalFormatRule#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ConditionalFormatRuleUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalFormatRule#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalFormatRule): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalFormatRule#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalFormatRule object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalFormatRuleData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalFormatRuleData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatruletype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatruletype.yml
new file mode 100644
index 0000000000..a7ab099292
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformatruletype.yml
@@ -0,0 +1,50 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalFormatRuleType
+uid: 'excel!Excel.ConditionalFormatRuleType:enum'
+package: excel!
+fullName: Excel.ConditionalFormatRuleType
+summary: Represents the types of conditional format values.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: automatic
+ uid: 'excel!Excel.ConditionalFormatRuleType.automatic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Automatic"'
+ - name: formula
+ uid: 'excel!Excel.ConditionalFormatRuleType.formula:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Formula"'
+ - name: highestValue
+ uid: 'excel!Excel.ConditionalFormatRuleType.highestValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"HighestValue"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalFormatRuleType.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: lowestValue
+ uid: 'excel!Excel.ConditionalFormatRuleType.lowestValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LowestValue"'
+ - name: number
+ uid: 'excel!Excel.ConditionalFormatRuleType.number:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Number"'
+ - name: percent
+ uid: 'excel!Excel.ConditionalFormatRuleType.percent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percent"'
+ - name: percentile
+ uid: 'excel!Excel.ConditionalFormatRuleType.percentile:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Percentile"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformattype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformattype.yml
new file mode 100644
index 0000000000..f3707bea26
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalformattype.yml
@@ -0,0 +1,96 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalFormatType
+uid: 'excel!Excel.ConditionalFormatType:enum'
+package: excel!
+fullName: Excel.ConditionalFormatType
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-advanced.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ queueCommandsToClearAllConditionalFormats(sheet);
+
+ const temperatureDataRange = sheet.tables.getItem("TemperatureTable").getDataBodyRange();
+
+ /* When the priority property of ConditionalFormat objects
+ is not explicitly set, they are prioritized in the order
+ that they are added, with zero-based numbering: 0, 1, ...
+ Contradictions are resolved in favor of the format with
+ the lower priority number. In the example below, negative
+ numbers will get a green background, but NOT a blue font,
+ because priority goes to the format that gives them a red font.
+ */
+
+ // Set low numbers to bold, dark red font. This format will
+ // get priority 0.
+ const presetFormat = temperatureDataRange.conditionalFormats
+ .add(Excel.ConditionalFormatType.presetCriteria);
+ presetFormat.preset.format.font.color = "red";
+ presetFormat.preset.format.font.bold = true;
+ presetFormat.preset.rule = { criterion: Excel.ConditionalFormatPresetCriterion.oneStdDevBelowAverage };
+
+ // Set negative numbers to blue font with green background.
+ // This format will get priority 1.
+ const cellValueFormat = temperatureDataRange.conditionalFormats
+ .add(Excel.ConditionalFormatType.cellValue);
+ cellValueFormat.cellValue.format.font.color = "blue";
+ cellValueFormat.cellValue.format.fill.color = "lightgreen";
+ cellValueFormat.cellValue.rule = { formula1: "=0", operator: "LessThan" };
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: cellValue
+ uid: 'excel!Excel.ConditionalFormatType.cellValue:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CellValue"'
+ - name: colorScale
+ uid: 'excel!Excel.ConditionalFormatType.colorScale:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ColorScale"'
+ - name: containsText
+ uid: 'excel!Excel.ConditionalFormatType.containsText:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ContainsText"'
+ - name: custom
+ uid: 'excel!Excel.ConditionalFormatType.custom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Custom"'
+ - name: dataBar
+ uid: 'excel!Excel.ConditionalFormatType.dataBar:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DataBar"'
+ - name: iconSet
+ uid: 'excel!Excel.ConditionalFormatType.iconSet:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"IconSet"'
+ - name: presetCriteria
+ uid: 'excel!Excel.ConditionalFormatType.presetCriteria:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"PresetCriteria"'
+ - name: topBottom
+ uid: 'excel!Excel.ConditionalFormatType.topBottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TopBottom"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaliconcriterion.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaliconcriterion.yml
new file mode 100644
index 0000000000..41cf7bc5d9
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaliconcriterion.yml
@@ -0,0 +1,218 @@
+### YamlMime:TSType
+name: Excel.ConditionalIconCriterion
+uid: 'excel!Excel.ConditionalIconCriterion:interface'
+package: excel!
+fullName: Excel.ConditionalIconCriterion
+summary: >-
+ Represents an icon criterion which contains a type, value, an operator, and an optional custom icon, if not using an
+ icon set.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: customIcon
+ uid: 'excel!Excel.ConditionalIconCriterion#customIcon:member'
+ package: excel!
+ fullName: customIcon
+ summary: 'The custom icon for the current criterion, if different from the default icon set, else `null` will be returned.'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'customIcon?: Excel.Icon;'
+ return:
+ type: ''
+ - name: formula
+ uid: 'excel!Excel.ConditionalIconCriterion#formula:member'
+ package: excel!
+ fullName: formula
+ summary: A number or a formula depending on the type.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.iconSet);
+ const iconSetCF = conditionalFormat.iconSet;
+ iconSetCF.style = Excel.IconSet.threeTriangles;
+
+ /*
+ The iconSetCF.criteria array is automatically prepopulated with
+ criterion elements whose properties have been given default settings.
+ You can't write to each property of a criterion directly. Instead,
+ replace the whole criteria object.
+
+ With a "three*" icon set style, such as "threeTriangles", the third
+ element in the criteria array (criteria[2]) defines the "top" icon;
+ e.g., a green triangle. The second (criteria[1]) defines the "middle"
+ icon. The first (criteria[0]) defines the "low" icon, but it
+ can often be left empty as the following object shows, because every
+ cell that does not match the other two criteria always gets the low
+ icon.
+ */
+ iconSetCF.criteria = [
+ {} as any,
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=700"
+ },
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=1000",
+ }
+ ];
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula: string;'
+ return:
+ type: string
+ - name: operator
+ uid: 'excel!Excel.ConditionalIconCriterion#operator:member'
+ package: excel!
+ fullName: operator
+ summary: '`greaterThan` or `greaterThanOrEqual` for each of the rule types for the icon conditional format.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.iconSet);
+ const iconSetCF = conditionalFormat.iconSet;
+ iconSetCF.style = Excel.IconSet.threeTriangles;
+
+ /*
+ The iconSetCF.criteria array is automatically prepopulated with
+ criterion elements whose properties have been given default settings.
+ You can't write to each property of a criterion directly. Instead,
+ replace the whole criteria object.
+
+ With a "three*" icon set style, such as "threeTriangles", the third
+ element in the criteria array (criteria[2]) defines the "top" icon;
+ e.g., a green triangle. The second (criteria[1]) defines the "middle"
+ icon. The first (criteria[0]) defines the "low" icon, but it
+ can often be left empty as the following object shows, because every
+ cell that does not match the other two criteria always gets the low
+ icon.
+ */
+ iconSetCF.criteria = [
+ {} as any,
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=700"
+ },
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=1000",
+ }
+ ];
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'operator: Excel.ConditionalIconCriterionOperator | "Invalid" | "GreaterThan" | "GreaterThanOrEqual";'
+ return:
+ type: >-
+ | "Invalid" | "GreaterThan" |
+ "GreaterThanOrEqual"
+ - name: type
+ uid: 'excel!Excel.ConditionalIconCriterion#type:member'
+ package: excel!
+ fullName: type
+ summary: What the icon conditional formula should be based on.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.iconSet);
+ const iconSetCF = conditionalFormat.iconSet;
+ iconSetCF.style = Excel.IconSet.threeTriangles;
+
+ /*
+ The iconSetCF.criteria array is automatically prepopulated with
+ criterion elements whose properties have been given default settings.
+ You can't write to each property of a criterion directly. Instead,
+ replace the whole criteria object.
+
+ With a "three*" icon set style, such as "threeTriangles", the third
+ element in the criteria array (criteria[2]) defines the "top" icon;
+ e.g., a green triangle. The second (criteria[1]) defines the "middle"
+ icon. The first (criteria[0]) defines the "low" icon, but it
+ can often be left empty as the following object shows, because every
+ cell that does not match the other two criteria always gets the low
+ icon.
+ */
+ iconSetCF.criteria = [
+ {} as any,
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=700"
+ },
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=1000",
+ }
+ ];
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: Excel.ConditionalFormatIconRuleType | "Invalid" | "Number" | "Percent" | "Formula" | "Percentile";'
+ return:
+ type: >-
+ | "Invalid" | "Number" | "Percent" | "Formula" |
+ "Percentile"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaliconcriterionoperator.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaliconcriterionoperator.yml
new file mode 100644
index 0000000000..b9ab82224c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaliconcriterionoperator.yml
@@ -0,0 +1,76 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalIconCriterionOperator
+uid: 'excel!Excel.ConditionalIconCriterionOperator:enum'
+package: excel!
+fullName: Excel.ConditionalIconCriterionOperator
+summary: Represents the operator for each icon criteria.
+remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.iconSet);
+ const iconSetCF = conditionalFormat.iconSet;
+ iconSetCF.style = Excel.IconSet.threeTriangles;
+
+ /*
+ The iconSetCF.criteria array is automatically prepopulated with
+ criterion elements whose properties have been given default settings.
+ You can't write to each property of a criterion directly. Instead,
+ replace the whole criteria object.
+
+ With a "three*" icon set style, such as "threeTriangles", the third
+ element in the criteria array (criteria[2]) defines the "top" icon;
+ e.g., a green triangle. The second (criteria[1]) defines the "middle"
+ icon. The first (criteria[0]) defines the "low" icon, but it
+ can often be left empty as the following object shows, because every
+ cell that does not match the other two criteria always gets the low
+ icon.
+ */
+ iconSetCF.criteria = [
+ {} as any,
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=700"
+ },
+ {
+ type: Excel.ConditionalFormatIconRuleType.number,
+ operator: Excel.ConditionalIconCriterionOperator.greaterThanOrEqual,
+ formula: "=1000",
+ }
+ ];
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: greaterThan
+ uid: 'excel!Excel.ConditionalIconCriterionOperator.greaterThan:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"GreaterThan"'
+ - name: greaterThanOrEqual
+ uid: 'excel!Excel.ConditionalIconCriterionOperator.greaterThanOrEqual:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"GreaterThanOrEqual"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalIconCriterionOperator.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalpresetcriteriarule.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalpresetcriteriarule.yml
new file mode 100644
index 0000000000..5f11dfda2a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalpresetcriteriarule.yml
@@ -0,0 +1,57 @@
+### YamlMime:TSType
+name: Excel.ConditionalPresetCriteriaRule
+uid: 'excel!Excel.ConditionalPresetCriteriaRule:interface'
+package: excel!
+fullName: Excel.ConditionalPresetCriteriaRule
+summary: Represents the preset criteria conditional format rule.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: criterion
+ uid: 'excel!Excel.ConditionalPresetCriteriaRule#criterion:member'
+ package: excel!
+ fullName: criterion
+ summary: The criterion of the conditional format.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B2:M5");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.presetCriteria);
+ conditionalFormat.preset.format.font.color = "white";
+ conditionalFormat.preset.rule = { criterion: Excel.ConditionalFormatPresetCriterion.oneStdDevAboveAverage };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ criterion: Excel.ConditionalFormatPresetCriterion | "Invalid" | "Blanks" | "NonBlanks" | "Errors" | "NonErrors"
+ | "Yesterday" | "Today" | "Tomorrow" | "LastSevenDays" | "LastWeek" | "ThisWeek" | "NextWeek" | "LastMonth" |
+ "ThisMonth" | "NextMonth" | "AboveAverage" | "BelowAverage" | "EqualOrAboveAverage" | "EqualOrBelowAverage" |
+ "OneStdDevAboveAverage" | "OneStdDevBelowAverage" | "TwoStdDevAboveAverage" | "TwoStdDevBelowAverage" |
+ "ThreeStdDevAboveAverage" | "ThreeStdDevBelowAverage" | "UniqueValues" | "DuplicateValues";
+ return:
+ type: >-
+ | "Invalid" | "Blanks" | "NonBlanks" |
+ "Errors" | "NonErrors" | "Yesterday" | "Today" | "Tomorrow" | "LastSevenDays" | "LastWeek" | "ThisWeek" |
+ "NextWeek" | "LastMonth" | "ThisMonth" | "NextMonth" | "AboveAverage" | "BelowAverage" | "EqualOrAboveAverage"
+ | "EqualOrBelowAverage" | "OneStdDevAboveAverage" | "OneStdDevBelowAverage" | "TwoStdDevAboveAverage" |
+ "TwoStdDevBelowAverage" | "ThreeStdDevAboveAverage" | "ThreeStdDevBelowAverage" | "UniqueValues" |
+ "DuplicateValues"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborder.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborder.yml
new file mode 100644
index 0000000000..383fc17847
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborder.yml
@@ -0,0 +1,201 @@
+### YamlMime:TSType
+name: Excel.ConditionalRangeBorder
+uid: 'excel!Excel.ConditionalRangeBorder:class'
+package: excel!
+fullName: Excel.ConditionalRangeBorder
+summary: Represents the border of an object.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: color
+ uid: 'excel!Excel.ConditionalRangeBorder#color:member'
+ package: excel!
+ fullName: color
+ summary: >-
+ HTML color code representing the color of the border line, in the form \#RRGGBB (e.g., "FFA500") or as a named
+ HTML color (e.g., "orange").
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ConditionalRangeBorder#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: sideIndex
+ uid: 'excel!Excel.ConditionalRangeBorder#sideIndex:member'
+ package: excel!
+ fullName: sideIndex
+ summary: >-
+ Constant value that indicates the specific side of the border. See `Excel.ConditionalRangeBorderIndex` for
+ details.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly sideIndex: Excel.ConditionalRangeBorderIndex | "EdgeTop" | "EdgeBottom" | "EdgeLeft" | "EdgeRight";'
+ return:
+ type: >-
+ | "EdgeTop" | "EdgeBottom" | "EdgeLeft" |
+ "EdgeRight"
+ - name: style
+ uid: 'excel!Excel.ConditionalRangeBorder#style:member'
+ package: excel!
+ fullName: style
+ summary: >-
+ One of the constants of line style specifying the line style for the border. See `Excel.BorderLineStyle` for
+ details.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ style: Excel.ConditionalRangeBorderLineStyle | "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" |
+ "Dot";
+ return:
+ type: >-
+ | "None" | "Continuous" | "Dash" | "DashDot" |
+ "DashDotDot" | "Dot"
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalRangeBorder#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ConditionalRangeBorderLoadOptions): Excel.ConditionalRangeBorder;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalRangeBorder#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalRangeBorder;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalRangeBorder#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalRangeBorder;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalRangeBorder#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ConditionalRangeBorderUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalRangeBorder#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalRangeBorder): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalRangeBorder#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalRangeBorder object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalRangeBorderData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalRangeBorderData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangebordercollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangebordercollection.yml
new file mode 100644
index 0000000000..7cfba8c751
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangebordercollection.yml
@@ -0,0 +1,231 @@
+### YamlMime:TSType
+name: Excel.ConditionalRangeBorderCollection
+uid: 'excel!Excel.ConditionalRangeBorderCollection:class'
+package: excel!
+fullName: Excel.ConditionalRangeBorderCollection
+summary: Represents the border objects that make up range border.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: bottom
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#bottom:member'
+ package: excel!
+ fullName: bottom
+ summary: Gets the bottom border.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly bottom: Excel.ConditionalRangeBorder;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: count
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#count:member'
+ package: excel!
+ fullName: count
+ summary: Number of border objects in the collection.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly count: number;'
+ return:
+ type: number
+ - name: items
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.ConditionalRangeBorder[];'
+ return:
+ type: '[]'
+ - name: left
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#left:member'
+ package: excel!
+ fullName: left
+ summary: Gets the left border.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly left: Excel.ConditionalRangeBorder;'
+ return:
+ type: ''
+ - name: right
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#right:member'
+ package: excel!
+ fullName: right
+ summary: Gets the right border.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly right: Excel.ConditionalRangeBorder;'
+ return:
+ type: ''
+ - name: top
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#top:member'
+ package: excel!
+ fullName: top
+ summary: Gets the top border.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly top: Excel.ConditionalRangeBorder;'
+ return:
+ type: ''
+methods:
+ - name: getItem(index)
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(index)
+ summary: Gets a border object using its name.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(index: Excel.ConditionalRangeBorderIndex): Excel.ConditionalRangeBorder;'
+ parameters:
+ - id: index
+ description: Index value of the border object to be retrieved. See `Excel.ConditionalRangeBorderIndex` for details.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: getItem(indexString)
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#getItem:member(2)'
+ package: excel!
+ fullName: getItem(indexString)
+ summary: Gets a border object using its name.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(indexString: "EdgeTop" | "EdgeBottom" | "EdgeLeft" | "EdgeRight"): Excel.ConditionalRangeBorder;'
+ parameters:
+ - id: indexString
+ description: Index value of the border object to be retrieved. See `Excel.ConditionalRangeBorderIndex` for details.
+ type: '"EdgeTop" | "EdgeBottom" | "EdgeLeft" | "EdgeRight"'
+ return:
+ type: ''
+ description: ''
+ - name: getItemAt(index)
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#getItemAt:member(1)'
+ package: excel!
+ fullName: getItemAt(index)
+ summary: Gets a border object using its index.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemAt(index: number): Excel.ConditionalRangeBorder;'
+ parameters:
+ - id: index
+ description: Index value of the object to be retrieved. Zero-indexed.
+ type: number
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.ConditionalRangeBorderCollectionLoadOptions &
+ Excel.Interfaces.CollectionLoadOptions): Excel.ConditionalRangeBorderCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalRangeBorderCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.ConditionalRangeBorderCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalRangeBorderCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.ConditionalRangeBorderCollection` object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalRangeBorderCollectionData`) that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalRangeBorderCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborderindex.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborderindex.yml
new file mode 100644
index 0000000000..2c5b0ac96e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborderindex.yml
@@ -0,0 +1,30 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalRangeBorderIndex
+uid: 'excel!Excel.ConditionalRangeBorderIndex:enum'
+package: excel!
+fullName: Excel.ConditionalRangeBorderIndex
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: edgeBottom
+ uid: 'excel!Excel.ConditionalRangeBorderIndex.edgeBottom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeBottom"'
+ - name: edgeLeft
+ uid: 'excel!Excel.ConditionalRangeBorderIndex.edgeLeft:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeLeft"'
+ - name: edgeRight
+ uid: 'excel!Excel.ConditionalRangeBorderIndex.edgeRight:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeRight"'
+ - name: edgeTop
+ uid: 'excel!Excel.ConditionalRangeBorderIndex.edgeTop:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EdgeTop"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborderlinestyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborderlinestyle.yml
new file mode 100644
index 0000000000..cee76a2935
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeborderlinestyle.yml
@@ -0,0 +1,40 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalRangeBorderLineStyle
+uid: 'excel!Excel.ConditionalRangeBorderLineStyle:enum'
+package: excel!
+fullName: Excel.ConditionalRangeBorderLineStyle
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: continuous
+ uid: 'excel!Excel.ConditionalRangeBorderLineStyle.continuous:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Continuous"'
+ - name: dash
+ uid: 'excel!Excel.ConditionalRangeBorderLineStyle.dash:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dash"'
+ - name: dashDot
+ uid: 'excel!Excel.ConditionalRangeBorderLineStyle.dashDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DashDot"'
+ - name: dashDotDot
+ uid: 'excel!Excel.ConditionalRangeBorderLineStyle.dashDotDot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"DashDotDot"'
+ - name: dot
+ uid: 'excel!Excel.ConditionalRangeBorderLineStyle.dot:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dot"'
+ - name: none
+ uid: 'excel!Excel.ConditionalRangeBorderLineStyle.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefill.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefill.yml
new file mode 100644
index 0000000000..8366e5093d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefill.yml
@@ -0,0 +1,180 @@
+### YamlMime:TSType
+name: Excel.ConditionalRangeFill
+uid: 'excel!Excel.ConditionalRangeFill:class'
+package: excel!
+fullName: Excel.ConditionalRangeFill
+summary: Represents the background of a conditional range object.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: color
+ uid: 'excel!Excel.ConditionalRangeFill#color:member'
+ package: excel!
+ fullName: color
+ summary: >-
+ HTML color code representing the color of the fill, in the form \#RRGGBB (e.g., "FFA500") or as a named HTML color
+ (e.g., "orange").
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ConditionalRangeFill#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+methods:
+ - name: clear()
+ uid: 'excel!Excel.ConditionalRangeFill#clear:member(1)'
+ package: excel!
+ fullName: clear()
+ summary: Resets the fill.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clear(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalRangeFill#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ConditionalRangeFillLoadOptions): Excel.ConditionalRangeFill;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalRangeFill#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalRangeFill;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalRangeFill#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalRangeFill;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalRangeFill#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ConditionalRangeFillUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalRangeFill#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalRangeFill): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalRangeFill#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalRangeFill object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalRangeFillData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalRangeFillData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefont.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefont.yml
new file mode 100644
index 0000000000..7897541218
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefont.yml
@@ -0,0 +1,226 @@
+### YamlMime:TSType
+name: Excel.ConditionalRangeFont
+uid: 'excel!Excel.ConditionalRangeFont:class'
+package: excel!
+fullName: Excel.ConditionalRangeFont
+summary: 'This object represents the font attributes (font style, color, etc.) for an object.'
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: bold
+ uid: 'excel!Excel.ConditionalRangeFont#bold:member'
+ package: excel!
+ fullName: bold
+ summary: Specifies if the font is bold.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'bold: boolean;'
+ return:
+ type: boolean
+ - name: color
+ uid: 'excel!Excel.ConditionalRangeFont#color:member'
+ package: excel!
+ fullName: color
+ summary: 'HTML color code representation of the text color (e.g., \#FF0000 represents Red).'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.ConditionalRangeFont#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: italic
+ uid: 'excel!Excel.ConditionalRangeFont#italic:member'
+ package: excel!
+ fullName: italic
+ summary: Specifies if the font is italic.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'italic: boolean;'
+ return:
+ type: boolean
+ - name: strikethrough
+ uid: 'excel!Excel.ConditionalRangeFont#strikethrough:member'
+ package: excel!
+ fullName: strikethrough
+ summary: Specifies the strikethrough status of the font.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'strikethrough: boolean;'
+ return:
+ type: boolean
+ - name: underline
+ uid: 'excel!Excel.ConditionalRangeFont#underline:member'
+ package: excel!
+ fullName: underline
+ summary: The type of underline applied to the font. See `Excel.ConditionalRangeFontUnderlineStyle` for details.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'underline: Excel.ConditionalRangeFontUnderlineStyle | "None" | "Single" | "Double";'
+ return:
+ type: ' | "None" | "Single" | "Double"'
+methods:
+ - name: clear()
+ uid: 'excel!Excel.ConditionalRangeFont#clear:member(1)'
+ package: excel!
+ fullName: clear()
+ summary: Resets the font formats.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clear(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalRangeFont#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ConditionalRangeFontLoadOptions): Excel.ConditionalRangeFont;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalRangeFont#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalRangeFont;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalRangeFont#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalRangeFont;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalRangeFont#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ConditionalRangeFontUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalRangeFont#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalRangeFont): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalRangeFont#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalRangeFont object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalRangeFontData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalRangeFontData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefontunderlinestyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefontunderlinestyle.yml
new file mode 100644
index 0000000000..3454dd81a4
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangefontunderlinestyle.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalRangeFontUnderlineStyle
+uid: 'excel!Excel.ConditionalRangeFontUnderlineStyle:enum'
+package: excel!
+fullName: Excel.ConditionalRangeFontUnderlineStyle
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: double
+ uid: 'excel!Excel.ConditionalRangeFontUnderlineStyle.double:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Double"'
+ - name: none
+ uid: 'excel!Excel.ConditionalRangeFontUnderlineStyle.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: single
+ uid: 'excel!Excel.ConditionalRangeFontUnderlineStyle.single:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Single"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeformat.yml
new file mode 100644
index 0000000000..f42700b172
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionalrangeformat.yml
@@ -0,0 +1,218 @@
+### YamlMime:TSType
+name: Excel.ConditionalRangeFormat
+uid: 'excel!Excel.ConditionalRangeFormat:class'
+package: excel!
+fullName: Excel.ConditionalRangeFormat
+summary: 'A format object encapsulating the conditional formats range''s font, fill, borders, and other properties.'
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: borders
+ uid: 'excel!Excel.ConditionalRangeFormat#borders:member'
+ package: excel!
+ fullName: borders
+ summary: Collection of border objects that apply to the overall conditional format range.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly borders: Excel.ConditionalRangeBorderCollection;'
+ return:
+ type: ''
+ - name: context
+ uid: 'excel!Excel.ConditionalRangeFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: fill
+ uid: 'excel!Excel.ConditionalRangeFormat#fill:member'
+ package: excel!
+ fullName: fill
+ summary: Returns the fill object defined on the overall conditional format range.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fill: Excel.ConditionalRangeFill;'
+ return:
+ type: ''
+ - name: font
+ uid: 'excel!Excel.ConditionalRangeFormat#font:member'
+ package: excel!
+ fullName: font
+ summary: Returns the font object defined on the overall conditional format range.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly font: Excel.ConditionalRangeFont;'
+ return:
+ type: ''
+ - name: numberFormat
+ uid: 'excel!Excel.ConditionalRangeFormat#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: >-
+ Represents Excel's number format code for the given range. For more information about Excel number formatting, see
+ [Number format
+ codes](https://support.microsoft.com/office/number-format-codes-5026bbd6-04bc-48cd-bf33-80f18b4eae68).
+ Cleared if `null` is passed in.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'numberFormat: any;'
+ return:
+ type: any
+methods:
+ - name: clearFormat()
+ uid: 'excel!Excel.ConditionalRangeFormat#clearFormat:member(1)'
+ package: excel!
+ fullName: clearFormat()
+ summary: Remove the format properties from a conditional format rule. This creates a rule with no format settings.
+ remarks: '\[ [API set: ExcelApi 1.17](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clearFormat(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.ConditionalRangeFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.ConditionalRangeFormatLoadOptions): Excel.ConditionalRangeFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.ConditionalRangeFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.ConditionalRangeFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.ConditionalRangeFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.ConditionalRangeFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.ConditionalRangeFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.ConditionalRangeFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.ConditionalRangeFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.ConditionalRangeFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.ConditionalRangeFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.ConditionalRangeFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.ConditionalRangeFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.ConditionalRangeFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltextcomparisonrule.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltextcomparisonrule.yml
new file mode 100644
index 0000000000..2ed9726d32
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltextcomparisonrule.yml
@@ -0,0 +1,60 @@
+### YamlMime:TSType
+name: Excel.ConditionalTextComparisonRule
+uid: 'excel!Excel.ConditionalTextComparisonRule:interface'
+package: excel!
+fullName: Excel.ConditionalTextComparisonRule
+summary: Represents a cell value conditional format rule.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: operator
+ uid: 'excel!Excel.ConditionalTextComparisonRule#operator:member'
+ package: excel!
+ fullName: operator
+ summary: The operator of the text conditional format.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'operator: Excel.ConditionalTextOperator | "Invalid" | "Contains" | "NotContains" | "BeginsWith" | "EndsWith";'
+ return:
+ type: >-
+ | "Invalid" | "Contains" | "NotContains" |
+ "BeginsWith" | "EndsWith"
+ - name: text
+ uid: 'excel!Excel.ConditionalTextComparisonRule#text:member'
+ package: excel!
+ fullName: text
+ summary: The text value of the conditional format.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B16:D18");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.containsText);
+ conditionalFormat.textComparison.format.font.color = "red";
+ conditionalFormat.textComparison.rule = { operator: Excel.ConditionalTextOperator.contains, text: "Delayed" };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'text: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltextoperator.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltextoperator.yml
new file mode 100644
index 0000000000..70b000b0fa
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltextoperator.yml
@@ -0,0 +1,58 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalTextOperator
+uid: 'excel!Excel.ConditionalTextOperator:enum'
+package: excel!
+fullName: Excel.ConditionalTextOperator
+summary: Represents the operator of the text conditional format type.
+remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B16:D18");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.containsText);
+ conditionalFormat.textComparison.format.font.color = "red";
+ conditionalFormat.textComparison.rule = { operator: Excel.ConditionalTextOperator.contains, text: "Delayed" };
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: beginsWith
+ uid: 'excel!Excel.ConditionalTextOperator.beginsWith:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BeginsWith"'
+ - name: contains
+ uid: 'excel!Excel.ConditionalTextOperator.contains:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Contains"'
+ - name: endsWith
+ uid: 'excel!Excel.ConditionalTextOperator.endsWith:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EndsWith"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalTextOperator.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: notContains
+ uid: 'excel!Excel.ConditionalTextOperator.notContains:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NotContains"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltopbottomcriteriontype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltopbottomcriteriontype.yml
new file mode 100644
index 0000000000..515bda1898
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltopbottomcriteriontype.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSEnum
+name: Excel.ConditionalTopBottomCriterionType
+uid: 'excel!Excel.ConditionalTopBottomCriterionType:enum'
+package: excel!
+fullName: Excel.ConditionalTopBottomCriterionType
+summary: Represents the criteria for the above/below average conditional format type.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bottomItems
+ uid: 'excel!Excel.ConditionalTopBottomCriterionType.bottomItems:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BottomItems"'
+ - name: bottomPercent
+ uid: 'excel!Excel.ConditionalTopBottomCriterionType.bottomPercent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BottomPercent"'
+ - name: invalid
+ uid: 'excel!Excel.ConditionalTopBottomCriterionType.invalid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Invalid"'
+ - name: topItems
+ uid: 'excel!Excel.ConditionalTopBottomCriterionType.topItems:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TopItems"'
+ - name: topPercent
+ uid: 'excel!Excel.ConditionalTopBottomCriterionType.topPercent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TopPercent"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltopbottomrule.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltopbottomrule.yml
new file mode 100644
index 0000000000..74842fef2b
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.conditionaltopbottomrule.yml
@@ -0,0 +1,39 @@
+### YamlMime:TSType
+name: Excel.ConditionalTopBottomRule
+uid: 'excel!Excel.ConditionalTopBottomRule:interface'
+package: excel!
+fullName: Excel.ConditionalTopBottomRule
+summary: Represents the rule of the top/bottom conditional format.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: rank
+ uid: 'excel!Excel.ConditionalTopBottomRule#rank:member'
+ package: excel!
+ fullName: rank
+ summary: The rank between 1 and 1000 for numeric ranks or 1 and 100 for percent ranks.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'rank: number;'
+ return:
+ type: number
+ - name: type
+ uid: 'excel!Excel.ConditionalTopBottomRule#type:member'
+ package: excel!
+ fullName: type
+ summary: Format values based on the top or bottom rank.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ type: Excel.ConditionalTopBottomCriterionType | "Invalid" | "TopItems" | "TopPercent" | "BottomItems" |
+ "BottomPercent";
+ return:
+ type: >-
+ | "Invalid" | "TopItems" | "TopPercent" |
+ "BottomItems" | "BottomPercent"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.connecterrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.connecterrorcellvalue.yml
new file mode 100644
index 0000000000..13147518a7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.connecterrorcellvalue.yml
@@ -0,0 +1,84 @@
+### YamlMime:TSType
+name: Excel.ConnectErrorCellValue
+uid: 'excel!Excel.ConnectErrorCellValue:interface'
+package: excel!
+fullName: Excel.ConnectErrorCellValue
+summary: 'Represents the value of a cell containing a \#CONNECT! error.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.ConnectErrorCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.ConnectErrorCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#CONNECT!" | string;'
+ return:
+ type: '"#CONNECT!" | string'
+ - name: errorSubType
+ uid: 'excel!Excel.ConnectErrorCellValue#errorSubType:member'
+ package: excel!
+ fullName: errorSubType
+ summary: Represents the type of `ConnectErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ errorSubType?: ConnectErrorCellValueSubType | "Unknown" | "ServiceError" | "ExternalLinks" |
+ "ExternalLinksNonCloudLocation" | "DataTypeNoConnection" | "DataTypeServiceError" | "MissingContent" |
+ "RequestThrottle" | "ExternalLinksFailedToRefresh" | "ExternalLinksAccessFailed" | "ExternalLinksServerError" |
+ "ExternalLinksInvalidRequest" | "ExternalLinksUnAuthenticated" | "ExternalLinksThrottledByHost" |
+ "ExternalLinksFileTooLarge" | "OutdatedLinkedEntity" | "GenericServerError";
+ return:
+ type: >-
+ | "Unknown" | "ServiceError" | "ExternalLinks" |
+ "ExternalLinksNonCloudLocation" | "DataTypeNoConnection" | "DataTypeServiceError" | "MissingContent" |
+ "RequestThrottle" | "ExternalLinksFailedToRefresh" | "ExternalLinksAccessFailed" | "ExternalLinksServerError"
+ | "ExternalLinksInvalidRequest" | "ExternalLinksUnAuthenticated" | "ExternalLinksThrottledByHost" |
+ "ExternalLinksFileTooLarge" | "OutdatedLinkedEntity" | "GenericServerError"
+ - name: errorType
+ uid: 'excel!Excel.ConnectErrorCellValue#errorType:member'
+ package: excel!
+ fullName: errorType
+ summary: Represents the type of `ErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorType?: ErrorCellValueType.connect | "Connect";'
+ return:
+ type: ' | "Connect"'
+ - name: type
+ uid: 'excel!Excel.ConnectErrorCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.connecterrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.connecterrorcellvaluesubtype.yml
new file mode 100644
index 0000000000..a8cc8d5f40
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.connecterrorcellvaluesubtype.yml
@@ -0,0 +1,152 @@
+### YamlMime:TSEnum
+name: Excel.ConnectErrorCellValueSubType
+uid: 'excel!Excel.ConnectErrorCellValueSubType:enum'
+package: excel!
+fullName: Excel.ConnectErrorCellValueSubType
+summary: 'Represents types of \#CONNECT! errors.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: dataTypeNoConnection
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.dataTypeNoConnection:member'
+ package: excel!
+ summary: |-
+ An error caused by no service connection for linked data types. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataTypeNoConnection"'
+ - name: dataTypeServiceError
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.dataTypeServiceError:member'
+ package: excel!
+ summary: |-
+ An error caused by an issue in the service for linked data types. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataTypeServiceError"'
+ - name: externalLinks
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinks:member'
+ package: excel!
+ summary: |-
+ An error caused by an issue with the external links. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinks"'
+ - name: externalLinksAccessFailed
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksAccessFailed:member'
+ package: excel!
+ summary: |-
+ An error caused by a failure to access external links. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksAccessFailed"'
+ - name: externalLinksFailedToRefresh
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksFailedToRefresh:member'
+ package: excel!
+ summary: |-
+ An error caused by external links failing to refresh. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksFailedToRefresh"'
+ - name: externalLinksFileTooLarge
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksFileTooLarge:member'
+ package: excel!
+ summary: >-
+ An error caused by an external link to a file which exceeds file size capacity. Displays as error type \#CONNECT!
+ in Excel.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksFileTooLarge"'
+ - name: externalLinksInvalidRequest
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksInvalidRequest:member'
+ package: excel!
+ summary: >-
+ An error caused by an invalid request while resolving an external link. Displays as error type \#CONNECT! in
+ Excel.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksInvalidRequest"'
+ - name: externalLinksNonCloudLocation
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksNonCloudLocation:member'
+ package: excel!
+ summary: >-
+ An error caused by an external link to a non-cloud location, such as a link to an Excel file that is saved to a
+ local computer instead of to a cloud location. Displays as error type \#CONNECT! in Excel.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksNonCloudLocation"'
+ - name: externalLinksServerError
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksServerError:member'
+ package: excel!
+ summary: |-
+ An error caused by a server error while resolving an external link. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksServerError"'
+ - name: externalLinksThrottledByHost
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksThrottledByHost:member'
+ package: excel!
+ summary: |-
+ An error caused by throttling from an external link host. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksThrottledByHost"'
+ - name: externalLinksUnAuthenticated
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.externalLinksUnAuthenticated:member'
+ package: excel!
+ summary: |-
+ An error caused by a lack of authentication for external links. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ExternalLinksUnAuthenticated"'
+ - name: genericServerError
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.genericServerError:member'
+ package: excel!
+ summary: |-
+ An error caused by an error returned from the server. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GenericServerError"'
+ - name: missingContent
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.missingContent:member'
+ package: excel!
+ summary: |-
+ An error caused by missing content. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MissingContent"'
+ - name: outdatedLinkedEntity
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.outdatedLinkedEntity:member'
+ package: excel!
+ summary: |-
+ An error caused by an outdated linked entity. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"OutdatedLinkedEntity"'
+ - name: requestThrottle
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.requestThrottle:member'
+ package: excel!
+ summary: |-
+ An error caused by request throttling. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RequestThrottle"'
+ - name: serviceError
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.serviceError:member'
+ package: excel!
+ summary: |-
+ An error caused by a problem with the service. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ServiceError"'
+ - name: unknown
+ uid: 'excel!Excel.ConnectErrorCellValueSubType.unknown:member'
+ package: excel!
+ summary: |-
+ An unknown type of error. Displays as error type \#CONNECT! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.connectortype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.connectortype.yml
new file mode 100644
index 0000000000..80f7dd983d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.connectortype.yml
@@ -0,0 +1,44 @@
+### YamlMime:TSEnum
+name: Excel.ConnectorType
+uid: 'excel!Excel.ConnectorType:enum'
+package: excel!
+fullName: Excel.ConnectorType
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/44-shape/shape-lines.yaml
+
+ await Excel.run(async (context) => {
+ const shapes = context.workbook.worksheets.getItem("Shapes").shapes;
+ const line = shapes.addLine(200, 50, 300, 150, Excel.ConnectorType.straight);
+ line.name = "StraightLine";
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: curve
+ uid: 'excel!Excel.ConnectorType.curve:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Curve"'
+ - name: elbow
+ uid: 'excel!Excel.ConnectorType.elbow:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Elbow"'
+ - name: straight
+ uid: 'excel!Excel.ConnectorType.straight:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Straight"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.contenttype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.contenttype.yml
new file mode 100644
index 0000000000..9e114ceb0c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.contenttype.yml
@@ -0,0 +1,58 @@
+### YamlMime:TSEnum
+name: Excel.ContentType
+uid: 'excel!Excel.ContentType:enum'
+package: excel!
+fullName: Excel.ContentType
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/12-comment/comment-mentions.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Comments");
+ const mention = {
+ email: "kakri@contoso.com",
+ id: 0,
+ name: "Kate Kristensen"
+ };
+
+ // This will tag the mention's name using the '@' syntax.
+ // They will be notified via email.
+ const commentBody = {
+ mentions: [mention],
+ richContent: '' + mention.name + " - Can you take a look?"
+ };
+
+ // Note that an InvalidArgument error will be thrown if multiple cells passed to `comment.add`.
+ sheet.comments.add("A1", commentBody, Excel.ContentType.mention);
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: mention
+ uid: 'excel!Excel.ContentType.mention:member'
+ package: excel!
+ summary: |-
+ Comment content containing mentions.
+
+ * \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Mention"'
+ - name: plain
+ uid: 'excel!Excel.ContentType.plain:member'
+ package: excel!
+ summary: |-
+ Indicates a plain format type for the comment content.
+
+ * \[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Plain"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cultureinfo.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cultureinfo.yml
new file mode 100644
index 0000000000..56e442b4d7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cultureinfo.yml
@@ -0,0 +1,202 @@
+### YamlMime:TSType
+name: Excel.CultureInfo
+uid: 'excel!Excel.CultureInfo:class'
+package: excel!
+fullName: Excel.CultureInfo
+summary: >-
+ Provides information based on current system culture settings. This includes the culture names, number formatting, and
+ other culturally dependent settings.
+remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CultureInfo#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: datetimeFormat
+ uid: 'excel!Excel.CultureInfo#datetimeFormat:member'
+ package: excel!
+ fullName: datetimeFormat
+ summary: >-
+ Defines the culturally appropriate format of displaying date and time. This is based on current system culture
+ settings.
+ remarks: >-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/culture-info-date-time.yaml
+
+ await Excel.run(async (context) => {
+ context.application.cultureInfo.datetimeFormat.load([
+ "longDatePattern",
+ "shortDatePattern",
+ "dateSeparator",
+ "longTimePattern",
+ "timeSeparator"
+ ]);
+ await context.sync();
+
+ // Use the cultural settings API to retrieve the user's system date and time settings.
+ const systemLongDatePattern = context.application.cultureInfo.datetimeFormat.longDatePattern;
+ const systemShortDatePattern = context.application.cultureInfo.datetimeFormat.shortDatePattern;
+ const systemDateSeparator = context.application.cultureInfo.datetimeFormat.dateSeparator;
+ const systemLongTimePattern = context.application.cultureInfo.datetimeFormat.longTimePattern;
+ const systemTimeSeparator = context.application.cultureInfo.datetimeFormat.timeSeparator;
+
+ // Write the date and time settings in your table.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+ const dateTimeData = sheet.getRange("A2:B6");
+ dateTimeData.values = [
+ ["Long date", systemLongDatePattern],
+ ["Short date", systemShortDatePattern],
+ ["Date separator", systemDateSeparator],
+ ["Long time format", systemLongTimePattern],
+ ["Time separator", systemTimeSeparator]
+ ];
+
+ sheet.tables
+ .getItemAt(0)
+ .getRange()
+ .format.autofitColumns();
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly datetimeFormat: Excel.DatetimeFormatInfo;'
+ return:
+ type: ''
+ - name: name
+ uid: 'excel!Excel.CultureInfo#name:member'
+ package: excel!
+ fullName: name
+ summary: >-
+ Gets the culture name in the format languagecode2-country/regioncode2 (e.g., "zh-cn" or "en-us"). This is based on
+ current system settings.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly name: string;'
+ return:
+ type: string
+ - name: numberFormat
+ uid: 'excel!Excel.CultureInfo#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: Defines the culturally appropriate format of displaying numbers. This is based on current system culture settings.
+ remarks: '\[ [API set: ExcelApi 1.11](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly numberFormat: Excel.NumberFormatInfo;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.CultureInfo#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.CultureInfoLoadOptions): Excel.CultureInfo;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CultureInfo#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CultureInfo;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CultureInfo#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.CultureInfo;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CultureInfo#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.CultureInfo object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.CultureInfoData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CultureInfoData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.customconditionalformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.customconditionalformat.yml
new file mode 100644
index 0000000000..e0a71d18ec
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.customconditionalformat.yml
@@ -0,0 +1,217 @@
+### YamlMime:TSType
+name: Excel.CustomConditionalFormat
+uid: 'excel!Excel.CustomConditionalFormat:class'
+package: excel!
+fullName: Excel.CustomConditionalFormat
+summary: Represents a custom conditional format type.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CustomConditionalFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: format
+ uid: 'excel!Excel.CustomConditionalFormat#format:member'
+ package: excel!
+ fullName: format
+ summary: 'Returns a format object, encapsulating the conditional formats font, fill, borders, and other properties.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats.add(Excel.ConditionalFormatType.custom);
+ conditionalFormat.custom.rule.formula = '=IF(B8>INDIRECT("RC[-1]",0),TRUE)';
+ conditionalFormat.custom.format.font.color = "green";
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly format: Excel.ConditionalRangeFormat;'
+ return:
+ type: ''
+ - name: rule
+ uid: 'excel!Excel.CustomConditionalFormat#rule:member'
+ package: excel!
+ fullName: rule
+ summary: Specifies the `Rule` object on this conditional format.
+ remarks: |-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+ const range = sheet.getRange("A1:A5");
+ range.values = [[1], [20], [""], [5], ["test"]];
+ const cf = range.conditionalFormats.add(Excel.ConditionalFormatType.custom);
+ const cfCustom = cf.customOrNullObject;
+ cfCustom.rule.formula = "=ISBLANK(A1)";
+ cfCustom.format.fill.color = "#00FF00";
+ await context.sync()
+
+ console.log("Added new custom conditional format highlighting all blank cells.");
+ });
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly rule: Excel.ConditionalFormatRule;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.CustomConditionalFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.CustomConditionalFormatLoadOptions): Excel.CustomConditionalFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CustomConditionalFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CustomConditionalFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CustomConditionalFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.CustomConditionalFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.CustomConditionalFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.CustomConditionalFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.CustomConditionalFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.CustomConditionalFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CustomConditionalFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.CustomConditionalFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.CustomConditionalFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CustomConditionalFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.customdatavalidation.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.customdatavalidation.yml
new file mode 100644
index 0000000000..fd0278861f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.customdatavalidation.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSType
+name: Excel.CustomDataValidation
+uid: 'excel!Excel.CustomDataValidation:interface'
+package: excel!
+fullName: Excel.CustomDataValidation
+summary: Represents the custom data validation criteria.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: formula
+ uid: 'excel!Excel.CustomDataValidation#formula:member'
+ package: excel!
+ fullName: formula
+ summary: >-
+ A custom data validation formula. This creates special input rules, such as preventing duplicates, or limiting the
+ total in a range of cells.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.customproperty.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.customproperty.yml
new file mode 100644
index 0000000000..c007d3f782
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.customproperty.yml
@@ -0,0 +1,206 @@
+### YamlMime:TSType
+name: Excel.CustomProperty
+uid: 'excel!Excel.CustomProperty:class'
+package: excel!
+fullName: Excel.CustomProperty
+summary: Represents a custom property.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CustomProperty#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: key
+ uid: 'excel!Excel.CustomProperty#key:member'
+ package: excel!
+ fullName: key
+ summary: >-
+ The key of the custom property. The key is limited to 255 characters outside of Excel on the web (larger keys are
+ automatically trimmed to 255 characters on other platforms).
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly key: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.CustomProperty#type:member'
+ package: excel!
+ fullName: type
+ summary: The type of the value used for the custom property.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly type: Excel.DocumentPropertyType | "Number" | "Boolean" | "Date" | "String" | "Float";'
+ return:
+ type: ' | "Number" | "Boolean" | "Date" | "String" | "Float"'
+ - name: value
+ uid: 'excel!Excel.CustomProperty#value:member'
+ package: excel!
+ fullName: value
+ summary: >-
+ The value of the custom property. The value is limited to 255 characters outside of Excel on the web (larger
+ values are automatically trimmed to 255 characters on other platforms).
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'value: any;'
+ return:
+ type: any
+methods:
+ - name: delete()
+ uid: 'excel!Excel.CustomProperty#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes the custom property.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CustomProperty#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.CustomPropertyLoadOptions): Excel.CustomProperty;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CustomProperty#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CustomProperty;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CustomProperty#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.CustomProperty;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.CustomProperty#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.CustomPropertyUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.CustomProperty#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.CustomProperty): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CustomProperty#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.CustomProperty object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.CustomPropertyData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CustomPropertyData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.custompropertycollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.custompropertycollection.yml
new file mode 100644
index 0000000000..6137a7a59f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.custompropertycollection.yml
@@ -0,0 +1,237 @@
+### YamlMime:TSType
+name: Excel.CustomPropertyCollection
+uid: 'excel!Excel.CustomPropertyCollection:class'
+package: excel!
+fullName: Excel.CustomPropertyCollection
+summary: Contains the collection of custom properties.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CustomPropertyCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.CustomPropertyCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.CustomProperty[];'
+ return:
+ type: '[]'
+methods:
+ - name: 'add(key, value)'
+ uid: 'excel!Excel.CustomPropertyCollection#add:member(1)'
+ package: excel!
+ fullName: 'add(key, value)'
+ summary: Creates a new or sets an existing custom property.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/26-document/custom-properties.yaml
+
+ await Excel.run(async (context) => {
+ // Get the key/value pair from the task pane.
+ const userKey = $("#key").text();
+ const userValue = $("#value").text();
+
+ // Add the custom property.
+ const customDocProperties = context.workbook.properties.custom;
+ customDocProperties.add(userKey, userValue);
+
+ await context.sync();
+
+ console.log(`Successfully set custom document property ${userKey}:${userValue}.`);
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(key: string, value: any): Excel.CustomProperty;'
+ parameters:
+ - id: key
+ description: >-
+ Required. The custom property's key, which is case-insensitive. The key is limited to 255 characters outside
+ of Excel on the web (larger keys are automatically trimmed to 255 characters on other platforms).
+ type: string
+ - id: value
+ description: >-
+ Required. The custom property's value. The value is limited to 255 characters outside of Excel on the web
+ (larger values are automatically trimmed to 255 characters on other platforms).
+ type: any
+ return:
+ type: ''
+ description: ''
+ - name: deleteAll()
+ uid: 'excel!Excel.CustomPropertyCollection#deleteAll:member(1)'
+ package: excel!
+ fullName: deleteAll()
+ summary: Deletes all custom properties in this collection.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'deleteAll(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.CustomPropertyCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the count of custom properties.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(key)
+ uid: 'excel!Excel.CustomPropertyCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(key)
+ summary: >-
+ Gets a custom property object by its key, which is case-insensitive. Throws an error if the custom property does
+ not exist.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(key: string): Excel.CustomProperty;'
+ parameters:
+ - id: key
+ description: The key that identifies the custom property object.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(key)
+ uid: 'excel!Excel.CustomPropertyCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(key)
+ summary: >-
+ Gets a custom property object by its key, which is case-insensitive. If the custom property doesn't exist, then
+ this method returns an object with its `isNullObject` property set to `true`. For further information, see
+ [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(key: string): Excel.CustomProperty;'
+ parameters:
+ - id: key
+ description: Required. The key that identifies the custom property object.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CustomPropertyCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.CustomPropertyCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.CustomPropertyCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CustomPropertyCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CustomPropertyCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CustomPropertyCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.CustomPropertyCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CustomPropertyCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.CustomPropertyCollection` object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.CustomPropertyCollectionData`) that contains
+ an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CustomPropertyCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpart.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpart.yml
new file mode 100644
index 0000000000..f8c521f683
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpart.yml
@@ -0,0 +1,315 @@
+### YamlMime:TSType
+name: Excel.CustomXmlPart
+uid: 'excel!Excel.CustomXmlPart:class'
+package: excel!
+fullName: Excel.CustomXmlPart
+summary: Represents a custom XML part object in a workbook.
+remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CustomXmlPart#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: id
+ uid: 'excel!Excel.CustomXmlPart#id:member'
+ package: excel!
+ fullName: id
+ summary: The custom XML part's ID.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/create-set-get-and-delete-custom-xml-parts.yaml
+
+ await Excel.run(async (context) => {
+ // You must have the xmlns attribute to populate the
+ // CustomXml.namespaceUri property.
+ const originalXml = "JuanHongSally";
+ const customXmlPart = context.workbook.customXmlParts.add(originalXml);
+ customXmlPart.load("id");
+ const xmlBlob = customXmlPart.getXml();
+
+ await context.sync();
+
+ const readableXml = addLineBreaksToXML(xmlBlob.value);
+ $("#display-xml").text(readableXml);
+
+ // Store the XML part's ID in a setting.
+ const settings = context.workbook.settings;
+ settings.add("ContosoReviewXmlPartId", customXmlPart.id);
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: namespaceUri
+ uid: 'excel!Excel.CustomXmlPart#namespaceUri:member'
+ package: excel!
+ fullName: namespaceUri
+ summary: The custom XML part's namespace URI.
+ remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly namespaceUri: string;'
+ return:
+ type: string
+methods:
+ - name: delete()
+ uid: 'excel!Excel.CustomXmlPart#delete:member(1)'
+ package: excel!
+ fullName: delete()
+ summary: Deletes the custom XML part.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/create-set-get-and-delete-custom-xml-parts.yaml
+
+ await Excel.run(async (context) => {
+ const settings = context.workbook.settings;
+ const xmlPartIDSetting = settings.getItemOrNullObject("ContosoReviewXmlPartId").load("value");
+ await context.sync();
+
+ if (xmlPartIDSetting.value) {
+ let customXmlPart = context.workbook.customXmlParts.getItem(xmlPartIDSetting.value);
+ const xmlBlob = customXmlPart.getXml();
+ customXmlPart.delete();
+ customXmlPart = context.workbook.customXmlParts.getItemOrNullObject(xmlPartIDSetting.value);
+
+ await context.sync();
+
+ if (customXmlPart.isNullObject) {
+ $("#display-xml").text(`The XML part with the id ${xmlPartIDSetting.value} has been deleted.`);
+
+ // Delete the unneeded setting too.
+ xmlPartIDSetting.delete();
+ } else {
+ const readableXml = addLineBreaksToXML(xmlBlob.value);
+ const strangeMessage = `This is strange. The XML part with the id ${xmlPartIDSetting.value} has not been deleted:\n${readableXml}`
+ $("#display-xml").text(strangeMessage);
+ }
+
+ await context.sync();
+ }
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'delete(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getXml()
+ uid: 'excel!Excel.CustomXmlPart#getXml:member(1)'
+ package: excel!
+ fullName: getXml()
+ summary: Gets the custom XML part's full XML content.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/create-set-get-and-delete-custom-xml-parts.yaml
+
+ await Excel.run(async (context) => {
+ // You must have the xmlns attribute to populate the
+ // CustomXml.namespaceUri property.
+ const originalXml = "JuanHongSally";
+ const customXmlPart = context.workbook.customXmlParts.add(originalXml);
+ customXmlPart.load("id");
+ const xmlBlob = customXmlPart.getXml();
+
+ await context.sync();
+
+ const readableXml = addLineBreaksToXML(xmlBlob.value);
+ $("#display-xml").text(readableXml);
+
+ // Store the XML part's ID in a setting.
+ const settings = context.workbook.settings;
+ settings.add("ContosoReviewXmlPartId", customXmlPart.id);
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getXml(): OfficeExtension.ClientResult;'
+ return:
+ type: '<string>'
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CustomXmlPart#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.CustomXmlPartLoadOptions): Excel.CustomXmlPart;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CustomXmlPart#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CustomXmlPart;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CustomXmlPart#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.CustomXmlPart;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: setXml(xml)
+ uid: 'excel!Excel.CustomXmlPart#setXml:member(1)'
+ package: excel!
+ fullName: setXml(xml)
+ summary: Sets the custom XML part's full XML content.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/create-set-get-and-delete-custom-xml-parts.yaml
+
+ await Excel.run(async (context) => {
+ const settings = context.workbook.settings;
+ const xmlPartIDSetting = settings.getItemOrNullObject("ContosoReviewXmlPartId").load("value");
+ await context.sync();
+
+ if (xmlPartIDSetting.value) {
+ const customXmlPart = context.workbook.customXmlParts.getItem(xmlPartIDSetting.value);
+
+ // The setXml method does a whole-for-whole replacement
+ // of the entire XML.
+ customXmlPart.setXml("JohnHitomi");
+ const xmlBlob = customXmlPart.getXml();
+ await context.sync();
+
+ const readableXml = addLineBreaksToXML(xmlBlob.value);
+ $("#display-xml").text(readableXml);
+ await context.sync();
+ }
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setXml(xml: string): void;'
+ parameters:
+ - id: xml
+ description: XML content for the part.
+ type: string
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CustomXmlPart#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.CustomXmlPart object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.CustomXmlPartData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CustomXmlPartData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpartcollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpartcollection.yml
new file mode 100644
index 0000000000..8f65ba1135
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpartcollection.yml
@@ -0,0 +1,309 @@
+### YamlMime:TSType
+name: Excel.CustomXmlPartCollection
+uid: 'excel!Excel.CustomXmlPartCollection:class'
+package: excel!
+fullName: Excel.CustomXmlPartCollection
+summary: A collection of custom XML parts.
+remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CustomXmlPartCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.CustomXmlPartCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.CustomXmlPart[];'
+ return:
+ type: '[]'
+methods:
+ - name: add(xml)
+ uid: 'excel!Excel.CustomXmlPartCollection#add:member(1)'
+ package: excel!
+ fullName: add(xml)
+ summary: Adds a new custom XML part to the workbook.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/create-set-get-and-delete-custom-xml-parts.yaml
+
+ await Excel.run(async (context) => {
+ // You must have the xmlns attribute to populate the
+ // CustomXml.namespaceUri property.
+ const originalXml = "JuanHongSally";
+ const customXmlPart = context.workbook.customXmlParts.add(originalXml);
+ customXmlPart.load("id");
+ const xmlBlob = customXmlPart.getXml();
+
+ await context.sync();
+
+ const readableXml = addLineBreaksToXML(xmlBlob.value);
+ $("#display-xml").text(readableXml);
+
+ // Store the XML part's ID in a setting.
+ const settings = context.workbook.settings;
+ settings.add("ContosoReviewXmlPartId", customXmlPart.id);
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(xml: string): Excel.CustomXmlPart;'
+ parameters:
+ - id: xml
+ description: XML content. Must be a valid XML fragment.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getByNamespace(namespaceUri)
+ uid: 'excel!Excel.CustomXmlPartCollection#getByNamespace:member(1)'
+ package: excel!
+ fullName: getByNamespace(namespaceUri)
+ summary: Gets a new scoped collection of custom XML parts whose namespaces match the given namespace.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/test-xml-for-unique-namespace.yaml
+
+ await Excel.run(async (context) => {
+ $("#display-xml").text("");
+ const contosoNamespace = "http://schemas.contoso.com/review/1.0";
+ const customXmlParts = context.workbook.customXmlParts;
+ const filteredXmlParts = customXmlParts.getByNamespace(contosoNamespace);
+ const numberOfPartsInNamespace = filteredXmlParts.getCount();
+
+ await context.sync();
+
+ if (numberOfPartsInNamespace.value == 1) {
+ const onlyXmlPartInNamespace = filteredXmlParts.getOnlyItem();
+ const xmlBlob = onlyXmlPartInNamespace.getXml();
+
+ await context.sync();
+
+ // Make it a bit more readable.
+ const readableXml = xmlBlob.value.replace(/>\n<");
+
+ $("#display-xml").text(`The only XML part in the namespace ${contosoNamespace} is:
+ ${readableXml}`);
+
+ } else {
+ console.log(`There are ${numberOfPartsInNamespace.value} XML parts with namespace ${contosoNamespace}. There should be exactly 1.`);
+ }
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getByNamespace(namespaceUri: string): Excel.CustomXmlPartScopedCollection;'
+ parameters:
+ - id: namespaceUri
+ description: 'This must be a fully qualified schema URI; for example, "http://schemas.contoso.com/review/1.0".'
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.CustomXmlPartCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the number of custom XML parts in the collection.
+ remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(id)
+ uid: 'excel!Excel.CustomXmlPartCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(id)
+ summary: Gets a custom XML part based on its ID.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/create-set-get-and-delete-custom-xml-parts.yaml
+
+ await Excel.run(async (context) => {
+ const settings = context.workbook.settings;
+ const xmlPartIDSetting = settings.getItemOrNullObject("ContosoReviewXmlPartId").load("value");
+ await context.sync();
+
+ if (xmlPartIDSetting.value) {
+ const customXmlPart = context.workbook.customXmlParts.getItem(xmlPartIDSetting.value);
+
+ // The setXml method does a whole-for-whole replacement
+ // of the entire XML.
+ customXmlPart.setXml("JohnHitomi");
+ const xmlBlob = customXmlPart.getXml();
+ await context.sync();
+
+ const readableXml = addLineBreaksToXML(xmlBlob.value);
+ $("#display-xml").text(readableXml);
+ await context.sync();
+ }
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(id: string): Excel.CustomXmlPart;'
+ parameters:
+ - id: id
+ description: ID of the object to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(id)
+ uid: 'excel!Excel.CustomXmlPartCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(id)
+ summary: >-
+ Gets a custom XML part based on its ID. If the `CustomXmlPart` does not exist, then this method returns an object
+ with its `isNullObject` property set to `true`. For further information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(id: string): Excel.CustomXmlPart;'
+ parameters:
+ - id: id
+ description: ID of the object to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CustomXmlPartCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.CustomXmlPartCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions):
+ Excel.CustomXmlPartCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CustomXmlPartCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CustomXmlPartCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CustomXmlPartCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.CustomXmlPartCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CustomXmlPartCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.CustomXmlPartCollection` object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.CustomXmlPartCollectionData`) that contains
+ an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CustomXmlPartCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpartscopedcollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpartscopedcollection.yml
new file mode 100644
index 0000000000..3b159e86c8
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.customxmlpartscopedcollection.yml
@@ -0,0 +1,321 @@
+### YamlMime:TSType
+name: Excel.CustomXmlPartScopedCollection
+uid: 'excel!Excel.CustomXmlPartScopedCollection:class'
+package: excel!
+fullName: Excel.CustomXmlPartScopedCollection
+summary: >-
+ A scoped collection of custom XML parts. A scoped collection is the result of some operation (e.g., filtering by
+ namespace). A scoped collection cannot be scoped any further.
+remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.CustomXmlPart[];'
+ return:
+ type: '[]'
+methods:
+ - name: getCount()
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the number of CustomXML parts in this collection.
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/test-xml-for-unique-namespace.yaml
+
+ await Excel.run(async (context) => {
+ $("#display-xml").text("");
+ const contosoNamespace = "http://schemas.contoso.com/review/1.0";
+ const customXmlParts = context.workbook.customXmlParts;
+ const filteredXmlParts = customXmlParts.getByNamespace(contosoNamespace);
+ const numberOfPartsInNamespace = filteredXmlParts.getCount();
+
+ await context.sync();
+
+ if (numberOfPartsInNamespace.value == 1) {
+ const onlyXmlPartInNamespace = filteredXmlParts.getOnlyItem();
+ const xmlBlob = onlyXmlPartInNamespace.getXml();
+
+ await context.sync();
+
+ // Make it a bit more readable.
+ const readableXml = xmlBlob.value.replace(/>\n<");
+
+ $("#display-xml").text(`The only XML part in the namespace ${contosoNamespace} is:
+ ${readableXml}`);
+
+ } else {
+ console.log(`There are ${numberOfPartsInNamespace.value} XML parts with namespace ${contosoNamespace}. There should be exactly 1.`);
+ }
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(id)
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(id)
+ summary: Gets a custom XML part based on its ID.
+ remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(id: string): Excel.CustomXmlPart;'
+ parameters:
+ - id: id
+ description: ID of the object to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(id)
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(id)
+ summary: >-
+ Gets a custom XML part based on its ID. If the `CustomXmlPart` does not exist, then this method returns an object
+ with its `isNullObject` property set to `true`. For further information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/create-set-get-and-delete-custom-xml-parts.yaml
+
+ await Excel.run(async (context) => {
+ const settings = context.workbook.settings;
+ const xmlPartIDSetting = settings.getItemOrNullObject("ContosoReviewXmlPartId").load("value");
+ await context.sync();
+
+ if (xmlPartIDSetting.value) {
+ let customXmlPart = context.workbook.customXmlParts.getItem(xmlPartIDSetting.value);
+ const xmlBlob = customXmlPart.getXml();
+ customXmlPart.delete();
+ customXmlPart = context.workbook.customXmlParts.getItemOrNullObject(xmlPartIDSetting.value);
+
+ await context.sync();
+
+ if (customXmlPart.isNullObject) {
+ $("#display-xml").text(`The XML part with the id ${xmlPartIDSetting.value} has been deleted.`);
+
+ // Delete the unneeded setting too.
+ xmlPartIDSetting.delete();
+ } else {
+ const readableXml = addLineBreaksToXML(xmlBlob.value);
+ const strangeMessage = `This is strange. The XML part with the id ${xmlPartIDSetting.value} has not been deleted:\n${readableXml}`
+ $("#display-xml").text(strangeMessage);
+ }
+
+ await context.sync();
+ }
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(id: string): Excel.CustomXmlPart;'
+ parameters:
+ - id: id
+ description: ID of the object to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getOnlyItem()
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#getOnlyItem:member(1)'
+ package: excel!
+ fullName: getOnlyItem()
+ summary: 'If the collection contains exactly one item, this method returns it. Otherwise, this method produces an error.'
+ remarks: >-
+ \[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/18-custom-xml-parts/test-xml-for-unique-namespace.yaml
+
+ await Excel.run(async (context) => {
+ $("#display-xml").text("");
+ const contosoNamespace = "http://schemas.contoso.com/review/1.0";
+ const customXmlParts = context.workbook.customXmlParts;
+ const filteredXmlParts = customXmlParts.getByNamespace(contosoNamespace);
+ const numberOfPartsInNamespace = filteredXmlParts.getCount();
+
+ await context.sync();
+
+ if (numberOfPartsInNamespace.value == 1) {
+ const onlyXmlPartInNamespace = filteredXmlParts.getOnlyItem();
+ const xmlBlob = onlyXmlPartInNamespace.getXml();
+
+ await context.sync();
+
+ // Make it a bit more readable.
+ const readableXml = xmlBlob.value.replace(/>\n<");
+
+ $("#display-xml").text(`The only XML part in the namespace ${contosoNamespace} is:
+ ${readableXml}`);
+
+ } else {
+ console.log(`There are ${numberOfPartsInNamespace.value} XML parts with namespace ${contosoNamespace}. There should be exactly 1.`);
+ }
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getOnlyItem(): Excel.CustomXmlPart;'
+ return:
+ type: ''
+ description: ''
+ - name: getOnlyItemOrNullObject()
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#getOnlyItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getOnlyItemOrNullObject()
+ summary: >-
+ If the collection contains exactly one item, this method returns it. Otherwise, this method returns `null`.
+ remarks: '\[ [API set: ExcelApi 1.5](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getOnlyItemOrNullObject(): Excel.CustomXmlPart;'
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.CustomXmlPartScopedCollectionLoadOptions &
+ Excel.Interfaces.CollectionLoadOptions): Excel.CustomXmlPartScopedCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.CustomXmlPartScopedCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.CustomXmlPartScopedCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.CustomXmlPartScopedCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.CustomXmlPartScopedCollection` object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.CustomXmlPartScopedCollectionData`)
+ that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.CustomXmlPartScopedCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.databarconditionalformat.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.databarconditionalformat.yml
new file mode 100644
index 0000000000..f9743843d3
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.databarconditionalformat.yml
@@ -0,0 +1,279 @@
+### YamlMime:TSType
+name: Excel.DataBarConditionalFormat
+uid: 'excel!Excel.DataBarConditionalFormat:class'
+package: excel!
+fullName: Excel.DataBarConditionalFormat
+summary: Represents an Excel conditional data bar type.
+remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: axisColor
+ uid: 'excel!Excel.DataBarConditionalFormat#axisColor:member'
+ package: excel!
+ fullName: axisColor
+ summary: >-
+ HTML color code representing the color of the Axis line, in the form \#RRGGBB (e.g., "FFA500") or as a named HTML
+ color (e.g., "orange"). Value is "" (an empty string) if no axis is present or set.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'axisColor: string;'
+ return:
+ type: string
+ - name: axisFormat
+ uid: 'excel!Excel.DataBarConditionalFormat#axisFormat:member'
+ package: excel!
+ fullName: axisFormat
+ summary: Representation of how the axis is determined for an Excel data bar.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'axisFormat: Excel.ConditionalDataBarAxisFormat | "Automatic" | "None" | "CellMidPoint";'
+ return:
+ type: ' | "Automatic" | "None" | "CellMidPoint"'
+ - name: barDirection
+ uid: 'excel!Excel.DataBarConditionalFormat#barDirection:member'
+ package: excel!
+ fullName: barDirection
+ summary: Specifies the direction that the data bar graphic should be based on.
+ remarks: >-
+ \[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/14-conditional-formatting/conditional-formatting-basic.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("B8:E13");
+ const conditionalFormat = range.conditionalFormats
+ .add(Excel.ConditionalFormatType.dataBar);
+ conditionalFormat.dataBar.barDirection = Excel.ConditionalDataBarDirection.leftToRight;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'barDirection: Excel.ConditionalDataBarDirection | "Context" | "LeftToRight" | "RightToLeft";'
+ return:
+ type: ' | "Context" | "LeftToRight" | "RightToLeft"'
+ - name: context
+ uid: 'excel!Excel.DataBarConditionalFormat#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: lowerBoundRule
+ uid: 'excel!Excel.DataBarConditionalFormat#lowerBoundRule:member'
+ package: excel!
+ fullName: lowerBoundRule
+ summary: >-
+ The rule for what consistutes the lower bound (and how to calculate it, if applicable) for a data bar. The
+ `ConditionalDataBarRule` object must be set as a JSON object (use `x.lowerBoundRule = {...}` instead of
+ `x.lowerBoundRule.formula = ...`).
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'lowerBoundRule: Excel.ConditionalDataBarRule;'
+ return:
+ type: ''
+ - name: negativeFormat
+ uid: 'excel!Excel.DataBarConditionalFormat#negativeFormat:member'
+ package: excel!
+ fullName: negativeFormat
+ summary: Representation of all values to the left of the axis in an Excel data bar.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly negativeFormat: Excel.ConditionalDataBarNegativeFormat;'
+ return:
+ type: ''
+ - name: positiveFormat
+ uid: 'excel!Excel.DataBarConditionalFormat#positiveFormat:member'
+ package: excel!
+ fullName: positiveFormat
+ summary: Representation of all values to the right of the axis in an Excel data bar.
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly positiveFormat: Excel.ConditionalDataBarPositiveFormat;'
+ return:
+ type: ''
+ - name: showDataBarOnly
+ uid: 'excel!Excel.DataBarConditionalFormat#showDataBarOnly:member'
+ package: excel!
+ fullName: showDataBarOnly
+ summary: 'If `true`, hides the values from the cells where the data bar is applied.'
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showDataBarOnly: boolean;'
+ return:
+ type: boolean
+ - name: upperBoundRule
+ uid: 'excel!Excel.DataBarConditionalFormat#upperBoundRule:member'
+ package: excel!
+ fullName: upperBoundRule
+ summary: >-
+ The rule for what constitutes the upper bound (and how to calculate it, if applicable) for a data bar. The
+ `ConditionalDataBarRule` object must be set as a JSON object (use `x.upperBoundRule = {...}` instead of
+ `x.upperBoundRule.formula = ...`).
+ remarks: '\[ [API set: ExcelApi 1.6](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'upperBoundRule: Excel.ConditionalDataBarRule;'
+ return:
+ type: ''
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.DataBarConditionalFormat#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.DataBarConditionalFormatLoadOptions): Excel.DataBarConditionalFormat;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.DataBarConditionalFormat#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.DataBarConditionalFormat;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.DataBarConditionalFormat#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.DataBarConditionalFormat;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.DataBarConditionalFormat#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.DataBarConditionalFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.DataBarConditionalFormat#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.DataBarConditionalFormat): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.DataBarConditionalFormat#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.DataBarConditionalFormat object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.DataBarConditionalFormatData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.DataBarConditionalFormatData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datachangetype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datachangetype.yml
new file mode 100644
index 0000000000..0b8c2a9823
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datachangetype.yml
@@ -0,0 +1,76 @@
+### YamlMime:TSEnum
+name: Excel.DataChangeType
+uid: 'excel!Excel.DataChangeType:enum'
+package: excel!
+fullName: Excel.DataChangeType
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: cellDeleted
+ uid: 'excel!Excel.DataChangeType.cellDeleted:member'
+ package: excel!
+ summary: |-
+ `CellDeleted` indicates that the data change event is triggered by deleting cells.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CellDeleted"'
+ - name: cellInserted
+ uid: 'excel!Excel.DataChangeType.cellInserted:member'
+ package: excel!
+ summary: |-
+ `CellInserted` indicates that the data change event is triggered by inserting new cells.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CellInserted"'
+ - name: columnDeleted
+ uid: 'excel!Excel.DataChangeType.columnDeleted:member'
+ package: excel!
+ summary: |-
+ `ColumnDeleted` indicates that the data change event is triggered by deleting columns.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ColumnDeleted"'
+ - name: columnInserted
+ uid: 'excel!Excel.DataChangeType.columnInserted:member'
+ package: excel!
+ summary: |-
+ `ColumnInserted` indicates that the data change event is triggered by inserting new columns.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ColumnInserted"'
+ - name: rangeEdited
+ uid: 'excel!Excel.DataChangeType.rangeEdited:member'
+ package: excel!
+ summary: |-
+ `RangeEdited` indicates that the data change event is triggered by a range being edited.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RangeEdited"'
+ - name: rowDeleted
+ uid: 'excel!Excel.DataChangeType.rowDeleted:member'
+ package: excel!
+ summary: |-
+ `RowDeleted` indicates that the data change event is triggered by deleting rows.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RowDeleted"'
+ - name: rowInserted
+ uid: 'excel!Excel.DataChangeType.rowInserted:member'
+ package: excel!
+ summary: |-
+ `RowInserted` indicates that the data change event is triggered by inserting new rows.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RowInserted"'
+ - name: unknown
+ uid: 'excel!Excel.DataChangeType.unknown:member'
+ package: excel!
+ summary: >-
+ `Unknown` indicates that the type of data change is not one of the listed types.
+
+
+ * \[ [API set: ExcelApi 1.8. The name of this value was 'Others' in ExcelApi
+ 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.dataconnectioncollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.dataconnectioncollection.yml
new file mode 100644
index 0000000000..c59ccf9266
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.dataconnectioncollection.yml
@@ -0,0 +1,68 @@
+### YamlMime:TSType
+name: Excel.DataConnectionCollection
+uid: 'excel!Excel.DataConnectionCollection:class'
+package: excel!
+fullName: Excel.DataConnectionCollection
+summary: Represents a collection of all the data connections that are part of the workbook.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.DataConnectionCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+methods:
+ - name: refreshAll()
+ uid: 'excel!Excel.DataConnectionCollection#refreshAll:member(1)'
+ package: excel!
+ fullName: refreshAll()
+ summary: >-
+ Refreshes data connections in the collection, such as from a PivotTable to a Power BI dataset, or a Data Model to
+ a table or range in the same workbook. Data connections unsupported by this method are: Power Query connections,
+ data connections outside the original workbook (except Power BI connections), and connections to data protected by
+ a firewall.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'refreshAll(): void;'
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.DataConnectionCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.DataConnectionCollection object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.DataConnectionCollectionData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ toJSON(): {
+ [key: string]: string;
+ };
+ return:
+ type: |-
+ {
+ [key: string]: string;
+ }
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datapivothierarchy.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datapivothierarchy.yml
new file mode 100644
index 0000000000..ab8862196c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datapivothierarchy.yml
@@ -0,0 +1,311 @@
+### YamlMime:TSType
+name: Excel.DataPivotHierarchy
+uid: 'excel!Excel.DataPivotHierarchy:class'
+package: excel!
+fullName: Excel.DataPivotHierarchy
+summary: Represents the Excel DataPivotHierarchy.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.DataPivotHierarchy#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: field
+ uid: 'excel!Excel.DataPivotHierarchy#field:member'
+ package: excel!
+ fullName: field
+ summary: Returns the PivotFields associated with the DataPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly field: Excel.PivotField;'
+ return:
+ type: ''
+ - name: id
+ uid: 'excel!Excel.DataPivotHierarchy#id:member'
+ package: excel!
+ fullName: id
+ summary: ID of the DataPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: name
+ uid: 'excel!Excel.DataPivotHierarchy#name:member'
+ package: excel!
+ fullName: name
+ summary: Name of the DataPivotHierarchy.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-create-and-modify.yaml
+
+ await Excel.run(async (context) => {
+ const dataHierarchies = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales").dataHierarchies
+ dataHierarchies.load("no-properties-needed");
+ await context.sync();
+
+ dataHierarchies.items[0].name = "Farm Sales";
+ dataHierarchies.items[1].name = "Wholesale";
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name: string;'
+ return:
+ type: string
+ - name: numberFormat
+ uid: 'excel!Excel.DataPivotHierarchy#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: Number format of the DataPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'numberFormat: string;'
+ return:
+ type: string
+ - name: position
+ uid: 'excel!Excel.DataPivotHierarchy#position:member'
+ package: excel!
+ fullName: position
+ summary: Position of the DataPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'position: number;'
+ return:
+ type: number
+ - name: showAs
+ uid: 'excel!Excel.DataPivotHierarchy#showAs:member'
+ package: excel!
+ fullName: showAs
+ summary: Specifies if the data should be shown as a specific summary calculation.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-calculations.yaml
+
+ await Excel.run(async (context) => {
+ const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");
+ const farmDataHierarchy: Excel.DataPivotHierarchy = pivotTable.dataHierarchies.getItem("Sum of Crates Sold at Farm");
+ const wholesaleDataHierarchy: Excel.DataPivotHierarchy = pivotTable.dataHierarchies.getItem("Sum of Crates Sold Wholesale");
+
+ farmDataHierarchy.load("showAs");
+ wholesaleDataHierarchy.load("showAs");
+ await context.sync();
+
+ // Show the crates of each fruit type sold at the farm as a percentage of the column's total.
+ let farmShowAs = farmDataHierarchy.showAs;
+ farmShowAs.calculation = Excel.ShowAsCalculation.percentOfColumnTotal;
+ farmShowAs.baseField = pivotTable.rowHierarchies.getItem("Type").fields.getItem("Type");
+ farmDataHierarchy.showAs = farmShowAs;
+
+ let wholesaleShowAs = wholesaleDataHierarchy.showAs;
+ wholesaleShowAs.calculation = Excel.ShowAsCalculation.percentOfColumnTotal;
+ wholesaleShowAs.baseField = pivotTable.rowHierarchies.getItem("Type").fields.getItem("Type");
+ wholesaleDataHierarchy.showAs = wholesaleShowAs;
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showAs: Excel.ShowAsRule;'
+ return:
+ type: ''
+ - name: summarizeBy
+ uid: 'excel!Excel.DataPivotHierarchy#summarizeBy:member'
+ package: excel!
+ fullName: summarizeBy
+ summary: Specifies if all items of the DataPivotHierarchy are shown.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ summarizeBy: Excel.AggregationFunction | "Unknown" | "Automatic" | "Sum" | "Count" | "Average" | "Max" | "Min" |
+ "Product" | "CountNumbers" | "StandardDeviation" | "StandardDeviationP" | "Variance" | "VarianceP";
+ return:
+ type: >-
+ | "Unknown" | "Automatic" | "Sum" | "Count" | "Average" |
+ "Max" | "Min" | "Product" | "CountNumbers" | "StandardDeviation" | "StandardDeviationP" | "Variance" |
+ "VarianceP"
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.DataPivotHierarchy#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.DataPivotHierarchyLoadOptions): Excel.DataPivotHierarchy;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.DataPivotHierarchy#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.DataPivotHierarchy;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.DataPivotHierarchy#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.DataPivotHierarchy;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.DataPivotHierarchy#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.DataPivotHierarchyUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.DataPivotHierarchy#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.DataPivotHierarchy): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setToDefault()
+ uid: 'excel!Excel.DataPivotHierarchy#setToDefault:member(1)'
+ package: excel!
+ fullName: setToDefault()
+ summary: Reset the DataPivotHierarchy back to its default values.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setToDefault(): void;'
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.DataPivotHierarchy#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.DataPivotHierarchy object is an API object, the `toJSON` method returns
+ a plain JavaScript object (typed as `Excel.Interfaces.DataPivotHierarchyData`) that contains shallow
+ copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.DataPivotHierarchyData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datapivothierarchycollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datapivothierarchycollection.yml
new file mode 100644
index 0000000000..8a56c71a4a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datapivothierarchycollection.yml
@@ -0,0 +1,205 @@
+### YamlMime:TSType
+name: Excel.DataPivotHierarchyCollection
+uid: 'excel!Excel.DataPivotHierarchyCollection:class'
+package: excel!
+fullName: Excel.DataPivotHierarchyCollection
+summary: Represents a collection of DataPivotHierarchy items associated with the PivotTable.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.DataPivotHierarchyCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.DataPivotHierarchyCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.DataPivotHierarchy[];'
+ return:
+ type: '[]'
+methods:
+ - name: add(pivotHierarchy)
+ uid: 'excel!Excel.DataPivotHierarchyCollection#add:member(1)'
+ package: excel!
+ fullName: add(pivotHierarchy)
+ summary: Adds the PivotHierarchy to the current axis.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(pivotHierarchy: Excel.PivotHierarchy): Excel.DataPivotHierarchy;'
+ parameters:
+ - id: pivotHierarchy
+ description: ''
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.DataPivotHierarchyCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the number of pivot hierarchies in the collection.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(name)
+ uid: 'excel!Excel.DataPivotHierarchyCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(name)
+ summary: Gets a DataPivotHierarchy by its name or ID.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(name: string): Excel.DataPivotHierarchy;'
+ parameters:
+ - id: name
+ description: Name of the DataPivotHierarchy to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(name)
+ uid: 'excel!Excel.DataPivotHierarchyCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(name)
+ summary: >-
+ Gets a DataPivotHierarchy by name. If the DataPivotHierarchy does not exist, then this method returns an object
+ with its `isNullObject` property set to `true`. For further information, see [*OrNullObject methods and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(name: string): Excel.DataPivotHierarchy;'
+ parameters:
+ - id: name
+ description: Name of the DataPivotHierarchy to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.DataPivotHierarchyCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.DataPivotHierarchyCollectionLoadOptions &
+ Excel.Interfaces.CollectionLoadOptions): Excel.DataPivotHierarchyCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.DataPivotHierarchyCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.DataPivotHierarchyCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.DataPivotHierarchyCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.DataPivotHierarchyCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: remove(DataPivotHierarchy)
+ uid: 'excel!Excel.DataPivotHierarchyCollection#remove:member(1)'
+ package: excel!
+ fullName: remove(DataPivotHierarchy)
+ summary: Removes the PivotHierarchy from the current axis.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'remove(DataPivotHierarchy: Excel.DataPivotHierarchy): void;'
+ parameters:
+ - id: DataPivotHierarchy
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.DataPivotHierarchyCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.DataPivotHierarchyCollection` object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.DataPivotHierarchyCollectionData`)
+ that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.DataPivotHierarchyCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datasourcetype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datasourcetype.yml
new file mode 100644
index 0000000000..e5122a0420
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datasourcetype.yml
@@ -0,0 +1,34 @@
+### YamlMime:TSEnum
+name: Excel.DataSourceType
+uid: 'excel!Excel.DataSourceType:enum'
+package: excel!
+fullName: Excel.DataSourceType
+summary: Represents a command type of `DataConnection`.
+remarks: '\[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: localRange
+ uid: 'excel!Excel.DataSourceType.localRange:member'
+ package: excel!
+ summary: |-
+ The data source type is a range in the current workbook.
+
+ * \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LocalRange"'
+ - name: localTable
+ uid: 'excel!Excel.DataSourceType.localTable:member'
+ package: excel!
+ summary: |-
+ The data source type is a table in the current workbook.
+
+ * \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LocalTable"'
+ - name: unknown
+ uid: 'excel!Excel.DataSourceType.unknown:member'
+ package: excel!
+ summary: |-
+ The data source type is unknown or unsupported.
+
+ * \[ [API set: ExcelApi 1.15](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidation.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidation.yml
new file mode 100644
index 0000000000..9252d742f4
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidation.yml
@@ -0,0 +1,396 @@
+### YamlMime:TSType
+name: Excel.DataValidation
+uid: 'excel!Excel.DataValidation:class'
+package: excel!
+fullName: Excel.DataValidation
+summary: >-
+ Represents the data validation applied to the current range. To learn more about the data validation object model,
+ read [Add data validation to Excel
+ ranges](https://docs.microsoft.com/office/dev/add-ins/excel/excel-add-ins-data-validation).
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.DataValidation#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: errorAlert
+ uid: 'excel!Excel.DataValidation#errorAlert:member'
+ package: excel!
+ fullName: errorAlert
+ summary: Error alert when user enters invalid data.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Decision");
+ const commentsRange =
+ sheet.tables.getItem("NameOptionsTable").columns.getItem("Comments").getDataBodyRange();
+
+ // When you are developing, it is a good practice to
+ // clear the dataValidation object with each run of your code.
+ commentsRange.dataValidation.clear();
+
+ // If the value of A2 is contained in the value of C2, then
+ // SEARCH(A2,C2) returns the number where it begins. Otherwise,
+ // it does not return a number.
+ let redundantStringRule = {
+ custom: {
+ formula: "=NOT(ISNUMBER(SEARCH(A2,C2)))"
+ }
+ };
+ commentsRange.dataValidation.rule = redundantStringRule;
+ commentsRange.dataValidation.errorAlert = {
+ message: "It is redundant to include the baby name in the comment.",
+ showAlert: true,
+ style: "Information",
+ title: "Baby Name in Comment"
+ };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorAlert: Excel.DataValidationErrorAlert;'
+ return:
+ type: ''
+ - name: ignoreBlanks
+ uid: 'excel!Excel.DataValidation#ignoreBlanks:member'
+ package: excel!
+ fullName: ignoreBlanks
+ summary: Specifies if data validation will be performed on blank cells. Default is `true`.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'ignoreBlanks: boolean;'
+ return:
+ type: boolean
+ - name: prompt
+ uid: 'excel!Excel.DataValidation#prompt:member'
+ package: excel!
+ fullName: prompt
+ summary: Prompt when users select a cell.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Decision");
+ const rankingRange = sheet.tables.getItem("NameOptionsTable").columns.getItem("Ranking").getDataBodyRange();
+
+ // When you are developing, it is a good practice to
+ // clear the dataValidation object with each run of your code.
+ rankingRange.dataValidation.clear();
+
+ let greaterThanZeroRule = {
+ wholeNumber: {
+ formula1: 0,
+ operator: Excel.DataValidationOperator.greaterThan
+ }
+ };
+ rankingRange.dataValidation.rule = greaterThanZeroRule;
+
+ rankingRange.dataValidation.prompt = {
+ message: "Please enter a positive number.",
+ showPrompt: true,
+ title: "Positive numbers only."
+ };
+
+ rankingRange.dataValidation.errorAlert = {
+ message: "Sorry, only positive numbers are allowed",
+ showAlert: true,
+ style: "Stop",
+ title: "Negative Number Entered"
+ };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'prompt: Excel.DataValidationPrompt;'
+ return:
+ type: ''
+ - name: rule
+ uid: 'excel!Excel.DataValidation#rule:member'
+ package: excel!
+ fullName: rule
+ summary: Data validation rule that contains different type of data validation criteria.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Decision");
+ const nameRange =
+ sheet.tables.getItem("NameOptionsTable").columns.getItem("Baby Name").getDataBodyRange();
+
+ // When you are developing, it is a good practice to
+ // clear the dataValidation object with each run of your code.
+ nameRange.dataValidation.clear();
+
+ const nameSourceRange = context.workbook.worksheets.getItem("Names").getRange("A1:A3");
+
+ let approvedListRule = {
+ list: {
+ inCellDropDown: true,
+ source: nameSourceRange
+ }
+ };
+ nameRange.dataValidation.rule = approvedListRule;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'rule: Excel.DataValidationRule;'
+ return:
+ type: ''
+ - name: type
+ uid: 'excel!Excel.DataValidation#type:member'
+ package: excel!
+ fullName: type
+ summary: 'Type of the data validation, see `Excel.DataValidationType` for details.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ readonly type: Excel.DataValidationType | "None" | "WholeNumber" | "Decimal" | "List" | "Date" | "Time" |
+ "TextLength" | "Custom" | "Inconsistent" | "MixedCriteria";
+ return:
+ type: >-
+ | "None" | "WholeNumber" | "Decimal" | "List" | "Date" |
+ "Time" | "TextLength" | "Custom" | "Inconsistent" | "MixedCriteria"
+ - name: valid
+ uid: 'excel!Excel.DataValidation#valid:member'
+ package: excel!
+ fullName: valid
+ summary: >-
+ Represents if all cell values are valid according to the data validation rules. Returns `true` if all cell values
+ are valid, or `false` if all cell values are invalid. Returns `null` if there are both valid and invalid cell
+ values within the range.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly valid: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: clear()
+ uid: 'excel!Excel.DataValidation#clear:member(1)'
+ package: excel!
+ fullName: clear()
+ summary: Clears the data validation from the current range.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clear(): void;'
+ return:
+ type: void
+ description: ''
+ - name: getInvalidCells()
+ uid: 'excel!Excel.DataValidation#getInvalidCells:member(1)'
+ package: excel!
+ fullName: getInvalidCells()
+ summary: >-
+ Returns a `RangeAreas` object, comprising one or more rectangular ranges, with invalid cell values. If all cell
+ values are valid, this function will throw an `ItemNotFound` error.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getInvalidCells(): Excel.RangeAreas;'
+ return:
+ type: ''
+ description: ''
+ - name: getInvalidCellsOrNullObject()
+ uid: 'excel!Excel.DataValidation#getInvalidCellsOrNullObject:member(1)'
+ package: excel!
+ fullName: getInvalidCellsOrNullObject()
+ summary: >-
+ Returns a `RangeAreas` object, comprising one or more rectangular ranges, with invalid cell values. If all cell
+ values are valid, this function will return `null`.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getInvalidCellsOrNullObject(): Excel.RangeAreas;'
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.DataValidation#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.DataValidationLoadOptions): Excel.DataValidation;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.DataValidation#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.DataValidation;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.DataValidation#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.DataValidation;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.DataValidation#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.DataValidationUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.DataValidation#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.DataValidation): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.DataValidation#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.DataValidation object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.DataValidationData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.DataValidationData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationalertstyle.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationalertstyle.yml
new file mode 100644
index 0000000000..589fabaf1e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationalertstyle.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSEnum
+name: Excel.DataValidationAlertStyle
+uid: 'excel!Excel.DataValidationAlertStyle:enum'
+package: excel!
+fullName: Excel.DataValidationAlertStyle
+summary: Represents the data validation error alert style. The default is `Stop`.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: information
+ uid: 'excel!Excel.DataValidationAlertStyle.information:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Information"'
+ - name: stop
+ uid: 'excel!Excel.DataValidationAlertStyle.stop:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Stop"'
+ - name: warning
+ uid: 'excel!Excel.DataValidationAlertStyle.warning:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Warning"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationerroralert.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationerroralert.yml
new file mode 100644
index 0000000000..b245d10c69
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationerroralert.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.DataValidationErrorAlert
+uid: 'excel!Excel.DataValidationErrorAlert:interface'
+package: excel!
+fullName: Excel.DataValidationErrorAlert
+summary: Represents the error alert properties for the data validation.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: message
+ uid: 'excel!Excel.DataValidationErrorAlert#message:member'
+ package: excel!
+ fullName: message
+ summary: Represents the error alert message.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'message: string;'
+ return:
+ type: string
+ - name: showAlert
+ uid: 'excel!Excel.DataValidationErrorAlert#showAlert:member'
+ package: excel!
+ fullName: showAlert
+ summary: Specifies whether to show an error alert dialog when a user enters invalid data. The default is `true`.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showAlert: boolean;'
+ return:
+ type: boolean
+ - name: style
+ uid: 'excel!Excel.DataValidationErrorAlert#style:member'
+ package: excel!
+ fullName: style
+ summary: 'The data validation alert type, please see `Excel.DataValidationAlertStyle` for details.'
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'style: Excel.DataValidationAlertStyle | "Stop" | "Warning" | "Information";'
+ return:
+ type: ' | "Stop" | "Warning" | "Information"'
+ - name: title
+ uid: 'excel!Excel.DataValidationErrorAlert#title:member'
+ package: excel!
+ fullName: title
+ summary: Represents the error alert dialog title.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'title: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationoperator.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationoperator.yml
new file mode 100644
index 0000000000..91c5234e35
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationoperator.yml
@@ -0,0 +1,94 @@
+### YamlMime:TSEnum
+name: Excel.DataValidationOperator
+uid: 'excel!Excel.DataValidationOperator:enum'
+package: excel!
+fullName: Excel.DataValidationOperator
+summary: Represents the data validation operator enum.
+remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Decision");
+ const rankingRange = sheet.tables.getItem("NameOptionsTable").columns.getItem("Ranking").getDataBodyRange();
+
+ // When you are developing, it is a good practice to
+ // clear the dataValidation object with each run of your code.
+ rankingRange.dataValidation.clear();
+
+ let greaterThanZeroRule = {
+ wholeNumber: {
+ formula1: 0,
+ operator: Excel.DataValidationOperator.greaterThan
+ }
+ };
+ rankingRange.dataValidation.rule = greaterThanZeroRule;
+
+ rankingRange.dataValidation.prompt = {
+ message: "Please enter a positive number.",
+ showPrompt: true,
+ title: "Positive numbers only."
+ };
+
+ rankingRange.dataValidation.errorAlert = {
+ message: "Sorry, only positive numbers are allowed",
+ showAlert: true,
+ style: "Stop",
+ title: "Negative Number Entered"
+ };
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: between
+ uid: 'excel!Excel.DataValidationOperator.between:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Between"'
+ - name: equalTo
+ uid: 'excel!Excel.DataValidationOperator.equalTo:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"EqualTo"'
+ - name: greaterThan
+ uid: 'excel!Excel.DataValidationOperator.greaterThan:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"GreaterThan"'
+ - name: greaterThanOrEqualTo
+ uid: 'excel!Excel.DataValidationOperator.greaterThanOrEqualTo:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"GreaterThanOrEqualTo"'
+ - name: lessThan
+ uid: 'excel!Excel.DataValidationOperator.lessThan:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LessThan"'
+ - name: lessThanOrEqualTo
+ uid: 'excel!Excel.DataValidationOperator.lessThanOrEqualTo:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LessThanOrEqualTo"'
+ - name: notBetween
+ uid: 'excel!Excel.DataValidationOperator.notBetween:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NotBetween"'
+ - name: notEqualTo
+ uid: 'excel!Excel.DataValidationOperator.notEqualTo:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NotEqualTo"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationprompt.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationprompt.yml
new file mode 100644
index 0000000000..42597e843d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationprompt.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.DataValidationPrompt
+uid: 'excel!Excel.DataValidationPrompt:interface'
+package: excel!
+fullName: Excel.DataValidationPrompt
+summary: Represents the user prompt properties for the data validation.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: message
+ uid: 'excel!Excel.DataValidationPrompt#message:member'
+ package: excel!
+ fullName: message
+ summary: Specifies the message of the prompt.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'message: string;'
+ return:
+ type: string
+ - name: showPrompt
+ uid: 'excel!Excel.DataValidationPrompt#showPrompt:member'
+ package: excel!
+ fullName: showPrompt
+ summary: Specifies if a prompt is shown when a user selects a cell with data validation.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'showPrompt: boolean;'
+ return:
+ type: boolean
+ - name: title
+ uid: 'excel!Excel.DataValidationPrompt#title:member'
+ package: excel!
+ fullName: title
+ summary: Specifies the title for the prompt.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'title: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationrule.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationrule.yml
new file mode 100644
index 0000000000..9db7a84854
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationrule.yml
@@ -0,0 +1,175 @@
+### YamlMime:TSType
+name: Excel.DataValidationRule
+uid: 'excel!Excel.DataValidationRule:interface'
+package: excel!
+fullName: Excel.DataValidationRule
+summary: >-
+ A data validation rule contains different types of data validation. You can only use one of them at a time according
+ the `Excel.DataValidationType`.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: custom
+ uid: 'excel!Excel.DataValidationRule#custom:member'
+ package: excel!
+ fullName: custom
+ summary: Custom data validation criteria.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'custom?: Excel.CustomDataValidation;'
+ return:
+ type: ''
+ - name: date
+ uid: 'excel!Excel.DataValidationRule#date:member'
+ package: excel!
+ fullName: date
+ summary: Date data validation criteria.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'date?: Excel.DateTimeDataValidation;'
+ return:
+ type: ''
+ - name: decimal
+ uid: 'excel!Excel.DataValidationRule#decimal:member'
+ package: excel!
+ fullName: decimal
+ summary: Decimal data validation criteria.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'decimal?: Excel.BasicDataValidation;'
+ return:
+ type: ''
+ - name: list
+ uid: 'excel!Excel.DataValidationRule#list:member'
+ package: excel!
+ fullName: list
+ summary: List data validation criteria.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Decision");
+ const nameRange =
+ sheet.tables.getItem("NameOptionsTable").columns.getItem("Baby Name").getDataBodyRange();
+
+ // When you are developing, it is a good practice to
+ // clear the dataValidation object with each run of your code.
+ nameRange.dataValidation.clear();
+
+ const nameSourceRange = context.workbook.worksheets.getItem("Names").getRange("A1:A3");
+
+ let approvedListRule = {
+ list: {
+ inCellDropDown: true,
+ source: nameSourceRange
+ }
+ };
+ nameRange.dataValidation.rule = approvedListRule;
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'list?: Excel.ListDataValidation;'
+ return:
+ type: ''
+ - name: textLength
+ uid: 'excel!Excel.DataValidationRule#textLength:member'
+ package: excel!
+ fullName: textLength
+ summary: Text length data validation criteria.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'textLength?: Excel.BasicDataValidation;'
+ return:
+ type: ''
+ - name: time
+ uid: 'excel!Excel.DataValidationRule#time:member'
+ package: excel!
+ fullName: time
+ summary: Time data validation criteria.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'time?: Excel.DateTimeDataValidation;'
+ return:
+ type: ''
+ - name: wholeNumber
+ uid: 'excel!Excel.DataValidationRule#wholeNumber:member'
+ package: excel!
+ fullName: wholeNumber
+ summary: Whole number data validation criteria.
+ remarks: >-
+ \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/22-data-validation/data-validation.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Decision");
+ const rankingRange = sheet.tables.getItem("NameOptionsTable").columns.getItem("Ranking").getDataBodyRange();
+
+ // When you are developing, it is a good practice to
+ // clear the dataValidation object with each run of your code.
+ rankingRange.dataValidation.clear();
+
+ let greaterThanZeroRule = {
+ wholeNumber: {
+ formula1: 0,
+ operator: Excel.DataValidationOperator.greaterThan
+ }
+ };
+ rankingRange.dataValidation.rule = greaterThanZeroRule;
+
+ rankingRange.dataValidation.prompt = {
+ message: "Please enter a positive number.",
+ showPrompt: true,
+ title: "Positive numbers only."
+ };
+
+ rankingRange.dataValidation.errorAlert = {
+ message: "Sorry, only positive numbers are allowed",
+ showAlert: true,
+ style: "Stop",
+ title: "Negative Number Entered"
+ };
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'wholeNumber?: Excel.BasicDataValidation;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationtype.yml
new file mode 100644
index 0000000000..568c0269c1
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datavalidationtype.yml
@@ -0,0 +1,92 @@
+### YamlMime:TSEnum
+name: Excel.DataValidationType
+uid: 'excel!Excel.DataValidationType:enum'
+package: excel!
+fullName: Excel.DataValidationType
+summary: Represents the data validation type enum.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: custom
+ uid: 'excel!Excel.DataValidationType.custom:member'
+ package: excel!
+ summary: |-
+ The custom data validation type.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Custom"'
+ - name: date
+ uid: 'excel!Excel.DataValidationType.date:member'
+ package: excel!
+ summary: |-
+ The date data validation type.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Date"'
+ - name: decimal
+ uid: 'excel!Excel.DataValidationType.decimal:member'
+ package: excel!
+ summary: |-
+ The decimal data validation type.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Decimal"'
+ - name: inconsistent
+ uid: 'excel!Excel.DataValidationType.inconsistent:member'
+ package: excel!
+ summary: >-
+ Inconsistent means that the range has inconsistent data validation, indicating that there are different rules on
+ different cells.
+
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Inconsistent"'
+ - name: list
+ uid: 'excel!Excel.DataValidationType.list:member'
+ package: excel!
+ summary: |-
+ The list data validation type.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"List"'
+ - name: mixedCriteria
+ uid: 'excel!Excel.DataValidationType.mixedCriteria:member'
+ package: excel!
+ summary: |-
+ Mixed criteria means that the range has data validation present on some but not all cells.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MixedCriteria"'
+ - name: none
+ uid: 'excel!Excel.DataValidationType.none:member'
+ package: excel!
+ summary: |-
+ None means allow any value, indicating that there is no data validation in the range.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"None"'
+ - name: textLength
+ uid: 'excel!Excel.DataValidationType.textLength:member'
+ package: excel!
+ summary: |-
+ The text length data validation type.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TextLength"'
+ - name: time
+ uid: 'excel!Excel.DataValidationType.time:member'
+ package: excel!
+ summary: |-
+ The time data validation type.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Time"'
+ - name: wholeNumber
+ uid: 'excel!Excel.DataValidationType.wholeNumber:member'
+ package: excel!
+ summary: |-
+ The whole number data validation type.
+
+ * \[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WholeNumber"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datefiltercondition.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datefiltercondition.yml
new file mode 100644
index 0000000000..dd32eb6f2a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datefiltercondition.yml
@@ -0,0 +1,382 @@
+### YamlMime:TSEnum
+name: Excel.DateFilterCondition
+uid: 'excel!Excel.DateFilterCondition:enum'
+package: excel!
+fullName: Excel.DateFilterCondition
+summary: >-
+ Enum representing all accepted conditions by which a date filter can be applied. Used to configure the type of
+ PivotFilter that is applied to the field.
+remarks: >-
+ \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotfilters.yaml
+
+ await Excel.run(async (context) => {
+ // Add a date-based PivotFilter.
+
+ // Get the PivotTable.
+ const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");
+
+ // PivotFilters can only be applied to PivotHierarchies that are being used for pivoting.
+ // If it's not already there, add "Date Updated" to the hierarchies.
+ let dateHierarchy = pivotTable.rowHierarchies.getItemOrNullObject("Date Updated");
+ await context.sync();
+ if (dateHierarchy.isNullObject) {
+ dateHierarchy = pivotTable.rowHierarchies.add(pivotTable.hierarchies.getItem("Date Updated"));
+ }
+
+ // Apply a date filter to filter out anything logged before August.
+ const filterField = dateHierarchy.fields.getItem("Date Updated");
+ const dateFilter = {
+ condition: Excel.DateFilterCondition.afterOrEqualTo,
+ comparator: {
+ date: "2020-08-01",
+ specificity: Excel.FilterDatetimeSpecificity.month
+ }
+ };
+ filterField.applyFilter({ dateFilter: dateFilter });
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: after
+ uid: 'excel!Excel.DateFilterCondition.after:member'
+ package: excel!
+ summary: |-
+ Date is after comparator date.
+
+ Required Criteria: {`comparator`}. Optional Criteria: {`wholeDays`}.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"After"'
+ - name: afterOrEqualTo
+ uid: 'excel!Excel.DateFilterCondition.afterOrEqualTo:member'
+ package: excel!
+ summary: |-
+ Date is after or equal to comparator date.
+
+ Required Criteria: {`comparator`}. Optional Criteria: {`wholeDays`}.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AfterOrEqualTo"'
+ - name: allDatesInPeriodApril
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodApril:member'
+ package: excel!
+ summary: |-
+ Date is in April.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodApril"'
+ - name: allDatesInPeriodAugust
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodAugust:member'
+ package: excel!
+ summary: |-
+ Date is in August.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodAugust"'
+ - name: allDatesInPeriodDecember
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodDecember:member'
+ package: excel!
+ summary: |-
+ Date is in December.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodDecember"'
+ - name: allDatesInPeriodFebruary
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodFebruary:member'
+ package: excel!
+ summary: |-
+ Date is in February.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodFebruary"'
+ - name: allDatesInPeriodJanuary
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodJanuary:member'
+ package: excel!
+ summary: |-
+ Date is in January.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodJanuary"'
+ - name: allDatesInPeriodJuly
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodJuly:member'
+ package: excel!
+ summary: |-
+ Date is in July.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodJuly"'
+ - name: allDatesInPeriodJune
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodJune:member'
+ package: excel!
+ summary: |-
+ Date is in June.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodJune"'
+ - name: allDatesInPeriodMarch
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodMarch:member'
+ package: excel!
+ summary: |-
+ Date is in March.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodMarch"'
+ - name: allDatesInPeriodMay
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodMay:member'
+ package: excel!
+ summary: |-
+ Date is in May.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodMay"'
+ - name: allDatesInPeriodNovember
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodNovember:member'
+ package: excel!
+ summary: |-
+ Date is in November.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodNovember"'
+ - name: allDatesInPeriodOctober
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodOctober:member'
+ package: excel!
+ summary: |-
+ Date is in October.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodOctober"'
+ - name: allDatesInPeriodQuarter1
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodQuarter1:member'
+ package: excel!
+ summary: |-
+ Date is in Quarter 1.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodQuarter1"'
+ - name: allDatesInPeriodQuarter2
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodQuarter2:member'
+ package: excel!
+ summary: |-
+ Date is in Quarter 2.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodQuarter2"'
+ - name: allDatesInPeriodQuarter3
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodQuarter3:member'
+ package: excel!
+ summary: |-
+ Date is in Quarter 3.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodQuarter3"'
+ - name: allDatesInPeriodQuarter4
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodQuarter4:member'
+ package: excel!
+ summary: |-
+ Date is in Quarter 4.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodQuarter4"'
+ - name: allDatesInPeriodSeptember
+ uid: 'excel!Excel.DateFilterCondition.allDatesInPeriodSeptember:member'
+ package: excel!
+ summary: |-
+ Date is in September.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AllDatesInPeriodSeptember"'
+ - name: before
+ uid: 'excel!Excel.DateFilterCondition.before:member'
+ package: excel!
+ summary: |-
+ Date is before comparator date.
+
+ Required Criteria: {`comparator`}. Optional Criteria: {`wholeDays`}.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Before"'
+ - name: beforeOrEqualTo
+ uid: 'excel!Excel.DateFilterCondition.beforeOrEqualTo:member'
+ package: excel!
+ summary: |-
+ Date is before or equal to comparator date.
+
+ Required Criteria: {`comparator`}. Optional Criteria: {`wholeDays`}.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BeforeOrEqualTo"'
+ - name: between
+ uid: 'excel!Excel.DateFilterCondition.between:member'
+ package: excel!
+ summary: >-
+ Between `lowerBound` and `upperBound` dates.
+
+
+ Required Criteria: {`lowerBound`, `upperBound`}. Optional Criteria: {`wholeDays`,
+ `exclusive`}.
+
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Between"'
+ - name: equals
+ uid: 'excel!Excel.DateFilterCondition.equals:member'
+ package: excel!
+ summary: >-
+ Equals comparator criterion.
+
+
+ Required Criteria: {`comparator`}. Optional Criteria: {`wholeDays`, `exclusive`}.
+
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Equals"'
+ - name: lastMonth
+ uid: 'excel!Excel.DateFilterCondition.lastMonth:member'
+ package: excel!
+ summary: |-
+ Date is last month.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LastMonth"'
+ - name: lastQuarter
+ uid: 'excel!Excel.DateFilterCondition.lastQuarter:member'
+ package: excel!
+ summary: |-
+ Date is last quarter.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LastQuarter"'
+ - name: lastWeek
+ uid: 'excel!Excel.DateFilterCondition.lastWeek:member'
+ package: excel!
+ summary: |-
+ Date is last week.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LastWeek"'
+ - name: lastYear
+ uid: 'excel!Excel.DateFilterCondition.lastYear:member'
+ package: excel!
+ summary: |-
+ Date is last year.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LastYear"'
+ - name: nextMonth
+ uid: 'excel!Excel.DateFilterCondition.nextMonth:member'
+ package: excel!
+ summary: |-
+ Date is next month.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NextMonth"'
+ - name: nextQuarter
+ uid: 'excel!Excel.DateFilterCondition.nextQuarter:member'
+ package: excel!
+ summary: |-
+ Date is next quarter.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NextQuarter"'
+ - name: nextWeek
+ uid: 'excel!Excel.DateFilterCondition.nextWeek:member'
+ package: excel!
+ summary: |-
+ Date is next week.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NextWeek"'
+ - name: nextYear
+ uid: 'excel!Excel.DateFilterCondition.nextYear:member'
+ package: excel!
+ summary: |-
+ Date is next year.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NextYear"'
+ - name: thisMonth
+ uid: 'excel!Excel.DateFilterCondition.thisMonth:member'
+ package: excel!
+ summary: |-
+ Date is this month.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ThisMonth"'
+ - name: thisQuarter
+ uid: 'excel!Excel.DateFilterCondition.thisQuarter:member'
+ package: excel!
+ summary: |-
+ Date is this quarter.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ThisQuarter"'
+ - name: thisWeek
+ uid: 'excel!Excel.DateFilterCondition.thisWeek:member'
+ package: excel!
+ summary: |-
+ Date is this week.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ThisWeek"'
+ - name: thisYear
+ uid: 'excel!Excel.DateFilterCondition.thisYear:member'
+ package: excel!
+ summary: |-
+ Date is this year.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ThisYear"'
+ - name: today
+ uid: 'excel!Excel.DateFilterCondition.today:member'
+ package: excel!
+ summary: |-
+ Date is today.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Today"'
+ - name: tomorrow
+ uid: 'excel!Excel.DateFilterCondition.tomorrow:member'
+ package: excel!
+ summary: |-
+ Date is tomorrow.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Tomorrow"'
+ - name: unknown
+ uid: 'excel!Excel.DateFilterCondition.unknown:member'
+ package: excel!
+ summary: |-
+ `DateFilterCondition` is unknown or unsupported.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
+ - name: yearToDate
+ uid: 'excel!Excel.DateFilterCondition.yearToDate:member'
+ package: excel!
+ summary: |-
+ Date is in the same year to date.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"YearToDate"'
+ - name: yesterday
+ uid: 'excel!Excel.DateFilterCondition.yesterday:member'
+ package: excel!
+ summary: |-
+ Date is yesterday.
+
+ * \[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Yesterday"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datetimedatavalidation.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datetimedatavalidation.yml
new file mode 100644
index 0000000000..bbe6db854d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datetimedatavalidation.yml
@@ -0,0 +1,62 @@
+### YamlMime:TSType
+name: Excel.DateTimeDataValidation
+uid: 'excel!Excel.DateTimeDataValidation:interface'
+package: excel!
+fullName: Excel.DateTimeDataValidation
+summary: Represents the date data validation criteria.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: formula1
+ uid: 'excel!Excel.DateTimeDataValidation#formula1:member'
+ package: excel!
+ fullName: formula1
+ summary: >-
+ Specifies the right-hand operand when the operator property is set to a binary operator such as GreaterThan (the
+ left-hand operand is the value the user tries to enter in the cell). With the ternary operators Between and
+ NotBetween, specifies the lower bound operand. When setting the value, it can be passed in as a Date, a Range
+ object, or a string formula (where the string is either a stringified date/time in ISO8601 format, a cell
+ reference like "=A1", or a formula like "=MIN(A1, B1)"). When retrieving the value, it will always be returned as
+ a string formula, for example: "=10", "=A1", "=SUM(A1:B5)", etc.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula1: string | Date | Range;'
+ return:
+ type: 'string | Date | '
+ - name: formula2
+ uid: 'excel!Excel.DateTimeDataValidation#formula2:member'
+ package: excel!
+ fullName: formula2
+ summary: >-
+ With the ternary operators Between and NotBetween, specifies the upper bound operand. Is not used with the binary
+ operators, such as GreaterThan. When setting the value, it can be passed in as a Date, a Range object, or a string
+ (where the string is either a stringified date/time in ISO8601 format, a cell reference like "=A1", or a formula
+ like "=MIN(A1, B1)"). When retrieving the value, it will always be returned as a string formula, for example:
+ "=10", "=A1", "=SUM(A1:B5)", etc.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formula2?: string | Date | Range;'
+ return:
+ type: 'string | Date | '
+ - name: operator
+ uid: 'excel!Excel.DateTimeDataValidation#operator:member'
+ package: excel!
+ fullName: operator
+ summary: The operator to use for validating the data.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ operator: Excel.DataValidationOperator | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" | "GreaterThan" |
+ "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo";
+ return:
+ type: >-
+ | "Between" | "NotBetween" | "EqualTo" | "NotEqualTo" |
+ "GreaterThan" | "LessThan" | "GreaterThanOrEqualTo" | "LessThanOrEqualTo"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.datetimeformatinfo.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.datetimeformatinfo.yml
new file mode 100644
index 0000000000..67bb0fd58f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.datetimeformatinfo.yml
@@ -0,0 +1,172 @@
+### YamlMime:TSType
+name: Excel.DatetimeFormatInfo
+uid: 'excel!Excel.DatetimeFormatInfo:class'
+package: excel!
+fullName: Excel.DatetimeFormatInfo
+summary: Defines the culturally appropriate format of displaying numbers. This is based on current system culture settings.
+remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.DatetimeFormatInfo#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: dateSeparator
+ uid: 'excel!Excel.DatetimeFormatInfo#dateSeparator:member'
+ package: excel!
+ fullName: dateSeparator
+ summary: Gets the string used as the date separator. This is based on current system settings.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly dateSeparator: string;'
+ return:
+ type: string
+ - name: longDatePattern
+ uid: 'excel!Excel.DatetimeFormatInfo#longDatePattern:member'
+ package: excel!
+ fullName: longDatePattern
+ summary: Gets the format string for a long date value. This is based on current system settings.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly longDatePattern: string;'
+ return:
+ type: string
+ - name: longTimePattern
+ uid: 'excel!Excel.DatetimeFormatInfo#longTimePattern:member'
+ package: excel!
+ fullName: longTimePattern
+ summary: Gets the format string for a long time value. This is based on current system settings.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly longTimePattern: string;'
+ return:
+ type: string
+ - name: shortDatePattern
+ uid: 'excel!Excel.DatetimeFormatInfo#shortDatePattern:member'
+ package: excel!
+ fullName: shortDatePattern
+ summary: Gets the format string for a short date value. This is based on current system settings.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly shortDatePattern: string;'
+ return:
+ type: string
+ - name: timeSeparator
+ uid: 'excel!Excel.DatetimeFormatInfo#timeSeparator:member'
+ package: excel!
+ fullName: timeSeparator
+ summary: Gets the string used as the time separator. This is based on current system settings.
+ remarks: '\[ [API set: ExcelApi 1.12](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly timeSeparator: string;'
+ return:
+ type: string
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.DatetimeFormatInfo#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.DatetimeFormatInfoLoadOptions): Excel.DatetimeFormatInfo;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.DatetimeFormatInfo#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.DatetimeFormatInfo;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.DatetimeFormatInfo#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.DatetimeFormatInfo;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.DatetimeFormatInfo#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.DatetimeFormatInfo object is an API object, the `toJSON` method returns
+ a plain JavaScript object (typed as `Excel.Interfaces.DatetimeFormatInfoData`) that contains shallow
+ copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.DatetimeFormatInfoData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.deleteshiftdirection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.deleteshiftdirection.yml
new file mode 100644
index 0000000000..671b7bd4ea
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.deleteshiftdirection.yml
@@ -0,0 +1,40 @@
+### YamlMime:TSEnum
+name: Excel.DeleteShiftDirection
+uid: 'excel!Excel.DeleteShiftDirection:enum'
+package: excel!
+fullName: Excel.DeleteShiftDirection
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet.yaml
+
+ // This function deletes data from a range and sets the delete shift direction to "up".
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+ const range = sheet.getRange("A5:F5");
+ range.delete(Excel.DeleteShiftDirection.up);
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: left
+ uid: 'excel!Excel.DeleteShiftDirection.left:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Left"'
+ - name: up
+ uid: 'excel!Excel.DeleteShiftDirection.up:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.1](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Up"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.div0errorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.div0errorcellvalue.yml
new file mode 100644
index 0000000000..179f341040
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.div0errorcellvalue.yml
@@ -0,0 +1,62 @@
+### YamlMime:TSType
+name: Excel.Div0ErrorCellValue
+uid: 'excel!Excel.Div0ErrorCellValue:interface'
+package: excel!
+fullName: Excel.Div0ErrorCellValue
+summary: 'Represents the value of a cell containing a \#DIV/0! error.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.Div0ErrorCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.Div0ErrorCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#DIV/0!" | string;'
+ return:
+ type: '"#DIV/0!" | string'
+ - name: errorType
+ uid: 'excel!Excel.Div0ErrorCellValue#errorType:member'
+ package: excel!
+ fullName: errorType
+ summary: Represents the type of `ErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorType?: ErrorCellValueType.div0 | "Div0";'
+ return:
+ type: ' | "Div0"'
+ - name: type
+ uid: 'excel!Excel.Div0ErrorCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.documentproperties.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.documentproperties.yml
new file mode 100644
index 0000000000..8791cd8b85
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.documentproperties.yml
@@ -0,0 +1,322 @@
+### YamlMime:TSType
+name: Excel.DocumentProperties
+uid: 'excel!Excel.DocumentProperties:class'
+package: excel!
+fullName: Excel.DocumentProperties
+summary: Represents workbook properties.
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: author
+ uid: 'excel!Excel.DocumentProperties#author:member'
+ package: excel!
+ fullName: author
+ summary: The author of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'author: string;'
+ return:
+ type: string
+ - name: category
+ uid: 'excel!Excel.DocumentProperties#category:member'
+ package: excel!
+ fullName: category
+ summary: The category of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'category: string;'
+ return:
+ type: string
+ - name: comments
+ uid: 'excel!Excel.DocumentProperties#comments:member'
+ package: excel!
+ fullName: comments
+ summary: The comments of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'comments: string;'
+ return:
+ type: string
+ - name: company
+ uid: 'excel!Excel.DocumentProperties#company:member'
+ package: excel!
+ fullName: company
+ summary: The company of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'company: string;'
+ return:
+ type: string
+ - name: context
+ uid: 'excel!Excel.DocumentProperties#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: creationDate
+ uid: 'excel!Excel.DocumentProperties#creationDate:member'
+ package: excel!
+ fullName: creationDate
+ summary: Gets the creation date of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly creationDate: Date;'
+ return:
+ type: Date
+ - name: custom
+ uid: 'excel!Excel.DocumentProperties#custom:member'
+ package: excel!
+ fullName: custom
+ summary: Gets the collection of custom properties of the workbook.
+ remarks: >-
+ \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/26-document/custom-properties.yaml
+
+ await Excel.run(async (context) => {
+ // Load the keys and values of all custom properties.
+ const customDocProperties = context.workbook.properties.custom;
+ customDocProperties.load(["key", "value"]);
+ await context.sync();
+
+ // Log each custom property to the console.
+ // Note that your document may have more properties than those you have set using this snippet.
+ customDocProperties.items.forEach((property) => {
+ console.log(`${property.key}:${property.value}`);
+ });
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly custom: Excel.CustomPropertyCollection;'
+ return:
+ type: ''
+ - name: keywords
+ uid: 'excel!Excel.DocumentProperties#keywords:member'
+ package: excel!
+ fullName: keywords
+ summary: The keywords of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'keywords: string;'
+ return:
+ type: string
+ - name: lastAuthor
+ uid: 'excel!Excel.DocumentProperties#lastAuthor:member'
+ package: excel!
+ fullName: lastAuthor
+ summary: Gets the last author of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly lastAuthor: string;'
+ return:
+ type: string
+ - name: manager
+ uid: 'excel!Excel.DocumentProperties#manager:member'
+ package: excel!
+ fullName: manager
+ summary: The manager of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'manager: string;'
+ return:
+ type: string
+ - name: revisionNumber
+ uid: 'excel!Excel.DocumentProperties#revisionNumber:member'
+ package: excel!
+ fullName: revisionNumber
+ summary: Gets the revision number of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'revisionNumber: number;'
+ return:
+ type: number
+ - name: subject
+ uid: 'excel!Excel.DocumentProperties#subject:member'
+ package: excel!
+ fullName: subject
+ summary: The subject of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'subject: string;'
+ return:
+ type: string
+ - name: title
+ uid: 'excel!Excel.DocumentProperties#title:member'
+ package: excel!
+ fullName: title
+ summary: The title of the workbook.
+ remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'title: string;'
+ return:
+ type: string
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.DocumentProperties#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.DocumentPropertiesLoadOptions): Excel.DocumentProperties;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.DocumentProperties#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.DocumentProperties;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.DocumentProperties#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.DocumentProperties;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.DocumentProperties#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.DocumentPropertiesUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.DocumentProperties#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.DocumentProperties): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.DocumentProperties#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.DocumentProperties object is an API object, the `toJSON` method returns
+ a plain JavaScript object (typed as `Excel.Interfaces.DocumentPropertiesData`) that contains shallow
+ copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.DocumentPropertiesData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.documentpropertyitem.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.documentpropertyitem.yml
new file mode 100644
index 0000000000..30dfcef163
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.documentpropertyitem.yml
@@ -0,0 +1,90 @@
+### YamlMime:TSEnum
+name: Excel.DocumentPropertyItem
+uid: 'excel!Excel.DocumentPropertyItem:enum'
+package: excel!
+fullName: Excel.DocumentPropertyItem
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: appName
+ uid: 'excel!Excel.DocumentPropertyItem.appName:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AppName"'
+ - name: author
+ uid: 'excel!Excel.DocumentPropertyItem.author:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Author"'
+ - name: category
+ uid: 'excel!Excel.DocumentPropertyItem.category:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Category"'
+ - name: comments
+ uid: 'excel!Excel.DocumentPropertyItem.comments:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Comments"'
+ - name: company
+ uid: 'excel!Excel.DocumentPropertyItem.company:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Company"'
+ - name: creation
+ uid: 'excel!Excel.DocumentPropertyItem.creation:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Creation"'
+ - name: format
+ uid: 'excel!Excel.DocumentPropertyItem.format:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Format"'
+ - name: keywords
+ uid: 'excel!Excel.DocumentPropertyItem.keywords:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Keywords"'
+ - name: lastAuth
+ uid: 'excel!Excel.DocumentPropertyItem.lastAuth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastAuth"'
+ - name: lastPrint
+ uid: 'excel!Excel.DocumentPropertyItem.lastPrint:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastPrint"'
+ - name: lastSave
+ uid: 'excel!Excel.DocumentPropertyItem.lastSave:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastSave"'
+ - name: manager
+ uid: 'excel!Excel.DocumentPropertyItem.manager:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Manager"'
+ - name: revision
+ uid: 'excel!Excel.DocumentPropertyItem.revision:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Revision"'
+ - name: subject
+ uid: 'excel!Excel.DocumentPropertyItem.subject:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Subject"'
+ - name: template
+ uid: 'excel!Excel.DocumentPropertyItem.template:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Template"'
+ - name: title
+ uid: 'excel!Excel.DocumentPropertyItem.title:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Title"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.documentpropertytype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.documentpropertytype.yml
new file mode 100644
index 0000000000..5b03e3240a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.documentpropertytype.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSEnum
+name: Excel.DocumentPropertyType
+uid: 'excel!Excel.DocumentPropertyType:enum'
+package: excel!
+fullName: Excel.DocumentPropertyType
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: boolean
+ uid: 'excel!Excel.DocumentPropertyType.boolean:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Boolean"'
+ - name: date
+ uid: 'excel!Excel.DocumentPropertyType.date:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Date"'
+ - name: float
+ uid: 'excel!Excel.DocumentPropertyType.float:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Float"'
+ - name: number
+ uid: 'excel!Excel.DocumentPropertyType.number:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Number"'
+ - name: string
+ uid: 'excel!Excel.DocumentPropertyType.string:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"String"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.doublecellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.doublecellvalue.yml
new file mode 100644
index 0000000000..eb3905b2c0
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.doublecellvalue.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.DoubleCellValue
+uid: 'excel!Excel.DoubleCellValue:interface'
+package: excel!
+fullName: Excel.DoubleCellValue
+summary: Represents the value of a cell containing a double.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.DoubleCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.double | "Double";'
+ return:
+ type: ' | "Double"'
+ - name: basicValue
+ uid: 'excel!Excel.DoubleCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: Represents the value that would be returned by `Range.values` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue: number;'
+ return:
+ type: number
+ - name: type
+ uid: 'excel!Excel.DoubleCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.double | "Double";'
+ return:
+ type: ' | "Double"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.dynamicfiltercriteria.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.dynamicfiltercriteria.yml
new file mode 100644
index 0000000000..3a6d215f20
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.dynamicfiltercriteria.yml
@@ -0,0 +1,216 @@
+### YamlMime:TSEnum
+name: Excel.DynamicFilterCriteria
+uid: 'excel!Excel.DynamicFilterCriteria:enum'
+package: excel!
+fullName: Excel.DynamicFilterCriteria
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/46-table/filter-data.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getItem("Sample");
+
+ const expensesTable = sheet.tables.getItem("ExpensesTable");
+
+ let filter = expensesTable.columns.getItem("Amount").filter;
+ filter.apply({
+ filterOn: Excel.FilterOn.dynamic,
+ dynamicCriteria: Excel.DynamicFilterCriteria.belowAverage
+ });
+
+ filter = expensesTable.columns.getItem("Category").filter;
+ filter.apply({
+ filterOn: Excel.FilterOn.values,
+ values: ["Restaurant", "Groceries"]
+ });
+
+ await context.sync();
+ });
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: aboveAverage
+ uid: 'excel!Excel.DynamicFilterCriteria.aboveAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AboveAverage"'
+ - name: allDatesInPeriodApril
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodApril:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodApril"'
+ - name: allDatesInPeriodAugust
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodAugust:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodAugust"'
+ - name: allDatesInPeriodDecember
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodDecember:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodDecember"'
+ - name: allDatesInPeriodFebruray
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodFebruray:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodFebruray"'
+ - name: allDatesInPeriodJanuary
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodJanuary:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodJanuary"'
+ - name: allDatesInPeriodJuly
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodJuly:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodJuly"'
+ - name: allDatesInPeriodJune
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodJune:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodJune"'
+ - name: allDatesInPeriodMarch
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodMarch:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodMarch"'
+ - name: allDatesInPeriodMay
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodMay:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodMay"'
+ - name: allDatesInPeriodNovember
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodNovember:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodNovember"'
+ - name: allDatesInPeriodOctober
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodOctober:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodOctober"'
+ - name: allDatesInPeriodQuarter1
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodQuarter1:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodQuarter1"'
+ - name: allDatesInPeriodQuarter2
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodQuarter2:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodQuarter2"'
+ - name: allDatesInPeriodQuarter3
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodQuarter3:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodQuarter3"'
+ - name: allDatesInPeriodQuarter4
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodQuarter4:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodQuarter4"'
+ - name: allDatesInPeriodSeptember
+ uid: 'excel!Excel.DynamicFilterCriteria.allDatesInPeriodSeptember:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"AllDatesInPeriodSeptember"'
+ - name: belowAverage
+ uid: 'excel!Excel.DynamicFilterCriteria.belowAverage:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BelowAverage"'
+ - name: lastMonth
+ uid: 'excel!Excel.DynamicFilterCriteria.lastMonth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastMonth"'
+ - name: lastQuarter
+ uid: 'excel!Excel.DynamicFilterCriteria.lastQuarter:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastQuarter"'
+ - name: lastWeek
+ uid: 'excel!Excel.DynamicFilterCriteria.lastWeek:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastWeek"'
+ - name: lastYear
+ uid: 'excel!Excel.DynamicFilterCriteria.lastYear:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LastYear"'
+ - name: nextMonth
+ uid: 'excel!Excel.DynamicFilterCriteria.nextMonth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NextMonth"'
+ - name: nextQuarter
+ uid: 'excel!Excel.DynamicFilterCriteria.nextQuarter:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NextQuarter"'
+ - name: nextWeek
+ uid: 'excel!Excel.DynamicFilterCriteria.nextWeek:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NextWeek"'
+ - name: nextYear
+ uid: 'excel!Excel.DynamicFilterCriteria.nextYear:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"NextYear"'
+ - name: thisMonth
+ uid: 'excel!Excel.DynamicFilterCriteria.thisMonth:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThisMonth"'
+ - name: thisQuarter
+ uid: 'excel!Excel.DynamicFilterCriteria.thisQuarter:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThisQuarter"'
+ - name: thisWeek
+ uid: 'excel!Excel.DynamicFilterCriteria.thisWeek:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThisWeek"'
+ - name: thisYear
+ uid: 'excel!Excel.DynamicFilterCriteria.thisYear:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"ThisYear"'
+ - name: today
+ uid: 'excel!Excel.DynamicFilterCriteria.today:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Today"'
+ - name: tomorrow
+ uid: 'excel!Excel.DynamicFilterCriteria.tomorrow:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Tomorrow"'
+ - name: unknown
+ uid: 'excel!Excel.DynamicFilterCriteria.unknown:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Unknown"'
+ - name: yearToDate
+ uid: 'excel!Excel.DynamicFilterCriteria.yearToDate:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"YearToDate"'
+ - name: yesterday
+ uid: 'excel!Excel.DynamicFilterCriteria.yesterday:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Yesterday"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.emptycellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.emptycellvalue.yml
new file mode 100644
index 0000000000..3388473279
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.emptycellvalue.yml
@@ -0,0 +1,47 @@
+### YamlMime:TSType
+name: Excel.EmptyCellValue
+uid: 'excel!Excel.EmptyCellValue:interface'
+package: excel!
+fullName: Excel.EmptyCellValue
+summary: Represents the value of a cell that's empty and has no formulas or data.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.EmptyCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.empty | "Empty";'
+ return:
+ type: ' | "Empty"'
+ - name: basicValue
+ uid: 'excel!Excel.EmptyCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: Represents the value that would be returned by `Range.values` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "";'
+ return:
+ type: '""'
+ - name: type
+ uid: 'excel!Excel.EmptyCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.empty | "Empty";'
+ return:
+ type: ' | "Empty"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycardlayout.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycardlayout.yml
new file mode 100644
index 0000000000..2a820d0b9a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycardlayout.yml
@@ -0,0 +1,24 @@
+### YamlMime:TSType
+name: Excel.EntityCardLayout
+uid: 'excel!Excel.EntityCardLayout:interface'
+package: excel!
+fullName: Excel.EntityCardLayout
+summary: Represents a card layout that is best used for an array.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: layout
+ uid: 'excel!Excel.EntityCardLayout#layout:member'
+ package: excel!
+ fullName: layout
+ summary: Represents the type of this layout.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'layout?: "Entity";'
+ return:
+ type: '"Entity"'
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycellvalue.yml
new file mode 100644
index 0000000000..35c5a7dd45
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycellvalue.yml
@@ -0,0 +1,120 @@
+### YamlMime:TSType
+name: Excel.EntityCellValue
+uid: 'excel!Excel.EntityCellValue:interface'
+package: excel!
+fullName: Excel.EntityCellValue
+summary: Represents a set of properties without a schema or defined structure.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.EntityCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.EntityCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#VALUE!" | string;'
+ return:
+ type: '"#VALUE!" | string'
+ - name: layouts
+ uid: 'excel!Excel.EntityCellValue#layouts:member'
+ package: excel!
+ fullName: layouts
+ summary: Represents layout information for views of this entity.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'layouts?: EntityViewLayouts;'
+ return:
+ type: ''
+ - name: properties
+ uid: 'excel!Excel.EntityCellValue#properties:member'
+ package: excel!
+ fullName: properties
+ summary: Represents the properties of this entity and their metadata.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ properties?: {
+ [key: string]: EntityPropertyType;
+ };
+ return:
+ type: |-
+ {
+ [key: string]: ;
+ }
+ - name: provider
+ uid: 'excel!Excel.EntityCellValue#provider:member'
+ package: excel!
+ fullName: provider
+ summary: >-
+ Represents information that describes the service that provided the data in this `EntityCellValue`. This
+ information can be used for branding in entity cards.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'provider?: CellValueProviderAttributes;'
+ return:
+ type: ''
+ - name: referencedValues
+ uid: 'excel!Excel.EntityCellValue#referencedValues:member'
+ package: excel!
+ fullName: referencedValues
+ summary: Represents the cell values which are referenced within `EntityCellValue.properties`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'referencedValues?: ReferencedValue[];'
+ return:
+ type: '[]'
+ - name: text
+ uid: 'excel!Excel.EntityCellValue#text:member'
+ package: excel!
+ fullName: text
+ summary: Represents the text shown when a cell with this value is rendered.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'text?: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.EntityCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.entity | ReferenceValueType.entity | "Entity";'
+ return:
+ type: >-
+ | | "Entity"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycompactlayout.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycompactlayout.yml
new file mode 100644
index 0000000000..323a90dc81
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycompactlayout.yml
@@ -0,0 +1,23 @@
+### YamlMime:TSType
+name: Excel.EntityCompactLayout
+uid: 'excel!Excel.EntityCompactLayout:interface'
+package: excel!
+fullName: Excel.EntityCompactLayout
+summary: The compact layout properties for an entity.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: icon
+ uid: 'excel!Excel.EntityCompactLayout#icon:member'
+ package: excel!
+ fullName: icon
+ summary: Specifies the name of the icon which is used to open the card.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'icon?: string | EntityCompactLayoutIcons;'
+ return:
+ type: 'string | '
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycompactlayouticons.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycompactlayouticons.yml
new file mode 100644
index 0000000000..c426e368cf
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitycompactlayouticons.yml
@@ -0,0 +1,4449 @@
+### YamlMime:TSEnum
+name: Excel.EntityCompactLayoutIcons
+uid: 'excel!Excel.EntityCompactLayoutIcons:enum'
+package: excel!
+fullName: Excel.EntityCompactLayoutIcons
+summary: >-
+ The list of icons available for `EntityCompactLayout`. An icon displays in the Excel UI, either to the left of
+ the title in a cell that contains an entity card, or to the left of the title of a referenced entity inside an entity
+ card. Selecting the icon opens the entity card.
+remarks: >-
+ \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```javascript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-entity-icons.yaml
+
+ function createEntitiesWithIcons(icons): Excel.EntityCellValue[][] {
+ /* This method creates an entity data type for each
+ * icon in the `EntityCompactLayoutIcons` enum,
+ * and then displays the icon name with its icon.
+ */
+ let entities = [];
+ icons.forEach(function(iconName, index, array) {
+ let icon = iconNames[iconName];
+ entities.push([
+ {
+ type: "Entity",
+ text: iconName,
+ properties: {},
+ layouts: {
+ compact: {
+ icon
+ }
+ }
+ }
+ ]);
+ });
+ return entities;
+ }
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: accessibility
+ uid: 'excel!Excel.EntityCompactLayoutIcons.accessibility:member'
+ package: excel!
+ summary: |-
+ Accessibility icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Accessibility"'
+ - name: airplane
+ uid: 'excel!Excel.EntityCompactLayoutIcons.airplane:member'
+ package: excel!
+ summary: |-
+ Airplane icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Airplane"'
+ - name: airplaneTakeOff
+ uid: 'excel!Excel.EntityCompactLayoutIcons.airplaneTakeOff:member'
+ package: excel!
+ summary: |-
+ Airplane taking off icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AirplaneTakeOff"'
+ - name: album
+ uid: 'excel!Excel.EntityCompactLayoutIcons.album:member'
+ package: excel!
+ summary: |-
+ Album icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Album"'
+ - name: alert
+ uid: 'excel!Excel.EntityCompactLayoutIcons.alert:member'
+ package: excel!
+ summary: |-
+ Alert icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Alert"'
+ - name: alertUrgent
+ uid: 'excel!Excel.EntityCompactLayoutIcons.alertUrgent:member'
+ package: excel!
+ summary: |-
+ Alert urgent icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AlertUrgent"'
+ - name: animal
+ uid: 'excel!Excel.EntityCompactLayoutIcons.animal:member'
+ package: excel!
+ summary: |-
+ Animal icon. Displays as a pawprint.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Animal"'
+ - name: animalCat
+ uid: 'excel!Excel.EntityCompactLayoutIcons.animalCat:member'
+ package: excel!
+ summary: |-
+ Animal cat icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AnimalCat"'
+ - name: animalDog
+ uid: 'excel!Excel.EntityCompactLayoutIcons.animalDog:member'
+ package: excel!
+ summary: |-
+ Animal dog icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AnimalDog"'
+ - name: animalRabbit
+ uid: 'excel!Excel.EntityCompactLayoutIcons.animalRabbit:member'
+ package: excel!
+ summary: |-
+ Animal rabbit icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AnimalRabbit"'
+ - name: animalTurtle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.animalTurtle:member'
+ package: excel!
+ summary: |-
+ Animal turtle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AnimalTurtle"'
+ - name: appFolder
+ uid: 'excel!Excel.EntityCompactLayoutIcons.appFolder:member'
+ package: excel!
+ summary: |-
+ App folder icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AppFolder"'
+ - name: appGeneric
+ uid: 'excel!Excel.EntityCompactLayoutIcons.appGeneric:member'
+ package: excel!
+ summary: |-
+ App generic icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AppGeneric"'
+ - name: apple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.apple:member'
+ package: excel!
+ summary: |-
+ Apple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Apple"'
+ - name: approvalsApp
+ uid: 'excel!Excel.EntityCompactLayoutIcons.approvalsApp:member'
+ package: excel!
+ summary: |-
+ Approvals app icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ApprovalsApp"'
+ - name: archive
+ uid: 'excel!Excel.EntityCompactLayoutIcons.archive:member'
+ package: excel!
+ summary: |-
+ Archive icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Archive"'
+ - name: archiveMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.archiveMultiple:member'
+ package: excel!
+ summary: |-
+ Archive multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ArchiveMultiple"'
+ - name: arrowTrendingLines
+ uid: 'excel!Excel.EntityCompactLayoutIcons.arrowTrendingLines:member'
+ package: excel!
+ summary: |-
+ Arrow trending lines icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ArrowTrendingLines"'
+ - name: art
+ uid: 'excel!Excel.EntityCompactLayoutIcons.art:member'
+ package: excel!
+ summary: |-
+ Art icon. Displays as a paint palette.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Art"'
+ - name: atom
+ uid: 'excel!Excel.EntityCompactLayoutIcons.atom:member'
+ package: excel!
+ summary: |-
+ Atom icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Atom"'
+ - name: attach
+ uid: 'excel!Excel.EntityCompactLayoutIcons.attach:member'
+ package: excel!
+ summary: |-
+ Attach icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Attach"'
+ - name: automobile
+ uid: 'excel!Excel.EntityCompactLayoutIcons.automobile:member'
+ package: excel!
+ summary: |-
+ Automobile icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Automobile"'
+ - name: autosum
+ uid: 'excel!Excel.EntityCompactLayoutIcons.autosum:member'
+ package: excel!
+ summary: |-
+ Autosum icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Autosum"'
+ - name: backpack
+ uid: 'excel!Excel.EntityCompactLayoutIcons.backpack:member'
+ package: excel!
+ summary: |-
+ Backpack icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Backpack"'
+ - name: badge
+ uid: 'excel!Excel.EntityCompactLayoutIcons.badge:member'
+ package: excel!
+ summary: |-
+ Badge icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Badge"'
+ - name: balloon
+ uid: 'excel!Excel.EntityCompactLayoutIcons.balloon:member'
+ package: excel!
+ summary: |-
+ Balloon icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Balloon"'
+ - name: bank
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bank:member'
+ package: excel!
+ summary: |-
+ Bank icon. Displays as a building with pillars and a triangular roof.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bank"'
+ - name: barcodeScanner
+ uid: 'excel!Excel.EntityCompactLayoutIcons.barcodeScanner:member'
+ package: excel!
+ summary: |-
+ Barcode scanner icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BarcodeScanner"'
+ - name: basketball
+ uid: 'excel!Excel.EntityCompactLayoutIcons.basketball:member'
+ package: excel!
+ summary: |-
+ Basketball icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Basketball"'
+ - name: battery0
+ uid: 'excel!Excel.EntityCompactLayoutIcons.battery0:member'
+ package: excel!
+ summary: |-
+ Battery empty icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Battery0"'
+ - name: battery10
+ uid: 'excel!Excel.EntityCompactLayoutIcons.battery10:member'
+ package: excel!
+ summary: |-
+ Battery full icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Battery10"'
+ - name: beach
+ uid: 'excel!Excel.EntityCompactLayoutIcons.beach:member'
+ package: excel!
+ summary: |-
+ Beach icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Beach"'
+ - name: beaker
+ uid: 'excel!Excel.EntityCompactLayoutIcons.beaker:member'
+ package: excel!
+ summary: |-
+ Beaker icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Beaker"'
+ - name: bed
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bed:member'
+ package: excel!
+ summary: |-
+ Bed icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bed"'
+ - name: binFull
+ uid: 'excel!Excel.EntityCompactLayoutIcons.binFull:member'
+ package: excel!
+ summary: |-
+ Bin full icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BinFull"'
+ - name: bird
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bird:member'
+ package: excel!
+ summary: |-
+ Bird icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bird"'
+ - name: bluetooth
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bluetooth:member'
+ package: excel!
+ summary: |-
+ Bluetooth icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bluetooth"'
+ - name: board
+ uid: 'excel!Excel.EntityCompactLayoutIcons.board:member'
+ package: excel!
+ summary: |-
+ Board icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Board"'
+ - name: boardGames
+ uid: 'excel!Excel.EntityCompactLayoutIcons.boardGames:member'
+ package: excel!
+ summary: |-
+ Board games icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BoardGames"'
+ - name: book
+ uid: 'excel!Excel.EntityCompactLayoutIcons.book:member'
+ package: excel!
+ summary: |-
+ Book icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Book"'
+ - name: bookmark
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bookmark:member'
+ package: excel!
+ summary: |-
+ Bookmark icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bookmark"'
+ - name: bookmarkMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bookmarkMultiple:member'
+ package: excel!
+ summary: |-
+ Bookmark multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BookmarkMultiple"'
+ - name: bot
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bot:member'
+ package: excel!
+ summary: |-
+ Bot icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bot"'
+ - name: bowlChopsticks
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bowlChopsticks:member'
+ package: excel!
+ summary: |-
+ Bowl chopsticks icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BowlChopsticks"'
+ - name: box
+ uid: 'excel!Excel.EntityCompactLayoutIcons.box:member'
+ package: excel!
+ summary: |-
+ Box icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Box"'
+ - name: boxMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.boxMultiple:member'
+ package: excel!
+ summary: |-
+ Box multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BoxMultiple"'
+ - name: brainCircuit
+ uid: 'excel!Excel.EntityCompactLayoutIcons.brainCircuit:member'
+ package: excel!
+ summary: |-
+ Brain circuit icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BrainCircuit"'
+ - name: branch
+ uid: 'excel!Excel.EntityCompactLayoutIcons.branch:member'
+ package: excel!
+ summary: |-
+ Branch icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Branch"'
+ - name: branchFork
+ uid: 'excel!Excel.EntityCompactLayoutIcons.branchFork:member'
+ package: excel!
+ summary: |-
+ Branch fork icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BranchFork"'
+ - name: branchRequest
+ uid: 'excel!Excel.EntityCompactLayoutIcons.branchRequest:member'
+ package: excel!
+ summary: |-
+ Branch request icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BranchRequest"'
+ - name: bridge
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bridge:member'
+ package: excel!
+ summary: |-
+ Bridge icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bridge"'
+ - name: briefcase
+ uid: 'excel!Excel.EntityCompactLayoutIcons.briefcase:member'
+ package: excel!
+ summary: |-
+ Briefcase icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Briefcase"'
+ - name: briefcaseMedical
+ uid: 'excel!Excel.EntityCompactLayoutIcons.briefcaseMedical:member'
+ package: excel!
+ summary: |-
+ Briefcase medical icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BriefcaseMedical"'
+ - name: broadActivityFeed
+ uid: 'excel!Excel.EntityCompactLayoutIcons.broadActivityFeed:member'
+ package: excel!
+ summary: |-
+ Broad activity feed icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BroadActivityFeed"'
+ - name: broom
+ uid: 'excel!Excel.EntityCompactLayoutIcons.broom:member'
+ package: excel!
+ summary: |-
+ Broom icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Broom"'
+ - name: bug
+ uid: 'excel!Excel.EntityCompactLayoutIcons.bug:member'
+ package: excel!
+ summary: |-
+ Bug icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Bug"'
+ - name: building
+ uid: 'excel!Excel.EntityCompactLayoutIcons.building:member'
+ package: excel!
+ summary: |-
+ Building icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Building"'
+ - name: buildingBank
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingBank:member'
+ package: excel!
+ summary: |-
+ Building bank icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingBank"'
+ - name: buildingFactory
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingFactory:member'
+ package: excel!
+ summary: |-
+ Building factory icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingFactory"'
+ - name: buildingGovernment
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingGovernment:member'
+ package: excel!
+ summary: |-
+ Building government icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingGovernment"'
+ - name: buildingHome
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingHome:member'
+ package: excel!
+ summary: |-
+ Building home icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingHome"'
+ - name: buildingLighthouse
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingLighthouse:member'
+ package: excel!
+ summary: |-
+ Building lighthouse icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingLighthouse"'
+ - name: buildingMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingMultiple:member'
+ package: excel!
+ summary: |-
+ Building multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingMultiple"'
+ - name: buildingRetail
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingRetail:member'
+ package: excel!
+ summary: |-
+ Building retail icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingRetail"'
+ - name: buildingRetailMore
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingRetailMore:member'
+ package: excel!
+ summary: |-
+ Building retail more icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingRetailMore"'
+ - name: buildingRetailToolbox
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingRetailToolbox:member'
+ package: excel!
+ summary: |-
+ Building retail toolbox icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingRetailToolbox"'
+ - name: buildingShop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingShop:member'
+ package: excel!
+ summary: |-
+ Building shop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingShop"'
+ - name: buildingSkyscraper
+ uid: 'excel!Excel.EntityCompactLayoutIcons.buildingSkyscraper:member'
+ package: excel!
+ summary: |-
+ Building skyscraper icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"BuildingSkyscraper"'
+ - name: calculator
+ uid: 'excel!Excel.EntityCompactLayoutIcons.calculator:member'
+ package: excel!
+ summary: |-
+ Calculator icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Calculator"'
+ - name: calendarLtr
+ uid: 'excel!Excel.EntityCompactLayoutIcons.calendarLtr:member'
+ package: excel!
+ summary: |-
+ Calendar left to right icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CalendarLtr"'
+ - name: calendarRtl
+ uid: 'excel!Excel.EntityCompactLayoutIcons.calendarRtl:member'
+ package: excel!
+ summary: |-
+ Calendar right to left icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CalendarRtl"'
+ - name: call
+ uid: 'excel!Excel.EntityCompactLayoutIcons.call:member'
+ package: excel!
+ summary: |-
+ Call icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Call"'
+ - name: calligraphyPen
+ uid: 'excel!Excel.EntityCompactLayoutIcons.calligraphyPen:member'
+ package: excel!
+ summary: |-
+ Calligraphy pen icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CalligraphyPen"'
+ - name: camera
+ uid: 'excel!Excel.EntityCompactLayoutIcons.camera:member'
+ package: excel!
+ summary: |-
+ Camera icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Camera"'
+ - name: cameraDome
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cameraDome:member'
+ package: excel!
+ summary: |-
+ Camera dome icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CameraDome"'
+ - name: car
+ uid: 'excel!Excel.EntityCompactLayoutIcons.car:member'
+ package: excel!
+ summary: |-
+ Car icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Car"'
+ - name: cart
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cart:member'
+ package: excel!
+ summary: |-
+ Cart icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Cart"'
+ - name: cat
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cat:member'
+ package: excel!
+ summary: |-
+ Cat icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Cat"'
+ - name: certificate
+ uid: 'excel!Excel.EntityCompactLayoutIcons.certificate:member'
+ package: excel!
+ summary: |-
+ Certificate icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Certificate"'
+ - name: chartMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.chartMultiple:member'
+ package: excel!
+ summary: |-
+ Chart multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ChartMultiple"'
+ - name: chat
+ uid: 'excel!Excel.EntityCompactLayoutIcons.chat:member'
+ package: excel!
+ summary: |-
+ Chat icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Chat"'
+ - name: chatMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.chatMultiple:member'
+ package: excel!
+ summary: |-
+ Chat multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ChatMultiple"'
+ - name: chatVideo
+ uid: 'excel!Excel.EntityCompactLayoutIcons.chatVideo:member'
+ package: excel!
+ summary: |-
+ Chat video icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ChatVideo"'
+ - name: check
+ uid: 'excel!Excel.EntityCompactLayoutIcons.check:member'
+ package: excel!
+ summary: |-
+ Check icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Check"'
+ - name: checkboxChecked
+ uid: 'excel!Excel.EntityCompactLayoutIcons.checkboxChecked:member'
+ package: excel!
+ summary: |-
+ Checkbox checked icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CheckboxChecked"'
+ - name: checkboxUnchecked
+ uid: 'excel!Excel.EntityCompactLayoutIcons.checkboxUnchecked:member'
+ package: excel!
+ summary: |-
+ Checkbox unchecked icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CheckboxUnchecked"'
+ - name: checkmark
+ uid: 'excel!Excel.EntityCompactLayoutIcons.checkmark:member'
+ package: excel!
+ summary: |-
+ Checkmark icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Checkmark"'
+ - name: chess
+ uid: 'excel!Excel.EntityCompactLayoutIcons.chess:member'
+ package: excel!
+ summary: |-
+ Chess icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Chess"'
+ - name: city
+ uid: 'excel!Excel.EntityCompactLayoutIcons.city:member'
+ package: excel!
+ summary: |-
+ City icon. Displays as multiple tall buildings.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"City"'
+ - name: class
+ uid: 'excel!Excel.EntityCompactLayoutIcons.class:member'
+ package: excel!
+ summary: |-
+ Class icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Class"'
+ - name: classification
+ uid: 'excel!Excel.EntityCompactLayoutIcons.classification:member'
+ package: excel!
+ summary: |-
+ Classification icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Classification"'
+ - name: clipboard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.clipboard:member'
+ package: excel!
+ summary: |-
+ Clipboard icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Clipboard"'
+ - name: clipboardDataBar
+ uid: 'excel!Excel.EntityCompactLayoutIcons.clipboardDataBar:member'
+ package: excel!
+ summary: |-
+ Clipboard data bar icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ClipboardDataBar"'
+ - name: clipboardPulse
+ uid: 'excel!Excel.EntityCompactLayoutIcons.clipboardPulse:member'
+ package: excel!
+ summary: |-
+ Clipboard pulse icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ClipboardPulse"'
+ - name: clipboardTask
+ uid: 'excel!Excel.EntityCompactLayoutIcons.clipboardTask:member'
+ package: excel!
+ summary: |-
+ Clipboard task icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ClipboardTask"'
+ - name: clock
+ uid: 'excel!Excel.EntityCompactLayoutIcons.clock:member'
+ package: excel!
+ summary: |-
+ Clock icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Clock"'
+ - name: clockAlarm
+ uid: 'excel!Excel.EntityCompactLayoutIcons.clockAlarm:member'
+ package: excel!
+ summary: |-
+ Clock alarm icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ClockAlarm"'
+ - name: cloud
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cloud:member'
+ package: excel!
+ summary: |-
+ Cloud icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Cloud"'
+ - name: cloudWords
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cloudWords:member'
+ package: excel!
+ summary: |-
+ Cloud words icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CloudWords"'
+ - name: code
+ uid: 'excel!Excel.EntityCompactLayoutIcons.code:member'
+ package: excel!
+ summary: |-
+ Code icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Code"'
+ - name: collections
+ uid: 'excel!Excel.EntityCompactLayoutIcons.collections:member'
+ package: excel!
+ summary: |-
+ Collections icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Collections"'
+ - name: comment
+ uid: 'excel!Excel.EntityCompactLayoutIcons.comment:member'
+ package: excel!
+ summary: |-
+ Comment icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Comment"'
+ - name: commentMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.commentMultiple:member'
+ package: excel!
+ summary: |-
+ Comment multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CommentMultiple"'
+ - name: communication
+ uid: 'excel!Excel.EntityCompactLayoutIcons.communication:member'
+ package: excel!
+ summary: |-
+ Communication icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Communication"'
+ - name: compassNorthwest
+ uid: 'excel!Excel.EntityCompactLayoutIcons.compassNorthwest:member'
+ package: excel!
+ summary: |-
+ Compass northwest icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CompassNorthwest"'
+ - name: conferenceRoom
+ uid: 'excel!Excel.EntityCompactLayoutIcons.conferenceRoom:member'
+ package: excel!
+ summary: |-
+ Conference room icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ConferenceRoom"'
+ - name: connector
+ uid: 'excel!Excel.EntityCompactLayoutIcons.connector:member'
+ package: excel!
+ summary: |-
+ Connector icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Connector"'
+ - name: constellation
+ uid: 'excel!Excel.EntityCompactLayoutIcons.constellation:member'
+ package: excel!
+ summary: |-
+ Constellation icon. Displays dots in the shape of Ursa Major.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Constellation"'
+ - name: contactCard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.contactCard:member'
+ package: excel!
+ summary: |-
+ Contact card icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ContactCard"'
+ - name: cookies
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cookies:member'
+ package: excel!
+ summary: |-
+ Cookies icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Cookies"'
+ - name: couch
+ uid: 'excel!Excel.EntityCompactLayoutIcons.couch:member'
+ package: excel!
+ summary: |-
+ Couch icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Couch"'
+ - name: creditCardPerson
+ uid: 'excel!Excel.EntityCompactLayoutIcons.creditCardPerson:member'
+ package: excel!
+ summary: |-
+ Credit card person icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CreditCardPerson"'
+ - name: creditCardToolbox
+ uid: 'excel!Excel.EntityCompactLayoutIcons.creditCardToolbox:member'
+ package: excel!
+ summary: |-
+ Credit card toolbox icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CreditCardToolbox"'
+ - name: cube
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cube:member'
+ package: excel!
+ summary: |-
+ Cube icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Cube"'
+ - name: cubeMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cubeMultiple:member'
+ package: excel!
+ summary: |-
+ Cube multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CubeMultiple"'
+ - name: cubeTree
+ uid: 'excel!Excel.EntityCompactLayoutIcons.cubeTree:member'
+ package: excel!
+ summary: |-
+ Cube tree icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CubeTree"'
+ - name: currencyDollarEuro
+ uid: 'excel!Excel.EntityCompactLayoutIcons.currencyDollarEuro:member'
+ package: excel!
+ summary: |-
+ Currency dollar euro icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CurrencyDollarEuro"'
+ - name: currencyDollarRupee
+ uid: 'excel!Excel.EntityCompactLayoutIcons.currencyDollarRupee:member'
+ package: excel!
+ summary: |-
+ Currency dollar rupee icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CurrencyDollarRupee"'
+ - name: dataArea
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataArea:member'
+ package: excel!
+ summary: |-
+ Data area icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataArea"'
+ - name: database
+ uid: 'excel!Excel.EntityCompactLayoutIcons.database:member'
+ package: excel!
+ summary: |-
+ Database icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Database"'
+ - name: databaseMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.databaseMultiple:member'
+ package: excel!
+ summary: |-
+ Database multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DatabaseMultiple"'
+ - name: dataFunnel
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataFunnel:member'
+ package: excel!
+ summary: |-
+ Data funnel icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataFunnel"'
+ - name: dataHistogram
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataHistogram:member'
+ package: excel!
+ summary: |-
+ Data histogram icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataHistogram"'
+ - name: dataLine
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataLine:member'
+ package: excel!
+ summary: |-
+ Data line icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataLine"'
+ - name: dataPie
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataPie:member'
+ package: excel!
+ summary: |-
+ Data pie icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataPie"'
+ - name: dataScatter
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataScatter:member'
+ package: excel!
+ summary: |-
+ Data scatter icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataScatter"'
+ - name: dataSunburst
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataSunburst:member'
+ package: excel!
+ summary: |-
+ Data sunburst icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataSunburst"'
+ - name: dataTreemap
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataTreemap:member'
+ package: excel!
+ summary: |-
+ Data treemap icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataTreemap"'
+ - name: dataWaterfall
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataWaterfall:member'
+ package: excel!
+ summary: |-
+ Data waterfall icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataWaterfall"'
+ - name: dataWhisker
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dataWhisker:member'
+ package: excel!
+ summary: |-
+ Data whisker icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataWhisker"'
+ - name: dentist
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dentist:member'
+ package: excel!
+ summary: |-
+ Dentist icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Dentist"'
+ - name: designIdeas
+ uid: 'excel!Excel.EntityCompactLayoutIcons.designIdeas:member'
+ package: excel!
+ summary: |-
+ Design ideas icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DesignIdeas"'
+ - name: desktop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.desktop:member'
+ package: excel!
+ summary: |-
+ Desktop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Desktop"'
+ - name: desktopMac
+ uid: 'excel!Excel.EntityCompactLayoutIcons.desktopMac:member'
+ package: excel!
+ summary: |-
+ Desktop Mac icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DesktopMac"'
+ - name: developerBoard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.developerBoard:member'
+ package: excel!
+ summary: |-
+ Developer board icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DeveloperBoard"'
+ - name: deviceMeetingRoom
+ uid: 'excel!Excel.EntityCompactLayoutIcons.deviceMeetingRoom:member'
+ package: excel!
+ summary: |-
+ Device meeting room icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DeviceMeetingRoom"'
+ - name: diagram
+ uid: 'excel!Excel.EntityCompactLayoutIcons.diagram:member'
+ package: excel!
+ summary: |-
+ Diagram icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Diagram"'
+ - name: dialpad
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dialpad:member'
+ package: excel!
+ summary: |-
+ Dialpad icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Dialpad"'
+ - name: diamond
+ uid: 'excel!Excel.EntityCompactLayoutIcons.diamond:member'
+ package: excel!
+ summary: |-
+ Diamond icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Diamond"'
+ - name: dinosaur
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dinosaur:member'
+ package: excel!
+ summary: |-
+ Dinosaur icon. Displays as a long-necked dinosaur, similar to a Brachiosaurus.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Dinosaur"'
+ - name: directions
+ uid: 'excel!Excel.EntityCompactLayoutIcons.directions:member'
+ package: excel!
+ summary: |-
+ Directions icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Directions"'
+ - name: disaster
+ uid: 'excel!Excel.EntityCompactLayoutIcons.disaster:member'
+ package: excel!
+ summary: |-
+ Disaster icon. Displays as a house sinking in a flood.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Disaster"'
+ - name: diversity
+ uid: 'excel!Excel.EntityCompactLayoutIcons.diversity:member'
+ package: excel!
+ summary: |-
+ Diversity icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Diversity"'
+ - name: dNA
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dNA:member'
+ package: excel!
+ summary: |-
+ DNA icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DNA"'
+ - name: doctor
+ uid: 'excel!Excel.EntityCompactLayoutIcons.doctor:member'
+ package: excel!
+ summary: |-
+ Doctor icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Doctor"'
+ - name: document
+ uid: 'excel!Excel.EntityCompactLayoutIcons.document:member'
+ package: excel!
+ summary: |-
+ Document icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Document"'
+ - name: documentData
+ uid: 'excel!Excel.EntityCompactLayoutIcons.documentData:member'
+ package: excel!
+ summary: |-
+ Document data icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DocumentData"'
+ - name: documentLandscape
+ uid: 'excel!Excel.EntityCompactLayoutIcons.documentLandscape:member'
+ package: excel!
+ summary: |-
+ Document landscape icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DocumentLandscape"'
+ - name: documentMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.documentMultiple:member'
+ package: excel!
+ summary: |-
+ Document multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DocumentMultiple"'
+ - name: documentPdf
+ uid: 'excel!Excel.EntityCompactLayoutIcons.documentPdf:member'
+ package: excel!
+ summary: |-
+ Document PDF icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DocumentPdf"'
+ - name: documentQueue
+ uid: 'excel!Excel.EntityCompactLayoutIcons.documentQueue:member'
+ package: excel!
+ summary: |-
+ Document queue icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DocumentQueue"'
+ - name: documentText
+ uid: 'excel!Excel.EntityCompactLayoutIcons.documentText:member'
+ package: excel!
+ summary: |-
+ Document text icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DocumentText"'
+ - name: dog
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dog:member'
+ package: excel!
+ summary: |-
+ Dog icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Dog"'
+ - name: door
+ uid: 'excel!Excel.EntityCompactLayoutIcons.door:member'
+ package: excel!
+ summary: |-
+ Door icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Door"'
+ - name: doorTag
+ uid: 'excel!Excel.EntityCompactLayoutIcons.doorTag:member'
+ package: excel!
+ summary: |-
+ Door tag icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DoorTag"'
+ - name: drafts
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drafts:member'
+ package: excel!
+ summary: |-
+ Drafts icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Drafts"'
+ - name: drama
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drama:member'
+ package: excel!
+ summary: |-
+ Drama icon. Displays as a pair of theatre masks.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Drama"'
+ - name: drinkBeer
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drinkBeer:member'
+ package: excel!
+ summary: |-
+ Drink beer icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DrinkBeer"'
+ - name: drinkCoffee
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drinkCoffee:member'
+ package: excel!
+ summary: |-
+ Drink coffee icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DrinkCoffee"'
+ - name: drinkMargarita
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drinkMargarita:member'
+ package: excel!
+ summary: |-
+ Drink margarita icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DrinkMargarita"'
+ - name: drinkToGo
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drinkToGo:member'
+ package: excel!
+ summary: |-
+ Drink to go icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DrinkToGo"'
+ - name: drinkWine
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drinkWine:member'
+ package: excel!
+ summary: |-
+ Drink wine icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DrinkWine"'
+ - name: driveTrain
+ uid: 'excel!Excel.EntityCompactLayoutIcons.driveTrain:member'
+ package: excel!
+ summary: |-
+ Drive train icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DriveTrain"'
+ - name: drop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.drop:member'
+ package: excel!
+ summary: |-
+ Drop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Drop"'
+ - name: dualScreen
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dualScreen:member'
+ package: excel!
+ summary: |-
+ Dual screen icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DualScreen"'
+ - name: dumbbell
+ uid: 'excel!Excel.EntityCompactLayoutIcons.dumbbell:member'
+ package: excel!
+ summary: |-
+ Dumbbell icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Dumbbell"'
+ - name: earth
+ uid: 'excel!Excel.EntityCompactLayoutIcons.earth:member'
+ package: excel!
+ summary: |-
+ Earth icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Earth"'
+ - name: emoji
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emoji:member'
+ package: excel!
+ summary: |-
+ Emoji icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Emoji"'
+ - name: emojiAngry
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiAngry:member'
+ package: excel!
+ summary: |-
+ Emoji angry icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiAngry"'
+ - name: emojiHand
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiHand:member'
+ package: excel!
+ summary: |-
+ Emoji hand icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiHand"'
+ - name: emojiLaugh
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiLaugh:member'
+ package: excel!
+ summary: |-
+ Emoji laugh icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiLaugh"'
+ - name: emojiMeh
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiMeh:member'
+ package: excel!
+ summary: |-
+ Emoji meh icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiMeh"'
+ - name: emojiMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiMultiple:member'
+ package: excel!
+ summary: |-
+ Emoji multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiMultiple"'
+ - name: emojiSad
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiSad:member'
+ package: excel!
+ summary: |-
+ Emoji sad icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiSad"'
+ - name: emojiSadSlight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiSadSlight:member'
+ package: excel!
+ summary: |-
+ Emoji sad slight icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiSadSlight"'
+ - name: emojiSmileSlight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiSmileSlight:member'
+ package: excel!
+ summary: |-
+ Emoji smile slight icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiSmileSlight"'
+ - name: emojiSparkle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiSparkle:member'
+ package: excel!
+ summary: |-
+ Emoji sparkle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiSparkle"'
+ - name: emojiSurprise
+ uid: 'excel!Excel.EntityCompactLayoutIcons.emojiSurprise:member'
+ package: excel!
+ summary: |-
+ Emoji surprise icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"EmojiSurprise"'
+ - name: engine
+ uid: 'excel!Excel.EntityCompactLayoutIcons.engine:member'
+ package: excel!
+ summary: |-
+ Engine icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Engine"'
+ - name: eraser
+ uid: 'excel!Excel.EntityCompactLayoutIcons.eraser:member'
+ package: excel!
+ summary: |-
+ Eraser icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Eraser"'
+ - name: eye
+ uid: 'excel!Excel.EntityCompactLayoutIcons.eye:member'
+ package: excel!
+ summary: |-
+ Eye icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Eye"'
+ - name: eyedropper
+ uid: 'excel!Excel.EntityCompactLayoutIcons.eyedropper:member'
+ package: excel!
+ summary: |-
+ Eyedropper icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Eyedropper"'
+ - name: fax
+ uid: 'excel!Excel.EntityCompactLayoutIcons.fax:member'
+ package: excel!
+ summary: |-
+ Fax icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Fax"'
+ - name: fingerprint
+ uid: 'excel!Excel.EntityCompactLayoutIcons.fingerprint:member'
+ package: excel!
+ summary: |-
+ Fingerprint icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Fingerprint"'
+ - name: firstAid
+ uid: 'excel!Excel.EntityCompactLayoutIcons.firstAid:member'
+ package: excel!
+ summary: |-
+ First aid icon. Displays as a briefcase with a medical cross symbol.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FirstAid"'
+ - name: flag
+ uid: 'excel!Excel.EntityCompactLayoutIcons.flag:member'
+ package: excel!
+ summary: |-
+ Flag icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Flag"'
+ - name: flash
+ uid: 'excel!Excel.EntityCompactLayoutIcons.flash:member'
+ package: excel!
+ summary: |-
+ Flash icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Flash"'
+ - name: flashlight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.flashlight:member'
+ package: excel!
+ summary: |-
+ Flashlight icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Flashlight"'
+ - name: flow
+ uid: 'excel!Excel.EntityCompactLayoutIcons.flow:member'
+ package: excel!
+ summary: |-
+ Flow icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Flow"'
+ - name: flowchart
+ uid: 'excel!Excel.EntityCompactLayoutIcons.flowchart:member'
+ package: excel!
+ summary: |-
+ Flowchart icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Flowchart"'
+ - name: folder
+ uid: 'excel!Excel.EntityCompactLayoutIcons.folder:member'
+ package: excel!
+ summary: |-
+ Folder icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Folder"'
+ - name: folderOpen
+ uid: 'excel!Excel.EntityCompactLayoutIcons.folderOpen:member'
+ package: excel!
+ summary: |-
+ Folder open icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FolderOpen"'
+ - name: folderOpenVertical
+ uid: 'excel!Excel.EntityCompactLayoutIcons.folderOpenVertical:member'
+ package: excel!
+ summary: |-
+ Folder open vertical icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FolderOpenVertical"'
+ - name: folderPerson
+ uid: 'excel!Excel.EntityCompactLayoutIcons.folderPerson:member'
+ package: excel!
+ summary: |-
+ Folder person icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FolderPerson"'
+ - name: folderZip
+ uid: 'excel!Excel.EntityCompactLayoutIcons.folderZip:member'
+ package: excel!
+ summary: |-
+ Folder zip icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FolderZip"'
+ - name: food
+ uid: 'excel!Excel.EntityCompactLayoutIcons.food:member'
+ package: excel!
+ summary: |-
+ Food icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Food"'
+ - name: foodApple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.foodApple:member'
+ package: excel!
+ summary: |-
+ Food apple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FoodApple"'
+ - name: foodCake
+ uid: 'excel!Excel.EntityCompactLayoutIcons.foodCake:member'
+ package: excel!
+ summary: |-
+ Food cake icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FoodCake"'
+ - name: foodEgg
+ uid: 'excel!Excel.EntityCompactLayoutIcons.foodEgg:member'
+ package: excel!
+ summary: |-
+ Food egg icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FoodEgg"'
+ - name: foodGrains
+ uid: 'excel!Excel.EntityCompactLayoutIcons.foodGrains:member'
+ package: excel!
+ summary: |-
+ Food grains icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FoodGrains"'
+ - name: foodPizza
+ uid: 'excel!Excel.EntityCompactLayoutIcons.foodPizza:member'
+ package: excel!
+ summary: |-
+ Food pizza icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FoodPizza"'
+ - name: foodToast
+ uid: 'excel!Excel.EntityCompactLayoutIcons.foodToast:member'
+ package: excel!
+ summary: |-
+ Food toast icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"FoodToast"'
+ - name: galaxy
+ uid: 'excel!Excel.EntityCompactLayoutIcons.galaxy:member'
+ package: excel!
+ summary: |-
+ Galaxy icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Galaxy"'
+ - name: games
+ uid: 'excel!Excel.EntityCompactLayoutIcons.games:member'
+ package: excel!
+ summary: |-
+ Games icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Games"'
+ - name: ganttChart
+ uid: 'excel!Excel.EntityCompactLayoutIcons.ganttChart:member'
+ package: excel!
+ summary: |-
+ Gantt chart icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GanttChart"'
+ - name: gas
+ uid: 'excel!Excel.EntityCompactLayoutIcons.gas:member'
+ package: excel!
+ summary: |-
+ Gas icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Gas"'
+ - name: gasPump
+ uid: 'excel!Excel.EntityCompactLayoutIcons.gasPump:member'
+ package: excel!
+ summary: |-
+ Gas pump icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GasPump"'
+ - name: gauge
+ uid: 'excel!Excel.EntityCompactLayoutIcons.gauge:member'
+ package: excel!
+ summary: |-
+ Gauge icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Gauge"'
+ - name: gavel
+ uid: 'excel!Excel.EntityCompactLayoutIcons.gavel:member'
+ package: excel!
+ summary: |-
+ Gavel icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Gavel"'
+ - name: generic
+ uid: 'excel!Excel.EntityCompactLayoutIcons.generic:member'
+ package: excel!
+ summary: |-
+ The default icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Generic"'
+ - name: gift
+ uid: 'excel!Excel.EntityCompactLayoutIcons.gift:member'
+ package: excel!
+ summary: |-
+ Gift icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Gift"'
+ - name: giftCard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.giftCard:member'
+ package: excel!
+ summary: |-
+ Gift card icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GiftCard"'
+ - name: glasses
+ uid: 'excel!Excel.EntityCompactLayoutIcons.glasses:member'
+ package: excel!
+ summary: |-
+ Glasses icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Glasses"'
+ - name: globe
+ uid: 'excel!Excel.EntityCompactLayoutIcons.globe:member'
+ package: excel!
+ summary: |-
+ Globe icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Globe"'
+ - name: globeSurface
+ uid: 'excel!Excel.EntityCompactLayoutIcons.globeSurface:member'
+ package: excel!
+ summary: |-
+ Globe surface icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GlobeSurface"'
+ - name: grid
+ uid: 'excel!Excel.EntityCompactLayoutIcons.grid:member'
+ package: excel!
+ summary: |-
+ Grid icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Grid"'
+ - name: gridDots
+ uid: 'excel!Excel.EntityCompactLayoutIcons.gridDots:member'
+ package: excel!
+ summary: |-
+ Grid dots icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GridDots"'
+ - name: gridKanban
+ uid: 'excel!Excel.EntityCompactLayoutIcons.gridKanban:member'
+ package: excel!
+ summary: |-
+ Grid Kanban icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GridKanban"'
+ - name: guardian
+ uid: 'excel!Excel.EntityCompactLayoutIcons.guardian:member'
+ package: excel!
+ summary: |-
+ Guardian icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Guardian"'
+ - name: guest
+ uid: 'excel!Excel.EntityCompactLayoutIcons.guest:member'
+ package: excel!
+ summary: |-
+ Guest icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Guest"'
+ - name: guitar
+ uid: 'excel!Excel.EntityCompactLayoutIcons.guitar:member'
+ package: excel!
+ summary: |-
+ Guitar icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Guitar"'
+ - name: handLeft
+ uid: 'excel!Excel.EntityCompactLayoutIcons.handLeft:member'
+ package: excel!
+ summary: |-
+ Hand left icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HandLeft"'
+ - name: handRight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.handRight:member'
+ package: excel!
+ summary: |-
+ Hand right icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HandRight"'
+ - name: handshake
+ uid: 'excel!Excel.EntityCompactLayoutIcons.handshake:member'
+ package: excel!
+ summary: |-
+ Handshake icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Handshake"'
+ - name: hardDrive
+ uid: 'excel!Excel.EntityCompactLayoutIcons.hardDrive:member'
+ package: excel!
+ summary: |-
+ Hard drive icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HardDrive"'
+ - name: hatGraduation
+ uid: 'excel!Excel.EntityCompactLayoutIcons.hatGraduation:member'
+ package: excel!
+ summary: |-
+ Graduation hat icon. Displays as a hat with a tassel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HatGraduation"'
+ - name: headphones
+ uid: 'excel!Excel.EntityCompactLayoutIcons.headphones:member'
+ package: excel!
+ summary: |-
+ Headphones icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Headphones"'
+ - name: headphonesSoundWave
+ uid: 'excel!Excel.EntityCompactLayoutIcons.headphonesSoundWave:member'
+ package: excel!
+ summary: |-
+ Headphones sound wave icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HeadphonesSoundWave"'
+ - name: headset
+ uid: 'excel!Excel.EntityCompactLayoutIcons.headset:member'
+ package: excel!
+ summary: |-
+ Headset icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Headset"'
+ - name: headsetVr
+ uid: 'excel!Excel.EntityCompactLayoutIcons.headsetVr:member'
+ package: excel!
+ summary: |-
+ Headset VR icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HeadsetVr"'
+ - name: heart
+ uid: 'excel!Excel.EntityCompactLayoutIcons.heart:member'
+ package: excel!
+ summary: |-
+ Heart icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Heart"'
+ - name: heartBroken
+ uid: 'excel!Excel.EntityCompactLayoutIcons.heartBroken:member'
+ package: excel!
+ summary: |-
+ Heart broken icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HeartBroken"'
+ - name: heartCircle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.heartCircle:member'
+ package: excel!
+ summary: |-
+ Heart circle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HeartCircle"'
+ - name: heartHuman
+ uid: 'excel!Excel.EntityCompactLayoutIcons.heartHuman:member'
+ package: excel!
+ summary: |-
+ Human heart icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HeartHuman"'
+ - name: heartPulse
+ uid: 'excel!Excel.EntityCompactLayoutIcons.heartPulse:member'
+ package: excel!
+ summary: |-
+ Heart pulse icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HeartPulse"'
+ - name: history
+ uid: 'excel!Excel.EntityCompactLayoutIcons.history:member'
+ package: excel!
+ summary: |-
+ History icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"History"'
+ - name: home
+ uid: 'excel!Excel.EntityCompactLayoutIcons.home:member'
+ package: excel!
+ summary: |-
+ Home icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Home"'
+ - name: homeMore
+ uid: 'excel!Excel.EntityCompactLayoutIcons.homeMore:member'
+ package: excel!
+ summary: |-
+ Home more icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HomeMore"'
+ - name: homePerson
+ uid: 'excel!Excel.EntityCompactLayoutIcons.homePerson:member'
+ package: excel!
+ summary: |-
+ Home person icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"HomePerson"'
+ - name: icons
+ uid: 'excel!Excel.EntityCompactLayoutIcons.icons:member'
+ package: excel!
+ summary: |-
+ Icons icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Icons"'
+ - name: image
+ uid: 'excel!Excel.EntityCompactLayoutIcons.image:member'
+ package: excel!
+ summary: |-
+ Image icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Image"'
+ - name: imageGlobe
+ uid: 'excel!Excel.EntityCompactLayoutIcons.imageGlobe:member'
+ package: excel!
+ summary: |-
+ Image globe icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ImageGlobe"'
+ - name: imageMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.imageMultiple:member'
+ package: excel!
+ summary: |-
+ Image multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ImageMultiple"'
+ - name: iot
+ uid: 'excel!Excel.EntityCompactLayoutIcons.iot:member'
+ package: excel!
+ summary: |-
+ IoT icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Iot"'
+ - name: joystick
+ uid: 'excel!Excel.EntityCompactLayoutIcons.joystick:member'
+ package: excel!
+ summary: |-
+ Joystick icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Joystick"'
+ - name: justice
+ uid: 'excel!Excel.EntityCompactLayoutIcons.justice:member'
+ package: excel!
+ summary: |-
+ Justice icon. Displays as the scales of justice.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Justice"'
+ - name: key
+ uid: 'excel!Excel.EntityCompactLayoutIcons.key:member'
+ package: excel!
+ summary: |-
+ Key icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Key"'
+ - name: keyboard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.keyboard:member'
+ package: excel!
+ summary: |-
+ Keyboard icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Keyboard"'
+ - name: keyboardLayoutSplit
+ uid: 'excel!Excel.EntityCompactLayoutIcons.keyboardLayoutSplit:member'
+ package: excel!
+ summary: |-
+ Keyboard layout split icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"KeyboardLayoutSplit"'
+ - name: keyMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.keyMultiple:member'
+ package: excel!
+ summary: |-
+ Key multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"KeyMultiple"'
+ - name: languages
+ uid: 'excel!Excel.EntityCompactLayoutIcons.languages:member'
+ package: excel!
+ summary: |-
+ Languages icon. Displays as a document and a globe.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Languages"'
+ - name: laptop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.laptop:member'
+ package: excel!
+ summary: |-
+ Laptop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Laptop"'
+ - name: lasso
+ uid: 'excel!Excel.EntityCompactLayoutIcons.lasso:member'
+ package: excel!
+ summary: |-
+ Lasso icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Lasso"'
+ - name: launcherSettings
+ uid: 'excel!Excel.EntityCompactLayoutIcons.launcherSettings:member'
+ package: excel!
+ summary: |-
+ Launcher settings icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LauncherSettings"'
+ - name: layer
+ uid: 'excel!Excel.EntityCompactLayoutIcons.layer:member'
+ package: excel!
+ summary: |-
+ Layer icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Layer"'
+ - name: leaf
+ uid: 'excel!Excel.EntityCompactLayoutIcons.leaf:member'
+ package: excel!
+ summary: |-
+ Leaf icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Leaf"'
+ - name: leafOne
+ uid: 'excel!Excel.EntityCompactLayoutIcons.leafOne:member'
+ package: excel!
+ summary: |-
+ Leaf one icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LeafOne"'
+ - name: leafThree
+ uid: 'excel!Excel.EntityCompactLayoutIcons.leafThree:member'
+ package: excel!
+ summary: |-
+ Leaf three icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LeafThree"'
+ - name: leafTwo
+ uid: 'excel!Excel.EntityCompactLayoutIcons.leafTwo:member'
+ package: excel!
+ summary: |-
+ Leaf two icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LeafTwo"'
+ - name: library
+ uid: 'excel!Excel.EntityCompactLayoutIcons.library:member'
+ package: excel!
+ summary: |-
+ Library icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Library"'
+ - name: lightbulb
+ uid: 'excel!Excel.EntityCompactLayoutIcons.lightbulb:member'
+ package: excel!
+ summary: |-
+ Lightbulb icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Lightbulb"'
+ - name: lightbulbFilament
+ uid: 'excel!Excel.EntityCompactLayoutIcons.lightbulbFilament:member'
+ package: excel!
+ summary: |-
+ Lightbulb filament icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LightbulbFilament"'
+ - name: likert
+ uid: 'excel!Excel.EntityCompactLayoutIcons.likert:member'
+ package: excel!
+ summary: |-
+ Likert icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Likert"'
+ - name: link
+ uid: 'excel!Excel.EntityCompactLayoutIcons.link:member'
+ package: excel!
+ summary: |-
+ Link icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Link"'
+ - name: localLanguage
+ uid: 'excel!Excel.EntityCompactLayoutIcons.localLanguage:member'
+ package: excel!
+ summary: |-
+ Local language icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LocalLanguage"'
+ - name: location
+ uid: 'excel!Excel.EntityCompactLayoutIcons.location:member'
+ package: excel!
+ summary: |-
+ Location icon. Displays as a map marker.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Location"'
+ - name: lockClosed
+ uid: 'excel!Excel.EntityCompactLayoutIcons.lockClosed:member'
+ package: excel!
+ summary: |-
+ Lock closed icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LockClosed"'
+ - name: lockMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.lockMultiple:member'
+ package: excel!
+ summary: |-
+ Lock multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LockMultiple"'
+ - name: lockOpen
+ uid: 'excel!Excel.EntityCompactLayoutIcons.lockOpen:member'
+ package: excel!
+ summary: |-
+ Lock open icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LockOpen"'
+ - name: lottery
+ uid: 'excel!Excel.EntityCompactLayoutIcons.lottery:member'
+ package: excel!
+ summary: |-
+ Lottery icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Lottery"'
+ - name: luggage
+ uid: 'excel!Excel.EntityCompactLayoutIcons.luggage:member'
+ package: excel!
+ summary: |-
+ Luggage icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Luggage"'
+ - name: mail
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mail:member'
+ package: excel!
+ summary: |-
+ Mail icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Mail"'
+ - name: mailInbox
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mailInbox:member'
+ package: excel!
+ summary: |-
+ Mail inbox icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MailInbox"'
+ - name: mailMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mailMultiple:member'
+ package: excel!
+ summary: |-
+ Mail multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MailMultiple"'
+ - name: map
+ uid: 'excel!Excel.EntityCompactLayoutIcons.map:member'
+ package: excel!
+ summary: |-
+ Map icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Map"'
+ - name: mapPin
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mapPin:member'
+ package: excel!
+ summary: |-
+ Map pin icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MapPin"'
+ - name: markdown
+ uid: 'excel!Excel.EntityCompactLayoutIcons.markdown:member'
+ package: excel!
+ summary: |-
+ Markdown icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Markdown"'
+ - name: mathFormula
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mathFormula:member'
+ package: excel!
+ summary: |-
+ Math formula icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MathFormula"'
+ - name: mathSymbols
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mathSymbols:member'
+ package: excel!
+ summary: |-
+ Math symbols icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MathSymbols"'
+ - name: max
+ uid: 'excel!Excel.EntityCompactLayoutIcons.max:member'
+ package: excel!
+ summary: |-
+ Max icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Max"'
+ - name: megaphone
+ uid: 'excel!Excel.EntityCompactLayoutIcons.megaphone:member'
+ package: excel!
+ summary: |-
+ Megaphone icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Megaphone"'
+ - name: megaphoneLoud
+ uid: 'excel!Excel.EntityCompactLayoutIcons.megaphoneLoud:member'
+ package: excel!
+ summary: |-
+ Megaphone loud icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MegaphoneLoud"'
+ - name: mention
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mention:member'
+ package: excel!
+ summary: |-
+ Mention icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Mention"'
+ - name: mic
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mic:member'
+ package: excel!
+ summary: |-
+ Mic icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Mic"'
+ - name: microscope
+ uid: 'excel!Excel.EntityCompactLayoutIcons.microscope:member'
+ package: excel!
+ summary: |-
+ Microscope icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Microscope"'
+ - name: midi
+ uid: 'excel!Excel.EntityCompactLayoutIcons.midi:member'
+ package: excel!
+ summary: |-
+ Midi icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Midi"'
+ - name: molecule
+ uid: 'excel!Excel.EntityCompactLayoutIcons.molecule:member'
+ package: excel!
+ summary: |-
+ Molecule icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Molecule"'
+ - name: money
+ uid: 'excel!Excel.EntityCompactLayoutIcons.money:member'
+ package: excel!
+ summary: |-
+ Money icon. Displays as paper money and coins.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Money"'
+ - name: moneyHand
+ uid: 'excel!Excel.EntityCompactLayoutIcons.moneyHand:member'
+ package: excel!
+ summary: |-
+ Money hand icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MoneyHand"'
+ - name: mountain
+ uid: 'excel!Excel.EntityCompactLayoutIcons.mountain:member'
+ package: excel!
+ summary: |-
+ Mountain icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Mountain"'
+ - name: movieCamera
+ uid: 'excel!Excel.EntityCompactLayoutIcons.movieCamera:member'
+ package: excel!
+ summary: |-
+ Movie camera icon. Displays as a video camera.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MovieCamera"'
+ - name: moviesAndTv
+ uid: 'excel!Excel.EntityCompactLayoutIcons.moviesAndTv:member'
+ package: excel!
+ summary: |-
+ Movies and TV icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MoviesAndTv"'
+ - name: musicNote
+ uid: 'excel!Excel.EntityCompactLayoutIcons.musicNote:member'
+ package: excel!
+ summary: |-
+ Music note icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MusicNote"'
+ - name: musicNote1
+ uid: 'excel!Excel.EntityCompactLayoutIcons.musicNote1:member'
+ package: excel!
+ summary: |-
+ Music note icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MusicNote1"'
+ - name: musicNote2
+ uid: 'excel!Excel.EntityCompactLayoutIcons.musicNote2:member'
+ package: excel!
+ summary: |-
+ Music double note icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MusicNote2"'
+ - name: myLocation
+ uid: 'excel!Excel.EntityCompactLayoutIcons.myLocation:member'
+ package: excel!
+ summary: |-
+ My location icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"MyLocation"'
+ - name: nByN
+ uid: 'excel!Excel.EntityCompactLayoutIcons.nByN:member'
+ package: excel!
+ summary: |-
+ N by N icon. Displays as a three by three grid.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NByN"'
+ - name: nByOne
+ uid: 'excel!Excel.EntityCompactLayoutIcons.nByOne:member'
+ package: excel!
+ summary: |-
+ N by one icon. Displays as a three by one grid.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NByOne"'
+ - name: news
+ uid: 'excel!Excel.EntityCompactLayoutIcons.news:member'
+ package: excel!
+ summary: |-
+ News icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"News"'
+ - name: notablePeople
+ uid: 'excel!Excel.EntityCompactLayoutIcons.notablePeople:member'
+ package: excel!
+ summary: |-
+ Notable people icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NotablePeople"'
+ - name: note
+ uid: 'excel!Excel.EntityCompactLayoutIcons.note:member'
+ package: excel!
+ summary: |-
+ Note icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Note"'
+ - name: notebook
+ uid: 'excel!Excel.EntityCompactLayoutIcons.notebook:member'
+ package: excel!
+ summary: |-
+ Notebook icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Notebook"'
+ - name: notepad
+ uid: 'excel!Excel.EntityCompactLayoutIcons.notepad:member'
+ package: excel!
+ summary: |-
+ Notepad icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Notepad"'
+ - name: notepadPerson
+ uid: 'excel!Excel.EntityCompactLayoutIcons.notepadPerson:member'
+ package: excel!
+ summary: |-
+ Notepad person icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NotepadPerson"'
+ - name: oneByN
+ uid: 'excel!Excel.EntityCompactLayoutIcons.oneByN:member'
+ package: excel!
+ summary: |-
+ One by N icon. Displays as a one by three grid.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"OneByN"'
+ - name: oneByOne
+ uid: 'excel!Excel.EntityCompactLayoutIcons.oneByOne:member'
+ package: excel!
+ summary: |-
+ One by one icon. Displays as a one by one grid.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"OneByOne"'
+ - name: options
+ uid: 'excel!Excel.EntityCompactLayoutIcons.options:member'
+ package: excel!
+ summary: |-
+ Options icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Options"'
+ - name: organization
+ uid: 'excel!Excel.EntityCompactLayoutIcons.organization:member'
+ package: excel!
+ summary: |-
+ Organization icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Organization"'
+ - name: organizationHorizontal
+ uid: 'excel!Excel.EntityCompactLayoutIcons.organizationHorizontal:member'
+ package: excel!
+ summary: |-
+ Organization horizontal icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"OrganizationHorizontal"'
+ - name: oval
+ uid: 'excel!Excel.EntityCompactLayoutIcons.oval:member'
+ package: excel!
+ summary: |-
+ Oval icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Oval"'
+ - name: paintBrush
+ uid: 'excel!Excel.EntityCompactLayoutIcons.paintBrush:member'
+ package: excel!
+ summary: |-
+ Paint brush icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PaintBrush"'
+ - name: paintBucket
+ uid: 'excel!Excel.EntityCompactLayoutIcons.paintBucket:member'
+ package: excel!
+ summary: |-
+ Paint bucket icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PaintBucket"'
+ - name: partlySunnyWeather
+ uid: 'excel!Excel.EntityCompactLayoutIcons.partlySunnyWeather:member'
+ package: excel!
+ summary: |-
+ Partly sunny weather icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PartlySunnyWeather"'
+ - name: password
+ uid: 'excel!Excel.EntityCompactLayoutIcons.password:member'
+ package: excel!
+ summary: |-
+ Password icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Password"'
+ - name: patch
+ uid: 'excel!Excel.EntityCompactLayoutIcons.patch:member'
+ package: excel!
+ summary: |-
+ Patch icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Patch"'
+ - name: patient
+ uid: 'excel!Excel.EntityCompactLayoutIcons.patient:member'
+ package: excel!
+ summary: |-
+ Patient icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Patient"'
+ - name: payment
+ uid: 'excel!Excel.EntityCompactLayoutIcons.payment:member'
+ package: excel!
+ summary: |-
+ Payment icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Payment"'
+ - name: pen
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pen:member'
+ package: excel!
+ summary: |-
+ Pen icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pen"'
+ - name: pentagon
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pentagon:member'
+ package: excel!
+ summary: |-
+ Pentagon icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pentagon"'
+ - name: people
+ uid: 'excel!Excel.EntityCompactLayoutIcons.people:member'
+ package: excel!
+ summary: |-
+ People icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"People"'
+ - name: peopleAudience
+ uid: 'excel!Excel.EntityCompactLayoutIcons.peopleAudience:member'
+ package: excel!
+ summary: |-
+ People audience icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PeopleAudience"'
+ - name: peopleCall
+ uid: 'excel!Excel.EntityCompactLayoutIcons.peopleCall:member'
+ package: excel!
+ summary: |-
+ People call icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PeopleCall"'
+ - name: peopleCommunity
+ uid: 'excel!Excel.EntityCompactLayoutIcons.peopleCommunity:member'
+ package: excel!
+ summary: |-
+ People community icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PeopleCommunity"'
+ - name: peopleMoney
+ uid: 'excel!Excel.EntityCompactLayoutIcons.peopleMoney:member'
+ package: excel!
+ summary: |-
+ People money icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PeopleMoney"'
+ - name: peopleQueue
+ uid: 'excel!Excel.EntityCompactLayoutIcons.peopleQueue:member'
+ package: excel!
+ summary: |-
+ People queue icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PeopleQueue"'
+ - name: peopleTeam
+ uid: 'excel!Excel.EntityCompactLayoutIcons.peopleTeam:member'
+ package: excel!
+ summary: |-
+ People team icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PeopleTeam"'
+ - name: peopleToolbox
+ uid: 'excel!Excel.EntityCompactLayoutIcons.peopleToolbox:member'
+ package: excel!
+ summary: |-
+ People toolbox icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PeopleToolbox"'
+ - name: person
+ uid: 'excel!Excel.EntityCompactLayoutIcons.person:member'
+ package: excel!
+ summary: |-
+ Person icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Person"'
+ - name: personBoard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.personBoard:member'
+ package: excel!
+ summary: |-
+ Person board icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PersonBoard"'
+ - name: personCall
+ uid: 'excel!Excel.EntityCompactLayoutIcons.personCall:member'
+ package: excel!
+ summary: |-
+ Person call icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PersonCall"'
+ - name: personChat
+ uid: 'excel!Excel.EntityCompactLayoutIcons.personChat:member'
+ package: excel!
+ summary: |-
+ Person chat icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PersonChat"'
+ - name: personFeedback
+ uid: 'excel!Excel.EntityCompactLayoutIcons.personFeedback:member'
+ package: excel!
+ summary: |-
+ Person feedback icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PersonFeedback"'
+ - name: personSupport
+ uid: 'excel!Excel.EntityCompactLayoutIcons.personSupport:member'
+ package: excel!
+ summary: |-
+ Person support icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PersonSupport"'
+ - name: personVoice
+ uid: 'excel!Excel.EntityCompactLayoutIcons.personVoice:member'
+ package: excel!
+ summary: |-
+ Person voice icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PersonVoice"'
+ - name: phone
+ uid: 'excel!Excel.EntityCompactLayoutIcons.phone:member'
+ package: excel!
+ summary: |-
+ Phone icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Phone"'
+ - name: phoneDesktop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.phoneDesktop:member'
+ package: excel!
+ summary: |-
+ Phone desktop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PhoneDesktop"'
+ - name: phoneLaptop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.phoneLaptop:member'
+ package: excel!
+ summary: |-
+ Phone laptop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PhoneLaptop"'
+ - name: phoneShake
+ uid: 'excel!Excel.EntityCompactLayoutIcons.phoneShake:member'
+ package: excel!
+ summary: |-
+ Phone shake icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PhoneShake"'
+ - name: phoneTablet
+ uid: 'excel!Excel.EntityCompactLayoutIcons.phoneTablet:member'
+ package: excel!
+ summary: |-
+ Phone tablet icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PhoneTablet"'
+ - name: phoneVibrate
+ uid: 'excel!Excel.EntityCompactLayoutIcons.phoneVibrate:member'
+ package: excel!
+ summary: |-
+ Phone vibrate icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PhoneVibrate"'
+ - name: photoFilter
+ uid: 'excel!Excel.EntityCompactLayoutIcons.photoFilter:member'
+ package: excel!
+ summary: |-
+ Photo filter icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PhotoFilter"'
+ - name: pi
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pi:member'
+ package: excel!
+ summary: |-
+ Pi icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pi"'
+ - name: pictureInPicture
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pictureInPicture:member'
+ package: excel!
+ summary: |-
+ Picture in picture icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PictureInPicture"'
+ - name: pilates
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pilates:member'
+ package: excel!
+ summary: |-
+ Pilates icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pilates"'
+ - name: pill
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pill:member'
+ package: excel!
+ summary: |-
+ Pill icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pill"'
+ - name: pin
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pin:member'
+ package: excel!
+ summary: |-
+ Pin icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pin"'
+ - name: pipeline
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pipeline:member'
+ package: excel!
+ summary: |-
+ Pipeline icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pipeline"'
+ - name: planet
+ uid: 'excel!Excel.EntityCompactLayoutIcons.planet:member'
+ package: excel!
+ summary: |-
+ Planet icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Planet"'
+ - name: playingCards
+ uid: 'excel!Excel.EntityCompactLayoutIcons.playingCards:member'
+ package: excel!
+ summary: |-
+ Playing cards icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PlayingCards"'
+ - name: plugConnected
+ uid: 'excel!Excel.EntityCompactLayoutIcons.plugConnected:member'
+ package: excel!
+ summary: |-
+ Plug connected icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PlugConnected"'
+ - name: plugDisconnected
+ uid: 'excel!Excel.EntityCompactLayoutIcons.plugDisconnected:member'
+ package: excel!
+ summary: |-
+ Plug disconnected icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PlugDisconnected"'
+ - name: pointScan
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pointScan:member'
+ package: excel!
+ summary: |-
+ Point scan icon. Displays as a target focus symbol.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PointScan"'
+ - name: poll
+ uid: 'excel!Excel.EntityCompactLayoutIcons.poll:member'
+ package: excel!
+ summary: |-
+ Poll icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Poll"'
+ - name: power
+ uid: 'excel!Excel.EntityCompactLayoutIcons.power:member'
+ package: excel!
+ summary: |-
+ Power icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Power"'
+ - name: predictions
+ uid: 'excel!Excel.EntityCompactLayoutIcons.predictions:member'
+ package: excel!
+ summary: |-
+ Predictions icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Predictions"'
+ - name: premium
+ uid: 'excel!Excel.EntityCompactLayoutIcons.premium:member'
+ package: excel!
+ summary: |-
+ Premium icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Premium"'
+ - name: presenter
+ uid: 'excel!Excel.EntityCompactLayoutIcons.presenter:member'
+ package: excel!
+ summary: |-
+ Presenter icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Presenter"'
+ - name: previewLink
+ uid: 'excel!Excel.EntityCompactLayoutIcons.previewLink:member'
+ package: excel!
+ summary: |-
+ Preview link icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PreviewLink"'
+ - name: print
+ uid: 'excel!Excel.EntityCompactLayoutIcons.print:member'
+ package: excel!
+ summary: |-
+ Print icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Print"'
+ - name: production
+ uid: 'excel!Excel.EntityCompactLayoutIcons.production:member'
+ package: excel!
+ summary: |-
+ Production icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Production"'
+ - name: prohibited
+ uid: 'excel!Excel.EntityCompactLayoutIcons.prohibited:member'
+ package: excel!
+ summary: |-
+ Prohibited icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Prohibited"'
+ - name: projectionScreen
+ uid: 'excel!Excel.EntityCompactLayoutIcons.projectionScreen:member'
+ package: excel!
+ summary: |-
+ Projection screen icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ProjectionScreen"'
+ - name: protocolHandler
+ uid: 'excel!Excel.EntityCompactLayoutIcons.protocolHandler:member'
+ package: excel!
+ summary: |-
+ Protocol handler icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ProtocolHandler"'
+ - name: pulse
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pulse:member'
+ package: excel!
+ summary: |-
+ Pulse icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Pulse"'
+ - name: pulseSquare
+ uid: 'excel!Excel.EntityCompactLayoutIcons.pulseSquare:member'
+ package: excel!
+ summary: |-
+ Pulse square icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PulseSquare"'
+ - name: puzzlePiece
+ uid: 'excel!Excel.EntityCompactLayoutIcons.puzzlePiece:member'
+ package: excel!
+ summary: |-
+ Puzzle piece icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"PuzzlePiece"'
+ - name: qrCode
+ uid: 'excel!Excel.EntityCompactLayoutIcons.qrCode:member'
+ package: excel!
+ summary: |-
+ QR code icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"QrCode"'
+ - name: radar
+ uid: 'excel!Excel.EntityCompactLayoutIcons.radar:member'
+ package: excel!
+ summary: |-
+ Radar icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Radar"'
+ - name: ram
+ uid: 'excel!Excel.EntityCompactLayoutIcons.ram:member'
+ package: excel!
+ summary: |-
+ Ram icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Ram"'
+ - name: readingList
+ uid: 'excel!Excel.EntityCompactLayoutIcons.readingList:member'
+ package: excel!
+ summary: |-
+ Reading list icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ReadingList"'
+ - name: realEstate
+ uid: 'excel!Excel.EntityCompactLayoutIcons.realEstate:member'
+ package: excel!
+ summary: |-
+ Real estate icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RealEstate"'
+ - name: receipt
+ uid: 'excel!Excel.EntityCompactLayoutIcons.receipt:member'
+ package: excel!
+ summary: |-
+ Receipt icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Receipt"'
+ - name: reward
+ uid: 'excel!Excel.EntityCompactLayoutIcons.reward:member'
+ package: excel!
+ summary: |-
+ Reward icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Reward"'
+ - name: rhombus
+ uid: 'excel!Excel.EntityCompactLayoutIcons.rhombus:member'
+ package: excel!
+ summary: |-
+ Rhombus icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Rhombus"'
+ - name: ribbon
+ uid: 'excel!Excel.EntityCompactLayoutIcons.ribbon:member'
+ package: excel!
+ summary: |-
+ Ribbon icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Ribbon"'
+ - name: ribbonStar
+ uid: 'excel!Excel.EntityCompactLayoutIcons.ribbonStar:member'
+ package: excel!
+ summary: |-
+ Ribbon star icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RibbonStar"'
+ - name: roadCone
+ uid: 'excel!Excel.EntityCompactLayoutIcons.roadCone:member'
+ package: excel!
+ summary: |-
+ Road cone icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RoadCone"'
+ - name: rocket
+ uid: 'excel!Excel.EntityCompactLayoutIcons.rocket:member'
+ package: excel!
+ summary: |-
+ Rocket icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Rocket"'
+ - name: router
+ uid: 'excel!Excel.EntityCompactLayoutIcons.router:member'
+ package: excel!
+ summary: |-
+ Router icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Router"'
+ - name: rss
+ uid: 'excel!Excel.EntityCompactLayoutIcons.rss:member'
+ package: excel!
+ summary: |-
+ RSS icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Rss"'
+ - name: ruler
+ uid: 'excel!Excel.EntityCompactLayoutIcons.ruler:member'
+ package: excel!
+ summary: |-
+ Ruler icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Ruler"'
+ - name: run
+ uid: 'excel!Excel.EntityCompactLayoutIcons.run:member'
+ package: excel!
+ summary: |-
+ Run icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Run"'
+ - name: running
+ uid: 'excel!Excel.EntityCompactLayoutIcons.running:member'
+ package: excel!
+ summary: |-
+ Running icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Running"'
+ - name: satellite
+ uid: 'excel!Excel.EntityCompactLayoutIcons.satellite:member'
+ package: excel!
+ summary: |-
+ Satellite icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Satellite"'
+ - name: save
+ uid: 'excel!Excel.EntityCompactLayoutIcons.save:member'
+ package: excel!
+ summary: |-
+ Save icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Save"'
+ - name: savings
+ uid: 'excel!Excel.EntityCompactLayoutIcons.savings:member'
+ package: excel!
+ summary: |-
+ Savings icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Savings"'
+ - name: scales
+ uid: 'excel!Excel.EntityCompactLayoutIcons.scales:member'
+ package: excel!
+ summary: |-
+ Scales icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Scales"'
+ - name: scan
+ uid: 'excel!Excel.EntityCompactLayoutIcons.scan:member'
+ package: excel!
+ summary: |-
+ Scan icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Scan"'
+ - name: scratchpad
+ uid: 'excel!Excel.EntityCompactLayoutIcons.scratchpad:member'
+ package: excel!
+ summary: |-
+ Scratchpad icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Scratchpad"'
+ - name: screenPerson
+ uid: 'excel!Excel.EntityCompactLayoutIcons.screenPerson:member'
+ package: excel!
+ summary: |-
+ Screen person icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ScreenPerson"'
+ - name: screenshot
+ uid: 'excel!Excel.EntityCompactLayoutIcons.screenshot:member'
+ package: excel!
+ summary: |-
+ Screenshot icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Screenshot"'
+ - name: search
+ uid: 'excel!Excel.EntityCompactLayoutIcons.search:member'
+ package: excel!
+ summary: |-
+ Search icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Search"'
+ - name: serialPort
+ uid: 'excel!Excel.EntityCompactLayoutIcons.serialPort:member'
+ package: excel!
+ summary: |-
+ Serial port icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SerialPort"'
+ - name: server
+ uid: 'excel!Excel.EntityCompactLayoutIcons.server:member'
+ package: excel!
+ summary: |-
+ Server icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Server"'
+ - name: serverMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.serverMultiple:member'
+ package: excel!
+ summary: |-
+ Server multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ServerMultiple"'
+ - name: serviceBell
+ uid: 'excel!Excel.EntityCompactLayoutIcons.serviceBell:member'
+ package: excel!
+ summary: |-
+ Service bell icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ServiceBell"'
+ - name: settings
+ uid: 'excel!Excel.EntityCompactLayoutIcons.settings:member'
+ package: excel!
+ summary: |-
+ Settings icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Settings"'
+ - name: shapes
+ uid: 'excel!Excel.EntityCompactLayoutIcons.shapes:member'
+ package: excel!
+ summary: |-
+ Shapes icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Shapes"'
+ - name: shield
+ uid: 'excel!Excel.EntityCompactLayoutIcons.shield:member'
+ package: excel!
+ summary: |-
+ Shield icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Shield"'
+ - name: shieldTask
+ uid: 'excel!Excel.EntityCompactLayoutIcons.shieldTask:member'
+ package: excel!
+ summary: |-
+ Shield task icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ShieldTask"'
+ - name: shoppingBag
+ uid: 'excel!Excel.EntityCompactLayoutIcons.shoppingBag:member'
+ package: excel!
+ summary: |-
+ Shopping bag icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ShoppingBag"'
+ - name: signature
+ uid: 'excel!Excel.EntityCompactLayoutIcons.signature:member'
+ package: excel!
+ summary: |-
+ Signature icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Signature"'
+ - name: sim
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sim:member'
+ package: excel!
+ summary: |-
+ Sim icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Sim"'
+ - name: sleep
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sleep:member'
+ package: excel!
+ summary: |-
+ Sleep icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Sleep"'
+ - name: smartwatch
+ uid: 'excel!Excel.EntityCompactLayoutIcons.smartwatch:member'
+ package: excel!
+ summary: |-
+ Smartwatch icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Smartwatch"'
+ - name: soundSource
+ uid: 'excel!Excel.EntityCompactLayoutIcons.soundSource:member'
+ package: excel!
+ summary: |-
+ Sound source icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SoundSource"'
+ - name: soundWaveCircle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.soundWaveCircle:member'
+ package: excel!
+ summary: |-
+ Sound wave circle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SoundWaveCircle"'
+ - name: sparkle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sparkle:member'
+ package: excel!
+ summary: |-
+ Sparkle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Sparkle"'
+ - name: speaker0
+ uid: 'excel!Excel.EntityCompactLayoutIcons.speaker0:member'
+ package: excel!
+ summary: |-
+ Speaker icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Speaker0"'
+ - name: speaker2
+ uid: 'excel!Excel.EntityCompactLayoutIcons.speaker2:member'
+ package: excel!
+ summary: |-
+ Speaker with sound wave icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Speaker2"'
+ - name: sport
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sport:member'
+ package: excel!
+ summary: |-
+ Sport icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Sport"'
+ - name: sportAmericanFootball
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sportAmericanFootball:member'
+ package: excel!
+ summary: |-
+ Sport american football icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SportAmericanFootball"'
+ - name: sportBaseball
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sportBaseball:member'
+ package: excel!
+ summary: |-
+ Sport baseball icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SportBaseball"'
+ - name: sportBasketball
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sportBasketball:member'
+ package: excel!
+ summary: |-
+ Sport basketball icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SportBasketball"'
+ - name: sportHockey
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sportHockey:member'
+ package: excel!
+ summary: |-
+ Sport hockey icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SportHockey"'
+ - name: sportSoccer
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sportSoccer:member'
+ package: excel!
+ summary: |-
+ Sport soccer icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SportSoccer"'
+ - name: squareMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.squareMultiple:member'
+ package: excel!
+ summary: |-
+ Square multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SquareMultiple"'
+ - name: squareShadow
+ uid: 'excel!Excel.EntityCompactLayoutIcons.squareShadow:member'
+ package: excel!
+ summary: |-
+ Square shadow icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SquareShadow"'
+ - name: squaresNested
+ uid: 'excel!Excel.EntityCompactLayoutIcons.squaresNested:member'
+ package: excel!
+ summary: |-
+ Squares nested icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SquaresNested"'
+ - name: stack
+ uid: 'excel!Excel.EntityCompactLayoutIcons.stack:member'
+ package: excel!
+ summary: |-
+ Stack icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Stack"'
+ - name: stackStar
+ uid: 'excel!Excel.EntityCompactLayoutIcons.stackStar:member'
+ package: excel!
+ summary: |-
+ Stack star icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StackStar"'
+ - name: star
+ uid: 'excel!Excel.EntityCompactLayoutIcons.star:member'
+ package: excel!
+ summary: |-
+ Star icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Star"'
+ - name: starFilled
+ uid: 'excel!Excel.EntityCompactLayoutIcons.starFilled:member'
+ package: excel!
+ summary: |-
+ Star filled icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StarFilled"'
+ - name: starHalf
+ uid: 'excel!Excel.EntityCompactLayoutIcons.starHalf:member'
+ package: excel!
+ summary: |-
+ Star half icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StarHalf"'
+ - name: starLineHorizontal3
+ uid: 'excel!Excel.EntityCompactLayoutIcons.starLineHorizontal3:member'
+ package: excel!
+ summary: |-
+ Star with 3 horizontal lines icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StarLineHorizontal3"'
+ - name: starOneQuarter
+ uid: 'excel!Excel.EntityCompactLayoutIcons.starOneQuarter:member'
+ package: excel!
+ summary: |-
+ Star one quarter icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StarOneQuarter"'
+ - name: starThreeQuarter
+ uid: 'excel!Excel.EntityCompactLayoutIcons.starThreeQuarter:member'
+ package: excel!
+ summary: |-
+ Star three quarter icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StarThreeQuarter"'
+ - name: status
+ uid: 'excel!Excel.EntityCompactLayoutIcons.status:member'
+ package: excel!
+ summary: |-
+ Status icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Status"'
+ - name: steps
+ uid: 'excel!Excel.EntityCompactLayoutIcons.steps:member'
+ package: excel!
+ summary: |-
+ Steps icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Steps"'
+ - name: stethoscope
+ uid: 'excel!Excel.EntityCompactLayoutIcons.stethoscope:member'
+ package: excel!
+ summary: |-
+ Stethoscope icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Stethoscope"'
+ - name: sticker
+ uid: 'excel!Excel.EntityCompactLayoutIcons.sticker:member'
+ package: excel!
+ summary: |-
+ Sticker icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Sticker"'
+ - name: storage
+ uid: 'excel!Excel.EntityCompactLayoutIcons.storage:member'
+ package: excel!
+ summary: |-
+ Storage icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Storage"'
+ - name: stream
+ uid: 'excel!Excel.EntityCompactLayoutIcons.stream:member'
+ package: excel!
+ summary: |-
+ Stream icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Stream"'
+ - name: streamInput
+ uid: 'excel!Excel.EntityCompactLayoutIcons.streamInput:member'
+ package: excel!
+ summary: |-
+ Stream input icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StreamInput"'
+ - name: streamInputOutput
+ uid: 'excel!Excel.EntityCompactLayoutIcons.streamInputOutput:member'
+ package: excel!
+ summary: |-
+ Stream input output icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StreamInputOutput"'
+ - name: streamOutput
+ uid: 'excel!Excel.EntityCompactLayoutIcons.streamOutput:member'
+ package: excel!
+ summary: |-
+ Stream output icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StreamOutput"'
+ - name: styleGuide
+ uid: 'excel!Excel.EntityCompactLayoutIcons.styleGuide:member'
+ package: excel!
+ summary: |-
+ Style guide icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"StyleGuide"'
+ - name: subGrid
+ uid: 'excel!Excel.EntityCompactLayoutIcons.subGrid:member'
+ package: excel!
+ summary: |-
+ Sub grid icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SubGrid"'
+ - name: subtitles
+ uid: 'excel!Excel.EntityCompactLayoutIcons.subtitles:member'
+ package: excel!
+ summary: |-
+ Subtitles icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Subtitles"'
+ - name: surfaceEarbuds
+ uid: 'excel!Excel.EntityCompactLayoutIcons.surfaceEarbuds:member'
+ package: excel!
+ summary: |-
+ Surface earbuds icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SurfaceEarbuds"'
+ - name: surfaceHub
+ uid: 'excel!Excel.EntityCompactLayoutIcons.surfaceHub:member'
+ package: excel!
+ summary: |-
+ Surface hub icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"SurfaceHub"'
+ - name: symbols
+ uid: 'excel!Excel.EntityCompactLayoutIcons.symbols:member'
+ package: excel!
+ summary: |-
+ Symbols icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Symbols"'
+ - name: syringe
+ uid: 'excel!Excel.EntityCompactLayoutIcons.syringe:member'
+ package: excel!
+ summary: |-
+ Syringe icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Syringe"'
+ - name: system
+ uid: 'excel!Excel.EntityCompactLayoutIcons.system:member'
+ package: excel!
+ summary: |-
+ System icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"System"'
+ - name: tabDesktop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tabDesktop:member'
+ package: excel!
+ summary: |-
+ Tab desktop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TabDesktop"'
+ - name: tabInprivateAccount
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tabInprivateAccount:member'
+ package: excel!
+ summary: |-
+ Tab InPrivate account icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TabInprivateAccount"'
+ - name: table
+ uid: 'excel!Excel.EntityCompactLayoutIcons.table:member'
+ package: excel!
+ summary: |-
+ Table icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Table"'
+ - name: tableImage
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tableImage:member'
+ package: excel!
+ summary: |-
+ Table image icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TableImage"'
+ - name: tableMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tableMultiple:member'
+ package: excel!
+ summary: |-
+ Table multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TableMultiple"'
+ - name: tablet
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tablet:member'
+ package: excel!
+ summary: |-
+ Tablet icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Tablet"'
+ - name: tabs
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tabs:member'
+ package: excel!
+ summary: |-
+ Tabs icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Tabs"'
+ - name: tag
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tag:member'
+ package: excel!
+ summary: |-
+ Tag icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Tag"'
+ - name: tagCircle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tagCircle:member'
+ package: excel!
+ summary: |-
+ Tag circle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TagCircle"'
+ - name: tagMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tagMultiple:member'
+ package: excel!
+ summary: |-
+ Tag multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TagMultiple"'
+ - name: target
+ uid: 'excel!Excel.EntityCompactLayoutIcons.target:member'
+ package: excel!
+ summary: |-
+ Target icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Target"'
+ - name: targetArrow
+ uid: 'excel!Excel.EntityCompactLayoutIcons.targetArrow:member'
+ package: excel!
+ summary: |-
+ Target arrow icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TargetArrow"'
+ - name: teddy
+ uid: 'excel!Excel.EntityCompactLayoutIcons.teddy:member'
+ package: excel!
+ summary: |-
+ Teddy icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Teddy"'
+ - name: temperature
+ uid: 'excel!Excel.EntityCompactLayoutIcons.temperature:member'
+ package: excel!
+ summary: |-
+ Temperature icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Temperature"'
+ - name: tent
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tent:member'
+ package: excel!
+ summary: |-
+ Tent icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Tent"'
+ - name: tetrisApp
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tetrisApp:member'
+ package: excel!
+ summary: |-
+ Tetris app icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TetrisApp"'
+ - name: textbox
+ uid: 'excel!Excel.EntityCompactLayoutIcons.textbox:member'
+ package: excel!
+ summary: |-
+ Textbox icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Textbox"'
+ - name: textQuote
+ uid: 'excel!Excel.EntityCompactLayoutIcons.textQuote:member'
+ package: excel!
+ summary: |-
+ Text quote icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TextQuote"'
+ - name: thinking
+ uid: 'excel!Excel.EntityCompactLayoutIcons.thinking:member'
+ package: excel!
+ summary: |-
+ Thinking icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Thinking"'
+ - name: thumbDislike
+ uid: 'excel!Excel.EntityCompactLayoutIcons.thumbDislike:member'
+ package: excel!
+ summary: |-
+ Thumb dislike icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ThumbDislike"'
+ - name: thumbLike
+ uid: 'excel!Excel.EntityCompactLayoutIcons.thumbLike:member'
+ package: excel!
+ summary: |-
+ Thumb like icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ThumbLike"'
+ - name: ticketDiagonal
+ uid: 'excel!Excel.EntityCompactLayoutIcons.ticketDiagonal:member'
+ package: excel!
+ summary: |-
+ Ticket diagonal icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TicketDiagonal"'
+ - name: ticketHorizontal
+ uid: 'excel!Excel.EntityCompactLayoutIcons.ticketHorizontal:member'
+ package: excel!
+ summary: |-
+ Ticket horizontal icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TicketHorizontal"'
+ - name: timeAndWeather
+ uid: 'excel!Excel.EntityCompactLayoutIcons.timeAndWeather:member'
+ package: excel!
+ summary: |-
+ Time and weather icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TimeAndWeather"'
+ - name: timeline
+ uid: 'excel!Excel.EntityCompactLayoutIcons.timeline:member'
+ package: excel!
+ summary: |-
+ Timeline icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Timeline"'
+ - name: timer
+ uid: 'excel!Excel.EntityCompactLayoutIcons.timer:member'
+ package: excel!
+ summary: |-
+ Timer icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Timer"'
+ - name: toolbox
+ uid: 'excel!Excel.EntityCompactLayoutIcons.toolbox:member'
+ package: excel!
+ summary: |-
+ Toolbox icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Toolbox"'
+ - name: topSpeed
+ uid: 'excel!Excel.EntityCompactLayoutIcons.topSpeed:member'
+ package: excel!
+ summary: |-
+ Top speed icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TopSpeed"'
+ - name: translate
+ uid: 'excel!Excel.EntityCompactLayoutIcons.translate:member'
+ package: excel!
+ summary: |-
+ Translate icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Translate"'
+ - name: transmission
+ uid: 'excel!Excel.EntityCompactLayoutIcons.transmission:member'
+ package: excel!
+ summary: |-
+ Transmission icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Transmission"'
+ - name: treeDeciduous
+ uid: 'excel!Excel.EntityCompactLayoutIcons.treeDeciduous:member'
+ package: excel!
+ summary: |-
+ Tree deciduous icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TreeDeciduous"'
+ - name: treeEvergreen
+ uid: 'excel!Excel.EntityCompactLayoutIcons.treeEvergreen:member'
+ package: excel!
+ summary: |-
+ Tree evergreen icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TreeEvergreen"'
+ - name: trophy
+ uid: 'excel!Excel.EntityCompactLayoutIcons.trophy:member'
+ package: excel!
+ summary: |-
+ Trophy icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Trophy"'
+ - name: tv
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tv:member'
+ package: excel!
+ summary: |-
+ TV icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Tv"'
+ - name: tvUsb
+ uid: 'excel!Excel.EntityCompactLayoutIcons.tvUsb:member'
+ package: excel!
+ summary: |-
+ TV USB icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TvUsb"'
+ - name: umbrella
+ uid: 'excel!Excel.EntityCompactLayoutIcons.umbrella:member'
+ package: excel!
+ summary: |-
+ Umbrella icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Umbrella"'
+ - name: usbPlug
+ uid: 'excel!Excel.EntityCompactLayoutIcons.usbPlug:member'
+ package: excel!
+ summary: |-
+ USB plug icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"UsbPlug"'
+ - name: usbStick
+ uid: 'excel!Excel.EntityCompactLayoutIcons.usbStick:member'
+ package: excel!
+ summary: |-
+ USB stick icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"UsbStick"'
+ - name: vault
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vault:member'
+ package: excel!
+ summary: |-
+ Vault icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Vault"'
+ - name: vehicleBicycle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleBicycle:member'
+ package: excel!
+ summary: |-
+ Vehicle bicycle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleBicycle"'
+ - name: vehicleBus
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleBus:member'
+ package: excel!
+ summary: |-
+ Vehicle bus icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleBus"'
+ - name: vehicleCab
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleCab:member'
+ package: excel!
+ summary: |-
+ Vehicle cab icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleCab"'
+ - name: vehicleCar
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleCar:member'
+ package: excel!
+ summary: |-
+ Vehicle car icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleCar"'
+ - name: vehicleCarCollision
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleCarCollision:member'
+ package: excel!
+ summary: |-
+ Vehicle car collision icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleCarCollision"'
+ - name: vehicleCarProfileLtr
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleCarProfileLtr:member'
+ package: excel!
+ summary: |-
+ Vehicle car profile left-to-right icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleCarProfileLtr"'
+ - name: vehicleCarProfileRtl
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleCarProfileRtl:member'
+ package: excel!
+ summary: |-
+ Vehicle car profile right-to-left icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleCarProfileRtl"'
+ - name: vehicleShip
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleShip:member'
+ package: excel!
+ summary: |-
+ Vehicle ship icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleShip"'
+ - name: vehicleSubway
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleSubway:member'
+ package: excel!
+ summary: |-
+ Vehicle subway icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleSubway"'
+ - name: vehicleTruck
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleTruck:member'
+ package: excel!
+ summary: |-
+ Vehicle truck icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleTruck"'
+ - name: vehicleTruckBag
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleTruckBag:member'
+ package: excel!
+ summary: |-
+ Vehicle truck bag icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleTruckBag"'
+ - name: vehicleTruckCube
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleTruckCube:member'
+ package: excel!
+ summary: |-
+ Vehicle truck cube icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleTruckCube"'
+ - name: vehicleTruckProfile
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vehicleTruckProfile:member'
+ package: excel!
+ summary: |-
+ Vehicle truck profile icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VehicleTruckProfile"'
+ - name: video
+ uid: 'excel!Excel.EntityCompactLayoutIcons.video:member'
+ package: excel!
+ summary: |-
+ Video icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Video"'
+ - name: video360
+ uid: 'excel!Excel.EntityCompactLayoutIcons.video360:member'
+ package: excel!
+ summary: |-
+ Video 360 icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Video360"'
+ - name: videoChat
+ uid: 'excel!Excel.EntityCompactLayoutIcons.videoChat:member'
+ package: excel!
+ summary: |-
+ Video chat icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VideoChat"'
+ - name: videoClip
+ uid: 'excel!Excel.EntityCompactLayoutIcons.videoClip:member'
+ package: excel!
+ summary: |-
+ Video clip icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VideoClip"'
+ - name: videoClipMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.videoClipMultiple:member'
+ package: excel!
+ summary: |-
+ Video clip multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VideoClipMultiple"'
+ - name: videoPerson
+ uid: 'excel!Excel.EntityCompactLayoutIcons.videoPerson:member'
+ package: excel!
+ summary: |-
+ Video person icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VideoPerson"'
+ - name: videoRecording
+ uid: 'excel!Excel.EntityCompactLayoutIcons.videoRecording:member'
+ package: excel!
+ summary: |-
+ Video recording icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VideoRecording"'
+ - name: videoSecurity
+ uid: 'excel!Excel.EntityCompactLayoutIcons.videoSecurity:member'
+ package: excel!
+ summary: |-
+ Video security icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VideoSecurity"'
+ - name: viewDesktop
+ uid: 'excel!Excel.EntityCompactLayoutIcons.viewDesktop:member'
+ package: excel!
+ summary: |-
+ View desktop icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ViewDesktop"'
+ - name: viewDesktopMobile
+ uid: 'excel!Excel.EntityCompactLayoutIcons.viewDesktopMobile:member'
+ package: excel!
+ summary: |-
+ View desktop mobile icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ViewDesktopMobile"'
+ - name: violin
+ uid: 'excel!Excel.EntityCompactLayoutIcons.violin:member'
+ package: excel!
+ summary: |-
+ Violin icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Violin"'
+ - name: virtualNetwork
+ uid: 'excel!Excel.EntityCompactLayoutIcons.virtualNetwork:member'
+ package: excel!
+ summary: |-
+ Virtual network icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VirtualNetwork"'
+ - name: voicemail
+ uid: 'excel!Excel.EntityCompactLayoutIcons.voicemail:member'
+ package: excel!
+ summary: |-
+ Voicemail icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Voicemail"'
+ - name: vote
+ uid: 'excel!Excel.EntityCompactLayoutIcons.vote:member'
+ package: excel!
+ summary: |-
+ Vote icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Vote"'
+ - name: walkieTalkie
+ uid: 'excel!Excel.EntityCompactLayoutIcons.walkieTalkie:member'
+ package: excel!
+ summary: |-
+ Walkie talkie icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WalkieTalkie"'
+ - name: wallet
+ uid: 'excel!Excel.EntityCompactLayoutIcons.wallet:member'
+ package: excel!
+ summary: |-
+ Wallet icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Wallet"'
+ - name: walletCreditCard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.walletCreditCard:member'
+ package: excel!
+ summary: |-
+ Wallet credit card icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WalletCreditCard"'
+ - name: wallpaper
+ uid: 'excel!Excel.EntityCompactLayoutIcons.wallpaper:member'
+ package: excel!
+ summary: |-
+ Wallpaper icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Wallpaper"'
+ - name: wand
+ uid: 'excel!Excel.EntityCompactLayoutIcons.wand:member'
+ package: excel!
+ summary: |-
+ Wand icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Wand"'
+ - name: warning
+ uid: 'excel!Excel.EntityCompactLayoutIcons.warning:member'
+ package: excel!
+ summary: |-
+ Warning icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Warning"'
+ - name: weatherBlowingSnow
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherBlowingSnow:member'
+ package: excel!
+ summary: |-
+ Weather blowing snow icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherBlowingSnow"'
+ - name: weatherCloudy
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherCloudy:member'
+ package: excel!
+ summary: |-
+ Weather cloudy icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherCloudy"'
+ - name: weatherDrizzle
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherDrizzle:member'
+ package: excel!
+ summary: |-
+ Weather drizzle icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherDrizzle"'
+ - name: weatherDuststorm
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherDuststorm:member'
+ package: excel!
+ summary: |-
+ Weather duststorm icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherDuststorm"'
+ - name: weatherFog
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherFog:member'
+ package: excel!
+ summary: |-
+ Weather fog icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherFog"'
+ - name: weatherHailDay
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherHailDay:member'
+ package: excel!
+ summary: |-
+ Weather hail day icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherHailDay"'
+ - name: weatherHailNight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherHailNight:member'
+ package: excel!
+ summary: |-
+ Weather hail night icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherHailNight"'
+ - name: weatherHaze
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherHaze:member'
+ package: excel!
+ summary: |-
+ Weather haze icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherHaze"'
+ - name: weatherMoon
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherMoon:member'
+ package: excel!
+ summary: |-
+ Weather moon icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherMoon"'
+ - name: weatherPartlyCloudyDay
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherPartlyCloudyDay:member'
+ package: excel!
+ summary: |-
+ Weather partly cloudy day icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherPartlyCloudyDay"'
+ - name: weatherPartlyCloudyNight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherPartlyCloudyNight:member'
+ package: excel!
+ summary: |-
+ Weather partly cloudy night icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherPartlyCloudyNight"'
+ - name: weatherRain
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherRain:member'
+ package: excel!
+ summary: |-
+ Weather rain icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherRain"'
+ - name: weatherRainShowersDay
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherRainShowersDay:member'
+ package: excel!
+ summary: |-
+ Weather rain showers day icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherRainShowersDay"'
+ - name: weatherRainShowersNight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherRainShowersNight:member'
+ package: excel!
+ summary: |-
+ Weather rain showers night icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherRainShowersNight"'
+ - name: weatherRainSnow
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherRainSnow:member'
+ package: excel!
+ summary: |-
+ Weather rain snow icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherRainSnow"'
+ - name: weatherSnow
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherSnow:member'
+ package: excel!
+ summary: |-
+ Weather snow icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherSnow"'
+ - name: weatherSnowflake
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherSnowflake:member'
+ package: excel!
+ summary: |-
+ Weather snowflake icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherSnowflake"'
+ - name: weatherSnowShowerDay
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherSnowShowerDay:member'
+ package: excel!
+ summary: |-
+ Weather snow shower day icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherSnowShowerDay"'
+ - name: weatherSnowShowerNight
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherSnowShowerNight:member'
+ package: excel!
+ summary: |-
+ Weather snow shower night icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherSnowShowerNight"'
+ - name: weatherSqualls
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherSqualls:member'
+ package: excel!
+ summary: |-
+ Weather squalls icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherSqualls"'
+ - name: weatherSunnyHigh
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherSunnyHigh:member'
+ package: excel!
+ summary: |-
+ Weather sunny high icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherSunnyHigh"'
+ - name: weatherSunnyLow
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherSunnyLow:member'
+ package: excel!
+ summary: |-
+ Weather sunny low icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherSunnyLow"'
+ - name: weatherThunderstorm
+ uid: 'excel!Excel.EntityCompactLayoutIcons.weatherThunderstorm:member'
+ package: excel!
+ summary: |-
+ Weather thunderstorm icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WeatherThunderstorm"'
+ - name: webAsset
+ uid: 'excel!Excel.EntityCompactLayoutIcons.webAsset:member'
+ package: excel!
+ summary: |-
+ Web asset icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WebAsset"'
+ - name: whiteboard
+ uid: 'excel!Excel.EntityCompactLayoutIcons.whiteboard:member'
+ package: excel!
+ summary: |-
+ Whiteboard icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Whiteboard"'
+ - name: wifi1
+ uid: 'excel!Excel.EntityCompactLayoutIcons.wifi1:member'
+ package: excel!
+ summary: |-
+ Wifi signal with 3 bars icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Wifi1"'
+ - name: wifi2
+ uid: 'excel!Excel.EntityCompactLayoutIcons.wifi2:member'
+ package: excel!
+ summary: |-
+ Wifi signal with 2 bars icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Wifi2"'
+ - name: window
+ uid: 'excel!Excel.EntityCompactLayoutIcons.window:member'
+ package: excel!
+ summary: |-
+ Window icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Window"'
+ - name: windowMultiple
+ uid: 'excel!Excel.EntityCompactLayoutIcons.windowMultiple:member'
+ package: excel!
+ summary: |-
+ Window multiple icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WindowMultiple"'
+ - name: windowWrench
+ uid: 'excel!Excel.EntityCompactLayoutIcons.windowWrench:member'
+ package: excel!
+ summary: |-
+ Window wrench icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WindowWrench"'
+ - name: wrench
+ uid: 'excel!Excel.EntityCompactLayoutIcons.wrench:member'
+ package: excel!
+ summary: |-
+ Wrench icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Wrench"'
+ - name: wrenchScrewdriver
+ uid: 'excel!Excel.EntityCompactLayoutIcons.wrenchScrewdriver:member'
+ package: excel!
+ summary: |-
+ Wrench screwdriver icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WrenchScrewdriver"'
+ - name: xray
+ uid: 'excel!Excel.EntityCompactLayoutIcons.xray:member'
+ package: excel!
+ summary: |-
+ X-ray icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Xray"'
+ - name: yoga
+ uid: 'excel!Excel.EntityCompactLayoutIcons.yoga:member'
+ package: excel!
+ summary: |-
+ Yoga icon.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Yoga"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertyextraproperties.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertyextraproperties.yml
new file mode 100644
index 0000000000..da3fa174f5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertyextraproperties.yml
@@ -0,0 +1,25 @@
+### YamlMime:TSType
+name: Excel.EntityPropertyExtraProperties
+uid: 'excel!Excel.EntityPropertyExtraProperties:interface'
+package: excel!
+fullName: Excel.EntityPropertyExtraProperties
+summary: >-
+ Properties used by `CellValueAndPropertyMetadata`. These properties refer to the metadata and not to a
+ `CellValue`.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: propertyMetadata
+ uid: 'excel!Excel.EntityPropertyExtraProperties#propertyMetadata:member'
+ package: excel!
+ fullName: propertyMetadata
+ summary: Represents metadata about the property.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'propertyMetadata?: CellValuePropertyMetadata;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertytype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertytype.yml
new file mode 100644
index 0000000000..34a8ee04a7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertytype.yml
@@ -0,0 +1,10 @@
+### YamlMime:TSTypeAlias
+name: Excel.EntityPropertyType
+uid: 'excel!Excel.EntityPropertyType:type'
+package: excel!
+fullName: Excel.EntityPropertyType
+summary: Represents the value of a property.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+syntax: export type EntityPropertyType = CellValueAndPropertyMetadata | CellValue;
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entityviewlayouts.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entityviewlayouts.yml
new file mode 100644
index 0000000000..e23a27d1e7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entityviewlayouts.yml
@@ -0,0 +1,37 @@
+### YamlMime:TSType
+name: Excel.EntityViewLayouts
+uid: 'excel!Excel.EntityViewLayouts:interface'
+package: excel!
+fullName: Excel.EntityViewLayouts
+summary: Represents layout information for various views of the entity.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: card
+ uid: 'excel!Excel.EntityViewLayouts#card:member'
+ package: excel!
+ fullName: card
+ summary: >-
+ Represents the layout of this entity in card view. If the `CardLayout` object does not have a layout property, it
+ is assumed to be "Entity".
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'card?: CardLayout;'
+ return:
+ type: ''
+ - name: compact
+ uid: 'excel!Excel.EntityViewLayouts#compact:member'
+ package: excel!
+ fullName: compact
+ summary: Represents the layout used when there is limited space to represent the entity.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'compact?: CompactLayout;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvalue.yml
new file mode 100644
index 0000000000..5c35b51d4e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvalue.yml
@@ -0,0 +1,44 @@
+### YamlMime:TSTypeAlias
+name: Excel.ErrorCellValue
+uid: 'excel!Excel.ErrorCellValue:type'
+package: excel!
+fullName: Excel.ErrorCellValue
+summary: Represents a cell value which contains an error.
+remarks: >-
+ \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+syntax: >-
+ export type ErrorCellValue = BlockedErrorCellValue | BusyErrorCellValue | CalcErrorCellValue | ConnectErrorCellValue |
+ Div0ErrorCellValue | ExternalErrorCellValue | FieldErrorCellValue | GettingDataErrorCellValue |
+ NotAvailableErrorCellValue | NameErrorCellValue | NullErrorCellValue | NumErrorCellValue | PlaceholderErrorCellValue |
+ RefErrorCellValue | SpillErrorCellValue | ValueErrorCellValue;
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvaluetype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvaluetype.yml
new file mode 100644
index 0000000000..638ed8444e
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvaluetype.yml
@@ -0,0 +1,168 @@
+### YamlMime:TSEnum
+name: Excel.ErrorCellValueType
+uid: 'excel!Excel.ErrorCellValueType:enum'
+package: excel!
+fullName: Excel.ErrorCellValueType
+summary: Represents the types of the `ErrorCellValue` object.
+remarks: >-
+ \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: blocked
+ uid: 'excel!Excel.ErrorCellValueType.blocked:member'
+ package: excel!
+ summary: |-
+ Represents a `BlockedErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Blocked"'
+ - name: busy
+ uid: 'excel!Excel.ErrorCellValueType.busy:member'
+ package: excel!
+ summary: |-
+ Represents a `BusyErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Busy"'
+ - name: calc
+ uid: 'excel!Excel.ErrorCellValueType.calc:member'
+ package: excel!
+ summary: |-
+ Represents a `CalcErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Calc"'
+ - name: connect
+ uid: 'excel!Excel.ErrorCellValueType.connect:member'
+ package: excel!
+ summary: |-
+ Represents a `ConnectErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Connect"'
+ - name: div0
+ uid: 'excel!Excel.ErrorCellValueType.div0:member'
+ package: excel!
+ summary: |-
+ Represents a `Div0ErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Div0"'
+ - name: external
+ uid: 'excel!Excel.ErrorCellValueType.external:member'
+ package: excel!
+ summary: |-
+ Represents an `ExternalErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"External"'
+ - name: field
+ uid: 'excel!Excel.ErrorCellValueType.field:member'
+ package: excel!
+ summary: |-
+ Represents a `FieldErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Field"'
+ - name: gettingData
+ uid: 'excel!Excel.ErrorCellValueType.gettingData:member'
+ package: excel!
+ summary: |-
+ Represents a `GettingDataErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"GettingData"'
+ - name: name
+ uid: 'excel!Excel.ErrorCellValueType.name:member'
+ package: excel!
+ summary: |-
+ Represents a `NameErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Name"'
+ - name: notAvailable
+ uid: 'excel!Excel.ErrorCellValueType.notAvailable:member'
+ package: excel!
+ summary: |-
+ Represents a `NotAvailableErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"NotAvailable"'
+ - name: 'null'
+ uid: 'excel!Excel.ErrorCellValueType.null:member'
+ package: excel!
+ summary: |-
+ Represents a `NullErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Null"'
+ - name: num
+ uid: 'excel!Excel.ErrorCellValueType.num:member'
+ package: excel!
+ summary: |-
+ Represents a `NumErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Num"'
+ - name: placeholder
+ uid: 'excel!Excel.ErrorCellValueType.placeholder:member'
+ package: excel!
+ summary: |-
+ Represents a `PlaceholderErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Placeholder"'
+ - name: ref
+ uid: 'excel!Excel.ErrorCellValueType.ref:member'
+ package: excel!
+ summary: |-
+ Represents a `RefErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Ref"'
+ - name: spill
+ uid: 'excel!Excel.ErrorCellValueType.spill:member'
+ package: excel!
+ summary: |-
+ Represents a `SpillErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Spill"'
+ - name: value
+ uid: 'excel!Excel.ErrorCellValueType.value:member'
+ package: excel!
+ summary: |-
+ Represents a `ValueErrorCellValue`.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Value"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcodes.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcodes.yml
new file mode 100644
index 0000000000..e313a2b9f9
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcodes.yml
@@ -0,0 +1,165 @@
+### YamlMime:TSEnum
+name: Excel.ErrorCodes
+uid: 'excel!Excel.ErrorCodes:enum'
+package: excel!
+fullName: Excel.ErrorCodes
+summary: ''
+remarks: ''
+isPreview: false
+isDeprecated: false
+fields:
+ - name: accessDenied
+ uid: 'excel!Excel.ErrorCodes.accessDenied:member'
+ package: excel!
+ summary: ''
+ value: '"AccessDenied"'
+ - name: apiNotFound
+ uid: 'excel!Excel.ErrorCodes.apiNotFound:member'
+ package: excel!
+ summary: ''
+ value: '"ApiNotFound"'
+ - name: conflict
+ uid: 'excel!Excel.ErrorCodes.conflict:member'
+ package: excel!
+ summary: ''
+ value: '"Conflict"'
+ - name: emptyChartSeries
+ uid: 'excel!Excel.ErrorCodes.emptyChartSeries:member'
+ package: excel!
+ summary: ''
+ value: '"EmptyChartSeries"'
+ - name: filteredRangeConflict
+ uid: 'excel!Excel.ErrorCodes.filteredRangeConflict:member'
+ package: excel!
+ summary: ''
+ value: '"FilteredRangeConflict"'
+ - name: formulaLengthExceedsLimit
+ uid: 'excel!Excel.ErrorCodes.formulaLengthExceedsLimit:member'
+ package: excel!
+ summary: ''
+ value: '"FormulaLengthExceedsLimit"'
+ - name: generalException
+ uid: 'excel!Excel.ErrorCodes.generalException:member'
+ package: excel!
+ summary: ''
+ value: '"GeneralException"'
+ - name: inactiveWorkbook
+ uid: 'excel!Excel.ErrorCodes.inactiveWorkbook:member'
+ package: excel!
+ summary: ''
+ value: '"InactiveWorkbook"'
+ - name: insertDeleteConflict
+ uid: 'excel!Excel.ErrorCodes.insertDeleteConflict:member'
+ package: excel!
+ summary: ''
+ value: '"InsertDeleteConflict"'
+ - name: invalidArgument
+ uid: 'excel!Excel.ErrorCodes.invalidArgument:member'
+ package: excel!
+ summary: ''
+ value: '"InvalidArgument"'
+ - name: invalidBinding
+ uid: 'excel!Excel.ErrorCodes.invalidBinding:member'
+ package: excel!
+ summary: ''
+ value: '"InvalidBinding"'
+ - name: invalidOperation
+ uid: 'excel!Excel.ErrorCodes.invalidOperation:member'
+ package: excel!
+ summary: ''
+ value: '"InvalidOperation"'
+ - name: invalidOperationInCellEditMode
+ uid: 'excel!Excel.ErrorCodes.invalidOperationInCellEditMode:member'
+ package: excel!
+ summary: ''
+ value: '"InvalidOperationInCellEditMode"'
+ - name: invalidReference
+ uid: 'excel!Excel.ErrorCodes.invalidReference:member'
+ package: excel!
+ summary: ''
+ value: '"InvalidReference"'
+ - name: invalidSelection
+ uid: 'excel!Excel.ErrorCodes.invalidSelection:member'
+ package: excel!
+ summary: ''
+ value: '"InvalidSelection"'
+ - name: itemAlreadyExists
+ uid: 'excel!Excel.ErrorCodes.itemAlreadyExists:member'
+ package: excel!
+ summary: ''
+ value: '"ItemAlreadyExists"'
+ - name: itemNotFound
+ uid: 'excel!Excel.ErrorCodes.itemNotFound:member'
+ package: excel!
+ summary: ''
+ value: '"ItemNotFound"'
+ - name: mergedRangeConflict
+ uid: 'excel!Excel.ErrorCodes.mergedRangeConflict:member'
+ package: excel!
+ summary: ''
+ value: '"MergedRangeConflict"'
+ - name: nonBlankCellOffSheet
+ uid: 'excel!Excel.ErrorCodes.nonBlankCellOffSheet:member'
+ package: excel!
+ summary: ''
+ value: '"NonBlankCellOffSheet"'
+ - name: notImplemented
+ uid: 'excel!Excel.ErrorCodes.notImplemented:member'
+ package: excel!
+ summary: ''
+ value: '"NotImplemented"'
+ - name: openWorkbookLinksBlocked
+ uid: 'excel!Excel.ErrorCodes.openWorkbookLinksBlocked:member'
+ package: excel!
+ summary: ''
+ value: '"OpenWorkbookLinksBlocked"'
+ - name: operationCellsExceedLimit
+ uid: 'excel!Excel.ErrorCodes.operationCellsExceedLimit:member'
+ package: excel!
+ summary: ''
+ value: '"OperationCellsExceedLimit"'
+ - name: pivotTableRangeConflict
+ uid: 'excel!Excel.ErrorCodes.pivotTableRangeConflict:member'
+ package: excel!
+ summary: ''
+ value: '"PivotTableRangeConflict"'
+ - name: rangeExceedsLimit
+ uid: 'excel!Excel.ErrorCodes.rangeExceedsLimit:member'
+ package: excel!
+ summary: ''
+ value: '"RangeExceedsLimit"'
+ - name: refreshWorkbookLinksBlocked
+ uid: 'excel!Excel.ErrorCodes.refreshWorkbookLinksBlocked:member'
+ package: excel!
+ summary: ''
+ value: '"RefreshWorkbookLinksBlocked"'
+ - name: requestAborted
+ uid: 'excel!Excel.ErrorCodes.requestAborted:member'
+ package: excel!
+ summary: ''
+ value: '"RequestAborted"'
+ - name: responsePayloadSizeLimitExceeded
+ uid: 'excel!Excel.ErrorCodes.responsePayloadSizeLimitExceeded:member'
+ package: excel!
+ summary: ''
+ value: '"ResponsePayloadSizeLimitExceeded"'
+ - name: unsupportedFeature
+ uid: 'excel!Excel.ErrorCodes.unsupportedFeature:member'
+ package: excel!
+ summary: ''
+ value: '"UnsupportedFeature"'
+ - name: unsupportedFillType
+ uid: 'excel!Excel.ErrorCodes.unsupportedFillType:member'
+ package: excel!
+ summary: ''
+ value: '"UnsupportedFillType"'
+ - name: unsupportedOperation
+ uid: 'excel!Excel.ErrorCodes.unsupportedOperation:member'
+ package: excel!
+ summary: ''
+ value: '"UnsupportedOperation"'
+ - name: unsupportedSheet
+ uid: 'excel!Excel.ErrorCodes.unsupportedSheet:member'
+ package: excel!
+ summary: ''
+ value: '"UnsupportedSheet"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.eventsource.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.eventsource.yml
new file mode 100644
index 0000000000..e08fccfd50
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.eventsource.yml
@@ -0,0 +1,26 @@
+### YamlMime:TSEnum
+name: Excel.EventSource
+uid: 'excel!Excel.EventSource:enum'
+package: excel!
+fullName: Excel.EventSource
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: local
+ uid: 'excel!Excel.EventSource.local:member'
+ package: excel!
+ summary: |-
+ Local means the event comes from a local user session.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Local"'
+ - name: remote
+ uid: 'excel!Excel.EventSource.remote:member'
+ package: excel!
+ summary: |-
+ Remote means the event comes from a remote user session.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Remote"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.eventtriggersource.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.eventtriggersource.yml
new file mode 100644
index 0000000000..0dc1d74adb
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.eventtriggersource.yml
@@ -0,0 +1,26 @@
+### YamlMime:TSEnum
+name: Excel.EventTriggerSource
+uid: 'excel!Excel.EventTriggerSource:enum'
+package: excel!
+fullName: Excel.EventTriggerSource
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: thisLocalAddin
+ uid: 'excel!Excel.EventTriggerSource.thisLocalAddin:member'
+ package: excel!
+ summary: |-
+ The event is triggered by the Office JS API of the current add-in.
+
+ * \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ThisLocalAddin"'
+ - name: unknown
+ uid: 'excel!Excel.EventTriggerSource.unknown:member'
+ package: excel!
+ summary: |-
+ The event trigger source is unknown or currently unsupported.
+
+ * \[ [API set: ExcelApi 1.14](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.eventtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.eventtype.yml
new file mode 100644
index 0000000000..2158b3230d
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.eventtype.yml
@@ -0,0 +1,430 @@
+### YamlMime:TSEnum
+name: Excel.EventType
+uid: 'excel!Excel.EventType:enum'
+package: excel!
+fullName: Excel.EventType
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: agaveVisualUpdate
+ uid: 'excel!Excel.EventType.agaveVisualUpdate:member'
+ package: excel!
+ summary: >-
+ `AgaveVisualUpdate` represents the type of an event that is associated with an agave visual and carries a new data
+ view following a data change.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"AgaveVisualUpdate"'
+ - name: chartActivated
+ uid: 'excel!Excel.EventType.chartActivated:member'
+ package: excel!
+ summary: >-
+ `ChartActivated` represents the type of event registered on a `Chart` or `ChartCollection` and occurs when a chart
+ activates.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ChartActivated"'
+ - name: chartAdded
+ uid: 'excel!Excel.EventType.chartAdded:member'
+ package: excel!
+ summary: >-
+ `ChartAdded` represents the type of event registered on a `ChartCollection` and occurs when a new chart is added
+ to the worksheet.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ChartAdded"'
+ - name: chartDeactivated
+ uid: 'excel!Excel.EventType.chartDeactivated:member'
+ package: excel!
+ summary: >-
+ `ChartDeactivated` represents the type of event registered on a `Chart` or `ChartCollection` and occurs when a
+ chart deactivates.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ChartDeactivated"'
+ - name: chartDeleted
+ uid: 'excel!Excel.EventType.chartDeleted:member'
+ package: excel!
+ summary: >-
+ `ChartDeleted` represents the type of event registered on a `ChartCollection` and occurs when a chart is deleted
+ from the worksheet.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ChartDeleted"'
+ - name: commentAdded
+ uid: 'excel!Excel.EventType.commentAdded:member'
+ package: excel!
+ summary: >-
+ `CommentAdded` represents the type of event that is registered on a comment collection and occurs when comments
+ are added.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CommentAdded"'
+ - name: commentChanged
+ uid: 'excel!Excel.EventType.commentChanged:member'
+ package: excel!
+ summary: >-
+ `CommentChanged` represents the type of event that is registered on a comment collection and occurs when comments
+ are changed.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CommentChanged"'
+ - name: commentDeleted
+ uid: 'excel!Excel.EventType.commentDeleted:member'
+ package: excel!
+ summary: >-
+ `CommentDeleted` represents the type of event that is registered on a comment collection and occurs when comments
+ are deleted.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"CommentDeleted"'
+ - name: lineageActivityUpdateAvailable
+ uid: 'excel!Excel.EventType.lineageActivityUpdateAvailable:member'
+ package: excel!
+ summary: |-
+ LineageActivityUpdateAvailable represents the type of event registered when new revision updates lineage model.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LineageActivityUpdateAvailable"'
+ - name: linkedDataTypeLinkedDataTypeAdded
+ uid: 'excel!Excel.EventType.linkedDataTypeLinkedDataTypeAdded:member'
+ package: excel!
+ summary: >-
+ `LinkedDataTypeAdded` represents the type of event registered on a `LinkedDataType` and occurs when a new linked
+ data type is added to the workbook.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LinkedDataTypeLinkedDataTypeAdded"'
+ - name: linkedDataTypeRefreshModeChanged
+ uid: 'excel!Excel.EventType.linkedDataTypeRefreshModeChanged:member'
+ package: excel!
+ summary: >-
+ `RefreshModeChanged` represents the type of event registered on a `LinkedDataType` and occurs when the linked data
+ type refresh mode is changed.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LinkedDataTypeRefreshModeChanged"'
+ - name: linkedDataTypeRefreshRequestCompleted
+ uid: 'excel!Excel.EventType.linkedDataTypeRefreshRequestCompleted:member'
+ package: excel!
+ summary: >-
+ `RefreshRequestCompleted` represents the type of event registered on a `LinkedDataType` and occurs when a request
+ to refresh a data source is completed.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LinkedDataTypeRefreshRequestCompleted"'
+ - name: linkedWorkbookRefreshCompleted
+ uid: 'excel!Excel.EventType.linkedWorkbookRefreshCompleted:member'
+ package: excel!
+ summary: >-
+ `WorkbookLinksRefreshCompleted` represents the type of event registered on a linked Workbook and occurs when a
+ linked workbook completes a refresh.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LinkedWorkbookRefreshCompleted"'
+ - name: linkedWorkbookWorkbookLinksChanged
+ uid: 'excel!Excel.EventType.linkedWorkbookWorkbookLinksChanged:member'
+ package: excel!
+ summary: |-
+ `WorkbookLinksChanged` represents the type of event which is fired when a workbook link is changed.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"LinkedWorkbookWorkbookLinksChanged"'
+ - name: ribbonCommandExecuted
+ uid: 'excel!Excel.EventType.ribbonCommandExecuted:member'
+ package: excel!
+ summary: >-
+ `RibbonCommandExecuted` represents the type of event registered on the ribbon and occurs when a user clicks on the
+ ribbon
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RibbonCommandExecuted"'
+ - name: shapeActivated
+ uid: 'excel!Excel.EventType.shapeActivated:member'
+ package: excel!
+ summary: |-
+ `ShapeActivated` represents the type of event that is registered on a `Shape` and occurs when the shape activates.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ShapeActivated"'
+ - name: shapeDeactivated
+ uid: 'excel!Excel.EventType.shapeDeactivated:member'
+ package: excel!
+ summary: >-
+ `ShapeDeactivated` represents the type of event that is registered on a `Shape` and occurs when the shape
+ deactivates.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"ShapeDeactivated"'
+ - name: tableAdded
+ uid: 'excel!Excel.EventType.tableAdded:member'
+ package: excel!
+ summary: |-
+ `TableAdded` represents the type of event registered on a `TableCollection` and occurs when a table is added.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TableAdded"'
+ - name: tableChanged
+ uid: 'excel!Excel.EventType.tableChanged:member'
+ package: excel!
+ summary: |-
+ `TableChanged` represents the type of event registered on a `Table` and occurs when data changes.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TableChanged"'
+ - name: tableDeleted
+ uid: 'excel!Excel.EventType.tableDeleted:member'
+ package: excel!
+ summary: >-
+ `TableDeleted` represents the type of event that is registered on a `TableCollection` and occurs when a table is
+ deleted.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TableDeleted"'
+ - name: tableFiltered
+ uid: 'excel!Excel.EventType.tableFiltered:member'
+ package: excel!
+ summary: >-
+ `TableFiltered` represents the type of event registered on a table or `TableCollection` and occurs when the data
+ of a table is filtered.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TableFiltered"'
+ - name: tableSelectionChanged
+ uid: 'excel!Excel.EventType.tableSelectionChanged:member'
+ package: excel!
+ summary: >-
+ `TableSelectionChanged` represents the type of event registered on a `Table` and occurs when the selection
+ changes.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"TableSelectionChanged"'
+ - name: visualChange
+ uid: 'excel!Excel.EventType.visualChange:member'
+ package: excel!
+ summary: |-
+ `VisualChange` represents the type of event registered on a `Visual` and occurs when there is a visual change.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VisualChange"'
+ - name: visualSelectionChanged
+ uid: 'excel!Excel.EventType.visualSelectionChanged:member'
+ package: excel!
+ summary: >-
+ `VisualSelectionChanged` represents the type of event registered on a `VisualCollection` and occurs when the
+ visual selection changes.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"VisualSelectionChanged"'
+ - name: workbookActivated
+ uid: 'excel!Excel.EventType.workbookActivated:member'
+ package: excel!
+ summary: |-
+ `WorkbookActivated` represents the type of event which is fired when a workbook is activated.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorkbookActivated"'
+ - name: workbookAutoSaveSettingChanged
+ uid: 'excel!Excel.EventType.workbookAutoSaveSettingChanged:member'
+ package: excel!
+ summary: >-
+ `WorkbookAutoSaveSettingChanged` represents the type of event registered on a workbook and occurs when there is an
+ auto save setting change.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorkbookAutoSaveSettingChanged"'
+ - name: worksheetActivated
+ uid: 'excel!Excel.EventType.worksheetActivated:member'
+ package: excel!
+ summary: >-
+ `WorksheetActivated` represents the type of event registered on a `Worksheet` or `WorksheetCollection` and occurs
+ when a worksheet activates.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetActivated"'
+ - name: worksheetAdded
+ uid: 'excel!Excel.EventType.worksheetAdded:member'
+ package: excel!
+ summary: >-
+ `WorksheetAdded` represents the type of event registered on a `WorksheetCollection` and occurs when a new
+ worksheet is added to the workbook.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetAdded"'
+ - name: worksheetCalculated
+ uid: 'excel!Excel.EventType.worksheetCalculated:member'
+ package: excel!
+ summary: >-
+ `WorksheetCalculated` represents the type of event registered on a `Worksheet` or `WorksheetCollection` and occurs
+ when a worksheet is calculated.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetCalculated"'
+ - name: worksheetChanged
+ uid: 'excel!Excel.EventType.worksheetChanged:member'
+ package: excel!
+ summary: >-
+ `WorksheetChanged` represents the type of event registered on a `Worksheet` or `WorksheetCollection` and occurs
+ when data changes.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetChanged"'
+ - name: worksheetColumnSorted
+ uid: 'excel!Excel.EventType.worksheetColumnSorted:member'
+ package: excel!
+ summary: |-
+ `WorksheetColumnSorted` represents the type of event registered on a worksheet and occurs columns are sorted.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetColumnSorted"'
+ - name: worksheetDeactivated
+ uid: 'excel!Excel.EventType.worksheetDeactivated:member'
+ package: excel!
+ summary: >-
+ `WorksheetDeactivated` represents the type of event registered on a `Worksheet` or `WorksheetCollection` and
+ occurs when a worksheet deactivates.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetDeactivated"'
+ - name: worksheetDeleted
+ uid: 'excel!Excel.EventType.worksheetDeleted:member'
+ package: excel!
+ summary: >-
+ `WorksheetDeleted` represents the type of event registered on a `WorksheetCollection` and occurs when a worksheet
+ is deleted from the workbook.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetDeleted"'
+ - name: worksheetFiltered
+ uid: 'excel!Excel.EventType.worksheetFiltered:member'
+ package: excel!
+ summary: >-
+ `WorksheetFiltered` represents the type of event registered on a worksheet or `WorksheetCollection` and occurs
+ when the data of an AutoFilter in the worksheet is filtered.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetFiltered"'
+ - name: worksheetFormatChanged
+ uid: 'excel!Excel.EventType.worksheetFormatChanged:member'
+ package: excel!
+ summary: >-
+ `WorksheetFormatChanged` represents the type of event registered on a worksheet and occurs when a format is
+ changed.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetFormatChanged"'
+ - name: worksheetFormulaChanged
+ uid: 'excel!Excel.EventType.worksheetFormulaChanged:member'
+ package: excel!
+ summary: >-
+ `WorksheetFormulaChanged` represents the type of event registered on a worksheet and occurs when a formula is
+ changed.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetFormulaChanged"'
+ - name: worksheetMoved
+ uid: 'excel!Excel.EventType.worksheetMoved:member'
+ package: excel!
+ summary: >-
+ WorksheetMoved represents the type of event registered on a worksheet that occurs when it is moved within a
+ workbook.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetMoved"'
+ - name: worksheetNameChanged
+ uid: 'excel!Excel.EventType.worksheetNameChanged:member'
+ package: excel!
+ summary: |-
+ WorksheetNameChanged represents the type of event registered on a worksheet that occurs when its name changes.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetNameChanged"'
+ - name: worksheetProtectionChanged
+ uid: 'excel!Excel.EventType.worksheetProtectionChanged:member'
+ package: excel!
+ summary: >-
+ WorksheetProtectionChanged represents the type of event registered on worksheet, and occurs when protection status
+ is changed.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetProtectionChanged"'
+ - name: worksheetRowHiddenChanged
+ uid: 'excel!Excel.EventType.worksheetRowHiddenChanged:member'
+ package: excel!
+ summary: >-
+ `WorksheetRowHiddenChanged` represents the type of event registered on a worksheet and occurs when a row's hidden
+ state is changed.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetRowHiddenChanged"'
+ - name: worksheetRowSorted
+ uid: 'excel!Excel.EventType.worksheetRowSorted:member'
+ package: excel!
+ summary: |-
+ `WorksheetRowSorted` represents the type of event registered on a worksheet and occurs when rows are sorted.
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetRowSorted"'
+ - name: worksheetSelectionChanged
+ uid: 'excel!Excel.EventType.worksheetSelectionChanged:member'
+ package: excel!
+ summary: >-
+ `WorksheetSelectionChanged` represents the type of event registered on a `Worksheet` and occurs when the selection
+ changes.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetSelectionChanged"'
+ - name: worksheetSingleClicked
+ uid: 'excel!Excel.EventType.worksheetSingleClicked:member'
+ package: excel!
+ summary: >-
+ `WorksheetSingleClicked` represents the type of event registered on a worksheet and occurs when a cell is
+ left-clicked or tapped.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetSingleClicked"'
+ - name: worksheetVisibilityChanged
+ uid: 'excel!Excel.EventType.worksheetVisibilityChanged:member'
+ package: excel!
+ summary: >-
+ WorksheetVisibilityChanged represents the type of event registered on a worksheet that occurs when its visibility
+ changes.
+
+
+ * \[ [API set: ExcelApi 1.7](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WorksheetVisibilityChanged"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.externalerrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.externalerrorcellvalue.yml
new file mode 100644
index 0000000000..9daa650016
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.externalerrorcellvalue.yml
@@ -0,0 +1,74 @@
+### YamlMime:TSType
+name: Excel.ExternalErrorCellValue
+uid: 'excel!Excel.ExternalErrorCellValue:interface'
+package: excel!
+fullName: Excel.ExternalErrorCellValue
+summary: 'Represents the value of a cell containing an \#EXTERNAL! error.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.ExternalErrorCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.ExternalErrorCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#EXTERNAL!" | string;'
+ return:
+ type: '"#EXTERNAL!" | string'
+ - name: errorSubType
+ uid: 'excel!Excel.ExternalErrorCellValue#errorSubType:member'
+ package: excel!
+ fullName: errorSubType
+ summary: Represents the type of `ExternalErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorSubType?: ExternalErrorCellValueSubType | "Unknown";'
+ return:
+ type: ' | "Unknown"'
+ - name: errorType
+ uid: 'excel!Excel.ExternalErrorCellValue#errorType:member'
+ package: excel!
+ fullName: errorType
+ summary: Represents the type of `ErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorType?: ErrorCellValueType.external | "External";'
+ return:
+ type: ' | "External"'
+ - name: type
+ uid: 'excel!Excel.ExternalErrorCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.externalerrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.externalerrorcellvaluesubtype.yml
new file mode 100644
index 0000000000..c7a532b0ef
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.externalerrorcellvaluesubtype.yml
@@ -0,0 +1,18 @@
+### YamlMime:TSEnum
+name: Excel.ExternalErrorCellValueSubType
+uid: 'excel!Excel.ExternalErrorCellValueSubType:enum'
+package: excel!
+fullName: Excel.ExternalErrorCellValueSubType
+summary: 'Represents types of \#EXTERNAL! errors.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: unknown
+ uid: 'excel!Excel.ExternalErrorCellValueSubType.unknown:member'
+ package: excel!
+ summary: |-
+ An unknown type of error. Displays as error type \#EXTERNAL! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fielderrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fielderrorcellvalue.yml
new file mode 100644
index 0000000000..9d9d7d29a2
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fielderrorcellvalue.yml
@@ -0,0 +1,90 @@
+### YamlMime:TSType
+name: Excel.FieldErrorCellValue
+uid: 'excel!Excel.FieldErrorCellValue:interface'
+package: excel!
+fullName: Excel.FieldErrorCellValue
+summary: 'Represents the value of a cell containing a \#FIELD! error.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.FieldErrorCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
+ - name: basicValue
+ uid: 'excel!Excel.FieldErrorCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: >-
+ Represents the value that would be returned by `Range.values` for a cell with this value. When accessed through a
+ `valuesAsJson` property, this string value aligns with the en-US locale. When accessed through a
+ `valuesAsJsonLocal` property, this string value aligns with the user's display locale.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue?: "#FIELD!" | string;'
+ return:
+ type: '"#FIELD!" | string'
+ - name: errorSubType
+ uid: 'excel!Excel.FieldErrorCellValue#errorSubType:member'
+ package: excel!
+ fullName: errorSubType
+ summary: Represents the type of `FieldErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ errorSubType?: FieldErrorCellValueSubType | "Unknown" | "WebImageMissingFilePart" | "DataProviderError" |
+ "RichValueRelMissingFilePart";
+ return:
+ type: >-
+ | "Unknown" | "WebImageMissingFilePart" |
+ "DataProviderError" | "RichValueRelMissingFilePart"
+ - name: errorType
+ uid: 'excel!Excel.FieldErrorCellValue#errorType:member'
+ package: excel!
+ fullName: errorType
+ summary: Represents the type of `ErrorCellValue`.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'errorType?: ErrorCellValueType.field | "Field";'
+ return:
+ type: ' | "Field"'
+ - name: fieldName
+ uid: 'excel!Excel.FieldErrorCellValue#fieldName:member'
+ package: excel!
+ fullName: fieldName
+ summary: Represents the field which was not found by FIELDVALUE.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fieldName?: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.FieldErrorCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.error | "Error";'
+ return:
+ type: ' | "Error"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fielderrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fielderrorcellvaluesubtype.yml
new file mode 100644
index 0000000000..e60693a0d3
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fielderrorcellvaluesubtype.yml
@@ -0,0 +1,46 @@
+### YamlMime:TSEnum
+name: Excel.FieldErrorCellValueSubType
+uid: 'excel!Excel.FieldErrorCellValueSubType:enum'
+package: excel!
+fullName: Excel.FieldErrorCellValueSubType
+summary: 'Represents types of \#FIELD! errors.'
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: dataProviderError
+ uid: 'excel!Excel.FieldErrorCellValueSubType.dataProviderError:member'
+ package: excel!
+ summary: |-
+ An error caused by an error from a data provider. Displays as error type \#FIELD! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"DataProviderError"'
+ - name: richValueRelMissingFilePart
+ uid: 'excel!Excel.FieldErrorCellValueSubType.richValueRelMissingFilePart:member'
+ package: excel!
+ summary: >-
+ An error caused by a missing file. In this case, the RichValueRel.xml file is missing from the metro package.
+ Displays as error type \#FIELD! in Excel.
+
+
+ * \[ [API set: 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"RichValueRelMissingFilePart"'
+ - name: unknown
+ uid: 'excel!Excel.FieldErrorCellValueSubType.unknown:member'
+ package: excel!
+ summary: |-
+ An unknown type of error. Displays as error type \#FIELD! in Excel.
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"Unknown"'
+ - name: webImageMissingFilePart
+ uid: 'excel!Excel.FieldErrorCellValueSubType.webImageMissingFilePart:member'
+ package: excel!
+ summary: >-
+ An error caused by a missing file. In this case, the RichValueWebImageValue.xml file is missing from the metro
+ package. Displays as error type \#FIELD! in Excel.
+
+
+ * \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+ value: '"WebImageMissingFilePart"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fillpattern.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fillpattern.yml
new file mode 100644
index 0000000000..8177a9d229
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fillpattern.yml
@@ -0,0 +1,199 @@
+### YamlMime:TSEnum
+name: Excel.FillPattern
+uid: 'excel!Excel.FillPattern:enum'
+package: excel!
+fullName: Excel.FillPattern
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Creating the SettableCellProperties objects to use for the range.
+ // In your add-in, these should be created once, outside the function.
+ const topHeaderProps: Excel.SettableCellProperties = {
+ // The style property takes a string matching the name of an Excel style.
+ // Built-in style names are listed in the `BuiltInStyle` enum.
+ // Note that a style will overwrite any formatting,
+ // so do not use the format property with the style property.
+ style: "Heading1"
+ };
+
+ const headerProps: Excel.SettableCellProperties = {
+ // Any subproperties of format that are not set will not be changed when these cell properties are set.
+ format: {
+ fill: {
+ color: "Blue"
+ },
+ font: {
+ color: "White",
+ bold: true
+ }
+ }
+ };
+
+ const nonApplicableProps: Excel.SettableCellProperties = {
+ format: {
+ fill: {
+ pattern: Excel.FillPattern.gray25
+ },
+ font: {
+ color: "Gray",
+ italic: true
+ }
+ }
+ };
+
+ const matchupScoreProps: Excel.SettableCellProperties = {
+ format: {
+ borders: {
+ bottom: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ left: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ right: {
+ style: Excel.BorderLineStyle.continuous
+ },
+ top: {
+ style: Excel.BorderLineStyle.continuous
+ }
+ }
+ }
+ };
+
+ const range = sheet.getRange("A1:E5");
+
+ // You can use empty JSON objects to avoid changing a cell's properties.
+ range.setCellProperties([
+ [topHeaderProps, {}, {}, {}, {}],
+ [{}, {}, headerProps, headerProps, headerProps],
+ [{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
+ [{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
+ ]);
+
+ sheet.getUsedRange().format.autofitColumns();
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: checker
+ uid: 'excel!Excel.FillPattern.checker:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Checker"'
+ - name: crissCross
+ uid: 'excel!Excel.FillPattern.crissCross:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CrissCross"'
+ - name: down
+ uid: 'excel!Excel.FillPattern.down:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Down"'
+ - name: gray16
+ uid: 'excel!Excel.FillPattern.gray16:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Gray16"'
+ - name: gray25
+ uid: 'excel!Excel.FillPattern.gray25:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Gray25"'
+ - name: gray50
+ uid: 'excel!Excel.FillPattern.gray50:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Gray50"'
+ - name: gray75
+ uid: 'excel!Excel.FillPattern.gray75:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Gray75"'
+ - name: gray8
+ uid: 'excel!Excel.FillPattern.gray8:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Gray8"'
+ - name: grid
+ uid: 'excel!Excel.FillPattern.grid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Grid"'
+ - name: horizontal
+ uid: 'excel!Excel.FillPattern.horizontal:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Horizontal"'
+ - name: lightDown
+ uid: 'excel!Excel.FillPattern.lightDown:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LightDown"'
+ - name: lightHorizontal
+ uid: 'excel!Excel.FillPattern.lightHorizontal:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LightHorizontal"'
+ - name: lightUp
+ uid: 'excel!Excel.FillPattern.lightUp:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LightUp"'
+ - name: lightVertical
+ uid: 'excel!Excel.FillPattern.lightVertical:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LightVertical"'
+ - name: linearGradient
+ uid: 'excel!Excel.FillPattern.linearGradient:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"LinearGradient"'
+ - name: none
+ uid: 'excel!Excel.FillPattern.none:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"None"'
+ - name: rectangularGradient
+ uid: 'excel!Excel.FillPattern.rectangularGradient:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"RectangularGradient"'
+ - name: semiGray75
+ uid: 'excel!Excel.FillPattern.semiGray75:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"SemiGray75"'
+ - name: solid
+ uid: 'excel!Excel.FillPattern.solid:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Solid"'
+ - name: up
+ uid: 'excel!Excel.FillPattern.up:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Up"'
+ - name: vertical
+ uid: 'excel!Excel.FillPattern.vertical:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Vertical"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filter.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filter.yml
new file mode 100644
index 0000000000..f9c7c1add3
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filter.yml
@@ -0,0 +1,385 @@
+### YamlMime:TSType
+name: Excel.Filter
+uid: 'excel!Excel.Filter:class'
+package: excel!
+fullName: Excel.Filter
+summary: Manages the filtering of a table's column.
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.Filter#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: criteria
+ uid: 'excel!Excel.Filter#criteria:member'
+ package: excel!
+ fullName: criteria
+ summary: The currently applied filter on the given column.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly criteria: Excel.FilterCriteria;'
+ return:
+ type: ''
+methods:
+ - name: apply(criteria)
+ uid: 'excel!Excel.Filter#apply:member(1)'
+ package: excel!
+ fullName: apply(criteria)
+ summary: Apply the given filter criteria on the given column.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'apply(criteria: Excel.FilterCriteria): void;'
+ parameters:
+ - id: criteria
+ description: The criteria to apply.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: applyBottomItemsFilter(count)
+ uid: 'excel!Excel.Filter#applyBottomItemsFilter:member(1)'
+ package: excel!
+ fullName: applyBottomItemsFilter(count)
+ summary: Apply a "Bottom Item" filter to the column for the given number of elements.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyBottomItemsFilter(count: number): void;'
+ parameters:
+ - id: count
+ description: The number of elements from the bottom to show.
+ type: number
+ return:
+ type: void
+ description: ''
+ - name: applyBottomPercentFilter(percent)
+ uid: 'excel!Excel.Filter#applyBottomPercentFilter:member(1)'
+ package: excel!
+ fullName: applyBottomPercentFilter(percent)
+ summary: Apply a "Bottom Percent" filter to the column for the given percentage of elements.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyBottomPercentFilter(percent: number): void;'
+ parameters:
+ - id: percent
+ description: The percentage of elements from the bottom to show.
+ type: number
+ return:
+ type: void
+ description: ''
+ - name: applyCellColorFilter(color)
+ uid: 'excel!Excel.Filter#applyCellColorFilter:member(1)'
+ package: excel!
+ fullName: applyCellColorFilter(color)
+ summary: Apply a "Cell Color" filter to the column for the given color.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyCellColorFilter(color: string): void;'
+ parameters:
+ - id: color
+ description: The background color of the cells to show.
+ type: string
+ return:
+ type: void
+ description: ''
+ - name: 'applyCustomFilter(criteria1, criteria2, oper)'
+ uid: 'excel!Excel.Filter#applyCustomFilter:member(1)'
+ package: excel!
+ fullName: 'applyCustomFilter(criteria1, criteria2, oper)'
+ summary: Apply an "Icon" filter to the column for the given criteria strings.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyCustomFilter(criteria1: string, criteria2?: string, oper?: Excel.FilterOperator): void;'
+ parameters:
+ - id: criteria1
+ description: The first criteria string.
+ type: string
+ - id: criteria2
+ description: Optional. The second criteria string.
+ type: string
+ - id: oper
+ description: Optional. The operator that describes how the two criteria are joined.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: 'applyCustomFilter(criteria1, criteria2, operString)'
+ uid: 'excel!Excel.Filter#applyCustomFilter:member(2)'
+ package: excel!
+ fullName: 'applyCustomFilter(criteria1, criteria2, operString)'
+ summary: Apply an "Icon" filter to the column for the given criteria strings.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyCustomFilter(criteria1: string, criteria2?: string, operString?: "And" | "Or"): void;'
+ parameters:
+ - id: criteria1
+ description: The first criteria string.
+ type: string
+ - id: criteria2
+ description: Optional. The second criteria string.
+ type: string
+ - id: operString
+ description: Optional. The operator that describes how the two criteria are joined.
+ type: '"And" | "Or"'
+ return:
+ type: void
+ description: ''
+ - name: applyDynamicFilter(criteria)
+ uid: 'excel!Excel.Filter#applyDynamicFilter:member(1)'
+ package: excel!
+ fullName: applyDynamicFilter(criteria)
+ summary: Apply a "Dynamic" filter to the column.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyDynamicFilter(criteria: Excel.DynamicFilterCriteria): void;'
+ parameters:
+ - id: criteria
+ description: The dynamic criteria to apply.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: applyDynamicFilter(criteriaString)
+ uid: 'excel!Excel.Filter#applyDynamicFilter:member(2)'
+ package: excel!
+ fullName: applyDynamicFilter(criteriaString)
+ summary: Apply a "Dynamic" filter to the column.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ applyDynamicFilter(criteriaString: "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" |
+ "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember" | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary" |
+ "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" | "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" |
+ "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" | "AllDatesInPeriodQuarter1" | "AllDatesInPeriodQuarter2"
+ | "AllDatesInPeriodQuarter3" | "AllDatesInPeriodQuarter4" | "AllDatesInPeriodSeptember" | "BelowAverage" |
+ "LastMonth" | "LastQuarter" | "LastWeek" | "LastYear" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" |
+ "ThisMonth" | "ThisQuarter" | "ThisWeek" | "ThisYear" | "Today" | "Tomorrow" | "YearToDate" | "Yesterday"):
+ void;
+ parameters:
+ - id: criteriaString
+ description: The dynamic criteria to apply.
+ type: >-
+ "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" | "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember"
+ | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary" | "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" |
+ "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" | "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" |
+ "AllDatesInPeriodQuarter1" | "AllDatesInPeriodQuarter2" | "AllDatesInPeriodQuarter3" |
+ "AllDatesInPeriodQuarter4" | "AllDatesInPeriodSeptember" | "BelowAverage" | "LastMonth" | "LastQuarter" |
+ "LastWeek" | "LastYear" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" |
+ "ThisQuarter" | "ThisWeek" | "ThisYear" | "Today" | "Tomorrow" | "YearToDate" | "Yesterday"
+ return:
+ type: void
+ description: ''
+ - name: applyFontColorFilter(color)
+ uid: 'excel!Excel.Filter#applyFontColorFilter:member(1)'
+ package: excel!
+ fullName: applyFontColorFilter(color)
+ summary: Apply a "Font Color" filter to the column for the given color.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyFontColorFilter(color: string): void;'
+ parameters:
+ - id: color
+ description: The font color of the cells to show.
+ type: string
+ return:
+ type: void
+ description: ''
+ - name: applyIconFilter(icon)
+ uid: 'excel!Excel.Filter#applyIconFilter:member(1)'
+ package: excel!
+ fullName: applyIconFilter(icon)
+ summary: Apply an "Icon" filter to the column for the given icon.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyIconFilter(icon: Excel.Icon): void;'
+ parameters:
+ - id: icon
+ description: The icons of the cells to show.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: applyTopItemsFilter(count)
+ uid: 'excel!Excel.Filter#applyTopItemsFilter:member(1)'
+ package: excel!
+ fullName: applyTopItemsFilter(count)
+ summary: Apply a "Top Item" filter to the column for the given number of elements.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyTopItemsFilter(count: number): void;'
+ parameters:
+ - id: count
+ description: The number of elements from the top to show.
+ type: number
+ return:
+ type: void
+ description: ''
+ - name: applyTopPercentFilter(percent)
+ uid: 'excel!Excel.Filter#applyTopPercentFilter:member(1)'
+ package: excel!
+ fullName: applyTopPercentFilter(percent)
+ summary: Apply a "Top Percent" filter to the column for the given percentage of elements.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyTopPercentFilter(percent: number): void;'
+ parameters:
+ - id: percent
+ description: The percentage of elements from the top to show.
+ type: number
+ return:
+ type: void
+ description: ''
+ - name: applyValuesFilter(values)
+ uid: 'excel!Excel.Filter#applyValuesFilter:member(1)'
+ package: excel!
+ fullName: applyValuesFilter(values)
+ summary: Apply a "Values" filter to the column for the given values.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'applyValuesFilter(values: Array): void;'
+ parameters:
+ - id: values
+ description: The list of values to show. This must be an array of strings or an array of `Excel.FilterDateTime` objects.
+ type: 'Array<string | >'
+ return:
+ type: void
+ description: ''
+ - name: clear()
+ uid: 'excel!Excel.Filter#clear:member(1)'
+ package: excel!
+ fullName: clear()
+ summary: Clear the filter on the given column.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clear(): void;'
+ return:
+ type: void
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.Filter#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.FilterLoadOptions): Excel.Filter;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.Filter#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.Filter;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.Filter#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.Filter;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.Filter#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.Filter object is an API object, the `toJSON` method returns a plain
+ JavaScript object (typed as `Excel.Interfaces.FilterData`) that contains shallow copies of any loaded
+ child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.FilterData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filtercriteria.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filtercriteria.yml
new file mode 100644
index 0000000000..005a5fe88a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filtercriteria.yml
@@ -0,0 +1,176 @@
+### YamlMime:TSType
+name: Excel.FilterCriteria
+uid: 'excel!Excel.FilterCriteria:interface'
+package: excel!
+fullName: Excel.FilterCriteria
+summary: Represents the filtering criteria applied to a column.
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: color
+ uid: 'excel!Excel.FilterCriteria#color:member'
+ package: excel!
+ fullName: color
+ summary: The HTML color string used to filter cells. Used with `cellColor` and `fontColor` filtering.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'color?: string;'
+ return:
+ type: string
+ - name: criterion1
+ uid: 'excel!Excel.FilterCriteria#criterion1:member'
+ package: excel!
+ fullName: criterion1
+ summary: >-
+ The first criterion used to filter data. Used as an operator in the case of `custom` filtering. For example ">50" for numbers greater than 50, or "=*s" for values ending in "s".
+
+
+ Used as a number in the case of top/bottom items/percents (e.g., "5" for the top 5 items if `filterOn` is set to
+ `topItems`).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'criterion1?: string;'
+ return:
+ type: string
+ - name: criterion2
+ uid: 'excel!Excel.FilterCriteria#criterion2:member'
+ package: excel!
+ fullName: criterion2
+ summary: The second criterion used to filter data. Only used as an operator in the case of `custom` filtering.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'criterion2?: string;'
+ return:
+ type: string
+ - name: dynamicCriteria
+ uid: 'excel!Excel.FilterCriteria#dynamicCriteria:member'
+ package: excel!
+ fullName: dynamicCriteria
+ summary: >-
+ The dynamic criteria from the `Excel.DynamicFilterCriteria` set to apply on this column. Used with `dynamic`
+ filtering.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ dynamicCriteria?: Excel.DynamicFilterCriteria | "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" |
+ "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember" | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary" |
+ "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" | "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" |
+ "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" | "AllDatesInPeriodQuarter1" | "AllDatesInPeriodQuarter2"
+ | "AllDatesInPeriodQuarter3" | "AllDatesInPeriodQuarter4" | "AllDatesInPeriodSeptember" | "BelowAverage" |
+ "LastMonth" | "LastQuarter" | "LastWeek" | "LastYear" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" |
+ "ThisMonth" | "ThisQuarter" | "ThisWeek" | "ThisYear" | "Today" | "Tomorrow" | "YearToDate" | "Yesterday";
+ return:
+ type: >-
+ | "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" |
+ "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember" | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary"
+ | "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" | "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" |
+ "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" | "AllDatesInPeriodQuarter1" |
+ "AllDatesInPeriodQuarter2" | "AllDatesInPeriodQuarter3" | "AllDatesInPeriodQuarter4" |
+ "AllDatesInPeriodSeptember" | "BelowAverage" | "LastMonth" | "LastQuarter" | "LastWeek" | "LastYear" |
+ "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" | "ThisQuarter" | "ThisWeek" | "ThisYear"
+ | "Today" | "Tomorrow" | "YearToDate" | "Yesterday"
+ - name: filterOn
+ uid: 'excel!Excel.FilterCriteria#filterOn:member'
+ package: excel!
+ fullName: filterOn
+ summary: The property used by the filter to determine whether the values should stay visible.
+ remarks: >-
+ \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml
+
+ // This function adds a percentage AutoFilter to the active worksheet
+
+ // and applies the filter to a column of the used range.
+
+ await Excel.run(async (context) => {
+ // Retrieve the active worksheet and the used range on that worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+ const farmData = sheet.getUsedRange();
+
+ // Add a filter that will only show the rows with the top 50% of values in column 3.
+ sheet.autoFilter.apply(farmData, 3, {
+ criterion1: "50",
+ filterOn: Excel.FilterOn.topPercent
+ });
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ filterOn: Excel.FilterOn | "BottomItems" | "BottomPercent" | "CellColor" | "Dynamic" | "FontColor" | "Values" |
+ "TopItems" | "TopPercent" | "Icon" | "Custom";
+ return:
+ type: >-
+ | "BottomItems" | "BottomPercent" | "CellColor" | "Dynamic" |
+ "FontColor" | "Values" | "TopItems" | "TopPercent" | "Icon" | "Custom"
+ - name: icon
+ uid: 'excel!Excel.FilterCriteria#icon:member'
+ package: excel!
+ fullName: icon
+ summary: The icon used to filter cells. Used with `icon` filtering.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'icon?: Excel.Icon;'
+ return:
+ type: ''
+ - name: operator
+ uid: 'excel!Excel.FilterCriteria#operator:member'
+ package: excel!
+ fullName: operator
+ summary: The operator used to combine criterion 1 and 2 when using `custom` filtering.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'operator?: Excel.FilterOperator | "And" | "Or";'
+ return:
+ type: ' | "And" | "Or"'
+ - name: subField
+ uid: 'excel!Excel.FilterCriteria#subField:member'
+ package: excel!
+ fullName: subField
+ summary: The property used by the filter to do a rich filter on rich values.
+ remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'subField?: string;'
+ return:
+ type: string
+ - name: values
+ uid: 'excel!Excel.FilterCriteria#values:member'
+ package: excel!
+ fullName: values
+ summary: The set of values to be used as part of `values` filtering.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'values?: Array;'
+ return:
+ type: 'Array<string | >'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filterdatetime.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterdatetime.yml
new file mode 100644
index 0000000000..8b1425b1f5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterdatetime.yml
@@ -0,0 +1,39 @@
+### YamlMime:TSType
+name: Excel.FilterDatetime
+uid: 'excel!Excel.FilterDatetime:interface'
+package: excel!
+fullName: Excel.FilterDatetime
+summary: Represents how to filter a date when filtering on values.
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: date
+ uid: 'excel!Excel.FilterDatetime#date:member'
+ package: excel!
+ fullName: date
+ summary: The date in ISO8601 format used to filter data.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'date: string;'
+ return:
+ type: string
+ - name: specificity
+ uid: 'excel!Excel.FilterDatetime#specificity:member'
+ package: excel!
+ fullName: specificity
+ summary: >-
+ How specific the date should be used to keep data. For example, if the date is 2005-04-02 and the specificity is
+ set to "month", the filter operation will keep all rows with a date in the month of April 2005.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'specificity: Excel.FilterDatetimeSpecificity | "Year" | "Month" | "Day" | "Hour" | "Minute" | "Second";'
+ return:
+ type: >-
+ | "Year" | "Month" | "Day" | "Hour" | "Minute" |
+ "Second"
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filterdatetimespecificity.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterdatetimespecificity.yml
new file mode 100644
index 0000000000..0f68fe42a7
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterdatetimespecificity.yml
@@ -0,0 +1,80 @@
+### YamlMime:TSEnum
+name: Excel.FilterDatetimeSpecificity
+uid: 'excel!Excel.FilterDatetimeSpecificity:enum'
+package: excel!
+fullName: Excel.FilterDatetimeSpecificity
+summary: ''
+remarks: >-
+ \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotfilters.yaml
+
+ await Excel.run(async (context) => {
+ // Add a date-based PivotFilter.
+
+ // Get the PivotTable.
+ const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");
+
+ // PivotFilters can only be applied to PivotHierarchies that are being used for pivoting.
+ // If it's not already there, add "Date Updated" to the hierarchies.
+ let dateHierarchy = pivotTable.rowHierarchies.getItemOrNullObject("Date Updated");
+ await context.sync();
+ if (dateHierarchy.isNullObject) {
+ dateHierarchy = pivotTable.rowHierarchies.add(pivotTable.hierarchies.getItem("Date Updated"));
+ }
+
+ // Apply a date filter to filter out anything logged before August.
+ const filterField = dateHierarchy.fields.getItem("Date Updated");
+ const dateFilter = {
+ condition: Excel.DateFilterCondition.afterOrEqualTo,
+ comparator: {
+ date: "2020-08-01",
+ specificity: Excel.FilterDatetimeSpecificity.month
+ }
+ };
+ filterField.applyFilter({ dateFilter: dateFilter });
+
+ await context.sync();
+ });
+
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: day
+ uid: 'excel!Excel.FilterDatetimeSpecificity.day:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Day"'
+ - name: hour
+ uid: 'excel!Excel.FilterDatetimeSpecificity.hour:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Hour"'
+ - name: minute
+ uid: 'excel!Excel.FilterDatetimeSpecificity.minute:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Minute"'
+ - name: month
+ uid: 'excel!Excel.FilterDatetimeSpecificity.month:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Month"'
+ - name: second
+ uid: 'excel!Excel.FilterDatetimeSpecificity.second:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Second"'
+ - name: year
+ uid: 'excel!Excel.FilterDatetimeSpecificity.year:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Year"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filteron.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filteron.yml
new file mode 100644
index 0000000000..ebdaeebfd3
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filteron.yml
@@ -0,0 +1,81 @@
+### YamlMime:TSEnum
+name: Excel.FilterOn
+uid: 'excel!Excel.FilterOn:enum'
+package: excel!
+fullName: Excel.FilterOn
+summary: ''
+remarks: |-
+ \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+ #### Examples
+
+ ```typescript
+ // This function adds a custom AutoFilter to the active worksheet
+ // and applies the filter to a column of the used range.
+ await Excel.run(async (context) => {
+ // Retrieve the active worksheet and the used range on that worksheet.
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+ const farmData = sheet.getUsedRange();
+
+ // Add a filter that will only show the rows with values that end with the letter "e" in column 1.
+ sheet.autoFilter.apply(farmData, 1, {
+ criterion1: "=*e",
+ filterOn: Excel.FilterOn.custom
+ });
+
+ await context.sync();
+ });
+ ```
+isPreview: false
+isDeprecated: false
+fields:
+ - name: bottomItems
+ uid: 'excel!Excel.FilterOn.bottomItems:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BottomItems"'
+ - name: bottomPercent
+ uid: 'excel!Excel.FilterOn.bottomPercent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"BottomPercent"'
+ - name: cellColor
+ uid: 'excel!Excel.FilterOn.cellColor:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"CellColor"'
+ - name: custom
+ uid: 'excel!Excel.FilterOn.custom:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Custom"'
+ - name: dynamic
+ uid: 'excel!Excel.FilterOn.dynamic:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Dynamic"'
+ - name: fontColor
+ uid: 'excel!Excel.FilterOn.fontColor:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"FontColor"'
+ - name: icon
+ uid: 'excel!Excel.FilterOn.icon:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Icon"'
+ - name: topItems
+ uid: 'excel!Excel.FilterOn.topItems:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TopItems"'
+ - name: topPercent
+ uid: 'excel!Excel.FilterOn.topPercent:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"TopPercent"'
+ - name: values
+ uid: 'excel!Excel.FilterOn.values:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Values"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filteroperator.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filteroperator.yml
new file mode 100644
index 0000000000..ac130f3a98
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filteroperator.yml
@@ -0,0 +1,20 @@
+### YamlMime:TSEnum
+name: Excel.FilterOperator
+uid: 'excel!Excel.FilterOperator:enum'
+package: excel!
+fullName: Excel.FilterOperator
+summary: ''
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+fields:
+ - name: and
+ uid: 'excel!Excel.FilterOperator.and:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"And"'
+ - name: or
+ uid: 'excel!Excel.FilterOperator.or:member'
+ package: excel!
+ summary: '* \[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ value: '"Or"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filterpivothierarchy.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterpivothierarchy.yml
new file mode 100644
index 0000000000..1b6a5aaf87
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterpivothierarchy.yml
@@ -0,0 +1,226 @@
+### YamlMime:TSType
+name: Excel.FilterPivotHierarchy
+uid: 'excel!Excel.FilterPivotHierarchy:class'
+package: excel!
+fullName: Excel.FilterPivotHierarchy
+summary: Represents the Excel FilterPivotHierarchy.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.FilterPivotHierarchy#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: enableMultipleFilterItems
+ uid: 'excel!Excel.FilterPivotHierarchy#enableMultipleFilterItems:member'
+ package: excel!
+ fullName: enableMultipleFilterItems
+ summary: Determines whether to allow multiple filter items.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'enableMultipleFilterItems: boolean;'
+ return:
+ type: boolean
+ - name: fields
+ uid: 'excel!Excel.FilterPivotHierarchy#fields:member'
+ package: excel!
+ fullName: fields
+ summary: Returns the PivotFields associated with the FilterPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly fields: Excel.PivotFieldCollection;'
+ return:
+ type: ''
+ - name: id
+ uid: 'excel!Excel.FilterPivotHierarchy#id:member'
+ package: excel!
+ fullName: id
+ summary: ID of the FilterPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly id: string;'
+ return:
+ type: string
+ - name: name
+ uid: 'excel!Excel.FilterPivotHierarchy#name:member'
+ package: excel!
+ fullName: name
+ summary: Name of the FilterPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'name: string;'
+ return:
+ type: string
+ - name: position
+ uid: 'excel!Excel.FilterPivotHierarchy#position:member'
+ package: excel!
+ fullName: position
+ summary: Position of the FilterPivotHierarchy.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'position: number;'
+ return:
+ type: number
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.FilterPivotHierarchy#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.FilterPivotHierarchyLoadOptions): Excel.FilterPivotHierarchy;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.FilterPivotHierarchy#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.FilterPivotHierarchy;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.FilterPivotHierarchy#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.FilterPivotHierarchy;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.FilterPivotHierarchy#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.FilterPivotHierarchyUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.FilterPivotHierarchy#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.FilterPivotHierarchy): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: setToDefault()
+ uid: 'excel!Excel.FilterPivotHierarchy#setToDefault:member(1)'
+ package: excel!
+ fullName: setToDefault()
+ summary: Reset the FilterPivotHierarchy back to its default values.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'setToDefault(): void;'
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.FilterPivotHierarchy#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.FilterPivotHierarchy object is an API object, the `toJSON` method
+ returns a plain JavaScript object (typed as `Excel.Interfaces.FilterPivotHierarchyData`) that contains
+ shallow copies of any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.FilterPivotHierarchyData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.filterpivothierarchycollection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterpivothierarchycollection.yml
new file mode 100644
index 0000000000..f554fcbc32
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.filterpivothierarchycollection.yml
@@ -0,0 +1,208 @@
+### YamlMime:TSType
+name: Excel.FilterPivotHierarchyCollection
+uid: 'excel!Excel.FilterPivotHierarchyCollection:class'
+package: excel!
+fullName: Excel.FilterPivotHierarchyCollection
+summary: Represents a collection of FilterPivotHierarchy items associated with the PivotTable.
+remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: items
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#items:member'
+ package: excel!
+ fullName: items
+ summary: Gets the loaded child items in this collection.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly items: Excel.FilterPivotHierarchy[];'
+ return:
+ type: '[]'
+methods:
+ - name: add(pivotHierarchy)
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#add:member(1)'
+ package: excel!
+ fullName: add(pivotHierarchy)
+ summary: >-
+ Adds the PivotHierarchy to the current axis. If the hierarchy is present elsewhere on the row, column, or filter
+ axis, it will be removed from that location.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'add(pivotHierarchy: Excel.PivotHierarchy): Excel.FilterPivotHierarchy;'
+ parameters:
+ - id: pivotHierarchy
+ description: ''
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: getCount()
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#getCount:member(1)'
+ package: excel!
+ fullName: getCount()
+ summary: Gets the number of pivot hierarchies in the collection.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getCount(): OfficeExtension.ClientResult;'
+ return:
+ type: '<number>'
+ description: ''
+ - name: getItem(name)
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#getItem:member(1)'
+ package: excel!
+ fullName: getItem(name)
+ summary: Gets a FilterPivotHierarchy by its name or ID.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItem(name: string): Excel.FilterPivotHierarchy;'
+ parameters:
+ - id: name
+ description: Name of the FilterPivotHierarchy to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: getItemOrNullObject(name)
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#getItemOrNullObject:member(1)'
+ package: excel!
+ fullName: getItemOrNullObject(name)
+ summary: >-
+ Gets a FilterPivotHierarchy by name. If the FilterPivotHierarchy does not exist, then this method returns an
+ object with its `isNullObject` property set to `true`. For further information, see [*OrNullObject methods
+ and
+ properties](https://docs.microsoft.com/office/dev/add-ins/develop/application-specific-api-model#ornullobject-methods-and-properties).
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'getItemOrNullObject(name: string): Excel.FilterPivotHierarchy;'
+ parameters:
+ - id: name
+ description: Name of the FilterPivotHierarchy to be retrieved.
+ type: string
+ return:
+ type: ''
+ description: ''
+ - name: load(options)
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ load(options?: Excel.Interfaces.FilterPivotHierarchyCollectionLoadOptions &
+ Excel.Interfaces.CollectionLoadOptions): Excel.FilterPivotHierarchyCollection;
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: >-
+ &
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.FilterPivotHierarchyCollection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.FilterPivotHierarchyCollection;'
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: remove(filterPivotHierarchy)
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#remove:member(1)'
+ package: excel!
+ fullName: remove(filterPivotHierarchy)
+ summary: Removes the PivotHierarchy from the current axis.
+ remarks: '\[ [API set: ExcelApi 1.8](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'remove(filterPivotHierarchy: Excel.FilterPivotHierarchy): void;'
+ parameters:
+ - id: filterPivotHierarchy
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.FilterPivotHierarchyCollection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `Excel.FilterPivotHierarchyCollection` object is an API object, the `toJSON`
+ method returns a plain JavaScript object (typed as `Excel.Interfaces.FilterPivotHierarchyCollectionData`)
+ that contains an "items" array with shallow copies of any loaded properties from the collection's items.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.FilterPivotHierarchyCollectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fivearrowsgrayset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fivearrowsgrayset.yml
new file mode 100644
index 0000000000..c33e645f50
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fivearrowsgrayset.yml
@@ -0,0 +1,71 @@
+### YamlMime:TSType
+name: Excel.FiveArrowsGraySet
+uid: 'excel!Excel.FiveArrowsGraySet:interface'
+package: excel!
+fullName: Excel.FiveArrowsGraySet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: grayDownArrow
+ uid: 'excel!Excel.FiveArrowsGraySet#grayDownArrow:member'
+ package: excel!
+ fullName: grayDownArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayDownArrow: Icon;'
+ return:
+ type: ''
+ - name: grayDownInclineArrow
+ uid: 'excel!Excel.FiveArrowsGraySet#grayDownInclineArrow:member'
+ package: excel!
+ fullName: grayDownInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayDownInclineArrow: Icon;'
+ return:
+ type: ''
+ - name: graySideArrow
+ uid: 'excel!Excel.FiveArrowsGraySet#graySideArrow:member'
+ package: excel!
+ fullName: graySideArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'graySideArrow: Icon;'
+ return:
+ type: ''
+ - name: grayUpArrow
+ uid: 'excel!Excel.FiveArrowsGraySet#grayUpArrow:member'
+ package: excel!
+ fullName: grayUpArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayUpArrow: Icon;'
+ return:
+ type: ''
+ - name: grayUpInclineArrow
+ uid: 'excel!Excel.FiveArrowsGraySet#grayUpInclineArrow:member'
+ package: excel!
+ fullName: grayUpInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayUpInclineArrow: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fivearrowsset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fivearrowsset.yml
new file mode 100644
index 0000000000..d635e06d8c
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fivearrowsset.yml
@@ -0,0 +1,71 @@
+### YamlMime:TSType
+name: Excel.FiveArrowsSet
+uid: 'excel!Excel.FiveArrowsSet:interface'
+package: excel!
+fullName: Excel.FiveArrowsSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: greenUpArrow
+ uid: 'excel!Excel.FiveArrowsSet#greenUpArrow:member'
+ package: excel!
+ fullName: greenUpArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'greenUpArrow: Icon;'
+ return:
+ type: ''
+ - name: redDownArrow
+ uid: 'excel!Excel.FiveArrowsSet#redDownArrow:member'
+ package: excel!
+ fullName: redDownArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'redDownArrow: Icon;'
+ return:
+ type: ''
+ - name: yellowDownInclineArrow
+ uid: 'excel!Excel.FiveArrowsSet#yellowDownInclineArrow:member'
+ package: excel!
+ fullName: yellowDownInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'yellowDownInclineArrow: Icon;'
+ return:
+ type: ''
+ - name: yellowSideArrow
+ uid: 'excel!Excel.FiveArrowsSet#yellowSideArrow:member'
+ package: excel!
+ fullName: yellowSideArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'yellowSideArrow: Icon;'
+ return:
+ type: ''
+ - name: yellowUpInclineArrow
+ uid: 'excel!Excel.FiveArrowsSet#yellowUpInclineArrow:member'
+ package: excel!
+ fullName: yellowUpInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'yellowUpInclineArrow: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fiveboxesset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fiveboxesset.yml
new file mode 100644
index 0000000000..daa02b82d5
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fiveboxesset.yml
@@ -0,0 +1,71 @@
+### YamlMime:TSType
+name: Excel.FiveBoxesSet
+uid: 'excel!Excel.FiveBoxesSet:interface'
+package: excel!
+fullName: Excel.FiveBoxesSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: fourFilledBoxes
+ uid: 'excel!Excel.FiveBoxesSet#fourFilledBoxes:member'
+ package: excel!
+ fullName: fourFilledBoxes
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fourFilledBoxes: Icon;'
+ return:
+ type: ''
+ - name: noFilledBoxes
+ uid: 'excel!Excel.FiveBoxesSet#noFilledBoxes:member'
+ package: excel!
+ fullName: noFilledBoxes
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'noFilledBoxes: Icon;'
+ return:
+ type: ''
+ - name: oneFilledBox
+ uid: 'excel!Excel.FiveBoxesSet#oneFilledBox:member'
+ package: excel!
+ fullName: oneFilledBox
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'oneFilledBox: Icon;'
+ return:
+ type: ''
+ - name: threeFilledBoxes
+ uid: 'excel!Excel.FiveBoxesSet#threeFilledBoxes:member'
+ package: excel!
+ fullName: threeFilledBoxes
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'threeFilledBoxes: Icon;'
+ return:
+ type: ''
+ - name: twoFilledBoxes
+ uid: 'excel!Excel.FiveBoxesSet#twoFilledBoxes:member'
+ package: excel!
+ fullName: twoFilledBoxes
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'twoFilledBoxes: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fivequartersset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fivequartersset.yml
new file mode 100644
index 0000000000..dadcf10dd4
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fivequartersset.yml
@@ -0,0 +1,71 @@
+### YamlMime:TSType
+name: Excel.FiveQuartersSet
+uid: 'excel!Excel.FiveQuartersSet:interface'
+package: excel!
+fullName: Excel.FiveQuartersSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: blackCircle
+ uid: 'excel!Excel.FiveQuartersSet#blackCircle:member'
+ package: excel!
+ fullName: blackCircle
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'blackCircle: Icon;'
+ return:
+ type: ''
+ - name: circleWithOneWhiteQuarter
+ uid: 'excel!Excel.FiveQuartersSet#circleWithOneWhiteQuarter:member'
+ package: excel!
+ fullName: circleWithOneWhiteQuarter
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'circleWithOneWhiteQuarter: Icon;'
+ return:
+ type: ''
+ - name: circleWithThreeWhiteQuarters
+ uid: 'excel!Excel.FiveQuartersSet#circleWithThreeWhiteQuarters:member'
+ package: excel!
+ fullName: circleWithThreeWhiteQuarters
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'circleWithThreeWhiteQuarters: Icon;'
+ return:
+ type: ''
+ - name: circleWithTwoWhiteQuarters
+ uid: 'excel!Excel.FiveQuartersSet#circleWithTwoWhiteQuarters:member'
+ package: excel!
+ fullName: circleWithTwoWhiteQuarters
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'circleWithTwoWhiteQuarters: Icon;'
+ return:
+ type: ''
+ - name: whiteCircleAllWhiteQuarters
+ uid: 'excel!Excel.FiveQuartersSet#whiteCircleAllWhiteQuarters:member'
+ package: excel!
+ fullName: whiteCircleAllWhiteQuarters
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'whiteCircleAllWhiteQuarters: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fiveratingset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fiveratingset.yml
new file mode 100644
index 0000000000..b9c9c9d826
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fiveratingset.yml
@@ -0,0 +1,71 @@
+### YamlMime:TSType
+name: Excel.FiveRatingSet
+uid: 'excel!Excel.FiveRatingSet:interface'
+package: excel!
+fullName: Excel.FiveRatingSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: fourBars
+ uid: 'excel!Excel.FiveRatingSet#fourBars:member'
+ package: excel!
+ fullName: fourBars
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fourBars: Icon;'
+ return:
+ type: ''
+ - name: noBars
+ uid: 'excel!Excel.FiveRatingSet#noBars:member'
+ package: excel!
+ fullName: noBars
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'noBars: Icon;'
+ return:
+ type: ''
+ - name: oneBar
+ uid: 'excel!Excel.FiveRatingSet#oneBar:member'
+ package: excel!
+ fullName: oneBar
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'oneBar: Icon;'
+ return:
+ type: ''
+ - name: threeBars
+ uid: 'excel!Excel.FiveRatingSet#threeBars:member'
+ package: excel!
+ fullName: threeBars
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'threeBars: Icon;'
+ return:
+ type: ''
+ - name: twoBars
+ uid: 'excel!Excel.FiveRatingSet#twoBars:member'
+ package: excel!
+ fullName: twoBars
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'twoBars: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.formatprotection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.formatprotection.yml
new file mode 100644
index 0000000000..018b097963
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.formatprotection.yml
@@ -0,0 +1,181 @@
+### YamlMime:TSType
+name: Excel.FormatProtection
+uid: 'excel!Excel.FormatProtection:class'
+package: excel!
+fullName: Excel.FormatProtection
+summary: Represents the format protection of a range object.
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.FormatProtection#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: formulaHidden
+ uid: 'excel!Excel.FormatProtection#formulaHidden:member'
+ package: excel!
+ fullName: formulaHidden
+ summary: >-
+ Specifies if Excel hides the formula for the cells in the range. A `null` value indicates that the entire range
+ doesn't have a uniform formula hidden setting.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'formulaHidden: boolean;'
+ return:
+ type: boolean
+ - name: locked
+ uid: 'excel!Excel.FormatProtection#locked:member'
+ package: excel!
+ fullName: locked
+ summary: >-
+ Specifies if Excel locks the cells in the object. A `null` value indicates that the entire range doesn't have a
+ uniform lock setting.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'locked: boolean;'
+ return:
+ type: boolean
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.FormatProtection#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.FormatProtectionLoadOptions): Excel.FormatProtection;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.FormatProtection#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): Excel.FormatProtection;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: ''
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.FormatProtection#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): Excel.FormatProtection;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: ''
+ description: ''
+ - name: 'set(properties, options)'
+ uid: 'excel!Excel.FormatProtection#set:member(1)'
+ package: excel!
+ fullName: 'set(properties, options)'
+ summary: >-
+ Sets multiple properties of an object at the same time. You can pass either a plain object with the appropriate
+ properties, or another API object of the same type.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Interfaces.FormatProtectionUpdateData, options?: OfficeExtension.UpdateOptions): void;'
+ parameters:
+ - id: properties
+ description: >-
+ A JavaScript object with properties that are structured isomorphically to the properties of the object on
+ which the method is called.
+ type: ''
+ - id: options
+ description: Provides an option to suppress errors if the properties object tries to set any read-only properties.
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: set(properties)
+ uid: 'excel!Excel.FormatProtection#set:member(2)'
+ package: excel!
+ fullName: set(properties)
+ summary: 'Sets multiple properties on the object at the same time, based on an existing loaded object.'
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'set(properties: Excel.FormatProtection): void;'
+ parameters:
+ - id: properties
+ description: ''
+ type: ''
+ return:
+ type: void
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.FormatProtection#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original Excel.FormatProtection object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Excel.Interfaces.FormatProtectionData`) that contains shallow copies of
+ any loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Excel.Interfaces.FormatProtectionData;'
+ return:
+ type: ''
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.formattednumbercellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.formattednumbercellvalue.yml
new file mode 100644
index 0000000000..4fbb51120f
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.formattednumbercellvalue.yml
@@ -0,0 +1,139 @@
+### YamlMime:TSType
+name: Excel.FormattedNumberCellValue
+uid: 'excel!Excel.FormattedNumberCellValue:interface'
+package: excel!
+fullName: Excel.FormattedNumberCellValue
+summary: >-
+ Represents the value of a cell containing a number with a format string. Number format strings must conform to Excel
+ guidelines. To learn more, see [Review guidelines for customizing a number
+ format](https://support.microsoft.com/office/review-guidelines-for-customizing-a-number-format-c0a1d1fa-d3f4-4018-96b7-9c9354dd99f5). In this scenario, the format is applied to the value and not to the cell, so the value retains its format string
+ throughout calculation.
+remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: basicType
+ uid: 'excel!Excel.FormattedNumberCellValue#basicType:member'
+ package: excel!
+ fullName: basicType
+ summary: Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicType?: RangeValueType.double | "Double";'
+ return:
+ type: ' | "Double"'
+ - name: basicValue
+ uid: 'excel!Excel.FormattedNumberCellValue#basicValue:member'
+ package: excel!
+ fullName: basicValue
+ summary: Represents the value that would be returned by `Range.values` for a cell with this value.
+ remarks: '\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'basicValue: number;'
+ return:
+ type: number
+ - name: numberFormat
+ uid: 'excel!Excel.FormattedNumberCellValue#numberFormat:member'
+ package: excel!
+ fullName: numberFormat
+ summary: >-
+ Returns the number format string that is used to display this value. When accessed through a `valuesAsJson`
+ property, this number format string is in the en-US locale. When accessed through a `valuesAsJsonLocal` property,
+ this number format is in the user's display locale. Number format strings must conform to Excel guidelines. To
+ learn more, see [Review guidelines for customizing a number
+ format](https://support.microsoft.com/office/review-guidelines-for-customizing-a-number-format-c0a1d1fa-d3f4-4018-96b7-9c9354dd99f5).
+ remarks: >-
+ \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-formatted-number.yaml
+
+ // This function creates a formatted number data type,
+
+ // and sets the format of this data type as a currency.
+
+ await Excel.run(async (context) => {
+ // Get the Sample worksheet and a range on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const currencyRange = sheet.getRange("A2");
+
+ // Write a number formatted as currency to cell A2.
+ currencyRange.valuesAsJson = [
+ [
+ {
+ type: Excel.CellValueType.formattedNumber,
+ basicValue: 12.34,
+ numberFormat: "$* #,##0.00"
+ }
+ ]
+ ];
+
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'numberFormat: string;'
+ return:
+ type: string
+ - name: type
+ uid: 'excel!Excel.FormattedNumberCellValue#type:member'
+ package: excel!
+ fullName: type
+ summary: Represents the type of this cell value.
+ remarks: >-
+ \[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ #### Examples
+
+
+ ```typescript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-formatted-number.yaml
+
+ // This function creates a formatted number data type,
+
+ // and sets the format of this data type as a date.
+
+ await Excel.run(async (context) => {
+ // Get the Sample worksheet and a range on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const dateRange = sheet.getRange("A1");
+
+ // Write a number formatted as a date to cell A1.
+ dateRange.valuesAsJson = [
+ [
+ {
+ type: Excel.CellValueType.formattedNumber,
+ basicValue: 32889.0,
+ numberFormat: "m/d/yyyy"
+ }
+ ]
+ ];
+ await context.sync();
+ });
+
+ ```
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'type: CellValueType.formattedNumber | "FormattedNumber";'
+ return:
+ type: ' | "FormattedNumber"'
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.formulachangedeventdetail.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.formulachangedeventdetail.yml
new file mode 100644
index 0000000000..a7e2cedb16
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.formulachangedeventdetail.yml
@@ -0,0 +1,35 @@
+### YamlMime:TSType
+name: Excel.FormulaChangedEventDetail
+uid: 'excel!Excel.FormulaChangedEventDetail:interface'
+package: excel!
+fullName: Excel.FormulaChangedEventDetail
+summary: Provides information about a changed formula during a formula changed event.
+remarks: '\[ [API set: ExcelApi 1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: cellAddress
+ uid: 'excel!Excel.FormulaChangedEventDetail#cellAddress:member'
+ package: excel!
+ fullName: cellAddress
+ summary: The address of the cell that contains the changed formula.
+ remarks: '\[ [API set: ExcelApi 1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'cellAddress: string;'
+ return:
+ type: string
+ - name: previousFormula
+ uid: 'excel!Excel.FormulaChangedEventDetail#previousFormula:member'
+ package: excel!
+ fullName: previousFormula
+ summary: 'Represents the previous formula, before it was changed.'
+ remarks: '\[ [API set: ExcelApi 1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'previousFormula: string;'
+ return:
+ type: string
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fourarrowsgrayset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourarrowsgrayset.yml
new file mode 100644
index 0000000000..138492d933
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourarrowsgrayset.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.FourArrowsGraySet
+uid: 'excel!Excel.FourArrowsGraySet:interface'
+package: excel!
+fullName: Excel.FourArrowsGraySet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: grayDownArrow
+ uid: 'excel!Excel.FourArrowsGraySet#grayDownArrow:member'
+ package: excel!
+ fullName: grayDownArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayDownArrow: Icon;'
+ return:
+ type: ''
+ - name: grayDownInclineArrow
+ uid: 'excel!Excel.FourArrowsGraySet#grayDownInclineArrow:member'
+ package: excel!
+ fullName: grayDownInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayDownInclineArrow: Icon;'
+ return:
+ type: ''
+ - name: grayUpArrow
+ uid: 'excel!Excel.FourArrowsGraySet#grayUpArrow:member'
+ package: excel!
+ fullName: grayUpArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayUpArrow: Icon;'
+ return:
+ type: ''
+ - name: grayUpInclineArrow
+ uid: 'excel!Excel.FourArrowsGraySet#grayUpInclineArrow:member'
+ package: excel!
+ fullName: grayUpInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayUpInclineArrow: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fourarrowsset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourarrowsset.yml
new file mode 100644
index 0000000000..1166cbb166
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourarrowsset.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.FourArrowsSet
+uid: 'excel!Excel.FourArrowsSet:interface'
+package: excel!
+fullName: Excel.FourArrowsSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: greenUpArrow
+ uid: 'excel!Excel.FourArrowsSet#greenUpArrow:member'
+ package: excel!
+ fullName: greenUpArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'greenUpArrow: Icon;'
+ return:
+ type: ''
+ - name: redDownArrow
+ uid: 'excel!Excel.FourArrowsSet#redDownArrow:member'
+ package: excel!
+ fullName: redDownArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'redDownArrow: Icon;'
+ return:
+ type: ''
+ - name: yellowDownInclineArrow
+ uid: 'excel!Excel.FourArrowsSet#yellowDownInclineArrow:member'
+ package: excel!
+ fullName: yellowDownInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'yellowDownInclineArrow: Icon;'
+ return:
+ type: ''
+ - name: yellowUpInclineArrow
+ uid: 'excel!Excel.FourArrowsSet#yellowUpInclineArrow:member'
+ package: excel!
+ fullName: yellowUpInclineArrow
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'yellowUpInclineArrow: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fourratingset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourratingset.yml
new file mode 100644
index 0000000000..5095f888f6
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourratingset.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.FourRatingSet
+uid: 'excel!Excel.FourRatingSet:interface'
+package: excel!
+fullName: Excel.FourRatingSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: fourBars
+ uid: 'excel!Excel.FourRatingSet#fourBars:member'
+ package: excel!
+ fullName: fourBars
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'fourBars: Icon;'
+ return:
+ type: ''
+ - name: oneBar
+ uid: 'excel!Excel.FourRatingSet#oneBar:member'
+ package: excel!
+ fullName: oneBar
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'oneBar: Icon;'
+ return:
+ type: ''
+ - name: threeBars
+ uid: 'excel!Excel.FourRatingSet#threeBars:member'
+ package: excel!
+ fullName: threeBars
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'threeBars: Icon;'
+ return:
+ type: ''
+ - name: twoBars
+ uid: 'excel!Excel.FourRatingSet#twoBars:member'
+ package: excel!
+ fullName: twoBars
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'twoBars: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fourredtoblackset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourredtoblackset.yml
new file mode 100644
index 0000000000..139693ad17
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourredtoblackset.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.FourRedToBlackSet
+uid: 'excel!Excel.FourRedToBlackSet:interface'
+package: excel!
+fullName: Excel.FourRedToBlackSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: blackCircle
+ uid: 'excel!Excel.FourRedToBlackSet#blackCircle:member'
+ package: excel!
+ fullName: blackCircle
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'blackCircle: Icon;'
+ return:
+ type: ''
+ - name: grayCircle
+ uid: 'excel!Excel.FourRedToBlackSet#grayCircle:member'
+ package: excel!
+ fullName: grayCircle
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'grayCircle: Icon;'
+ return:
+ type: ''
+ - name: pinkCircle
+ uid: 'excel!Excel.FourRedToBlackSet#pinkCircle:member'
+ package: excel!
+ fullName: pinkCircle
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'pinkCircle: Icon;'
+ return:
+ type: ''
+ - name: redCircle
+ uid: 'excel!Excel.FourRedToBlackSet#redCircle:member'
+ package: excel!
+ fullName: redCircle
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'redCircle: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.fourtrafficlightsset.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourtrafficlightsset.yml
new file mode 100644
index 0000000000..897544e3fa
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.fourtrafficlightsset.yml
@@ -0,0 +1,59 @@
+### YamlMime:TSType
+name: Excel.FourTrafficLightsSet
+uid: 'excel!Excel.FourTrafficLightsSet:interface'
+package: excel!
+fullName: Excel.FourTrafficLightsSet
+summary: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+remarks: ''
+isPreview: false
+isDeprecated: false
+type: interface
+properties:
+ - name: blackCircleWithBorder
+ uid: 'excel!Excel.FourTrafficLightsSet#blackCircleWithBorder:member'
+ package: excel!
+ fullName: blackCircleWithBorder
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'blackCircleWithBorder: Icon;'
+ return:
+ type: ''
+ - name: greenCircle
+ uid: 'excel!Excel.FourTrafficLightsSet#greenCircle:member'
+ package: excel!
+ fullName: greenCircle
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'greenCircle: Icon;'
+ return:
+ type: ''
+ - name: redCircleWithBorder
+ uid: 'excel!Excel.FourTrafficLightsSet#redCircleWithBorder:member'
+ package: excel!
+ fullName: redCircleWithBorder
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'redCircleWithBorder: Icon;'
+ return:
+ type: ''
+ - name: yellowCircle
+ uid: 'excel!Excel.FourTrafficLightsSet#yellowCircle:member'
+ package: excel!
+ fullName: yellowCircle
+ summary: ''
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'yellowCircle: Icon;'
+ return:
+ type: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.functionresult.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.functionresult.yml
new file mode 100644
index 0000000000..3389b72a5a
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.functionresult.yml
@@ -0,0 +1,140 @@
+### YamlMime:TSType
+name: Excel.FunctionResult
+uid: 'excel!Excel.FunctionResult:class'
+package: excel!
+fullName: Excel.FunctionResult
+summary: An object containing the result of a function-evaluation operation
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.FunctionResult#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+ - name: error
+ uid: 'excel!Excel.FunctionResult#error:member'
+ package: excel!
+ fullName: error
+ summary: >-
+ Error value (such as "\#DIV/0") representing the error. If the error string is not set, then the function
+ succeeded, and its result is written to the Value field. The error is always in the English locale.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly error: string;'
+ return:
+ type: string
+ - name: value
+ uid: 'excel!Excel.FunctionResult#value:member'
+ package: excel!
+ fullName: value
+ summary: >-
+ The value of function evaluation. The value field will be populated only if no error has occurred (i.e., the Error
+ property is not set).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'readonly value: T;'
+ return:
+ type: T
+methods:
+ - name: load(options)
+ uid: 'excel!Excel.FunctionResult#load:member(1)'
+ package: excel!
+ fullName: load(options)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(options?: Excel.Interfaces.FunctionResultLoadOptions): FunctionResult;'
+ parameters:
+ - id: options
+ description: Provides options for which properties of the object to load.
+ type: ''
+ return:
+ type: '<T>'
+ description: ''
+ - name: load(propertyNames)
+ uid: 'excel!Excel.FunctionResult#load:member(2)'
+ package: excel!
+ fullName: load(propertyNames)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'load(propertyNames?: string | string[]): FunctionResult;'
+ parameters:
+ - id: propertyNames
+ description: A comma-delimited string or an array of strings that specify the properties to load.
+ type: 'string | string[]'
+ return:
+ type: '<T>'
+ description: ''
+ - name: load(propertyNamesAndPaths)
+ uid: 'excel!Excel.FunctionResult#load:member(3)'
+ package: excel!
+ fullName: load(propertyNamesAndPaths)
+ summary: >-
+ Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
+ the properties.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: |-
+ load(propertyNamesAndPaths?: {
+ select?: string;
+ expand?: string;
+ }): FunctionResult;
+ parameters:
+ - id: propertyNamesAndPaths
+ description: >-
+ `propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
+ `propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
+ type: |-
+ {
+ select?: string;
+ expand?: string;
+ }
+ return:
+ type: '<T>'
+ description: ''
+ - name: toJSON()
+ uid: 'excel!Excel.FunctionResult#toJSON:member(1)'
+ package: excel!
+ fullName: toJSON()
+ summary: >-
+ Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
+ `JSON.stringify()`. (`JSON.stringify`, in turn, calls the `toJSON` method of the object that is
+ passed to it.) Whereas the original `FunctionResult` object is an API object, the `toJSON` method returns a
+ plain JavaScript object (typed as `Interfaces.FunctionResultData`) that contains shallow copies of any
+ loaded child properties from the original object.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'toJSON(): Interfaces.FunctionResultData;'
+ return:
+ type: '<T>'
+ description: ''
+extends: ''
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.functions.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.functions.yml
new file mode 100644
index 0000000000..d5a2c632b2
--- /dev/null
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.functions.yml
@@ -0,0 +1,10537 @@
+### YamlMime:TSType
+name: Excel.Functions
+uid: 'excel!Excel.Functions:class'
+package: excel!
+fullName: Excel.Functions
+summary: An object for evaluating Excel functions.
+remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+isPreview: false
+isDeprecated: false
+type: class
+properties:
+ - name: context
+ uid: 'excel!Excel.Functions#context:member'
+ package: excel!
+ fullName: context
+ summary: >-
+ The request context associated with the object. This connects the add-in's process to the Office host
+ application's process.
+ remarks: ''
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'context: RequestContext;'
+ return:
+ type: ''
+methods:
+ - name: abs(number)
+ uid: 'excel!Excel.Functions#abs:member(1)'
+ package: excel!
+ fullName: abs(number)
+ summary: 'Returns the absolute value of a number, a number without its sign.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'abs(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is the real number for which you want the absolute value.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'accrInt(issue, firstInterest, settlement, rate, par, frequency, basis, calcMethod)'
+ uid: 'excel!Excel.Functions#accrInt:member(1)'
+ package: excel!
+ fullName: 'accrInt(issue, firstInterest, settlement, rate, par, frequency, basis, calcMethod)'
+ summary: Returns the accrued interest for a security that pays periodic interest.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ accrInt(issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ firstInterest: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, rate:
+ number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, par: number | string
+ | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, frequency: number | string | boolean
+ | Excel.Range | Excel.RangeReference | Excel.FunctionResult, basis?: number | string | boolean |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult, calcMethod?: number | string | boolean |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: issue
+ description: 'Is the security''s issue date, expressed as a serial date number.'
+ type: >-
+ number | string | boolean | | | <any>
+ - id: firstInterest
+ description: 'Is the security''s first interest date, expressed as a serial date number.'
+ type: >-
+ number | string | boolean | | | <any>
+ - id: settlement
+ description: 'Is the security''s settlement date, expressed as a serial date number.'
+ type: >-
+ number | string | boolean | | | <any>
+ - id: rate
+ description: Is the security's annual coupon rate.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: par
+ description: Is the security's par value.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: frequency
+ description: Is the number of coupon payments per year.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: basis
+ description: Is the type of day count basis to use.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: calcMethod
+ description: >-
+ Is a logical value: to accrued interest from issue date = TRUE or omitted; to calculate from last coupon
+ payment date = FALSE.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'accrIntM(issue, settlement, rate, par, basis)'
+ uid: 'excel!Excel.Functions#accrIntM:member(1)'
+ package: excel!
+ fullName: 'accrIntM(issue, settlement, rate, par, basis)'
+ summary: Returns the accrued interest for a security that pays interest at maturity.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ accrIntM(issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, rate:
+ number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, par: number | string
+ | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, basis?: number | string | boolean |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: issue
+ description: 'Is the security''s issue date, expressed as a serial date number.'
+ type: >-
+ number | string | boolean | | | <any>
+ - id: settlement
+ description: 'Is the security''s maturity date, expressed as a serial date number.'
+ type: >-
+ number | string | boolean | | | <any>
+ - id: rate
+ description: Is the security's annual coupon rate.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: par
+ description: Is the security's par value.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: basis
+ description: Is the type of day count basis to use.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: acos(number)
+ uid: 'excel!Excel.Functions#acos:member(1)'
+ package: excel!
+ fullName: acos(number)
+ summary: >-
+ Returns the arccosine of a number, in radians in the range 0 to Pi. The arccosine is the angle whose cosine is
+ Number.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'acos(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is the cosine of the angle you want and must be from -1 to 1.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: acosh(number)
+ uid: 'excel!Excel.Functions#acosh:member(1)'
+ package: excel!
+ fullName: acosh(number)
+ summary: Returns the inverse hyperbolic cosine of a number.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'acosh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is any real number equal to or greater than 1.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: acot(number)
+ uid: 'excel!Excel.Functions#acot:member(1)'
+ package: excel!
+ fullName: acot(number)
+ summary: 'Returns the arccotangent of a number, in radians in the range 0 to Pi.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'acot(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is the cotangent of the angle you want.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: acoth(number)
+ uid: 'excel!Excel.Functions#acoth:member(1)'
+ package: excel!
+ fullName: acoth(number)
+ summary: Returns the inverse hyperbolic cotangent of a number.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'acoth(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is the hyperbolic cotangent of the angle that you want.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'amorDegrc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)'
+ uid: 'excel!Excel.Functions#amorDegrc:member(1)'
+ package: excel!
+ fullName: 'amorDegrc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)'
+ summary: Returns the prorated linear depreciation of an asset for each accounting period.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ amorDegrc(cost: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ datePurchased: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ firstPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ salvage: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, period:
+ number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, rate: number |
+ string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, basis?: number | string |
+ boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: cost
+ description: Is the cost of the asset.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: datePurchased
+ description: Is the date the asset is purchased.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: firstPeriod
+ description: Is the date of the end of the first period.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: salvage
+ description: Is the salvage value at the end of life of the asset.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: period
+ description: Is the period.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: rate
+ description: Is the rate of depreciation.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: basis
+ description: 'Year\_basis : 0 for year of 360 days, 1 for actual, 3 for year of 365 days.'
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'amorLinc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)'
+ uid: 'excel!Excel.Functions#amorLinc:member(1)'
+ package: excel!
+ fullName: 'amorLinc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)'
+ summary: Returns the prorated linear depreciation of an asset for each accounting period.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ amorLinc(cost: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ datePurchased: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ firstPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ salvage: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, period:
+ number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, rate: number |
+ string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, basis?: number | string |
+ boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: cost
+ description: Is the cost of the asset.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: datePurchased
+ description: Is the date the asset is purchased.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: firstPeriod
+ description: Is the date of the end of the first period.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: salvage
+ description: Is the salvage value at the end of life of the asset.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: period
+ description: Is the period.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: rate
+ description: Is the rate of depreciation.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: basis
+ description: 'Year\_basis : 0 for year of 360 days, 1 for actual, 3 for year of 365 days.'
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: and(values)
+ uid: 'excel!Excel.Functions#and:member(1)'
+ package: excel!
+ fullName: and(values)
+ summary: 'Checks whether all arguments are TRUE, and returns TRUE if all arguments are TRUE.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ and(...values: Array>):
+ FunctionResult;
+ parameters:
+ - id: values
+ description: >-
+ List of parameters, whose elements are 1 to 255 conditions you want to test that can be either TRUE or FALSE
+ and can be logical values, arrays, or references.
+ type: >-
+ Array<boolean | | | <any>>
+ return:
+ type: '<boolean>'
+ description: ''
+ - name: arabic(text)
+ uid: 'excel!Excel.Functions#arabic:member(1)'
+ package: excel!
+ fullName: arabic(text)
+ summary: Converts a Roman numeral to Arabic.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'arabic(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: text
+ description: Is the Roman numeral you want to convert.
+ type: >-
+ string | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: areas(reference)
+ uid: 'excel!Excel.Functions#areas:member(1)'
+ package: excel!
+ fullName: areas(reference)
+ summary: Returns the number of areas in a reference. An area is a range of contiguous cells or a single cell.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'areas(reference: Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: reference
+ description: Is a reference to a cell or range of cells and can refer to multiple areas.
+ type: >-
+ | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: asc(text)
+ uid: 'excel!Excel.Functions#asc:member(1)'
+ package: excel!
+ fullName: asc(text)
+ summary: >-
+ Changes full-width (double-byte) characters to half-width (single-byte) characters. Use with double-byte character
+ sets (DBCS).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'asc(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: text
+ description: 'Is a text, or a reference to a cell containing a text.'
+ type: >-
+ string | | |
+ <any>
+ return:
+ type: '<string>'
+ description: ''
+ - name: asin(number)
+ uid: 'excel!Excel.Functions#asin:member(1)'
+ package: excel!
+ fullName: asin(number)
+ summary: 'Returns the arcsine of a number in radians, in the range -Pi/2 to Pi/2.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'asin(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is the sine of the angle you want and must be from -1 to 1.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: asinh(number)
+ uid: 'excel!Excel.Functions#asinh:member(1)'
+ package: excel!
+ fullName: asinh(number)
+ summary: Returns the inverse hyperbolic sine of a number.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'asinh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is any real number equal to or greater than 1.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: atan(number)
+ uid: 'excel!Excel.Functions#atan:member(1)'
+ package: excel!
+ fullName: atan(number)
+ summary: 'Returns the arctangent of a number in radians, in the range -Pi/2 to Pi/2.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'atan(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is the tangent of the angle you want.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'atan2(xNum, yNum)'
+ uid: 'excel!Excel.Functions#atan2:member(1)'
+ package: excel!
+ fullName: 'atan2(xNum, yNum)'
+ summary: 'Returns the arctangent of the specified x- and y- coordinates, in radians between -Pi and Pi, excluding -Pi.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ atan2(xNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, yNum: number | Excel.Range
+ | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: xNum
+ description: Is the x-coordinate of the point.
+ type: >-
+ number | | |
+ <any>
+ - id: yNum
+ description: Is the y-coordinate of the point.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: atanh(number)
+ uid: 'excel!Excel.Functions#atanh:member(1)'
+ package: excel!
+ fullName: atanh(number)
+ summary: Returns the inverse hyperbolic tangent of a number.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'atanh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is any real number between -1 and 1 excluding -1 and 1.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: aveDev(values)
+ uid: 'excel!Excel.Functions#aveDev:member(1)'
+ package: excel!
+ fullName: aveDev(values)
+ summary: >-
+ Returns the average of the absolute deviations of data points from their mean. Arguments can be numbers or names,
+ arrays, or references that contain numbers.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ aveDev(...values: Array>):
+ FunctionResult;
+ parameters:
+ - id: values
+ description: >-
+ List of parameters, whose elements are 1 to 255 arguments for which you want the average of the absolute
+ deviations.
+ type: >-
+ Array<number | | | <any>>
+ return:
+ type: '<number>'
+ description: ''
+ - name: average(values)
+ uid: 'excel!Excel.Functions#average:member(1)'
+ package: excel!
+ fullName: average(values)
+ summary: >-
+ Returns the average (arithmetic mean) of its arguments, which can be numbers or names, arrays, or references that
+ contain numbers.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ average(...values: Array>):
+ FunctionResult;
+ parameters:
+ - id: values
+ description: 'List of parameters, whose elements are 1 to 255 numeric arguments for which you want the average.'
+ type: >-
+ Array<number | | | <any>>
+ return:
+ type: '<number>'
+ description: ''
+ - name: averageA(values)
+ uid: 'excel!Excel.Functions#averageA:member(1)'
+ package: excel!
+ fullName: averageA(values)
+ summary: >-
+ Returns the average (arithmetic mean) of its arguments, evaluating text and FALSE in arguments as 0; TRUE
+ evaluates as 1. Arguments can be numbers, names, arrays, or references.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ averageA(...values: Array>):
+ FunctionResult;
+ parameters:
+ - id: values
+ description: 'List of parameters, whose elements are 1 to 255 arguments for which you want the average.'
+ type: >-
+ Array<number | | | <any>>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'averageIf(range, criteria, averageRange)'
+ uid: 'excel!Excel.Functions#averageIf:member(1)'
+ package: excel!
+ fullName: 'averageIf(range, criteria, averageRange)'
+ summary: Finds average(arithmetic mean) for the cells specified by a given condition or criteria.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ averageIf(range: Excel.Range | Excel.RangeReference | Excel.FunctionResult, criteria: number | string |
+ boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, averageRange?: Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: range
+ description: Is the range of cells you want evaluated.
+ type: >-
+ | | <any>
+ - id: criteria
+ description: >-
+ Is the condition or criteria in the form of a number, expression, or text that defines which cells will be
+ used to find the average.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: averageRange
+ description: 'Are the actual cells to be used to find the average. If omitted, the cells in range are used.'
+ type: >-
+ | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'averageIfs(averageRange, values)'
+ uid: 'excel!Excel.Functions#averageIfs:member(1)'
+ package: excel!
+ fullName: 'averageIfs(averageRange, values)'
+ summary: Finds average(arithmetic mean) for the cells specified by a given set of conditions or criteria.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ averageIfs(averageRange: Excel.Range | Excel.RangeReference | Excel.FunctionResult, ...values:
+ Array | number | string | boolean>):
+ FunctionResult;
+ parameters:
+ - id: averageRange
+ description: Are the actual cells to be used to find the average.
+ type: >-
+ | | <any>
+ - id: values
+ description: >-
+ List of parameters, where the first element of each pair is the Is the range of cells you want evaluated for
+ the particular condition , and the second element is is the condition or criteria in the form of a number,
+ expression, or text that defines which cells will be used to find the average.
+ type: >-
+ Array< | |
+ <any> | number | string | boolean>
+ return:
+ type: '<number>'
+ description: ''
+ - name: bahtText(number)
+ uid: 'excel!Excel.Functions#bahtText:member(1)'
+ package: excel!
+ fullName: bahtText(number)
+ summary: Converts a number to text (baht).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bahtText(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult):
+ FunctionResult;
+ parameters:
+ - id: number
+ description: Is a number that you want to convert.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<string>'
+ description: ''
+ - name: 'base(number, radix, minLength)'
+ uid: 'excel!Excel.Functions#base:member(1)'
+ package: excel!
+ fullName: 'base(number, radix, minLength)'
+ summary: Converts a number into a text representation with the given radix (base).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ base(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, radix: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult, minLength?: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number
+ description: Is the number that you want to convert.
+ type: >-
+ number | | |
+ <any>
+ - id: radix
+ description: Is the base Radix that you want to convert the number into.
+ type: >-
+ number | | |
+ <any>
+ - id: minLength
+ description: Is the minimum length of the returned string. If omitted leading zeros are not added.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<string>'
+ description: ''
+ - name: 'besselI(x, n)'
+ uid: 'excel!Excel.Functions#besselI:member(1)'
+ package: excel!
+ fullName: 'besselI(x, n)'
+ summary: Returns the modified Bessel function In(x).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ besselI(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, n: number
+ | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: x
+ description: Is the value at which to evaluate the function.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: 'n'
+ description: Is the order of the Bessel function.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'besselJ(x, n)'
+ uid: 'excel!Excel.Functions#besselJ:member(1)'
+ package: excel!
+ fullName: 'besselJ(x, n)'
+ summary: Returns the Bessel function Jn(x).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ besselJ(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, n: number
+ | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: x
+ description: Is the value at which to evaluate the function.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: 'n'
+ description: Is the order of the Bessel function.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'besselK(x, n)'
+ uid: 'excel!Excel.Functions#besselK:member(1)'
+ package: excel!
+ fullName: 'besselK(x, n)'
+ summary: Returns the modified Bessel function Kn(x).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ besselK(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, n: number
+ | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: x
+ description: Is the value at which to evaluate the function.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: 'n'
+ description: Is the order of the function.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'besselY(x, n)'
+ uid: 'excel!Excel.Functions#besselY:member(1)'
+ package: excel!
+ fullName: 'besselY(x, n)'
+ summary: Returns the Bessel function Yn(x).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ besselY(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, n: number
+ | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: x
+ description: Is the value at which to evaluate the function.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: 'n'
+ description: Is the order of the function.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'beta_Dist(x, alpha, beta, cumulative, A, B)'
+ uid: 'excel!Excel.Functions#beta_Dist:member(1)'
+ package: excel!
+ fullName: 'beta_Dist(x, alpha, beta, cumulative, A, B)'
+ summary: Returns the beta probability distribution function.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ beta_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, alpha: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult, beta: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult, cumulative: boolean | Excel.Range | Excel.RangeReference |
+ Excel.FunctionResult, A?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, B?:
+ number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: x
+ description: Is the value between A and B at which to evaluate the function.
+ type: >-
+ number | | |
+ <any>
+ - id: alpha
+ description: Is a parameter to the distribution and must be greater than 0.
+ type: >-
+ number | | |
+ <any>
+ - id: beta
+ description: Is a parameter to the distribution and must be greater than 0.
+ type: >-
+ number | | |
+ <any>
+ - id: cumulative
+ description: >-
+ Is a logical value: for the cumulative distribution function, use TRUE; for the probability density
+ function, use FALSE.
+ type: >-
+ boolean | | |
+ <any>
+ - id: A
+ description: 'Is an optional lower bound to the interval of x. If omitted, A = 0.'
+ type: >-
+ number | | |
+ <any>
+ - id: B
+ description: 'Is an optional upper bound to the interval of x. If omitted, B = 1.'
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'beta_Inv(probability, alpha, beta, A, B)'
+ uid: 'excel!Excel.Functions#beta_Inv:member(1)'
+ package: excel!
+ fullName: 'beta_Inv(probability, alpha, beta, A, B)'
+ summary: Returns the inverse of the cumulative beta probability density function (BETA.DIST).
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ beta_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, alpha: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult, beta: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult, A?: number | Excel.Range | Excel.RangeReference |
+ Excel.FunctionResult, B?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult):
+ FunctionResult;
+ parameters:
+ - id: probability
+ description: Is a probability associated with the beta distribution.
+ type: >-
+ number | | |
+ <any>
+ - id: alpha
+ description: Is a parameter to the distribution and must be greater than 0.
+ type: >-
+ number | | |
+ <any>
+ - id: beta
+ description: Is a parameter to the distribution and must be greater than 0.
+ type: >-
+ number | | |
+ <any>
+ - id: A
+ description: 'Is an optional lower bound to the interval of x. If omitted, A = 0.'
+ type: >-
+ number | | |
+ <any>
+ - id: B
+ description: 'Is an optional upper bound to the interval of x. If omitted, B = 1.'
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: bin2Dec(number)
+ uid: 'excel!Excel.Functions#bin2Dec:member(1)'
+ package: excel!
+ fullName: bin2Dec(number)
+ summary: Converts a binary number to decimal.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bin2Dec(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult):
+ FunctionResult;
+ parameters:
+ - id: number
+ description: Is the binary number you want to convert.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'bin2Hex(number, places)'
+ uid: 'excel!Excel.Functions#bin2Hex:member(1)'
+ package: excel!
+ fullName: 'bin2Hex(number, places)'
+ summary: Converts a binary number to hexadecimal.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bin2Hex(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult):
+ FunctionResult;
+ parameters:
+ - id: number
+ description: Is the binary number you want to convert.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: places
+ description: Is the number of characters to use.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'bin2Oct(number, places)'
+ uid: 'excel!Excel.Functions#bin2Oct:member(1)'
+ package: excel!
+ fullName: 'bin2Oct(number, places)'
+ summary: Converts a binary number to octal.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bin2Oct(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult):
+ FunctionResult;
+ parameters:
+ - id: number
+ description: Is the binary number you want to convert.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: places
+ description: Is the number of characters to use.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'binom_Dist_Range(trials, probabilityS, numberS, numberS2)'
+ uid: 'excel!Excel.Functions#binom_Dist_Range:member(1)'
+ package: excel!
+ fullName: 'binom_Dist_Range(trials, probabilityS, numberS, numberS2)'
+ summary: Returns the probability of a trial result using a binomial distribution.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ binom_Dist_Range(trials: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, probabilityS:
+ number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, numberS: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult, numberS2?: number | Excel.Range | Excel.RangeReference |
+ Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: trials
+ description: Is the number of independent trials.
+ type: >-
+ number | | |
+ <any>
+ - id: probabilityS
+ description: Is the probability of success on each trial.
+ type: >-
+ number | | |
+ <any>
+ - id: numberS
+ description: Is the number of successes in trials.
+ type: >-
+ number | | |
+ <any>
+ - id: numberS2
+ description: >-
+ If provided this function returns the probability that the number of successful trials shall lie between
+ numberS and numberS2.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'binom_Dist(numberS, trials, probabilityS, cumulative)'
+ uid: 'excel!Excel.Functions#binom_Dist:member(1)'
+ package: excel!
+ fullName: 'binom_Dist(numberS, trials, probabilityS, cumulative)'
+ summary: Returns the individual term binomial distribution probability.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ binom_Dist(numberS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, trials: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult, probabilityS: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult, cumulative: boolean | Excel.Range | Excel.RangeReference |
+ Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: numberS
+ description: Is the number of successes in trials.
+ type: >-
+ number | | |
+ <any>
+ - id: trials
+ description: Is the number of independent trials.
+ type: >-
+ number | | |
+ <any>
+ - id: probabilityS
+ description: Is the probability of success on each trial.
+ type: >-
+ number | | |
+ <any>
+ - id: cumulative
+ description: >-
+ Is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function,
+ use FALSE.
+ type: >-
+ boolean | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'binom_Inv(trials, probabilityS, alpha)'
+ uid: 'excel!Excel.Functions#binom_Inv:member(1)'
+ package: excel!
+ fullName: 'binom_Inv(trials, probabilityS, alpha)'
+ summary: >-
+ Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion
+ value.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ binom_Inv(trials: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, probabilityS: number
+ | Excel.Range | Excel.RangeReference | Excel.FunctionResult, alpha: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: trials
+ description: Is the number of Bernoulli trials.
+ type: >-
+ number | | |
+ <any>
+ - id: probabilityS
+ description: 'Is the probability of success on each trial, a number between 0 and 1 inclusive.'
+ type: >-
+ number | | |
+ <any>
+ - id: alpha
+ description: 'Is the criterion value, a number between 0 and 1 inclusive.'
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'bitand(number1, number2)'
+ uid: 'excel!Excel.Functions#bitand:member(1)'
+ package: excel!
+ fullName: 'bitand(number1, number2)'
+ summary: Returns a bitwise 'And' of two numbers.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bitand(number1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, number2: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number1
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ - id: number2
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'bitlshift(number, shiftAmount)'
+ uid: 'excel!Excel.Functions#bitlshift:member(1)'
+ package: excel!
+ fullName: 'bitlshift(number, shiftAmount)'
+ summary: Returns a number shifted left by shift\_amount bits.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bitlshift(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, shiftAmount: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ - id: shiftAmount
+ description: Is the number of bits that you want to shift Number left by.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'bitor(number1, number2)'
+ uid: 'excel!Excel.Functions#bitor:member(1)'
+ package: excel!
+ fullName: 'bitor(number1, number2)'
+ summary: Returns a bitwise 'Or' of two numbers.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bitor(number1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, number2: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number1
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ - id: number2
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'bitrshift(number, shiftAmount)'
+ uid: 'excel!Excel.Functions#bitrshift:member(1)'
+ package: excel!
+ fullName: 'bitrshift(number, shiftAmount)'
+ summary: Returns a number shifted right by shift\_amount bits.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bitrshift(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, shiftAmount: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ - id: shiftAmount
+ description: Is the number of bits that you want to shift Number right by.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'bitxor(number1, number2)'
+ uid: 'excel!Excel.Functions#bitxor:member(1)'
+ package: excel!
+ fullName: 'bitxor(number1, number2)'
+ summary: Returns a bitwise 'Exclusive Or' of two numbers.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ bitxor(number1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, number2: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number1
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ - id: number2
+ description: Is the decimal representation of the binary number you want to evaluate.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'ceiling_Math(number, significance, mode)'
+ uid: 'excel!Excel.Functions#ceiling_Math:member(1)'
+ package: excel!
+ fullName: 'ceiling_Math(number, significance, mode)'
+ summary: 'Rounds a number up, to the nearest integer or to the nearest multiple of significance.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ ceiling_Math(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, significance?:
+ number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, mode?: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number
+ description: Is the value you want to round.
+ type: >-
+ number | | |
+ <any>
+ - id: significance
+ description: Is the multiple to which you want to round.
+ type: >-
+ number | | |
+ <any>
+ - id: mode
+ description: When given and nonzero this function will round away from zero.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'ceiling_Precise(number, significance)'
+ uid: 'excel!Excel.Functions#ceiling_Precise:member(1)'
+ package: excel!
+ fullName: 'ceiling_Precise(number, significance)'
+ summary: 'Rounds a number up, to the nearest integer or to the nearest multiple of significance.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ ceiling_Precise(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, significance?:
+ number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number
+ description: Is the value you want to round.
+ type: >-
+ number | | |
+ <any>
+ - id: significance
+ description: Is the multiple to which you want to round.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: char(number)
+ uid: 'excel!Excel.Functions#char:member(1)'
+ package: excel!
+ fullName: char(number)
+ summary: Returns the character specified by the code number from the character set for your computer.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'char(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: number
+ description: Is a number between 1 and 255 specifying which character you want.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<string>'
+ description: ''
+ - name: 'chiSq_Dist_RT(x, degFreedom)'
+ uid: 'excel!Excel.Functions#chiSq_Dist_RT:member(1)'
+ package: excel!
+ fullName: 'chiSq_Dist_RT(x, degFreedom)'
+ summary: Returns the right-tailed probability of the chi-squared distribution.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ chiSq_Dist_RT(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, degFreedom: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: x
+ description: 'Is the value at which you want to evaluate the distribution, a nonnegative number.'
+ type: >-
+ number | | |
+ <any>
+ - id: degFreedom
+ description: 'Is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.'
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'chiSq_Dist(x, degFreedom, cumulative)'
+ uid: 'excel!Excel.Functions#chiSq_Dist:member(1)'
+ package: excel!
+ fullName: 'chiSq_Dist(x, degFreedom, cumulative)'
+ summary: Returns the left-tailed probability of the chi-squared distribution.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ chiSq_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, degFreedom: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult, cumulative: boolean | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: x
+ description: 'Is the value at which you want to evaluate the distribution, a nonnegative number.'
+ type: >-
+ number | | |
+ <any>
+ - id: degFreedom
+ description: 'Is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.'
+ type: >-
+ number | | |
+ <any>
+ - id: cumulative
+ description: >-
+ Is a logical value for the function to return: the cumulative distribution function = TRUE; the probability
+ density function = FALSE.
+ type: >-
+ boolean | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'chiSq_Inv_RT(probability, degFreedom)'
+ uid: 'excel!Excel.Functions#chiSq_Inv_RT:member(1)'
+ package: excel!
+ fullName: 'chiSq_Inv_RT(probability, degFreedom)'
+ summary: Returns the inverse of the right-tailed probability of the chi-squared distribution.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ chiSq_Inv_RT(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, degFreedom:
+ number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: probability
+ description: 'Is a probability associated with the chi-squared distribution, a value between 0 and 1 inclusive.'
+ type: >-
+ number | | |
+ <any>
+ - id: degFreedom
+ description: 'Is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.'
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'chiSq_Inv(probability, degFreedom)'
+ uid: 'excel!Excel.Functions#chiSq_Inv:member(1)'
+ package: excel!
+ fullName: 'chiSq_Inv(probability, degFreedom)'
+ summary: Returns the inverse of the left-tailed probability of the chi-squared distribution.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ chiSq_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, degFreedom:
+ number | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: probability
+ description: 'Is a probability associated with the chi-squared distribution, a value between 0 and 1 inclusive.'
+ type: >-
+ number | | |
+ <any>
+ - id: degFreedom
+ description: 'Is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.'
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'choose(indexNum, values)'
+ uid: 'excel!Excel.Functions#choose:member(1)'
+ package: excel!
+ fullName: 'choose(indexNum, values)'
+ summary: 'Chooses a value or action to perform from a list of values, based on an index number.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ choose(indexNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, ...values:
+ Array>):
+ FunctionResult;
+ parameters:
+ - id: indexNum
+ description: >-
+ Specifies which value argument is selected. indexNum must be between 1 and 254, or a formula or a reference
+ to a number between 1 and 254.
+ type: >-
+ number | | |
+ <any>
+ - id: values
+ description: >-
+ List of parameters, whose elements are 1 to 254 numbers, cell references, defined names, formulas,
+ functions, or text arguments from which CHOOSE selects.
+ type: >-
+ Array< | number | string | boolean | | <any>>
+ return:
+ type: '<number | string | boolean>'
+ description: ''
+ - name: clean(text)
+ uid: 'excel!Excel.Functions#clean:member(1)'
+ package: excel!
+ fullName: clean(text)
+ summary: Removes all nonprintable characters from text.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'clean(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: text
+ description: Is any worksheet information from which you want to remove nonprintable characters.
+ type: >-
+ string | | |
+ <any>
+ return:
+ type: '<string>'
+ description: ''
+ - name: code(text)
+ uid: 'excel!Excel.Functions#code:member(1)'
+ package: excel!
+ fullName: code(text)
+ summary: 'Returns a numeric code for the first character in a text string, in the character set used by your computer.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'code(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: text
+ description: Is the text for which you want the code of the first character.
+ type: >-
+ string | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: columns(array)
+ uid: 'excel!Excel.Functions#columns:member(1)'
+ package: excel!
+ fullName: columns(array)
+ summary: Returns the number of columns in an array or reference.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: 'columns(array: Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;'
+ parameters:
+ - id: array
+ description: 'Is an array or array formula, or a reference to a range of cells for which you want the number of columns.'
+ type: >-
+ | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'combin(number, numberChosen)'
+ uid: 'excel!Excel.Functions#combin:member(1)'
+ package: excel!
+ fullName: 'combin(number, numberChosen)'
+ summary: Returns the number of combinations for a given number of items.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ combin(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, numberChosen: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number
+ description: Is the total number of items.
+ type: >-
+ number | | |
+ <any>
+ - id: numberChosen
+ description: Is the number of items in each combination.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'combina(number, numberChosen)'
+ uid: 'excel!Excel.Functions#combina:member(1)'
+ package: excel!
+ fullName: 'combina(number, numberChosen)'
+ summary: Returns the number of combinations with repetitions for a given number of items.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ combina(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, numberChosen: number |
+ Excel.Range | Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: number
+ description: Is the total number of items.
+ type: >-
+ number | | |
+ <any>
+ - id: numberChosen
+ description: Is the number of items in each combination.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'complex(realNum, iNum, suffix)'
+ uid: 'excel!Excel.Functions#complex:member(1)'
+ package: excel!
+ fullName: 'complex(realNum, iNum, suffix)'
+ summary: Converts real and imaginary coefficients into a complex number.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ complex(realNum: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult,
+ iNum: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult, suffix?:
+ number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult):
+ FunctionResult;
+ parameters:
+ - id: realNum
+ description: Is the real coefficient of the complex number.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: iNum
+ description: Is the imaginary coefficient of the complex number.
+ type: >-
+ number | string | boolean | | | <any>
+ - id: suffix
+ description: Is the suffix for the imaginary component of the complex number.
+ type: >-
+ number | string | boolean | | | <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: concatenate(values)
+ uid: 'excel!Excel.Functions#concatenate:member(1)'
+ package: excel!
+ fullName: concatenate(values)
+ summary: Joins several text strings into one text string.
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ concatenate(...values: Array>):
+ FunctionResult;
+ parameters:
+ - id: values
+ description: >-
+ List of parameters, whose elements are 1 to 255 text strings to be joined into a single text string and can
+ be text strings, numbers, or single-cell references.
+ type: >-
+ Array<string | | | <any>>
+ return:
+ type: '<string>'
+ description: ''
+ - name: 'confidence_Norm(alpha, standardDev, size)'
+ uid: 'excel!Excel.Functions#confidence_Norm:member(1)'
+ package: excel!
+ fullName: 'confidence_Norm(alpha, standardDev, size)'
+ summary: 'Returns the confidence interval for a population mean, using a normal distribution.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ confidence_Norm(alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, standardDev:
+ number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, size: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult): FunctionResult;
+ parameters:
+ - id: alpha
+ description: 'Is the significance level used to compute the confidence level, a number greater than 0 and less than 1.'
+ type: >-
+ number | | |
+ <any>
+ - id: standardDev
+ description: >-
+ Is the population standard deviation for the data range and is assumed to be known. standardDev must be
+ greater than 0.
+ type: >-
+ number | | |
+ <any>
+ - id: size
+ description: Is the sample size.
+ type: >-
+ number | | |
+ <any>
+ return:
+ type: '<number>'
+ description: ''
+ - name: 'confidence_T(alpha, standardDev, size)'
+ uid: 'excel!Excel.Functions#confidence_T:member(1)'
+ package: excel!
+ fullName: 'confidence_T(alpha, standardDev, size)'
+ summary: 'Returns the confidence interval for a population mean, using a Student''s T distribution.'
+ remarks: '\[ [API set: ExcelApi 1.2](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
+ isPreview: false
+ isDeprecated: false
+ syntax:
+ content: >-
+ confidence_T(alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult, standardDev: number
+ | Excel.Range | Excel.RangeReference | Excel.FunctionResult, size: number | Excel.Range |
+ Excel.RangeReference | Excel.FunctionResult): FunctionResult