cppcheck/gui/mainwindow.h

/*
 * Cppcheck - A tool for static C/C++ code analysis
 * Copyright (C) 2007-2016 Cppcheck team.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QSettings>
#include <QFileDialog>
#include <QActionGroup>
#include <QTimer>
#include <QStringList>

#include "settings.h"
#include "platforms.h"
#include "ui_mainwindow.h"

class ThreadHandler;
class TranslationHandler;
class ScratchPad;
class LogView;
class Project;
class ErrorItem;
class QAction;

/// @addtogroup GUI
/// @{

/**
 * @brief Main window for cppcheck-gui
 *
 */
class MainWindow : public QMainWindow {
    Q_OBJECT
public:

    /**
     * @brief Maximum number of MRU project items in File-menu.
     */
    enum { MaxRecentProjects = 5 };

    MainWindow(TranslationHandler* th, QSettings* settings);
    virtual ~MainWindow();

    /**
      * List of checked platforms.
      */
    Platforms mPlatforms;

    /**
     * @brief Checks given code
     *
     * @param code Content of the (virtual) file to be checked
     * @param filename Name of the (virtual) file to be checked - determines language.
     */
    void CheckCode(const QString& code, const QString& filename);

public slots:

    /** @brief Slot for check files menu item */
    void CheckFiles();

    /** @brief Slot to recheck all files */
    void ReCheckAll();

    /**
     * @brief Slot to recheck selected files
     * @param selectedFilesList list of selected files
     */
    void PerformSelectedFilesCheck(QStringList selectedFilesList);

    /** @brief Slot to recheck modified files */
    void ReCheckModified();

    /** @brief Slot to clear all search results */
    void ClearResults();

    /** @brief Slot to open XML report file */
    void OpenResults();

    /**
     * @brief Show errors with type "style"
     * @param checked Should errors be shown (true) or hidden (false)
     */
    void ShowStyle(bool checked);

    /**
     * @brief Show errors with type "error"
     * @param checked Should errors be shown (true) or hidden (false)
     */
    void ShowErrors(bool checked);

    /**
     * @brief Show errors with type "warning"
     * @param checked Should errors be shown (true) or hidden (false)
     */
    void ShowWarnings(bool checked);

    /**
     * @brief Show errors with type "portability"
     * @param checked Should errors be shown (true) or hidden (false)
     */
    void ShowPortability(bool checked);

    /**
     * @brief Show errors with type "performance"
     * @param checked Should errors be shown (true) or hidden (false)
     */
    void ShowPerformance(bool checked);

    /**
     * @brief Show errors with type "information"
     * @param checked Should errors be shown (true) or hidden (false)
     */
    void ShowInformation(bool checked);

    /** @brief Slot to check all "Show errors" menu items */
    void CheckAll();

    /** @brief Slot to uncheck all "Show errors" menu items */
    void UncheckAll();

    /** @brief Slot for check directory menu item */
    void CheckDirectory();

    /** @brief Slot to open program's settings dialog */
    void ProgramSettings();

    /** @brief Slot to open program's about dialog */
    void About();

    /** @brief Slot to to show license text */
    void ShowLicense();

    /** @brief Slot to to show authors list */
    void ShowAuthors();

    /** @brief Slot to save results */
    void Save();

    /** @brief Slot to create new project file */
    void NewProjectFile();

    /** @brief Slot to open project file and start checking contained paths. */
    void OpenProjectFile();

    /** @brief Slot to show scratchpad. */
    void ShowScratchpad();

    /** @brief Slot to close open project file. */
    void CloseProjectFile();

    /** @brief Slot to edit project file. */
    void EditProjectFile();

    /** @brief Slot for showing the log view. */
    void ShowLogView();

    /** @brief Slot for showing the scan and project statistics. */
    void ShowStatistics();

    /** @brief Slot for showing the library editor */
    void ShowLibraryEditor();

protected slots:

    /** @brief Slot for checkthread's done signal */
    void CheckDone();

    /** @brief Lock down UI while checking */
    void CheckLockDownUI();

    /** @brief Slot for enabling save and clear button */
    void ResultsAdded();

    /** @brief Slot for showing/hiding standard toolbar */
    void ToggleMainToolBar();

    /** @brief Slot for showing/hiding Categories toolbar */
    void ToggleViewToolBar();

    /** @brief Slot for showing/hiding Filter toolbar */
    void ToggleFilterToolBar();

    /** @brief Slot for updating View-menu before it is shown. */
    void AboutToShowViewMenu();

    /** @brief Slot when stop checking button is pressed */
    void StopChecking();

    /** @brief Open help file contents */
    void OpenHelpContents();

    /** @brief Add new line to log. */
    void Log(const QString &logline);

    /** @brief Handle new debug error. */
    void DebugError(const ErrorItem &item);

    /** @brief Filters the results in the result list. */
    void FilterResults();

    /** @brief Opens recently opened project file. */
    void OpenRecentProject();

    /** @brief Selects the platform as checked platform. */
    void SelectPlatform();

private:

    /** @brief Rechecks files */
    void ReCheck(bool all);

    /**
     * @brief Recheck selected files
     * @param files list of selected files
     * @param all true if all files of list, false if modified files of list
     */
    void ReCheckSelected(QStringList files, bool all);

    /**
      * @brief Check the project.
      * @param project Pointer to the project to check.
      */
    void CheckProject(Project *project);

