Word.CustomXmlPartScopedCollection class

Pacote:

word

Contém a coleção de Word. Objetos CustomXmlPart com um namespace específico.

Extends

OfficeExtension.ClientObject

Comentários

[ Conjunto de API: WordApi 1.4 ]

Propriedades

context	O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.
items	Obtém os itens filhos carregados nesta coleção.

Métodos

getCount()	Obtém o número de itens na coleção.
getItem(id)	Obtém uma parte XML personalizada com base em sua ID.
getItemOrNullObject(id)	Obtém uma parte XML personalizada com base em sua ID. Se o CustomXmlPart não existir na coleção, esse método retornará um objeto com sua isNullObject propriedade definida como true. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getOnlyItem()	Se o conjunto contiver exatamente um item, esse método o retornará. Caso contrário, esse método produzirá um erro.
getOnlyItemOrNullObject()	Se o conjunto contiver exatamente um item, esse método o retornará. Caso contrário, esse método retornará um objeto com sua isNullObject propriedade definida como true. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
load(options)	Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.
load(propertyNames)	Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.
load(propertyNamesAndPaths)	Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.
toJSON()	Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é passado para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que é passado para ele.) Considerando que o objeto original Word.CustomXmlPartScopedCollection é um objeto API, o toJSON método retorna um objeto JavaScript simples (digitado como Word.Interfaces.CustomXmlPartScopedCollectionData) que contém uma matriz de "itens" com cópias rasas de quaisquer propriedades carregadas dos itens da coleção.
track()	Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Essa chamada é uma abreviação para context.trackedObjects.add(thisObject). Se você estiver usando esse objeto entre .sync chamadas e fora da execução sequencial de um lote ".run" e receber um erro "InvalidObjectPath" ao definir uma propriedade ou invocar um método no objeto, você precisará adicionar o objeto à coleção de objetos rastreados quando o objeto foi criado pela primeira vez. Se esse objeto fizer parte de uma coleção, você também deverá acompanhar a coleção pai.
untrack()	Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Essa chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Você precisará chamar context.sync() antes que a versão da memória entre em vigor.

Detalhes da propriedade

context

O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.

context: RequestContext;

Valor da propriedade

Word.RequestContext

items

Obtém os itens filhos carregados nesta coleção.

readonly items: Word.CustomXmlPart[];

Valor da propriedade

Word.CustomXmlPart[]

Detalhes do método

getCount()

Obtém o número de itens na coleção.

getCount(): OfficeExtension.ClientResult<number>;

Retornos

OfficeExtension.ClientResult<number>

Comentários

[ Conjunto de API: WordApi 1.4 ]

getItem(id)

Obtém uma parte XML personalizada com base em sua ID.

getItem(id: string): Word.CustomXmlPart;

Parâmetros

id

string

ID da parte XML personalizada a ser recuperada.

Retornos

Word.CustomXmlPart

Comentários

[ Conjunto de API: WordApi 1.4 ]

getItemOrNullObject(id)

Obtém uma parte XML personalizada com base em sua ID. Se o CustomXmlPart não existir na coleção, esse método retornará um objeto com sua isNullObject propriedade definida como true. Para obter mais informações, consulte *Métodos e propriedades orNullObject.

getItemOrNullObject(id: string): Word.CustomXmlPart;

Parâmetros

id

string

Obrigatório. ID do objeto a ser recuperado.

Retornos

Word.CustomXmlPart

Comentários

[ Conjunto de API: WordApi 1.4 ]

getOnlyItem()

Se o conjunto contiver exatamente um item, esse método o retornará. Caso contrário, esse método produzirá um erro.

getOnlyItem(): Word.CustomXmlPart;

Retornos

Word.CustomXmlPart

Comentários

[ Conjunto de API: WordApi 1.4 ]

getOnlyItemOrNullObject()

Se o conjunto contiver exatamente um item, esse método o retornará. Caso contrário, esse método retornará um objeto com sua isNullObject propriedade definida como true. Para obter mais informações, consulte *Métodos e propriedades orNullObject.

getOnlyItemOrNullObject(): Word.CustomXmlPart;

Retornos

Word.CustomXmlPart

Comentários

[ Conjunto de API: WordApi 1.4 ]

load(options)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(options?: Word.Interfaces.CustomXmlPartScopedCollectionLoadOptions & Word.Interfaces.CollectionLoadOptions): Word.CustomXmlPartScopedCollection;

Parâmetros

options

Word.Interfaces.CustomXmlPartScopedCollectionLoadOptions & Word.Interfaces.CollectionLoadOptions

Fornece opções para quais propriedades do objeto carregar.

Retornos

Word.CustomXmlPartScopedCollection

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames?: string | string[]): Word.CustomXmlPartScopedCollection;

Parâmetros

propertyNames

string | string[]

Uma cadeia de caracteres delimitada por vírgulas ou uma matriz de cadeias de caracteres que especificam as propriedades a serem carregadas.

Retornos

Word.CustomXmlPartScopedCollection

load(propertyNamesAndPaths)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Word.CustomXmlPartScopedCollection;

Parâmetros

propertyNamesAndPaths

OfficeExtension.LoadOption

propertyNamesAndPaths.select é uma cadeia de caracteres delimitada por vírgulas que especifica as propriedades a serem carregadas e propertyNamesAndPaths.expand é uma cadeia de caracteres delimitada por vírgulas que especifica as propriedades de navegação a serem carregadas.

Retornos

Word.CustomXmlPartScopedCollection

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é passado para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que é passado para ele.) Considerando que o objeto original Word.CustomXmlPartScopedCollection é um objeto API, o toJSON método retorna um objeto JavaScript simples (digitado como Word.Interfaces.CustomXmlPartScopedCollectionData) que contém uma matriz de "itens" com cópias rasas de quaisquer propriedades carregadas dos itens da coleção.

toJSON(): Word.Interfaces.CustomXmlPartScopedCollectionData;

Retornos

Word.Interfaces.CustomXmlPartScopedCollectionData

track()

Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Essa chamada é uma abreviação para context.trackedObjects.add(thisObject). Se você estiver usando esse objeto entre .sync chamadas e fora da execução sequencial de um lote ".run" e receber um erro "InvalidObjectPath" ao definir uma propriedade ou invocar um método no objeto, você precisará adicionar o objeto à coleção de objetos rastreados quando o objeto foi criado pela primeira vez. Se esse objeto fizer parte de uma coleção, você também deverá acompanhar a coleção pai.

track(): Word.CustomXmlPartScopedCollection;

Retornos

Word.CustomXmlPartScopedCollection

untrack()

Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Essa chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Você precisará chamar context.sync() antes que a versão da memória entre em vigor.

untrack(): Word.CustomXmlPartScopedCollection;

Retornos

Word.CustomXmlPartScopedCollection