Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.0.2 - Français

Change language to:
English - 日本語 - Português - Русский

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

Aide de Scilab >> Graphiques > text > stringbox

stringbox

Calcule le rectangle englobant d'un texte ou d'un label.

Séquence d'appel

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

Paramètres

rect

matrice 2x4 contenant les coordonées des 4 sommets du rectangle englobant.

string

matrice de chaine de caractère à  entourer.

x,y

scalaires réels, coordonnées du point en bas à  gauche des chaînes de caractères.

angle

Angle de rotation de la chaîne en degrés autour du point (x,y) dans le sens des aiguilles d'une montre.

fonStyle

un entier specifiant le type de la fonte.

fontSize

un entier specifiant la taille de la fonte.

handle

un handle de type Text ou Label.

Description

stringbox renvoie les positions des quatres sommets du rectangle englobant d'un objet Text ou Label ou d'une chaine de caractère que l'on souhaite afficher. Les coordonnées sont données dans l'échelle graphique courante. Le premier sommet correspond à  la coordonnées du texte, le point en bas à  gauche sans rotations, les suivants sont donnés dans le sens des aiguilles d'une montre.

Le résultat est approximatif avec le pilote PostScript.

Exemples

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

// display a labels for axes
xtitle( 'stringbox', 'X', 'Y' )  ;

// get the bounding box of X label
stringbox( axes.x_label )

// draw a string
str = [ "Scilab", "is" , "not", "Skylab" ] ;
xstring( 4, 9, str ) ;

//modify the text
e = gce() ;
e.font_angle = 90 ;
e.font_size    = 6  ;
e.font_style   = 7 ;
e.box = 'on' ;

// get its bounding box
stringbox( e )
// or
rect = stringbox( str, 4, 9, 90, 7, 6 )

// click and find if the text was hit
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('You hit the text.') ;
else
  disp('You missed it.')
end;

Voir aussi

  • xstring — dessine des chaînes de caractères
  • xstringl — calcule les dimensions d'une boîte entourant des chaînes de caractères
  • xstringb — dessine des chaînes de caractères dans une boîte
Report an issue
<< Rendu d'équations mathématiques dans le graphique Scilab text text properties >>

Copyright (c) 2022-2024 (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 Feb 14 14:59:58 CET 2019