Word.Interfaces.ContentControlLoadOptions interface
Representa um controle de conteúdo. Controles de conteúdo são regiões limitadas e possivelmente rotuladas de um documento, que servem como contêineres para tipos específicos de conteúdo. Os controles de conteúdo individuais podem incluir conteúdo, como imagens, tabelas ou parágrafos de texto formatado. Atualmente, apenas são suportados controlos de conteúdo de rich text, texto simples e caixa de verificação.
Comentários
[ Conjunto de API: WordApi 1.1 ]
Propriedades
$all | Especificar |
appearance | Especifica o aspeto do controlo de conteúdo. O valor pode ser "BoundingBox", "Tags" ou "Hidden". |
cannot |
Especifica um valor que indica se o utilizador pode eliminar o controlo de conteúdo. Mutuamente exclusivo com a propriedade removeWhenEdited. |
cannot |
Especifica um valor que indica se o utilizador pode editar os conteúdos do controlo de conteúdo. |
checkbox |
Obtém os dados do controlo de conteúdo quando o respetivo tipo é "Caixa de Verificação". De |
color | Especifica a cor do controlo de conteúdo. A cor é especificada no formato "#RRGGBB" ou utilizando o nome da cor. |
font | Obtém o formato de texto do controle de conteúdo. Use isto para obter e definir o nome, o tamanho e a cor da fonte, além de outras propriedades. |
id | Obtém um número inteiro que representa o identificador do controle de conteúdo. |
parent |
Obtém o corpo pai do controle de conteúdo. |
parent |
Obtém o controle de conteúdo que inclui o controle de conteúdo. Gera um |
parent |
Obtém o controle de conteúdo que inclui o controle de conteúdo. Se não existir um controlo de conteúdo principal, este método devolverá um objeto com a respetiva |
parent |
Obtém a tabela que contém o controle de conteúdo. Gera um |
parent |
Obtém a célula de tabela que contém o controle de conteúdo. Gera um |
parent |
Obtém a célula de tabela que contém o controle de conteúdo. Se não estiver contido numa célula de tabela, este método devolverá um objeto com a respetiva |
parent |
Obtém a tabela que contém o controle de conteúdo. Se não estiver contido numa tabela, este método devolverá um objeto com a respetiva |
placeholder |
Especifica o texto do marcador de posição do controlo de conteúdo. Quando o controle de conteúdo está vazio, o sistema exibe o texto esmaecido. |
remove |
Especifica um valor que indica se o controlo de conteúdo é removido depois de ser editado. Mutuamente exclusivo com a propriedade cannotDelete. |
style | Especifica o nome do estilo para o controlo de conteúdo. Use esta propriedade de estilos personalizados e nomes de estilo localizados. Para usar os estilos internos que são portáteis entre localidades, confira a propriedade "styleBuiltIn". |
style |
Especifica o nome de estilo incorporado para o controlo de conteúdo. Use esta propriedade para estilos internos que são portáteis entre localidades. Para usar estilos personalizados ou nomes de estilo localizados, confira a propriedade "estilo". |
subtype | Obtém o subtipo de controle de conteúdo. O subtipo pode ser "RichTextInline", "RichTextParagraphs", "RichTextTableCell", "RichTextTableRow" e "RichTextTable" para controlos de conteúdo de texto formatado ou "PlainTextInline" e "PlainTextParagraph" para controlos de conteúdo de texto simples ou "Caixa de Verificação" para controlos de conteúdo da caixa de verificação. |
tag | Especifica uma etiqueta para identificar um controlo de conteúdo. |
text | Obtém o texto do controle de conteúdo. |
title | Especifica o título de um controlo de conteúdo. |
type | Obtém o tipo de controle de conteúdo. Atualmente, só são suportados controlos de conteúdo de rich text, texto simples e caixa de verificação. |
Detalhes da propriedade
$all
Especificar $all
para as opções de carga carrega todas as propriedades escalares (como Range.address
) mas não as propriedades de navegação (como Range.format.fill.color
).
$all?: boolean;
Valor da propriedade
boolean
appearance
Especifica o aspeto do controlo de conteúdo. O valor pode ser "BoundingBox", "Tags" ou "Hidden".
appearance?: boolean;
Valor da propriedade
boolean
Comentários
cannotDelete
Especifica um valor que indica se o utilizador pode eliminar o controlo de conteúdo. Mutuamente exclusivo com a propriedade removeWhenEdited.
cannotDelete?: boolean;
Valor da propriedade
boolean
Comentários
cannotEdit
Especifica um valor que indica se o utilizador pode editar os conteúdos do controlo de conteúdo.
cannotEdit?: boolean;
Valor da propriedade
boolean
Comentários
checkboxContentControl
Obtém os dados do controlo de conteúdo quando o respetivo tipo é "Caixa de Verificação". De null
outra forma.
checkboxContentControl?: Word.Interfaces.CheckboxContentControlLoadOptions;
Valor da propriedade
Comentários
color
Especifica a cor do controlo de conteúdo. A cor é especificada no formato "#RRGGBB" ou utilizando o nome da cor.
color?: boolean;
Valor da propriedade
boolean
Comentários
font
Obtém o formato de texto do controle de conteúdo. Use isto para obter e definir o nome, o tamanho e a cor da fonte, além de outras propriedades.
font?: Word.Interfaces.FontLoadOptions;
Valor da propriedade
Comentários
id
Obtém um número inteiro que representa o identificador do controle de conteúdo.
id?: boolean;
Valor da propriedade
boolean
Comentários
parentBody
Obtém o corpo pai do controle de conteúdo.
parentBody?: Word.Interfaces.BodyLoadOptions;
Valor da propriedade
Comentários
parentContentControl
Obtém o controle de conteúdo que inclui o controle de conteúdo. Gera um ItemNotFound
erro se não existir um controlo de conteúdo principal.
parentContentControl?: Word.Interfaces.ContentControlLoadOptions;
Valor da propriedade
Comentários
parentContentControlOrNullObject
Obtém o controle de conteúdo que inclui o controle de conteúdo. Se não existir um controlo de conteúdo principal, este método devolverá um objeto com a respetiva isNullObject
propriedade definida como true
. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).
parentContentControlOrNullObject?: Word.Interfaces.ContentControlLoadOptions;
Valor da propriedade
Comentários
parentTable
Obtém a tabela que contém o controle de conteúdo. Gera um ItemNotFound
erro se não estiver contido numa tabela.
parentTable?: Word.Interfaces.TableLoadOptions;
Valor da propriedade
Comentários
parentTableCell
Obtém a célula de tabela que contém o controle de conteúdo. Gera um ItemNotFound
erro se não estiver contido numa célula de tabela.
parentTableCell?: Word.Interfaces.TableCellLoadOptions;
Valor da propriedade
Comentários
parentTableCellOrNullObject
Obtém a célula de tabela que contém o controle de conteúdo. Se não estiver contido numa célula de tabela, este método devolverá um objeto com a respetiva isNullObject
propriedade definida como true
. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).
parentTableCellOrNullObject?: Word.Interfaces.TableCellLoadOptions;
Valor da propriedade
Comentários
parentTableOrNullObject
Obtém a tabela que contém o controle de conteúdo. Se não estiver contido numa tabela, este método devolverá um objeto com a respetiva isNullObject
propriedade definida como true
. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).
parentTableOrNullObject?: Word.Interfaces.TableLoadOptions;
Valor da propriedade
Comentários
placeholderText
Especifica o texto do marcador de posição do controlo de conteúdo. Quando o controle de conteúdo está vazio, o sistema exibe o texto esmaecido.
placeholderText?: boolean;
Valor da propriedade
boolean
Comentários
removeWhenEdited
Especifica um valor que indica se o controlo de conteúdo é removido depois de ser editado. Mutuamente exclusivo com a propriedade cannotDelete.
removeWhenEdited?: boolean;
Valor da propriedade
boolean
Comentários
style
Especifica o nome do estilo para o controlo de conteúdo. Use esta propriedade de estilos personalizados e nomes de estilo localizados. Para usar os estilos internos que são portáteis entre localidades, confira a propriedade "styleBuiltIn".
style?: boolean;
Valor da propriedade
boolean
Comentários
styleBuiltIn
Especifica o nome de estilo incorporado para o controlo de conteúdo. Use esta propriedade para estilos internos que são portáteis entre localidades. Para usar estilos personalizados ou nomes de estilo localizados, confira a propriedade "estilo".
styleBuiltIn?: boolean;
Valor da propriedade
boolean
Comentários
subtype
Obtém o subtipo de controle de conteúdo. O subtipo pode ser "RichTextInline", "RichTextParagraphs", "RichTextTableCell", "RichTextTableRow" e "RichTextTable" para controlos de conteúdo de texto formatado ou "PlainTextInline" e "PlainTextParagraph" para controlos de conteúdo de texto simples ou "Caixa de Verificação" para controlos de conteúdo da caixa de verificação.
subtype?: boolean;
Valor da propriedade
boolean
Comentários
tag
Especifica uma etiqueta para identificar um controlo de conteúdo.
tag?: boolean;
Valor da propriedade
boolean
Comentários
text
Obtém o texto do controle de conteúdo.
text?: boolean;
Valor da propriedade
boolean
Comentários
title
Especifica o título de um controlo de conteúdo.
title?: boolean;
Valor da propriedade
boolean
Comentários
type
Obtém o tipo de controle de conteúdo. Atualmente, só são suportados controlos de conteúdo de rich text, texto simples e caixa de verificação.
type?: boolean;
Valor da propriedade
boolean