4D Doc Center : SVG

4D v14

SVG_New


SVG_New {( largo ; alto {; titulo {; descriçao {; retangulo {; visualizaçao}}}} )} -> Resultado

Parâmetro	Tipo	Descrição
largo	Inteiro longo	Largura do documento em pontos
alto	Inteiro longo	Altura do documento em pontos
titulo	cadeia	Texto do documento
descriçao	cadeia	Descrição
retangulo	Booleano	Definir o retângulo de visualização
visualizaçao	Inteiro	Formato de visualização da imagem
Resultado	SVG_Ref	Referencia do traço

Descrição

O comando SVG_New cria um novo documento SVG e devolve seu número de referencia.

Os parâmetros opcionais largo e alto permitem delimitar o espaço do documento SVG. Estes dois parâmetros devem ser expressados em pontos usuário ('px'), se deseja especificar outra unidade, deve utilizar o comando SVG_SET_DIMENSIONS.

Os parâmetros opcionais titulo e descriçao permitem dar informação sobre o conteúdo.

Se passar True no parâmetro opcional retangulo, o retângulo de visualização (atributo "viewBox") se ajusta automaticamente ao tamanho do documento criado.

Nota: É possível modificar as coordenadas do retângulo de visualização da gráfica e para ajustar a adaptação da imagem com maior precisão utilizando o comando SVG_SET_VIEWBOX.

O parâmetro opcional visualizaçao pode ser utilizado para indicar se a gráfica deve ser adaptada ao tamanho do documento. Pode passar neste parâmetro uma das seguintes constantes do tema Formatos de visualização de imagens de 4D: Scaled to fit prop centered ou Scaled to Fit.

O comando devolve uma cadeia de 16 caracteres (SVG_Ref) que consiste da referencia em memória da estrutura virtual do documento. Esta referencia deve ser utilizada com os outros comandos do componente.

Importante: Uma vez que já não necessite, não esqueça de chamar ao comando SVG_CLEAR com esta referencia para liberar a memória.

Exemplo

 svgRef:=SVG_New

 svgRef:=SVG_New(500;200)

 svgRef:=SVG_New(900;700;"Prova componente SVG";"Este é um exemplo";True;Scaled to fit)