4D Doc Center : WR SET TEXT PROPERTY

4D Write v14

WR SET TEXT PROPERTY


WR SET TEXT PROPERTY ( area ; propriedade ; valor )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D Write
propriedade	Inteiro	Número de propriedade de texto a fixar
valor	Inteiro longo	Valor para a propriedade selecionada

Descrição

O comando WR SET TEXT PROPERTY permite modificar os atributos do texto selecionado em área.

Os parâmetros propriedade e valor se utilizam juntos.

Nota: É recomendado utilizar o comando WR SET FONT no lugar de WR SET TEXT PROPERTY (Area;wr font number;Valor), porque os números de fonte se geram dinamicamente e variam de um sistema ao outro.

Se passar um número de propriedade errado, é gerado o erro 1075.
Se passar um valor errado para a propriedade selecionada, é gerado o erro 1076.

Notas:

propriedade e valor podem ser definidos utilizando constantes. As listas de propriedades de texto e dos valores para as propriedades de texto se encontram nos temas das constantes "WR Text properties" e "WR Text properties values". Pode passar indiferentemente o valor ou a constante.
A lista de códigos erro está disponível em Anexo C: Códigos de erros.

As seguintes constantes e valores podem ser utilizadas com os comandos WR SET TEXT PROPERTY e WR Get text property:

propriedade (WR Propriedades de texto)	utilizado para definir ou ler (valor ou WR Valores para propriedades de texto)
wr bold (0)	o estilo negrito no texto (false=0, true=1)
wr italic (1)	o estilo itálico no texto (false=0, true=1)
wr shadow (2)	o estilo sombreado no texto (false=0, true=1)
wr strikethrough (3)	o estilo tachado no texto (false=0, true=1)
wr underline (4)	o estilo sublinhado no texto: sem sublinhado=0, wr single underline (1), wr word underline (2), wr double underline (3), wr hatched underline (4)
wr superscript or subscript (5)	texto em superíndice ou subíndice: nenhum=0, wr superscript (1), wr subscript (2)
wr capital case (6)	texto em versaletes, minúsculas ou maiúsculas: minúsculas=0, wr capitals (1), wr small capitals (2)
wr font number (7)	o valor passado é um número interno. 4D Write atribui os números de fonte gradualmente a medida que se utilizam. Se recomenda geralmente utilizar os comandos WR Get font e WR SET FONT que trabalham com os nomes de fontes.
wr font size (8)	o tamanho do texto (valor entre 9 e 255)
wr text color (9)	o valor deve ser passado de forma 0x00RRGGBB como em 4D (ou nas versões anteriores de 4D Write). Pode utilizar as constantes do tema WR Standard colors.
wr text back color (10)
wr strikethrough color (11)
wr underline color (12)
wr shadow color (13)
wr links appearance (14)	la aparência dos links: wr no links appearance (0), wr unvisited links appearance (1), wr visited links appearance (2)
wr stylesheet number (15)	passe o número de índice da folha de estilo na lista. Lembre que se passar um índice de folha de estilo, será atribuído ao texto uma folha de estilo, mas as propriedades da folha de estilo não serão aplicadas. O comando WR APPLY STYLESHEET define a propriedade e aplica as propriedades da folha de estilo.
wr user property (16)	seu valor se fixa livremente. Pode definir e ler todo valor personalizado para esta propriedade. Por exemplo, se deseja conservar uma lista hierárquica em paralelo com um texto, pode utilizar esta propriedade para guardar uma referencia de elemento da lista hierárquica. Cada vez que fizer clique no texto, obtém a propriedade e seleciona o elemento correspondente na lista hierárquica.
wr justification (32)	justificação do texto: wr left justified (0), wr centered (1), wr right justified (2), wr full justified (3)
wr line spacing (33)	em entrelinhas, o valor varia de 1 a 10 em passos de 0.5: 1=entrelinhas simples, 1.5=1.5 entrelinha, 2=entrelinhas duplas
wr bullet (34)	o estilo da vinheta: wr black square bullet (110), wr white square bullet (111), wr black circle bullet (108), wr white circle bullet (109), wr diamonds bullet (117), wr clubs bullet (118), wr no bullet (0)
wr left margin (35)	a distância com respeito à margem morta esquerda. O valor se expressa na unidade atual do documento.
wr first indent (36)	a distância com respeito à margem direita. <0 = à esquerda da margem direita, >0 = à direita da margem direita. O valor se expressa na unidade atual do documento.
wr right margin (37)	a distância com respeito à margem morta direita. O valor se expressa na unidade atual do documento.
wr border back color (38)	o valor deve ser passado da forma 0x00RRGGBB como em 4D (ou em versões anteriores de 4D Write). Pode utilizar as constantes do tema .
wr border line color (39)
wr border line style (40)	o estilo e o tamanho da linha de borde: wr 1 pt line (0), wr 2 pts line (1), wr 3 pts line (2), wr dotted line (3), wr double dotted line (4), wr triple dotted line (5), wr double 1 pt line (6), wr double inside 2 pts line (7), wr triple center 2 pts line (8), wr double outside 2 pts line (9), wr half pt line (10), wr quarter pt linet (11). Definir o estilo do borde diretamente afeta os bordes da seleção, ou lhe permite definir o tipo de borde antes de colocar. É melhor definir o tipo de borde primeiro e depois localizar. Dessa forma, evita ter que voltar a desenhar. Lembre que o estilo do borde é o mesmo para todos os lados (esquerda/direita e acima/abaixo) de uma seleção.
wr left border (41)	definir o borde (false=0, true=1)
wr right border (42)	definir o borde (false=0, true=1)
wr inside top border (43)	definir o borde interno (false=0, true=1). Um espaço é adicionado acima e abaixo do parágrafo.
wr inside bottom border (44)	define o borde interno (false=0, true=1). Um espaço é adicionado acima e abaixo do parágrafo.
wr border spacing (45)	a distância entre o borde e o texto. O valor se expressa na unidade atual do documento.
wr top border (46)	definir o borde (false=0, true=1). Um espaço é adicionado acima do parágrafo.
wr bottom border (47)	definir o borde (false=0, true=1). Um espaço é adicionado abaixo do parágrafo.
wr tab (64)	o número de tabulações no último parágrafo da seleção. Propriedade não válida com WR SET TEXT PROPERTY a utilizar unicamente com WR Get text property.

