Описание класса QWhatsThisКласс QWhatsThis предоставляет простое описание любого виджета, т.е. ответ на вопрос "Что это?". Далее... #include <QWhatsThis>
Статические открытые члены
Подробное описаниеКласс QWhatsThis предоставляет простое описание любого виджета, т.е. ответ на вопрос "Что это?". Справка "Что это?" является частью интерактивной системы справки приложения и предоставляет пользователям информацию о функциональности и использовании конкретного виджета. Тексты справки "Что это?" обычно более длинные и подробные, чем всплывающие подсказки, но, как правило, предоставляют меньше информации, чем отдельные окна справки. QWhatsThis предоставляет единое окно с пояснительным текстом, которое появляется, когда пользователь спрашивает: "Что это?". Способом по умолчанию для пользователей задать вопрос является перемещение фокуса в соответствующий виджет и нажатие Shift+F1. Текст справки появляется немедленно; он исчезает, когда пользователь делает что-нибудь другое. (Заметьте, что если есть комбинация горячих клавиш для Shift+F1, то этот механизм не будет работать.) Некоторые диалоговые окна предоставляют кнопку "?", которую может нажать пользователь для входа в режим "Что это?"; затем необходимо щёлкнуть по соответствующему виджету, чтобы появилось окно "Что это?". Также можно предоставить пункт меню или кнопку на панели инструментов, чтобы переключаться в режим "Что это?". Для добавление текста "Что это?" к виджету или действию вы просто вызываете QWidget::setWhatsThis() или QAction::setWhatsThis(). Текст может быть как форматированным, так и обычным. Если вы предоставите строку форматированного текста, то он будет отображён с помощью таблицы стилей по умолчанию, что делает возможным встраивание изображений в отображаемый текст. Чтобы быть быстрой, таблица стилей по умолчанию использует простой метод для определения того, может ли текст быть отображён как простой текст. Для получения детальной информации смотрите Qt::mightBeRichText(). newAct = new QAction(tr("&New"), this); newAct->setShortcut(tr("Ctrl+N")); newAct->setStatusTip(tr("Create a new file")); newAct->setWhatsThis(tr("Click this option to create a new file.")); Альтернативным способом войти в режим "Что это?" является вызов createAction() и добавление возвращённого QAction в меню или панель инструментов. Вызывая действие этой контекстной справки (на рисунке ниже кнопка со стрелкой и пиктограммой знака вопроса), пользователь переключает режим "Что это?". Если теперь нажать на виджете, то будет показан соответствующий текст справки. Режим завершается, когда отображается справка или когда пользователь нажимает Esc. Вы можете войти в режим "Что это?" программно с помощью enterWhatsThisMode(), проверить режим с помощью inWhatsThisMode() и вернуться в нормальный режим с помощью leaveWhatsThisMode(). Если вы хотите управлять поведением виджета "Что это?" вручную, то смотрите Qt::WA_CustomWhatsThis. Также возможно отображать различные тексты справки для различных регионов виджета, используя QHelpEvent типа QEvent::WhatsThis. Перехватите событие справки в вашей функции QWidget::event() виджета и вызовите QWhatsThis::showText() с текстом, который вы хотите отобразить для позиции, указанной в QHelpEvent::pos(). Если текст является форматированным и пользователь нажимает на ссылку, то виджет также получает QWhatsThisClickedEvent со ссылкой на ссылку как QWhatsThisClickedEvent::href(). Если QWhatsThisClickedEvent обрабатывается (т.е. QWidget::event() возвращает true), то окно справки остаётся видимым. Вызовите QWhatsThis::hideText(), чтобы явно его скрыть. Смотрите также QToolTip. Описание функций-членовQAction * QWhatsThis::createAction ( QObject * parent = 0 ) [static]Возвращает готовый QAction, используемый для вызова контекстной справки "Что это?", с заданным родителем parent. Возвращаемый QAction предоставляет удобный способ, позволяющий пользователям входить в режим "Что это?". void QWhatsThis::enterWhatsThisMode () [static]Эта функция переключает пользовательский интерфейс в режим "Что это?". Пользовательский интерфейс может быть переключён обратно в нормальный режим пользователем (например, щелчком или нажатием Esc) или программно вызовом leaveWhatsThisMode(). При входе в режим "Что это?" всем виджетам верхнего уровня отправляется QEvent типа Qt::EnterWhatsThisMode. Смотрите также inWhatsThisMode() и leaveWhatsThisMode(). void QWhatsThis::hideText () [static]Если окно "Что это?" отображено, то она уничтожает его. Смотрите также showText(). bool QWhatsThis::inWhatsThisMode () [static]Возвращает true, если пользовательский интерфейс находится в режиме "Что это?"; в противном случае возвращает false. Смотрите также enterWhatsThisMode(). void QWhatsThis::leaveWhatsThisMode () [static]Если пользовательский интерфейс находится в режиме "Что это?", то эта функция переключает его обратно в нормальный режим; в противном случае она ничего не делает. При завершении режима "Что это?" всем виджетам верхнего уровня отправляется QEvent типа Qt::LeaveWhatsThisMode. Смотрите также enterWhatsThisMode() и inWhatsThisMode(). void QWhatsThis::showText ( const QPoint & pos, const QString & text, QWidget * w = 0 ) [static]Отображает текст text как окно "Что это?" в глобальной позиции pos. Дополнительный параметр, виджет w, используется для определения соответствующего экрана на многоэкранных системах. Смотрите также hideText(). |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |