PageCollection object (JavaScript API for Visio)
Applies to: Visio Online
Represents a collection of Page objects that are part of the document.
Properties
| Property | Type | Description |
|---|---|---|
| items | Page[] | A collection of page objects. Read-only. |
Relationships
None
Methods
| Method | Return Type | Description |
|---|---|---|
| getCount() | int | Gets the number of pages in the collection. |
| getItem(key: number or string) | Page | Gets a page using its key (name or Id). |
| load(param: object) | void | Fills the proxy object created in JavaScript layer with property and object values specified in the parameter. |
Method Details
getCount()
Gets the number of pages in the collection.
Syntax
pageCollectionObject.getCount();
Parameters
None
Returns
int
getItem(key: number or string)
Gets a page using its key (name or Id).
Syntax
pageCollectionObject.getItem(key);
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| key | number or string | Key is the name or Id of the page to be retrieved. |
Returns
Examples
Visio.run(function (ctx) {
var pageName = 'Page-1';
var page = ctx.document.pages.getItem(pageName);
page.activate();
return ctx.sync();
}).catch(function(error) {
console.log("Error: " + error);
if (error instanceof OfficeExtension.Error) {
console.log("Debug info: " + JSON.stringify(error.debugInfo));
}
});
load(param: object)
Fills the proxy object created in JavaScript layer with property and object values specified in the parameter.
Syntax
object.load(param);
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| param | object | Optional. Accepts parameter and relationship names as delimited string or an array. Or, provide loadOption object. |
Returns
void
Fills the proxy object created in JavaScript layer with property and object values specified in the parameter.
Syntax
object.load(param);
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| param | object | Optional. Accepts parameter and relationship names as delimited string or an array. Or, provide loadOption object. |
Returns
void