4D v16
Accessar texto e atributos de imagem por programação
- Referência 4D Write Pro
-
- Linguagem 4D Write Pro
-
- Sobre objetos 4D Write Pro
- Utilizar os comandos do tema Objeto (Formulários)
- Utilizar os comanos do tema Texto com estilo
- Accessar texto e atributos de imagem por programação
- Constantes 4D Write Pro
- WP SET ATTRIBUTES
- WP CREATE BOOKMARKNew
- WP DELETE BOOKMARKNew
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get bookmark rangeNew
- WP GET BOOKMARKSNew
- WP Get page countNew
- WP Get paragraphs
- WP Get pictures
- WP Get range
- WP Get selection
- WP Import document
- WP INSERT BREAKNew
- WP INSERT DOCUMENTNew
- WP INSERT PICTURENew
- WP Is font style supported
- WP NewUpd
- WP PRINTUpd
- WP RESET ATTRIBUTES
- WP SELECT
- WP USE PAGE SETUP
- Atributos 4D Write Pro
Accessar texto e atributos de imagem por programação
4D Write Pro oferece um conjunto completo de comandos permitindo que modifique atributos de texto e imagens em seus documentos. Graças a estas propriedades, desenvolvedores 4D podem criar suas próprias interfaces de usuário (botões, menus, check boxes, etc) para os documentos 4D Write Pro. Comandos podem ser aplicados para documentos completos ou para porções específicos (faixas) ou baseads em seleções de usuários ou valores personalizados. Propriedades disponíveis incluem unidades de documentos, fundo, configurações de parágrafos, cores, fontes, estilos de fonte, assim como as propriedades de imagem.
Por exemplo, a 4D Write Pro area objeto de biblioteca faz uso extensivo de estas propriedades para oferecer uma interface 4D Write Pro sofisticada:
Diversos comandos são dedicados a manejar seleções nos documentos. Já que texto selecionado pode conter tags (invisíveis) de formatação, 4D Write Pro trabalha com faixas (ranges). Uma faixa é um objeto que representa uma porção do documento 4D Write.
- WP Get range( wpArea ; startRange ; endRange ) -> rangeObj: retorna uma nova range correspondente aos limites passados como parâmetros.
- ( {*;} wpArea ) -> rangeObj: retorna uma nova range correspondente a seleção do usuário atual.
- WP Get pictures( rangeObj ) -> rangeObj: retorna uma nova range contendo apenas as imagens.
- WP Get paragraphs( rangeObj ) -> rangeObj: retorna uma nova ange contendo apenas os parágrafos.
- WP SELECT( {*;} wpArea {; rangeObj}{; startRange ; endRange} ): seleciona o texto correspondente a range.
4D Write Pro permite criar e trabalhar com referências dinâmicas para faixas, chamadas bookmarks. Uma bookmark é uma referência de nome anexada à faixa especifica em um documento 4D Write Pro.
Bookmarks são dinâmicas, que significa que se suas faixas associadas são modificadas, estendidas ou reduzidas, a bookmark ainda vai referenciar a mesma faixa dentro do documento. Por exemplo:
- Se criar uma bookmark chamada "MyBM" que referencia o texto "Hello world" na página 20 de seu documento.
- Se então inserir 50 páginas no começo do documento.
- Mesmo assim ainda poderá acessar o mesmo texto "Hello world" automaticamente, agora na página 70 do documento, através da bookmark "MyBM".
Um documento pode conter um número ilimitado de bookmarks. Diversas bookmarks podem referenciar a mesma faixa, e faixas de bookmarks podem ser can intercaladas. Entretanto, cada nome de bookmark pode ser único no documento. Bookmarks não são importados quando usando o comando MissingRef ou WP New (bookmarks no documento destino não podem ser gravadas por cima).
Ao ser criada, uma bookmark é armazenada dentro do documento. A bookmark é salvada com o documento e pode ser manejada através de diversos comandos. Também pode ser usada para referenciar partes de um documento modelo. Estas partes podem então ser juntadas automaticamente com dados do banco de dados para produzir documentos output dinâmicos tais como faturas ou catálogos.
Diversos comandos permitem que crie, remova ou use bookmarks:
- WP CREATE BOOKMARK para criar uma nova bookmark de uma faixa,
- para obter todas as bookmarks definidas em um documento,
- WP Get bookmark range para recuperar uma faixa de uma bookmark existente,
- WP DELETE BOOKMARK para apagar uma bookmark.
Os comandos abaixo podem obter ou estabelecer qualquer atributos do documento:
- WP SET ATTRIBUTES( rangeObj | wpDoc ; attribName ; attribValue {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} ): estabelece um ou mais pares de atributo/valores no documento ou range.
- WP GET ATTRIBUTES( rangeObj | wpDoc ; attribName ; attribValue {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} ): obtém o valor atual de atributos no documento ou range.
- WP RESET ATTRIBUTES( rangeObj ; attribName {; attribName2 ; ... ; attribNameN } ): reseta valores de atributo no documento ou range.
Atributos são detalhados na seção Atributos 4D Write Pro.
Este comando permite que consiga informação sobre suporte de estilo para uma range:
- WP Is font style supported ( rangeObj ; wpFontStyle ) -> true or false: permite que saiba se uma range suporta um determinado estilo (útil para criar uma interface).
Produto: 4D
Tema: Linguagem 4D Write Pro
Modificado: 4D v16
Referência 4D Write Pro ( 4D v16)
