pqCoreUtilities.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Kitware Inc.
// SPDX-FileCopyrightText: Copyright (c) Sandia Corporation
// SPDX-License-Identifier: BSD-3-Clause
#ifndef pqCoreUtilities_h
#define pqCoreUtilities_h
 
#include "pqCoreModule.h"
#include "pqEventDispatcher.h"
 
#include <QDir>
#include <QEventLoop>
#include <QFile>
#include <QFileInfo>
#include <QMessageBox>
#include <QPointer>
#include <QString>
#include <QStringList>
#include <QWidget>
 
class QPalette;
class vtkObject;
 
class PQCORE_EXPORT pqCoreUtilitiesEventHelper : public QObject
{
  Q_OBJECT;
  typedef QObject Superclass;
 
public:
  pqCoreUtilitiesEventHelper(QObject* parent);
  ~pqCoreUtilitiesEventHelper() override;
 
Q_SIGNALS:
  void eventInvoked(vtkObject*, unsigned long, void*);
 
private:
  Q_DISABLE_COPY(pqCoreUtilitiesEventHelper)
 
  void executeEvent(vtkObject*, unsigned long, void*);
  class pqInternal;
  pqInternal* Interal;
  friend class pqCoreUtilities;
};
 
class PQCORE_EXPORT pqCoreUtilities : public QObject
{
  Q_OBJECT
public:
  static void setMainWidget(QWidget* widget) { pqCoreUtilities::MainWidget = widget; }
  static QWidget* mainWidget()
  {
    if (!pqCoreUtilities::MainWidget)
    {
      pqCoreUtilities::MainWidget = pqCoreUtilities::findMainWindow();
    }
    return pqCoreUtilities::MainWidget;
  }
 
  static void processEvents(QEventLoop::ProcessEventsFlags flags = QEventLoop::AllEvents)
  {
    pqEventDispatcher::processEvents(flags);
  }
 
  static QString getParaViewUserDirectory();
 
  static QString getParaViewApplicationDirectory();
 
  static QStringList findParaviewPaths(
    QString directoryOrFileName, bool lookupInAppDir, bool lookupInUserDir);
  static QString getNoneExistingFileName(QString expectedFilePath);
 
  static unsigned long connect(vtkObject* vtk_object, int vtk_event_id, QObject* qobject,
    const char* signal_or_slot, Qt::ConnectionType type = Qt::AutoConnection);
 
  static bool promptUser(const QString& settingsKey, QMessageBox::Icon icon, const QString& title,
    const QString& message, QMessageBox::StandardButtons buttons, QWidget* parentWdg = nullptr);
 
  static QMessageBox::Button promptUserGeneric(const QString& title, const QString& message,
    QMessageBox::Icon icon, QMessageBox::StandardButtons buttons, QWidget* parentWidget);
 
  static QString number(double value, int lowExponent = -6, int highExponent = 20);
 
  static QString formatFullNumber(double value);
 
 
  // Format with given precision and notation and shortAccurate flag
  static QString formatDouble(double value, int notation, bool shortAccurate, int precision,
    int fullLowExponent = -6, int fullHighExponent = 20);
 
  // Format with RealNumberDisplayed settings
  static QString formatNumber(double value);
 
  // Format with AnimationTime settings
  static QString formatTime(double value);
 
  static QString formatMemoryFromKiBValue(double memoryInKB, int precision = 2);
 
  static void initializeClickMeButton(QAbstractButton* button);
 
  static void setPaletteHighlightToOk(QPalette& palette);
 
  static void setPaletteHighlightToWarning(QPalette& palette);
 
  static void setPaletteHighlightToCritical(QPalette& palette);
 
  static void removeRecursively(QDir dir);
 
  static void remove(const QString& filePath);
 
private:
  static QWidget* findMainWindow();
  static QPointer<QWidget> MainWidget;
};
 
#endif