Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.1 - Português

Change language to:
English - Français - 日本語 -

Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
See the recommended documentation of this function

Ajuda Scilab >> Biblioteca de Gráficos > text > stringbox

stringbox

Computa o retângulo de fronteira de um texto ou rótulo.

Seqüência de Chamamento

rect = stringbox( string, x, y, [angle, [fontStyle, [fontSize]]] )
rect = stringbox( Handle )

Parâmetros

rect

uma matriz 2x4 contendo as quatro coordenadas dos vértices do retângulo de fronteira.

string

matriz de strings a ser encerrada

x,y

escalares reais, coordenadas do ponto inferior esquerdo dos strings.

angle

ângulo de rotação dos strings em sentido horário e em graus ao redor do ponto (x,y).

fonStyle

inteiro especificando o tipo da fonte.

fontSize

inteiro especificando o tamanho da fonte.

Handle

um manipulador gráfico do tipo Text ou Label.

Descrição

stringbox retorna os vértices de um retângulo de fronteira de um texto ou rótulo ou um string que será exibido de certo modo. As coordenadas são dadas com a escala gráfica corrente. O primeiro vértice corresponde às coordenadas do texto (x,y), ponto superior esquerdo sem rotação, os vértices seguintes são dados em sentido horário na matriz resultante.

O resultado pode ser impreciso com um driver Postscript.

Exemplos

// exibindo eixos
axes = gca() ;
axes.axes_visible = 'on' ;
axes.data_bounds = [ 1, 1 ; 10, 10 ] ;

// exibindo rótulos para eixos
xtitle( 'stringbox', 'X', 'Y' )  ;

// obtendo a caixa de fronteixa do rótulo X
stringbox( axes.x_label )

// imprimindo um string
str = [ "Scilab", "não" , "é", "Skylab" ] ;
xstring( 4, 9, str ) ;

//modificando o texto
e = gce() ;
e.font_angle = 90 ;
e.font_size    = 6  ;
e.font_style   = 7 ;
e.box = 'on' ;

// obtendo sua caixa de fronteira
stringbox( e )
// ou
rect = stringbox( str, 4, 9, 90, 7, 6 )

// clicando e descobrindo se o texto foi acertado
hit = xclick()  ;
hit = hit( 2 : 3 ) ;

if hit(1) >= rect(1,1)  & hit(1) <=  rect(1,2) & hit(2) <= rect(2,2) & hit(2) >= rect(2,3) then
  disp('Você acertou o texto.') ;
else
  disp('Você errou.')
end;

Ver Também

  • xstring — imprime strings
  • xstringl — computa uma caixa que cerca strings
  • xstringb — escreve strings em uma caixa

Autor

Jean-Baptiste Silvy

<< graphics_fonts text titlepage >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Mar 03 11:00:35 CET 2011