Exemplo 1

Você quer aplicar a seleção atual as seguintes propriedades: fonte Times, 12 pontos, cor Violeta, não itálica, negrito.

 Violet:=WR RGB to color(61952;2048;33792)

 WR SET FONT(Area;"Times")

 WR SET TEXT PROPERTY(Area;wr font size;12)

 WR SET TEXT PROPERTY(Area;wr text color;wr violet)

 WR SET TEXT PROPERTY(Area;wr bold;1)

 WR SET TEXT PROPERTY(Area;wr italic;0)

Exemplo 2

Você quer definir as margens do texto em um valor predefinido:

 WR GET SELECTION(Area;StartSel;EndSel) `É salvada a seleção do texto

 WR UPDATE MODE(Area;0) `Desativação das atualizações da tela

 WR EXECUTE COMMAND(Area;wr cmd select all) `Selecionar tudo

  `Definir a unidade atual do documento em centímetros

 WR SET DOC PROPERTY(Area;wr unit;0)

  `Definir as margens em centímetros

 WR SET TEXT PROPERTY(Area;wr right margin;1,8)

 WR SET TEXT PROPERTY(Area;wr left margin;1,3)

 WR SET SELECTION(Area;StartSel;EndSel) `Seleção do texto

 WR UPDATE MODE(Area;1) `Reativar a atualização da tela