Описание класса QFontDialog
|
| Константа | Значение | Описание |
|---|---|---|
| QFontDialog::NoButtons | 0x00000001 | Не показывать кнопки OK и Cancel buttons. (Полезно для "живых диалогов".) |
| QFontDialog::DontUseNativeDialog | 0x00000002 | Используйте стандартный диалог выбора шрифта Qt в Mac взамен родной панели шрифтов Apple. (В настоящее время "родной" диалог никогда не используется, но вероятно это изменится в будущих выпусках Qt.) |
Данное перечисление было введено в Qt 4.5.
Тип FontDialogOptions является псевдонимом (typedef) для QFlags<FontDialogOption>. Он хранит комбинацию значений (по ИЛИ) FontDialogOption.
Смотрите также options, setOption() и testOption().
Описание свойств
currentFont : QFont
Это свойство содержит текущий шрифт диалога.
Это свойство было введено в Qt 4.5.
Функции доступа:
- QFont currentFont () const
- void setCurrentFont ( const QFont & font )
опции : FontDialogOptions
Это свойство содержит различные опции, которые влияют на внешний вид и поведение диалога.
По умолчанию все опции отключены.
Опции должны быть установлены до показа диалога. Их установка пока диалог видим не гарантирует немедленного эффекта на диалоге (зависит от опции и платформы).
Это свойство было введено в Qt 4.5.
Функции доступа:
- FontDialogOptions options () const
- void setOptions ( FontDialogOptions options )
Смотрите также setOption() и testOption().
Описание функций-членов
QFontDialog::QFontDialog ( QWidget * parent = 0 )
Создаёт стандартный диалог выбора шрифта.
Используйте setCurrentFont() для установки начальных атрибутов шрифта.
Параметр parent передаётся в конструктор QDialog.
Эта функция была введена в Qt 4.5.
Смотрите также getFont().
QFontDialog::QFontDialog ( const QFont & initial, QWidget * parent = 0 )
Создает стандартный диалог выбора шрифта с заданным parent и указанным цветом initial.
Эта функция была введена в Qt 4.5.
void QFontDialog::currentFontChanged ( const QFont & font ) [signal]
Этот сигнал испускается когда изменился текущий шрифт. Новый шрифт задается в font.
Сигнал испускается пока пользователь не выберет шрифт. В конечном счёте, выбранный шрифт может отличаться от текущего выбранного шрифта.
Эта функция была введена в Qt 4.5.
Смотрите также currentFont, fontSelected() и selectedFont().
void QFontDialog::done ( int result ) [virtual protected]
Закрывает диалог и устанавливает его код результата в result. Если этот диалог показывается с помощью exec(), done() вызывает завершение локального цикла обработки событий, а exec(), чтобы вернуть result.
Повторно реализовано из QDialog.
Смотрите также QDialog::done().
void QFontDialog::fontSelected ( const QFont & font ) [signal]
Этот сигнал испускается когда шрифт выбран. Выбранный шрифт указывается в font.
Сигнал испускается только когда пользователь выбрал конечный шрифт для использования. Он не испускается пока пользователь выбирает текущий шрифт в диалоге выбора шрифта.
Эта функция была введена в Qt 4.5.
Смотрите также selectedFont(), currentFontChanged() и currentFont.
QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent, const QString & title, FontDialogOptions options ) [static]
Открывает модальный диалог выбора шрифта и возвращает выбранный шрифт.
Если пользователь нажимает кнопку OK, то возвращается выбранный шрифт. Если пользователь нажимает кнопку Cancel, то возвращается шрифт initial.
Диалог создает с заданным родителем parent и опций, задаваемых в options. title показывает как заголовок окна диалога, а initial - первоначально выбранный шрифт. Если параметр ok не равен нулю, значение, на которое он ссылается, устанавливается равным true, если пользователь щелкнул кнопку OK, и устанавливается равным false, если пользователь щелкнул кнопку Cancel.
Примеры:
bool ok;
QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
if (ok) {
// устанавливается шрифт, выбранный пользователем
} else {
// пользователь нажимает отменить, шрифт остаётся прежним
// в данном случае, Times, 12.
}
Диалог также может использоваться для непосредственного задания шрифта виджета:
myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));
В данном примере, если пользователь нажмет кнопку OK, то будет использоваться выбранный шрифт, а если нажмет кнопку Cancel, то использоваться будет исходный шрифт.
Предупреждение: Не удаляйте parent во время выполнения диалога. Если вы этого хотите, вы должны создать свой диалог используя один из конструкторов QFontDialog.
QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent, const char * name ) [static]
Вызывайте взамен getFont(ok, initial, parent).
Предупреждение: Не удаляйте parent во время выполнения диалога. Если вы этого хотите, вы должны создать свой диалог используя один из конструкторов QFontDialog.
Параметр name игнорируется.
Эта функция была введена в Qt 4.5.
QFont QFontDialog::getFont ( bool * ok, QWidget * parent, const char * name ) [static]
Вместо нее можно вызвать функцию getFont(ok, parent).
Предупреждение: Не удаляйте parent во время выполнения диалога. Если вы этого хотите, вы должны создать свой диалог используя один из конструкторов QFontDialog.
Параметр name игнорируется.
QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent, const QString & title ) [static]
Это перегруженная функция.
Эта функция была введена в Qt 4.5.
QFont QFontDialog::getFont ( bool * ok, const QFont & initial, QWidget * parent = 0 ) [static]
Это перегруженная функция.
QFont QFontDialog::getFont ( bool * ok, QWidget * parent = 0 ) [static]
Это перегруженная функция.
Открывает модальный диалог выбора шрифта и возвращает выбранный шрифт.
Если пользователь нажимает кнопку OK, то возвращается выбранный шрифт. Если пользователь нажимает кнопку Cancel, то возвращается шрифт Qt по умолчанию.
Диалог создается с родителем parent. Если параметр ok не является нулевым указателем, то его значение устанавливается в true, когда пользователь нажимает кнопку OK, и в false, когда пользователь нажимает кнопку Cancel.
Пример:
bool ok;
QFont font = QFontDialog::getFont(&ok, this);
if (ok) {
// устанавливается шрифт, выбранный пользователем
} else {
// пользователь нажимает отменить, шрифт остаётся прежним
// в качестве шрифта устанавливается шрифт приложения, QApplication::font()
}
Предупреждение: Не удаляйте parent во время выполнения диалога. Если вы этого хотите, вы должны создать свой диалог используя один из конструкторов QFontDialog.
void QFontDialog::open ( QObject * receiver, const char * member )
Это перегруженная функция.
Открывает диалог и соединяет его сигнал fontSelected() со слотом, заданным receiver и member.
Сигнал будет отсоединен от слота когда диалог закрывается.
Эта функция была введена в Qt 4.5.
QFont QFontDialog::selectedFont () const
Возвращает шрифт, которые пользователь выбрал щелкнув по кнопке OK или эквивалентной кнопке.
Замечание: Этот шрифт не всегда такой же, как шрифт содержащийся в свойстве currentFont поскольку пользователь может выбирать разные шрифты перед тем как окончательно выбрать один для использования.
void QFontDialog::setOption ( FontDialogOption option, bool on = true )
Устанавливает заданную опцию option включённой если on равно true; в противном случае очищает заданную опцию option.
Смотрите также options и testOption().
bool QFontDialog::testOption ( FontDialogOption option ) const
Возвращает true если заданная опция option включена; в противном случае возвращается false.
Смотрите также options и setOption().
| Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) | Торговые марки | Qt 4.5.3 |
|
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |