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.'};

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

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

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;

Входные параметры

свернуть все

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

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

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

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

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

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

свернуть все

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

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

См. также

|

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