Compartilhar via


Word.ListFormat class

Representa as características de formatação de lista de um intervalo.

Extends

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

Propriedades

context

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

isSingleList

Indica se o ListFormat objeto contém uma única lista.

isSingleListTemplate

Indica se o ListFormat objeto contém um único modelo de lista.

list

Devolve um List objeto que representa a primeira lista formatada contida no ListFormat objeto.

listLevelNumber

Especifica o número de nível de lista do primeiro parágrafo para o ListFormat objeto.

listString

Obtém a representação de cadeia do valor de lista do primeiro parágrafo no intervalo do ListFormat objeto.

listTemplate

Obtém o modelo de lista associado ao ListFormat objeto.

listType

Obtém o tipo da lista para o ListFormat objeto.

listValue

Obtém o valor numérico do primeiro parágrafo no intervalo do ListFormat objeto.

Métodos

applyBulletDefault(defaultListBehavior)

Adiciona marcas de lista e formatação aos parágrafos no intervalo.

applyBulletDefault(defaultListBehavior)

Adiciona marcas de lista e formatação aos parágrafos no intervalo.

applyListTemplateWithLevel(listTemplate, options)

Aplica um modelo de lista com um nível específico aos parágrafos no intervalo.

applyNumberDefault(defaultListBehavior)

Adiciona numeração e formatação aos parágrafos no intervalo.

applyNumberDefault(defaultListBehavior)

Adiciona numeração e formatação aos parágrafos no intervalo.

applyOutlineNumberDefault(defaultListBehavior)

Adiciona numeração e formatação hierárquicas aos parágrafos no intervalo.

applyOutlineNumberDefault(defaultListBehavior)

Adiciona numeração e formatação hierárquicas aos parágrafos no intervalo.

canContinuePreviousList(listTemplate)

Determina se o ListFormat objeto pode continuar uma lista anterior.

convertNumbersToText(numberType)

Converte números na lista em texto simples.

convertNumbersToText(numberType)

Converte números na lista em texto simples.

countNumberedItems(options)

Conta os itens numerados na lista.

listIndent()

Avançar a lista por um nível.

listOutdent()

Diminui o avanço da lista por um nível.

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.

removeNumbers(numberType)

Remove a numeração da lista.

removeNumbers(numberType)

Remove a numeração da lista.

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.ListFormat é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.ListFormatData) 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.

Detalhes da propriedade

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

isSingleList

Indica se o ListFormat objeto contém uma única lista.

readonly isSingleList: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

isSingleListTemplate

Indica se o ListFormat objeto contém um único modelo de lista.

readonly isSingleListTemplate: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

list

Devolve um List objeto que representa a primeira lista formatada contida no ListFormat objeto.

readonly list: Word.List;

Valor da propriedade

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

listLevelNumber

Especifica o número de nível de lista do primeiro parágrafo para o ListFormat objeto.

listLevelNumber: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

listString

Obtém a representação de cadeia do valor de lista do primeiro parágrafo no intervalo do ListFormat objeto.

readonly listString: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

listTemplate

Obtém o modelo de lista associado ao ListFormat objeto.

readonly listTemplate: Word.ListTemplate;

Valor da propriedade

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

listType

Obtém o tipo da lista para o ListFormat objeto.

readonly listType: Word.ListType | "ListNoNumbering" | "ListListNumOnly" | "ListBullet" | "ListSimpleNumbering" | "ListOutlineNumbering" | "ListMixedNumbering" | "ListPictureBullet";

Valor da propriedade

Word.ListType | "ListNoNumbering" | "ListListNumOnly" | "ListBullet" | "ListSimpleNumbering" | "ListOutlineNumbering" | "ListMixedNumbering" | "ListPictureBullet"

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

listValue

Obtém o valor numérico do primeiro parágrafo no intervalo do ListFormat objeto.

readonly listValue: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

Detalhes do método

applyBulletDefault(defaultListBehavior)

Adiciona marcas de lista e formatação aos parágrafos no intervalo.

applyBulletDefault(defaultListBehavior: Word.DefaultListBehavior): void;

Parâmetros

defaultListBehavior
Word.DefaultListBehavior

Opcional. Especifica o comportamento predefinido da lista. A predefinição é word97.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

applyBulletDefault(defaultListBehavior)

Adiciona marcas de lista e formatação aos parágrafos no intervalo.

applyBulletDefault(defaultListBehavior: "Word97" | "Word2000" | "Word2002"): void;

Parâmetros

defaultListBehavior

"Word97" | "Word2000" | "Word2002"