    /**
     * @brief Set current language
     * @param code Language code of the language to set (e.g. "en").
     */
    void SetLanguage(const QString &code);

    /** @brief Event coming when application is about to close. */
    virtual void closeEvent(QCloseEvent *event);

    /**
     * @brief Helper function to toggle all show error menu items
     * @param checked Should all errors be shown (true) or hidden (false)
     */
    void ToggleAllChecked(bool checked);

    /** @brief Helper function to enable/disable all check,recheck buttons */
    void EnableCheckButtons(bool enable);

    /**
     * @brief Select files/or directory to check.
     * Helper function to open a dialog to ask user to select files or
     * directory to check. Use native dialogs instead of Qt:s own dialogs.
     *
     * @param mode Dialog open mode (files or directories)
     * @return QStringList of files or directories that were selected to check
     */
    QStringList SelectFilesToCheck(QFileDialog::FileMode mode);

    /**
     * @brief Check project
     * @param p imported project
     */
    void DoCheckProject(ImportProject p);

    /**
     * @brief Check all files specified in parameter files
     *
     * @param files List of files and/or directories to check
     */
    void DoCheckFiles(const QStringList &files);

    /**
     * @brief Get our default cppcheck settings and read project file.
     *
     * @return Default cppcheck settings
     */
    Settings GetCppcheckSettings();

    /** @brief Load program settings */
    void LoadSettings();

    /** @brief Save program settings */
    void SaveSettings() const;

    /**
     * @brief Format main window title.
     * @param text Text added to end of the title.
     */
    void FormatAndSetTitle(const QString &text = QString());

    /** @brief Show help contents */
    void OpenOnlineHelp();

    /**
     * @brief Enable or disable project file actions.
     * Project editing and closing actions should be only enabled when project is
     * open and we are not checking files.
     * @param enable If true then actions are enabled.
     */
    void EnableProjectActions(bool enable);

    /**
     * @brief Enable or disable project file actions.
     * Project opening and creating actions should be disabled when checking.
     * @param enable If true then actions are enabled.
     */
    void EnableProjectOpenActions(bool enable);

    /**
     * @brief Add include directories.
     * @param includeDirs List of include directories to add.
     * @param result Settings class where include directories are added.
     */
    void AddIncludeDirs(const QStringList &includeDirs, Settings &result);

    /**
     * @brief Handle command line parameters given to GUI.
     * @param params List of string given to command line.
     */
    void HandleCLIParams(const QStringList &params);

    /**
     * @brief Load XML file to the GUI.
     * @param file Filename (inc. path) of XML file to load.
     */
    void LoadResults(const QString file);

    /**
     * @brief Load XML file to the GUI.
     * @param file Filename (inc. path) of XML file to load.
     * @param checkedDirectory Path to the directory that the results were generated for.
     */
    void LoadResults(const QString file, const QString checkedDirectory);

    /**
     * @brief Load project file to the GUI.
     * @param filePath Filename (inc. path) of project file to load.
     */
    void LoadProjectFile(const QString &filePath);

    /**
     * @brief Load library file
     * @param library  library to use
     * @param filename filename (no path)
     * @return error code
     */
    Library::Error LoadLibrary(Library *library, QString filename);

    /**
     * @brief Tries to load library file, prints message on error
     * @param library  library to use
     * @param filename filename (no path)
     * @return True if no error
     */
    bool TryLoadLibrary(Library *library, QString filename);

    /**
     * @brief Update project MRU items in File-menu.
     */
    void UpdateMRUMenuItems();

    /**
     * @brief Add project file (path) to the MRU list.
     * @param project Full path to the project file to add.
     */
    void AddProjectMRU(const QString &project);

    /**
     * @brief Remove project file (path) from the MRU list.
     * @param project Full path of the project file to remove.
     */
    void RemoveProjectMRU(const QString &project);

    /** @brief Program settings */
    QSettings *mSettings;

    /** @brief Thread to check files */
    ThreadHandler *mThread;

    /** @brief List of user defined applications to open errors with */
    ApplicationList *mApplications;

    /** @brief Class to handle translation changes */
    TranslationHandler *mTranslation;

    /** @brief Class holding all UI components */
    Ui::MainWindow mUI;

    /** @brief Current checked directory. */
    QString mCurrentDirectory;

    /** @brief Log view. */
    LogView *mLogView;

    /** @brief Scratchpad. */
    ScratchPad* mScratchPad;

    /** @brief Project (file). */
    Project *mProject;

    /** @brief Filter field in the Filter toolbar. */
    QLineEdit* mLineEditFilter;

    /** @brief Timer to delay filtering while typing. */
    QTimer* mFilterTimer;

    /** @brief GUI actions for selecting the checked platform. */
    QActionGroup *mPlatformActions;

    /** @brief GUI actions for selecting the coding standard. */
    QActionGroup *mCStandardActions, *mCppStandardActions;

    /** @brief GUI actions for selecting language. */
    QActionGroup *mSelectLanguageActions;

    /**
     * @brief Are we exiting the cppcheck?
     * If this is true then the cppcheck is waiting for check threads to exit
     * so that the application can be closed.
     */
    bool mExiting;

    /** @brief Set to true in case of loading log file. */
    bool mIsLogfileLoaded;

    /**
     * @brief Project MRU menu actions.
     * List of MRU menu actions. Needs also to store the separator.
     */
    QAction *mRecentProjectActs[MaxRecentProjects + 1];
};
/// @}
#endif // MAINWINDOW_H