MATLAB Function Reference

textwrap

Return wrapped string matrix for given uicontrol

Syntax

• outstring = textwrap(h,instring)
  [outstring,position] = textwrap(h,instring)
  

Description

outstring = textwrap(h,instring) returns a wrapped string cell array, outstring, that fits inside the uicontrol with handle h. instring is a cell array, with each cell containing a single line of text. outstring is the wrapped string matrix in cell array format. Each cell of the input string is considered a paragraph.

[outstring,position]=textwrap(h,instring) returns the recommended position of the uicontrol in the units of the uicontrol. position considers the extent of the multiline text in the x and y directions.

Example

Place a textwrapped string in a uicontrol:

• pos = [10 10 100 10];
  h = uicontrol('Style','Text','Position',pos);
  string = {'This is a string for the uicontrol.',
            'It should be correctly wrapped inside.'};
  [outstring,newpos] = textwrap(h,string);
  pos(4) = newpos(4);
  set(h,'String',outstring,'Position',[pos(1),pos(2),pos(3)+10,pos(4)])
  

See Also

uicontrol

textread

tic, toc