Opcional. Especifica o comportamento predefinido da lista. A predefinição é word97.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

applyListTemplateWithLevel(listTemplate, options)

Aplica um modelo de lista com um nível específico aos parágrafos no intervalo.

applyListTemplateWithLevel(listTemplate: Word.ListTemplate, options?: Word.ListTemplateApplyOptions): void;

Parâmetros

listTemplate
Word.ListTemplate

O modelo de lista a aplicar.

options
Word.ListTemplateApplyOptions

Opcional. Opções para aplicar o modelo de lista, como se pretende continuar a lista anterior ou a que parte da lista deve aplicar o modelo.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

applyNumberDefault(defaultListBehavior)

Adiciona numeração e formatação aos parágrafos no intervalo.

applyNumberDefault(defaultListBehavior: Word.DefaultListBehavior): void;

Parâmetros

defaultListBehavior
Word.DefaultListBehavior

Opcional. Especifica o comportamento predefinido da lista.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

applyNumberDefault(defaultListBehavior)

Adiciona numeração e formatação aos parágrafos no intervalo.

applyNumberDefault(defaultListBehavior: "Word97" | "Word2000" | "Word2002"): void;

Parâmetros

defaultListBehavior

"Word97" | "Word2000" | "Word2002"

Opcional. Especifica o comportamento predefinido da lista.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

applyOutlineNumberDefault(defaultListBehavior)

Adiciona numeração e formatação hierárquicas aos parágrafos no intervalo.

applyOutlineNumberDefault(defaultListBehavior: Word.DefaultListBehavior): void;

Parâmetros

defaultListBehavior
Word.DefaultListBehavior

Opcional. Especifica o comportamento predefinido da lista.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

applyOutlineNumberDefault(defaultListBehavior)

Adiciona numeração e formatação hierárquicas aos parágrafos no intervalo.

applyOutlineNumberDefault(defaultListBehavior: "Word97" | "Word2000" | "Word2002"): void;

Parâmetros

defaultListBehavior

"Word97" | "Word2000" | "Word2002"

Opcional. Especifica o comportamento predefinido da lista.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

canContinuePreviousList(listTemplate)

Determina se o ListFormat objeto pode continuar uma lista anterior.

canContinuePreviousList(listTemplate: Word.ListTemplate): OfficeExtension.ClientResult<Word.Continue>;

Parâmetros

listTemplate
Word.ListTemplate

O modelo de lista a marcar.

Retornos

Um Continue valor que indica se a continuação é possível.

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

convertNumbersToText(numberType)

Converte números na lista em texto simples.

convertNumbersToText(numberType: Word.NumberType): void;

Parâmetros

numberType
Word.NumberType

Opcional. O tipo de número a converter.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

convertNumbersToText(numberType)

Converte números na lista em texto simples.

convertNumbersToText(numberType: "Paragraph" | "ListNum" | "AllNumbers"): void;

Parâmetros

numberType

"Paragraph" | "ListNum" | "AllNumbers"

Opcional. O tipo de número a converter.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

countNumberedItems(options)

Conta os itens numerados na lista.

countNumberedItems(options?: Word.ListFormatCountNumberedItemsOptions): OfficeExtension.ClientResult<number>;

Parâmetros

options
Word.ListFormatCountNumberedItemsOptions

Opcional. Opções para contar itens numerados, como o tipo de número e o nível a contar.

Retornos

O número de itens.

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

listIndent()

Avançar a lista por um nível.

listIndent(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

listOutdent()

Diminui o avanço da lista por um nível.

listOutdent(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

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.ListFormatLoadOptions): Word.ListFormat;

Parâmetros

options
Word.Interfaces.ListFormatLoadOptions

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

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

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

removeNumbers(numberType)

Remove a numeração da lista.

removeNumbers(numberType: Word.NumberType): void;

Parâmetros

numberType
Word.NumberType

Opcional. O tipo de número a remover.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

removeNumbers(numberType)

Remove a numeração da lista.

removeNumbers(numberType: "Paragraph" | "ListNum" | "AllNumbers"): void;

Parâmetros

numberType

"Paragraph" | "ListNum" | "AllNumbers"

Opcional. O tipo de número a remover.

Retornos

void

Comentários

[ Conjunto de API: WordApiDesktop 1.3 ]

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.ListFormatUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parâmetros

properties
Word.Interfaces.ListFormatUpdateData

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.ListFormat): void;

Parâmetros

properties
Word.ListFormat

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.ListFormat é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.ListFormatData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): Word.Interfaces.ListFormatData;

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

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

Retornos