Skip to content

Commit 16364d7

Browse files
Merge pull request #2194 from OfficeDev/main
[Admin] Publish
2 parents 4c37d6d + db273df commit 16364d7

37 files changed

+1466
-170
lines changed

docs/docs-ref-autogen/powerpoint/powerpoint.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,8 @@ interfaces:
3636
- 'powerpoint!PowerPoint.Interfaces.ParagraphFormatData:interface'
3737
- 'powerpoint!PowerPoint.Interfaces.ParagraphFormatLoadOptions:interface'
3838
- 'powerpoint!PowerPoint.Interfaces.ParagraphFormatUpdateData:interface'
39+
- 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatData:interface'
40+
- 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions:interface'
3941
- 'powerpoint!PowerPoint.Interfaces.PresentationData:interface'
4042
- 'powerpoint!PowerPoint.Interfaces.PresentationLoadOptions:interface'
4143
- 'powerpoint!PowerPoint.Interfaces.ShapeCollectionData:interface'
@@ -102,6 +104,7 @@ classes:
102104
- 'powerpoint!PowerPoint.Hyperlink:class'
103105
- 'powerpoint!PowerPoint.HyperlinkCollection:class'
104106
- 'powerpoint!PowerPoint.ParagraphFormat:class'
107+
- 'powerpoint!PowerPoint.PlaceholderFormat:class'
105108
- 'powerpoint!PowerPoint.Presentation:class'
106109
- 'powerpoint!PowerPoint.RequestContext:class'
107110
- 'powerpoint!PowerPoint.Shape:class'
@@ -129,6 +132,7 @@ enums:
129132
- 'powerpoint!PowerPoint.GeometricShapeType:enum'
130133
- 'powerpoint!PowerPoint.InsertSlideFormatting:enum'
131134
- 'powerpoint!PowerPoint.ParagraphHorizontalAlignment:enum'
135+
- 'powerpoint!PowerPoint.PlaceholderType:enum'
132136
- 'powerpoint!PowerPoint.ShapeAutoSize:enum'
133137
- 'powerpoint!PowerPoint.ShapeFillType:enum'
134138
- 'powerpoint!PowerPoint.ShapeFontUnderlineStyle:enum'
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
### YamlMime:TSType
2+
name: PowerPoint.Interfaces.PlaceholderFormatData
3+
uid: 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatData:interface'
4+
package: powerpoint!
5+
fullName: PowerPoint.Interfaces.PlaceholderFormatData
6+
summary: An interface describing the data returned by calling `placeholderFormat.toJSON()`<!-- -->.
7+
remarks: ''
8+
isPreview: false
9+
isDeprecated: false
10+
type: interface
11+
properties:
12+
- name: containedType
13+
uid: 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatData#containedType:member'
14+
package: powerpoint!
15+
fullName: containedType
16+
summary: >-
17+
Gets the type of the shape contained within the placeholder. See
18+
[PowerPoint.ShapeType](xref:powerpoint!PowerPoint.ShapeType:enum) for details. Returns `null` if the placeholder
19+
is empty.
20+
remarks: >-
21+
\[ [API set: PowerPointApi BETA (PREVIEW
22+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
23+
isPreview: true
24+
isDeprecated: false
25+
syntax:
26+
content: 'containedType?: ShapeType | null;'
27+
return:
28+
type: '<xref uid="powerpoint!PowerPoint.ShapeType:enum" /> | null'
29+
- name: type
30+
uid: 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatData#type:member'
31+
package: powerpoint!
32+
fullName: type
33+
summary: >-
34+
Returns the type of this placeholder. See
35+
[PowerPoint.PlaceholderType](xref:powerpoint!PowerPoint.PlaceholderType:enum) for details.
36+
remarks: >-
37+
\[ [API set: PowerPointApi BETA (PREVIEW
38+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
39+
isPreview: true
40+
isDeprecated: false
41+
syntax:
42+
content: >-
43+
type?: PowerPoint.PlaceholderType | "Unsupported" | "Date" | "SlideNumber" | "Footer" | "Header" | "Title" |
44+
"Body" | "CenterTitle" | "Subtitle" | "VerticalTitle" | "VerticalBody" | "Content" | "Chart" | "Table" |
45+
"OnlinePicture" | "SmartArt" | "Media" | "VerticalContent" | "Picture" | "Cameo";
46+
return:
47+
type: >-
48+
<xref uid="powerpoint!PowerPoint.PlaceholderType:enum" /> | "Unsupported" | "Date" | "SlideNumber" | "Footer"
49+
| "Header" | "Title" | "Body" | "CenterTitle" | "Subtitle" | "VerticalTitle" | "VerticalBody" | "Content" |
50+
"Chart" | "Table" | "OnlinePicture" | "SmartArt" | "Media" | "VerticalContent" | "Picture" | "Cameo"
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
### YamlMime:TSType
2+
name: PowerPoint.Interfaces.PlaceholderFormatLoadOptions
3+
uid: 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions:interface'
4+
package: powerpoint!
5+
fullName: PowerPoint.Interfaces.PlaceholderFormatLoadOptions
6+
summary: Represents the properties of a `placeholder` shape.
7+
remarks: >-
8+
\[ [API set: PowerPointApi BETA (PREVIEW
9+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
10+
isPreview: true
11+
isDeprecated: false
12+
type: interface
13+
properties:
14+
- name: $all
15+
uid: 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions#$all:member'
16+
package: powerpoint!
17+
fullName: $all
18+
summary: >-
19+
Specifying `$all` for the load options loads all the scalar properties (such as `Range.address`<!-- -->) but not
20+
the navigational properties (such as `Range.format.fill.color`<!-- -->).
21+
remarks: ''
22+
isPreview: true
23+
isDeprecated: false
24+
syntax:
25+
content: '$all?: boolean;'
26+
return:
27+
type: boolean
28+
- name: containedType
29+
uid: 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions#containedType:member'
30+
package: powerpoint!
31+
fullName: containedType
32+
summary: >-
33+
Gets the type of the shape contained within the placeholder. See
34+
[PowerPoint.ShapeType](xref:powerpoint!PowerPoint.ShapeType:enum) for details. Returns `null` if the placeholder
35+
is empty.
36+
remarks: >-
37+
\[ [API set: PowerPointApi BETA (PREVIEW
38+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
39+
isPreview: true
40+
isDeprecated: false
41+
syntax:
42+
content: 'containedType?: boolean;'
43+
return:
44+
type: boolean
45+
- name: type
46+
uid: 'powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions#type:member'
47+
package: powerpoint!
48+
fullName: type
49+
summary: >-
50+
Returns the type of this placeholder. See
51+
[PowerPoint.PlaceholderType](xref:powerpoint!PowerPoint.PlaceholderType:enum) for details.
52+
remarks: >-
53+
\[ [API set: PowerPointApi BETA (PREVIEW
54+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
55+
isPreview: true
56+
isDeprecated: false
57+
syntax:
58+
content: 'type?: boolean;'
59+
return:
60+
type: boolean

docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.interfaces.shapecollectionloadoptions.yml

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -152,6 +152,22 @@ properties:
152152
content: 'parentGroup?: PowerPoint.Interfaces.ShapeLoadOptions;'
153153
return:
154154
type: '<xref uid="powerpoint!PowerPoint.Interfaces.ShapeLoadOptions:interface" />'
155+
- name: placeholderFormat
156+
uid: 'powerpoint!PowerPoint.Interfaces.ShapeCollectionLoadOptions#placeholderFormat:member'
157+
package: powerpoint!
158+
fullName: placeholderFormat
159+
summary: >-
160+
For EACH ITEM in the collection: Returns the properties that apply specifically to this placeholder. If the shape
161+
type isn't `placeholder`<!-- -->, then this method returns the `GeneralException` error.
162+
remarks: >-
163+
\[ [API set: PowerPointApi BETA (PREVIEW
164+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
165+
isPreview: true
166+
isDeprecated: false
167+
syntax:
168+
content: 'placeholderFormat?: PowerPoint.Interfaces.PlaceholderFormatLoadOptions;'
169+
return:
170+
type: '<xref uid="powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions:interface" />'
155171
- name: textFrame
156172
uid: 'powerpoint!PowerPoint.Interfaces.ShapeCollectionLoadOptions#textFrame:member'
157173
package: powerpoint!

docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.interfaces.shapeloadoptions.yml

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,22 @@ properties:
150150
content: 'parentGroup?: PowerPoint.Interfaces.ShapeLoadOptions;'
151151
return:
152152
type: '<xref uid="powerpoint!PowerPoint.Interfaces.ShapeLoadOptions:interface" />'
153+
- name: placeholderFormat
154+
uid: 'powerpoint!PowerPoint.Interfaces.ShapeLoadOptions#placeholderFormat:member'
155+
package: powerpoint!
156+
fullName: placeholderFormat
157+
summary: >-
158+
Returns the properties that apply specifically to this placeholder. If the shape type isn't `placeholder`<!-- -->,
159+
then this method returns the `GeneralException` error.
160+
remarks: >-
161+
\[ [API set: PowerPointApi BETA (PREVIEW
162+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
163+
isPreview: true
164+
isDeprecated: false
165+
syntax:
166+
content: 'placeholderFormat?: PowerPoint.Interfaces.PlaceholderFormatLoadOptions;'
167+
return:
168+
type: '<xref uid="powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions:interface" />'
153169
- name: textFrame
154170
uid: 'powerpoint!PowerPoint.Interfaces.ShapeLoadOptions#textFrame:member'
155171
package: powerpoint!

docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.interfaces.shapescopedcollectionloadoptions.yml

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -152,6 +152,22 @@ properties:
152152
content: 'parentGroup?: PowerPoint.Interfaces.ShapeLoadOptions;'
153153
return:
154154
type: '<xref uid="powerpoint!PowerPoint.Interfaces.ShapeLoadOptions:interface" />'
155+
- name: placeholderFormat
156+
uid: 'powerpoint!PowerPoint.Interfaces.ShapeScopedCollectionLoadOptions#placeholderFormat:member'
157+
package: powerpoint!
158+
fullName: placeholderFormat
159+
summary: >-
160+
For EACH ITEM in the collection: Returns the properties that apply specifically to this placeholder. If the shape
161+
type isn't `placeholder`<!-- -->, then this method returns the `GeneralException` error.
162+
remarks: >-
163+
\[ [API set: PowerPointApi BETA (PREVIEW
164+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
165+
isPreview: true
166+
isDeprecated: false
167+
syntax:
168+
content: 'placeholderFormat?: PowerPoint.Interfaces.PlaceholderFormatLoadOptions;'
169+
return:
170+
type: '<xref uid="powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions:interface" />'
155171
- name: textFrame
156172
uid: 'powerpoint!PowerPoint.Interfaces.ShapeScopedCollectionLoadOptions#textFrame:member'
157173
package: powerpoint!
Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
### YamlMime:TSType
2+
name: PowerPoint.PlaceholderFormat
3+
uid: 'powerpoint!PowerPoint.PlaceholderFormat:class'
4+
package: powerpoint!
5+
fullName: PowerPoint.PlaceholderFormat
6+
summary: Represents the properties of a `placeholder` shape.
7+
remarks: >-
8+
\[ [API set: PowerPointApi BETA (PREVIEW
9+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
10+
isPreview: true
11+
isDeprecated: false
12+
type: class
13+
properties:
14+
- name: containedType
15+
uid: 'powerpoint!PowerPoint.PlaceholderFormat#containedType:member'
16+
package: powerpoint!
17+
fullName: containedType
18+
summary: >-
19+
Gets the type of the shape contained within the placeholder. See
20+
[PowerPoint.ShapeType](xref:powerpoint!PowerPoint.ShapeType:enum) for details. Returns `null` if the placeholder
21+
is empty.
22+
remarks: >-
23+
\[ [API set: PowerPointApi BETA (PREVIEW
24+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
25+
isPreview: true
26+
isDeprecated: false
27+
syntax:
28+
content: 'readonly containedType: ShapeType | null;'
29+
return:
30+
type: '<xref uid="powerpoint!PowerPoint.ShapeType:enum" /> | null'
31+
- name: context
32+
uid: 'powerpoint!PowerPoint.PlaceholderFormat#context:member'
33+
package: powerpoint!
34+
fullName: context
35+
summary: >-
36+
The request context associated with the object. This connects the add-in's process to the Office host
37+
application's process.
38+
remarks: ''
39+
isPreview: true
40+
isDeprecated: false
41+
syntax:
42+
content: 'context: RequestContext;'
43+
return:
44+
type: '<xref uid="powerpoint!PowerPoint.RequestContext:class" />'
45+
- name: type
46+
uid: 'powerpoint!PowerPoint.PlaceholderFormat#type:member'
47+
package: powerpoint!
48+
fullName: type
49+
summary: >-
50+
Returns the type of this placeholder. See
51+
[PowerPoint.PlaceholderType](xref:powerpoint!PowerPoint.PlaceholderType:enum) for details.
52+
remarks: >-
53+
\[ [API set: PowerPointApi BETA (PREVIEW
54+
ONLY)](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets) \]
55+
isPreview: true
56+
isDeprecated: false
57+
syntax:
58+
content: >-
59+
readonly type: PowerPoint.PlaceholderType | "Unsupported" | "Date" | "SlideNumber" | "Footer" | "Header" |
60+
"Title" | "Body" | "CenterTitle" | "Subtitle" | "VerticalTitle" | "VerticalBody" | "Content" | "Chart" | "Table"
61+
| "OnlinePicture" | "SmartArt" | "Media" | "VerticalContent" | "Picture" | "Cameo";
62+
return:
63+
type: >-
64+
<xref uid="powerpoint!PowerPoint.PlaceholderType:enum" /> | "Unsupported" | "Date" | "SlideNumber" | "Footer"
65+
| "Header" | "Title" | "Body" | "CenterTitle" | "Subtitle" | "VerticalTitle" | "VerticalBody" | "Content" |
66+
"Chart" | "Table" | "OnlinePicture" | "SmartArt" | "Media" | "VerticalContent" | "Picture" | "Cameo"
67+
methods:
68+
- name: load(options)
69+
uid: 'powerpoint!PowerPoint.PlaceholderFormat#load:member(1)'
70+
package: powerpoint!
71+
fullName: load(options)
72+
summary: >-
73+
Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
74+
the properties.
75+
remarks: ''
76+
isPreview: true
77+
isDeprecated: false
78+
syntax:
79+
content: 'load(options?: PowerPoint.Interfaces.PlaceholderFormatLoadOptions): PowerPoint.PlaceholderFormat;'
80+
parameters:
81+
- id: options
82+
description: Provides options for which properties of the object to load.
83+
type: '<xref uid="powerpoint!PowerPoint.Interfaces.PlaceholderFormatLoadOptions:interface" />'
84+
return:
85+
type: '<xref uid="powerpoint!PowerPoint.PlaceholderFormat:class" />'
86+
description: ''
87+
- name: load(propertyNames)
88+
uid: 'powerpoint!PowerPoint.PlaceholderFormat#load:member(2)'
89+
package: powerpoint!
90+
fullName: load(propertyNames)
91+
summary: >-
92+
Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
93+
the properties.
94+
remarks: ''
95+
isPreview: true
96+
isDeprecated: false
97+
syntax:
98+
content: 'load(propertyNames?: string | string[]): PowerPoint.PlaceholderFormat;'
99+
parameters:
100+
- id: propertyNames
101+
description: A comma-delimited string or an array of strings that specify the properties to load.
102+
type: 'string | string[]'
103+
return:
104+
type: '<xref uid="powerpoint!PowerPoint.PlaceholderFormat:class" />'
105+
description: ''
106+
- name: load(propertyNamesAndPaths)
107+
uid: 'powerpoint!PowerPoint.PlaceholderFormat#load:member(3)'
108+
package: powerpoint!
109+
fullName: load(propertyNamesAndPaths)
110+
summary: >-
111+
Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading
112+
the properties.
113+
remarks: ''
114+
isPreview: true
115+
isDeprecated: false
116+
syntax:
117+
content: |-
118+
load(propertyNamesAndPaths?: {
119+
select?: string;
120+
expand?: string;
121+
}): PowerPoint.PlaceholderFormat;
122+
parameters:
123+
- id: propertyNamesAndPaths
124+
description: >-
125+
`propertyNamesAndPaths.select` is a comma-delimited string that specifies the properties to load, and
126+
`propertyNamesAndPaths.expand` is a comma-delimited string that specifies the navigation properties to load.
127+
type: |-
128+
{
129+
select?: string;
130+
expand?: string;
131+
}
132+
return:
133+
type: '<xref uid="powerpoint!PowerPoint.PlaceholderFormat:class" />'
134+
description: ''
135+
- name: toJSON()
136+
uid: 'powerpoint!PowerPoint.PlaceholderFormat#toJSON:member(1)'
137+
package: powerpoint!
138+
fullName: toJSON()
139+
summary: >-
140+
Overrides the JavaScript `toJSON()` method in order to provide more useful output when an API object is passed to
141+
`JSON.stringify()`<!-- -->. (`JSON.stringify`<!-- -->, in turn, calls the `toJSON` method of the object that's
142+
passed to it.) Whereas the original `PowerPoint.PlaceholderFormat` object is an API object, the `toJSON` method
143+
returns a plain JavaScript object (typed as `PowerPoint.Interfaces.PlaceholderFormatData`<!-- -->) that contains
144+
shallow copies of any loaded child properties from the original object.
145+
remarks: ''
146+
isPreview: true
147+
isDeprecated: false
148+
syntax:
149+
content: 'toJSON(): PowerPoint.Interfaces.PlaceholderFormatData;'
150+
return:
151+
type: '<xref uid="powerpoint!PowerPoint.Interfaces.PlaceholderFormatData:interface" />'
152+
description: ''
153+
extends: '<xref uid="office!OfficeExtension.ClientObject:class" />'

0 commit comments

Comments
 (0)