Шрифты и строки

Названия гарнитур системных шрифтов мы получаем с помощью метода static const StringArray Font::findAllTypefaceNames(), который возвращает массив строк (класс StringArray Juce), содержащий эти названия. Число элементов массива возвращается его методом int StringArray::size() const throw(). В цикле

for(int i = 0; i < sSystemFonts.size(); i++)
{
    pFontsBox->addItem(sSystemFonts[i], i + 1);
} 

мы перебираем по одному элементы списка и добавляем их в качестве элементов выпадающего списка pFontsBox.

Элементы списка размера шрифтов(pFontSizeBox) добавляем в диапазоне от 8 до 20 пунктов.

Заметим, что в Juce групповой блок служит исключительно в качестве элемента оформления; радиокнопки, рисуемые на его поверхности, не являются его потомками, а представляют собой самостоятельные виджеты. Для того, чтобы объединить их в одну группу, необходимо воспользоваться методом void Button::setRadioGroupId(int newGroupId). Если метод у нескольких радиокнопок принимает в качестве параметра какое-либо одно, отличное от нуля, число, то эти кнопки начинают действовать как единая радиогруппа, т.е. возможно включение одной и только одной кнопки из набора. В качестве ID для нашей радиогруппы используется число 1234.

Деструктор и методы перерисовки и задания размеров нашего класса приведены в листинге 6.3 .

TCentralComponent::~TCentralComponent()
{
  // Удаляем дочерние виджеты
  // и обнуляем их указатели
  deleteAllChildren();
}
//-------------------------------------------------
void TCentralComponent::paint(Graphics Canvas)
{
  Canvas.fillAll(Colours::azure);
}
//-------------------------------------------------
void TCentralComponent::resized()
{
  pFontViewer->setBounds(proportionOfWidth(0.5505f), 8,    
            proportionOfWidth(0.4192f), 
            proportionOfHeight(0.9507f));
  pFontNameLabel->setBounds(8, 8,       
            roundFloatToInt((proportionOfWidth(0.4192f)) *  
            1.2048f), 25);
  pFontsBox->setBounds(8, 38, 
            roundFloatToInt((proportionOfWidth(0.4192f)) * 
            1.2048f), 25);
  pFontSizeLabel->setBounds (8, 68, 
            roundFloatToInt((proportionOfWidth(0.4192f)) * 
            1.2048f), 25);
  pFontSizeBox->setBounds(8, 96, 
            roundFloatToInt((proportionOfWidth(0.4192f)) * 
            1.2048f), 25);
  pFontStyleLabel->setBounds(8, 126, 
             roundFloatToInt((proportionOfWidth(0.4192f)) * 
             1.2048f), 25);
  pFontGroup->setBounds(8, 156, 
             roundFloatToInt((proportionOfWidth(0.4192f)) * 
             1.2048f), 196);
  pNormalButton->setBounds(32, 185, 150, 25);
  pBoldButton->setBounds(32, 216, 150, 25);
  pItalicButton->setBounds(32, 248, 150, 25);
}

Для задания относительных горизонтальных размеров виджетов мы использовали уже знакомую функцию int Component::proportionOfWidth(float proportion) const throw(). Для преобразования чисел с плавающей точкой, получаемых после расчёта координат компонентов, в целые использована функция из juce_MathsFunctions.h int roundFloatToInt(const float value) throw().

Как видно из рисунка 6.1 , гарнитура и размер шрифта текста, отображаемого в многострочном текстовом поле TextEditor* pFontViewer, выбираются пользователем из выпадающих списков. Поскольку сам компонент-контейнер TCentralComponent является слушателем изменений списков (ComboBoxListener), в его классе мы переопределяем наследуемую от класса linstener'а виртуальную функцию virtual void ComboBox::Listener::ComboBoxChanged(ComboBox* ComboNoxThatHasChanged), которая отвечает за реакцию программы на выбор пользователя. Её реализация приведена в листинге 6.4 .

void TCentralComponent::comboBoxChanged(ComboBox* pComboBox)
{
  // Изменён выпадающий список гарнитуры шрифта
  if(pComboBox == pFontsBox)
  {
    // Устанавливаем в качестве шрифта текста поля ввода
    // шрифт, выбранный пользователем из списка
    CurrentFont.setTypefaceName(pFontsBox->getText());
  }
  // Изменён выпадающий список размера шрифта
  else if(pComboBox == pFontSizeBox)
  {
    // Вычисляем размер шрифта в пикселях,
    // исходя из выбранного пользователем кегля в типографских пунктах
    float fFontHeight = pFontSizeBox->getText().getFloatValue() * 96 
    / 72;
    // Устанавливаем размер шрифта
    CurrentFont.setHeight(fFontHeight);
  }
  // Задаём шрифт для отображения текста
  pFontViewer->applyFontToAllText(CurrentFont);
}

