Compartilhar via


Word.TableOfFigures class

Representa uma tabela de ilustrações num Word documento.

Extends

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

Propriedades

additionalHeadingStyles

Obtém os estilos adicionais utilizados para a tabela de ilustrações. Os estilos predefinidos "Cabeçalho 1" - "Cabeçalho 9" não estão incluídos nesta coleção.

areBuiltInHeadingStylesUsed

Especifica se os estilos de cabeçalho incorporados são utilizados para o índice de ilustrações.

areFieldsUsed

Especifica se os campos de Entrada de Índice (TC) estão incluídos no índice de ilustrações.

areHyperlinksUsedOnWeb

Especifica se as entradas na tabela de ilustrações devem ser formatadas como hiperligações ao publicar na Web.

arePageNumbersHiddenOnWeb

Especifica se os números de página na tabela de ilustrações devem ser ocultados ao publicar na Web.

arePageNumbersIncluded

Especifica se os números de página estão incluídos na tabela de ilustrações.

arePageNumbersRightAligned

Especifica se os números de página estão alinhados com a margem direita na tabela de ilustrações.

captionLabel

Especifica a etiqueta que identifica os itens a serem incluídos na tabela de ilustrações.

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

isLabelIncluded

Especifica se a etiqueta legenda e legenda número estão incluídos na tabela de ilustrações.

lowerHeadingLevel

Especifica o nível de cabeçalho final para o índice de ilustrações. Tem de ser um valor de 1 a 9 e superior a upperHeadingLevel.

range

Obtém a parte de um documento que é esta tabela de ilustrações.

tabLeader

Especifica o caráter entre as entradas e os respetivos números de página na tabela de ilustrações.

tableId

Especifica um identificador de uma letra dos campos TC que é utilizado para a tabela de ilustrações.

upperHeadingLevel

Especifica o nível de cabeçalho inicial para a tabela de ilustrações. Tem de ser um valor de 1 a 9 e inferior a lowerHeadingLevel.

Métodos

delete()

Elimina esta tabela de ilustrações.

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.

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base num objeto carregado existente.

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original Word.TableOfFigures é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.TableOfFiguresData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

track()

Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Esta chamada é uma abreviatura de context.trackedObjects.add(thisObject). Se estiver a utilizar este 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, terá de adicionar o objeto à coleção de objetos controlados quando o objeto foi criado pela primeira vez. Se este objeto fizer parte de uma coleção, também deve controlar a coleção principal.

untrack()

Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Esta 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. Terá de chamar context.sync() antes de a libertação da memória ser aplicada.

updatePageNumbers()

Atualizações toda a tabela de ilustrações.

Detalhes da propriedade

additionalHeadingStyles

Obtém os estilos adicionais utilizados para a tabela de ilustrações. Os estilos predefinidos "Cabeçalho 1" - "Cabeçalho 9" não estão incluídos nesta coleção.

readonly additionalHeadingStyles: Word.HeadingStyleCollection;

Valor da propriedade

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

areBuiltInHeadingStylesUsed

Especifica se os estilos de cabeçalho incorporados são utilizados para o índice de ilustrações.

areBuiltInHeadingStylesUsed: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

areFieldsUsed

Especifica se os campos de Entrada de Índice (TC) estão incluídos no índice de ilustrações.

areFieldsUsed: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

areHyperlinksUsedOnWeb

Especifica se as entradas na tabela de ilustrações devem ser formatadas como hiperligações ao publicar na Web.

areHyperlinksUsedOnWeb: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

arePageNumbersHiddenOnWeb

Especifica se os números de página na tabela de ilustrações devem ser ocultados ao publicar na Web.

arePageNumbersHiddenOnWeb: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

arePageNumbersIncluded

Especifica se os números de página estão incluídos na tabela de ilustrações.

arePageNumbersIncluded: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

arePageNumbersRightAligned

Especifica se os números de página estão alinhados com a margem direita na tabela de ilustrações.

arePageNumbersRightAligned: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

captionLabel

Especifica a etiqueta que identifica os itens a serem incluídos na tabela de ilustrações.

captionLabel: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

isLabelIncluded

Especifica se a etiqueta legenda e legenda número estão incluídos na tabela de ilustrações.

isLabelIncluded: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

lowerHeadingLevel

Especifica o nível de cabeçalho final para o índice de ilustrações. Tem de ser um valor de 1 a 9 e superior a upperHeadingLevel.

lowerHeadingLevel: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

range

Obtém a parte de um documento que é esta tabela de ilustrações.

readonly range: Word.Range;

Valor da propriedade

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

tabLeader

Especifica o caráter entre as entradas e os respetivos números de página na tabela de ilustrações.

tabLeader: Word.TabLeader | "Spaces" | "Dots" | "Dashes" | "Lines" | "Heavy" | "MiddleDot";

Valor da propriedade

Word.TabLeader | "Spaces" | "Dots" | "Dashes" | "Lines" | "Heavy" | "MiddleDot"

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

tableId

Especifica um identificador de uma letra dos campos TC que é utilizado para a tabela de ilustrações.

tableId: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

upperHeadingLevel

Especifica o nível de cabeçalho inicial para a tabela de ilustrações. Tem de ser um valor de 1 a 9 e inferior a lowerHeadingLevel.

upperHeadingLevel: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

Detalhes do método

delete()

Elimina esta tabela de ilustrações.

delete(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 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.TableOfFiguresLoadOptions): Word.TableOfFigures;

Parâmetros

options
Word.Interfaces.TableOfFiguresLoadOptions

Fornece opções para as propriedades do objeto a carregar.

Retornos

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.TableOfFigures;

Parâmetros

propertyNames

string | string[]

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

Retornos

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?: {
            select?: string;
            expand?: string;
        }): Word.TableOfFigures;

Parâmetros

propertyNamesAndPaths

{ select?: string; expand?: string; }

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

Retornos

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

set(properties: Interfaces.TableOfFiguresUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parâmetros

properties
Word.Interfaces.TableOfFiguresUpdateData

Um objeto JavaScript com propriedades que são estruturadas isomorfoticamente para as propriedades do objeto no qual o método é chamado.

options
OfficeExtension.UpdateOptions

Fornece uma opção para suprimir erros se o objeto de propriedades tentar definir quaisquer propriedades só de leitura.

Retornos

void

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base num objeto carregado existente.

set(properties: Word.TableOfFigures): void;

Parâmetros

properties
Word.TableOfFigures

Retornos

void

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original Word.TableOfFigures é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.TableOfFiguresData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): Word.Interfaces.TableOfFiguresData;

Retornos

track()

Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Esta chamada é uma abreviatura de context.trackedObjects.add(thisObject). Se estiver a utilizar este 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, terá de adicionar o objeto à coleção de objetos controlados quando o objeto foi criado pela primeira vez. Se este objeto fizer parte de uma coleção, também deve controlar a coleção principal.

track(): Word.TableOfFigures;

Retornos

untrack()

Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Esta 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. Terá de chamar context.sync() antes de a libertação da memória ser aplicada.

untrack(): Word.TableOfFigures;

Retornos

updatePageNumbers()

Atualizações toda a tabela de ilustrações.

updatePageNumbers(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]