// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-FileCopyrightText: Copyright 2009 Sandia Corporation
// SPDX-License-Identifier: LicenseRef-BSD-3-Clause-Sandia-USGov
/**
 * @class   vtkQtView
 * @brief   Superclass for Qt widget-based views.
 *
 *
 * This abstract superclass provides common api to integrate a Qt widget
 * into the VTK view framework. Not much here yet, but in the future there
 * could be methods around selection, event-handling, drag-and-drop, etc.
 *
 */

#ifndef vtkQtView_h
#define vtkQtView_h

#include "vtkView.h"
#include "vtkViewsQtModule.h" // For export macro

#include <QObject> // Needed to hook into Qt

VTK_ABI_NAMESPACE_BEGIN
class VTKVIEWSQT_EXPORT vtkQtView
  : public QObject
  , public vtkView
{
  Q_OBJECT
public:
  vtkTypeMacro(vtkQtView, vtkView);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  /**
   * Get the main container of this view (a  QWidget).
   * The application typically places the view with a call
   * to GetWidget(): something like this
   * this->ui->box->layout()->addWidget(this->View->GetWidget());
   */
  virtual QWidget* GetWidget() = 0;

  /**
   * Calls QApplication::processEvents().  This is useful if you are using QWidgets
   * but have not called QApplication::exec because you don't want to give control
   * to the Qt event loop.  See also ProcessQtEventsNoUserEvents().
   */
  virtual void ProcessQtEvents();

  /**
   * Calls QApplication::processEvents(QEventLoop::ExcludeUserInputEvents).
   * See also ProcessQtEvents().
   */
  virtual void ProcessQtEventsNoUserInput();

  /**
   * Save an image.  Uses QPixmap::grab and QPixmap::save.  The image format will
   * be determined from the filename.  Qt's image format support may vary, usually
   * bmp, jpg, ppm, or png is a safe choice.  Returns false if there was a failure.
   */
  virtual bool SaveImage(VTK_FILEPATH const char* fileName);

protected:
  vtkQtView();
  ~vtkQtView() override;

private:
  vtkQtView(const vtkQtView&) = delete;
  void operator=(const vtkQtView&) = delete;
};

VTK_ABI_NAMESPACE_END
#endif
// VTK-HeaderTest-Exclude: vtkQtView.h
