exponenta event banner

textwrap

Перенос текста для управления пользовательским интерфейсом

Используйте эту функцию только с GUIDE или с приложениями, созданными с помощью figure функция

Описание

пример

wrappedtext = textwrap(c,txt) возвращает текст, обернутый по ширине символа, который соответствует указанному UIControl объект, c. Объект управления пользовательским интерфейсом должен быть создан с помощью uicontrol функция, 'Style' значение свойства равно 'text' или 'edit'. Например, c = uicontrol('Style','text').

пример

wrappedtext = textwrap(c,txt,numchar) возвращает текст, содержащий каждую строку в указанном количестве символов. Пробелы включаются в число символов. textwrap избегает расщепления слов, когда это возможно. Если слово не может быть помещено в указанное число символов, то textwrap перемещает его в начало следующей строки.

пример

[wrappedtext,position] = textwrap(___) также возвращает рекомендуемую позицию для элемента управления пользовательского интерфейса на основе текста, который будет упакован. Возвращенная позиция позволяет отображать полный текст в uicontrol без отсечения. Если элемент управления пользовательского интерфейса не указан, вектор положения содержит все нули.

Примеры

свернуть все

Укажите две строки текста для String свойства статического текстового поля.

c = uicontrol('Style','text');
c.String = {'Extraordinarily long text will be wrapped', ...
'inside of a static text field.'};

Текст отсекается и пересекает более двух строк, поскольку ширина и высота текстового поля по умолчанию недостаточно велики, чтобы вместить весь текст. Обратите внимание, что слово «необыкновенно» также разделено на две строки.

Предварительный просмотр массива ячеек векторов символов, рекомендуемых для переноса текста таким образом, чтобы он вписывался в ширину элемента управления пользовательского интерфейса с наименьшим изменением размера.

wrappedtext = textwrap(c,c.String)
wrappedtext =

  7×1 cell array

    {'Extraordinarily'}
    {'long text'      }
    {'will be'        }
    {'wrapped'        }
    {'inside of a'    }
    {'static text'    }
    {'field.'         }

Перенос текста с заданной шириной символа и отображение его в статическом текстовом поле.

Создание статического текстового поля в позиции по умолчанию [20 20 60 20]. Укажите текст для отображения в нем.

c = uicontrol('Style','text');
c.String = {'The data shown represents 18 months of observations.'};

Текст отсекается и отображается на нескольких линиях, поскольку значения ширины и высоты по умолчанию uicontrol слишком малы для размещения полного текста.

Предварительный просмотр обернутого текста и рекомендуемого положения uicontrol на основе максимальной ширины текста 16 символов.

[wrappedtext,position] = textwrap(c,c.String,16)
wrappedtext =

  4×1 cell array

    {'The data shown '}
    {'represents 18 ' }
    {'months of '     }
    {'observations.'  }


position =

    20    20    86    64

Выведите текст в текстовом поле и переместите его в рекомендуемое положение.

c.String = wrappedtext;
c.Position = position;

Входные аргументы

свернуть все

Объект управления пользовательским интерфейсом, указанный как UIControl объект. UIControl объект должен поддерживать многострочный текст. Например, его 'Style свойство может быть 'text' или 'edit'. Этот аргумент используется для определения того, как текст переносится в указанный элемент управления пользовательского интерфейса, или для определения рекомендуемого размера элемента управления пользовательского интерфейса на основе текста, который будет переноситься.

Текст для переноса, заданный как массив ячеек из векторов символов, строковый массив или строковый скаляр.

Пример: {'Please select an answer from the options below.'}

Пример: ["Enter your name using","the format LastName, FirstName"]

Число символов в каждой строке текста, указанное как положительное целое число. Этот аргумент используется для указания максимальной ширины символа для каждой строки. Если numchar превышает количество символов в txt, то текст не переносится.

Выходные аргументы

свернуть все

Упакованный текст, возвращаемый в виде массива ячеек векторов символов. Чтобы отобразить текст на указанном элементе управления пользовательского интерфейса, необходимо назначить wrappedtext в String свойство элемента управления пользовательского интерфейса.

Положение, рекомендуемое для управления пользовательским интерфейсом, возвращаемое в виде четырехэлементного вектора формы [left bottom width height]. Блоки аналогичны блокам управления пользовательского интерфейса. Возвращаемое положение оптимизирует ширину и высоту uicontrol таким образом, указанный текст может отображаться на нескольких строках без отсечения. Если элемент управления пользовательского интерфейса не указан, то вектор положения содержит все нули.

См. также

|

Представлен до R2006a