Word.ListFormat class
Representa as características de formatação de lista de um intervalo.
- Extends
Comentários
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. |
| is |
Indica se o |
| is |
Indica se o |
| list | Devolve um |
| list |
Especifica o número de nível de lista do primeiro parágrafo para o |
| list |
Obtém a representação de cadeia do valor de lista do primeiro parágrafo no intervalo do |
| list |
Obtém o modelo de lista associado ao |
| list |
Obtém o tipo da lista para o |
| list |
Obtém o valor numérico do primeiro parágrafo no intervalo do |
Métodos
| apply |
Adiciona marcas de lista e formatação aos parágrafos no intervalo. |
| apply |
Adiciona marcas de lista e formatação aos parágrafos no intervalo. |
| apply |
Aplica um modelo de lista com um nível específico aos parágrafos no intervalo. |
| apply |
Adiciona numeração e formatação aos parágrafos no intervalo. |
| apply |
Adiciona numeração e formatação aos parágrafos no intervalo. |
| apply |
Adiciona numeração e formatação hierárquicas aos parágrafos no intervalo. |
| apply |
Adiciona numeração e formatação hierárquicas aos parágrafos no intervalo. |
| can |
Determina se o |
| convert |
Converte números na lista em texto simples. |
| convert |
Converte números na lista em texto simples. |
| count |
Conta os itens numerados na lista. |
| list |
Avançar a lista por um nível. |
| list |
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 |
| load(property |
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
| load(property |
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
| remove |
Remove a numeração da lista. |
| remove |
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 |
| 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 |
| 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 |
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
isSingleListTemplate
Indica se o ListFormat objeto contém um único modelo de lista.
readonly isSingleListTemplate: boolean;
Valor da propriedade
boolean
Comentários
list
Devolve um List objeto que representa a primeira lista formatada contida no ListFormat objeto.
readonly list: Word.List;
Valor da propriedade
Comentários
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
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
listTemplate
Obtém o modelo de lista associado ao ListFormat objeto.
readonly listTemplate: Word.ListTemplate;
Valor da propriedade
Comentários
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
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
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
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
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
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
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
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
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
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
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
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
countNumberedItems(options)
Conta os itens numerados na lista.
countNumberedItems(options?: Word.ListFormatCountNumberedItemsOptions): OfficeExtension.ClientResult<number>;
Parâmetros
Opcional. Opções para contar itens numerados, como o tipo de número e o nível a contar.
Retornos
OfficeExtension.ClientResult<number>
O número de itens.
Comentários
listIndent()
Avançar a lista por um nível.
listIndent(): void;
Retornos
void
Comentários
listOutdent()
Diminui o avanço da lista por um nível.
listOutdent(): void;
Retornos
void
Comentários
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
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
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
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;