VBoxProblemReporter.h revision 94eb4c40aabf9f75b9b827c9069a789015f33b81
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * VBox frontends: Qt GUI ("VirtualBox"):
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * VBoxProblemReporter class declaration
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * Copyright (C) 2006-2008 Sun Microsystems, Inc.
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * This file is part of VirtualBox Open Source Edition (OSE), as
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * available from http://www.virtualbox.org. This file is free software;
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * you can redistribute it and/or modify it under the terms of the GNU
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * General Public License (GPL) as published by the Free Software
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * Foundation, in version 2 as it comes in the "COPYING" file of the
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * Clara, CA 95054 USA or visit http://www.sun.com if you need
5a4b3207b395b426c5a9066f4afea8d3fa8c6660stoddard * additional information or have any questions.
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard/* Qt icludes */
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard// VBoxHelpActions class
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard////////////////////////////////////////////////////////////////////////////////
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * Help Menu action container.
1f2f357528d122de2c7886a073b4eee8766d5c95wrowe * Contains actions for all help menu items and methods to insert them to a
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * QMenu and to perform NLS string translation.
56e85d89d42a6980f31b800266649efbed338da3wrowe * Instances of this class are to be created as members of QWidget classes that
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * need a Help menu. The containing class usually passes itself as an argument
37ad54b8fd2611b7a4f2b269eec3d27ed784a25dwrowe * to the #setup() method and then calls #addTo() to add actions to its Help
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * menu. The #retranslateUi() method is called when it is necessary to
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * re-translate all action NLS according to the current language.
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard// VBoxProblemReporter class
1f2f357528d122de2c7886a073b4eee8766d5c95wrowe////////////////////////////////////////////////////////////////////////////////
e1ad80c048e29e968221817698529d73098f07a4wrowe * The VBoxProblemReporter class is a central place to handle all problem/error
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * situations that happen during application runtime and require the user's
37ad54b8fd2611b7a4f2b269eec3d27ed784a25dwrowe * attention.
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * The role of this class is to describe the problem and/or the cause of the
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * error to the user and give him the opportunity to select an action (when
96d86960482354ffa1c192ea3df73a4cd46f0d82stoddard * appropriate).
a751155a30bbd9ccb739c1b052635b14d39038c2wrowe * Every problem sutiation has its own (correspondingly named) method in this
94b262d3639149df0b02642a9daa6db8bff58577wrowe * class that takes a list of arguments necessary to describe the situation and
94b262d3639149df0b02642a9daa6db8bff58577wrowe * to provide the appropriate actions. The method then returns the choice to the
bool isValid();
const char *aAutoConfirmId = 0,
const char *aAutoConfirmId,
const char *aAutoConfirmId = 0,
const char *aAutoConfirmId,
const char *aAutoConfirmId = 0,
const char *aAutoConfirmId,
#ifdef Q_WS_X11
bool strict = true,
void cannotSendACPIToMachine();
bool warnAboutVirtNotEnabled();
#if defined Q_WS_WIN
void remindAboutAutoCapture();
bool remindAboutPausedVMInput();
bool aAfterRefresh);
bool remindAboutInaccessibleMedia();
void cannotRunInSelectorMode();
void showHelpWebDialog();
void showHelpAboutDialog();
void showHelpHelpDialog();
void resetSuppressedMessages();