После того, как пользователь выбрал какой-либо пункт в выпадающем списке, отображаемый текст виджета изменяется соответственно надписи выбранного пункта. Получить этот текст можно с помощью функции const String ComboBox::getText() const. В случае первого списка (pFontsBox) это будет название выбранной пользователем гарнитуры шрифта.

Это название передаём в качестве параметра в функию void void Font::setTypefaceName(const String faceName). Как понятно из названия, она устанавливает гарнитуру вызвавшего шрифта (объект класса Font) с названием, соответствующим строке-параметру. Если гарнитура с таким названием не будет найдена (шрифт не установлен на компьютере), то будет использоваться шрифт по умолчанию. В нашем случае такого происходить не должно, т.к. пользователь выбирает из ранее найденных названий шрифтов, установленных в системе.

Во втором выпадающем списке,

Теперь можно использовать шрифт с заданными пользователем параметрами для отображения текста в многострочном поле ввода pFontViewer. У класса TextEditor есть для этого два метода:

Понятно, что в нашем случае подходит именно второй метод ().

void TCentralComponent::buttonClicked(Button* pButton)
{
  if (pButton == pNormalButton)
  {
    if(CurrentFont.isBold())
    {
      CurrentFont.setBold(false);
    }
    else if(CurrentFont.isItalic())
    {
      CurrentFont.setItalic(false);  
    }
  }
  else if (pButton == pBoldButton)
  {
    if(CurrentFont.isItalic())
    {
      CurrentFont.setItalic(false);
    }
    CurrentFont.setBold(true);
  }
  else if (pButton == pItalicButton)
  {
    if(CurrentFont.isBold())
    {
      CurrentFont.setBold(false);
    }
    CurrentFont.setItalic(true);
  }
  pFontViewer->applyFontToAllText(CurrentFont);
}

Следует подчеркнуть, что вызов функций задания того или иного стиля, приведённых в листинге 6.5 , не отменяет предыдущий стиль шрифта. Например, при последовательном вызове

CurrentFont.setBold(true);
CurrentFont.setItalic(true);

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

void TCentralComponent::buttonClicked(Button* pButton)
{
  if (pButton == pNormalButton)
  {
    // Задаём стиль шрифта - нормальный
    CurrentFont.setStyleFlags(Font::plain);
  }
  else if (pButton == pBoldButton)
  {
    // Задаём стиль шрифта - полужирный
    CurrentFont.setStyleFlags(Font::bold);
  }
  else if (pButton == pItalicButton)
  {   
    // Задаём стиль шрифта - курсив
    CurrentFont.setStyleFlags(Font::italic);
  }
  pFontViewer->applyFontToAllText(CurrentFont);
}

String sNumber(1234); // Строка содержит текст "1234".

Последние две функции возвращают шестнадцатеричное число соответствующего размера; прочие символы, если их содержит строка, игнорируются. Пример использования функции getFloatValue приведён в листинге 6.4 .

Кроме того, класс String включает довольно интересный метод int String::getTrailingIntValue() const throw(), который возвращает целое число, находящееся в конце строки. Например:

String sNumber("321 xyz654");
// Функция возвращает 654
int iNumber = sNumber.getTrailingIntValue()

Список строк (класс StringArray)

Для хранения массива строковых объектов в Juce имеется класс StringArray, который описывает список строк с расширенными возможностями манипулирования ими.

Класс поддерживает следующие операции работы со строками:

Доступ к строке по её индексу возможен с помощью оператора [], как к элементу обычного массива. Если индекс выходит за пределы массива, будет возвращена пустая строка. Кроме того, получить ссылку на одну из строк массива по её индексу позволяет метод класса String StringArray::getReference(int index) throw().

Возвращение числа элементов списка (хранящихся строк) осуществляет метод int StringArray::size() const throw().

Добавление новых строк в конец списка. Производится функцией void StringArray::add(const String stringToAdd). Кроме того, в конец списка можно добавить целый массив строк, другой объект класса StringArray, с помощью метода void StringArray::addArray(const StringArray other, int startIndex = 0, int numElementsToAdd = -1), где other — первый элемент добавляемого строкового массива, с которого необходимо начинать вставку, а numElementsToAdd — максимальное число строк из добавляемого массива для вставки. Если значение параметра меньше нуля, то добавляются все элементы.

Вставка новых строк в произвольное место списка со смещением элементов массива. Функция void StringArray::insert(int index, const String stringToAdd) вставляет строку stringToAdd в массив на место, заданное индексом index, поднимая другие элементы. Если значение индекса меньше нуля или превышает размер массива, то строка добавляется в конец списка.

Вставка новых строк в произвольное место списка с заменой элементов массива. Функция void StringArray::set(int index, const String newString) вставляет строку newString в массив на место, заданное индексом index. При этом прежняя строка замещается новой. Если значение индекса меньше нуля функция не делает ничего, а если оно превышает размер массива, то строка добавляется в конец списка.

Поиск строк в массиве (по содержимому). Чаще бывает, что найти необходимую строку в массиве бывает нужно не по её индексу, а по тексту, в ней содержащемуся. В этом может помочь метод bool StringArray::contains(const String stringToLookFor, bool ignoreCase = false) const. Также, как и раньше, второй параметр — флаг, следует ли при поиске строки stringToLookFor учитывать регистр.

Удаление строк. Удалить одну строку, находящуюся на позиции index, из списка можно с помощью функции void StringArray::remove(int index). Если индекс выходит за пределы массива, то функция ничего не делает. Поиск строки stringToRemove в массиве с последующим её удалением выполняет функция void StringArray::removeString(const String stringToRemove, bool ignoreCase = false); второй её параметр — флаг, показывающий, следует ли игнорировать регистр.

Полезны также функции, позволяющие удалить все повторяющиеся строки, void StringArray::removeDuplicates(bool ignoreCase), и все пустые строки в массиве, void StringArray::removeEmptyStrings(bool removeWhiteSpaceStrings = true). Если последняя функция в качестве параметра принимает истину, то пустыми будут считаться также строки, заполненные только пробелами.

Кроме того, класс StringArray позволяет удалять сразу ряд строк. Для этого используется метод void StringArray::removeRange(int startIndex, int numberToRemove), где startIndex — индекс первой строки из ряда, подлежащего удалению, а numberToRemove — число удаляемых элементов.

Перемещение строк на новую позицию в массиве осуществляет метод void StringArray::move(int currentIndex, int newIndex) throw(). При вызове функции экземпляром класса StringArray происходит перемещение содержащейся в нём строки, находящейся на позиции currentIndex, на позицию newIndex.

Сортировка элементов списка осуществляется функцией void StringArray::sort(bool ignoreCase); параметр указывает, следует ли учитывать регистр. Строки сортируются в алфавитном порядке.

Очистка списка. Удаление всех строк из списка с обнулением его размера выполняет функция void StringArray::clear().

Нахождение индекса строки осуществляет функция int StringArray::indexOf(const String stringToLookFor, bool ignoreCase = false, int startIndex = 0) const, где stringToLookFor — текст (строка) для поиска, ignoreCase— флаг, показывающий, следует ли игнорировать регистр, а startIndex — индекс элемента, с которого начинается поиск. Функция возвращает индекс найденной строки, а в случае, если ничего не было найдено, возвращается -1.

Объединение строк массива в одну. Удобно для автоматической генерации текста, добавляемого, скажем, в многострочное поле ввода на основании собранных и сохранённых в массиве StringArray данных. Осуществляется функцией const String StringArray::joinIntoString(const String separatorString, int startIndex = 0, int numberOfElements = -1) const.

Мы можем с помощью параметра separatorString задать строку-разделитель, которая будет разделять элементы массива в результирующей строке. Например, если массив StringArray включал строки "a", "b" и "c", то вызов метода joinIntoString(",") вернёт строку "a,b,c".

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

Краткие итоги

Для вывода неформатированного текста в Juce используется класс String, а форматированного — также и класс Font, хранящий информацию о параметрах шрифта текста.

Класс String, инкапсулирует действия со строками. Объект класса String — это строка, состоящая из произвольного числа символов. Литерные константы типа String представляют собой последовательности символов, заключённые в двойные кавычки.

Дополнительные материалы

Архив с исходными текстами примера Вы можете скачать здесь