/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/gui/qgsexternalresourcewidget.h                                  *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/






%ModuleHeaderCode
// fix to allow compilation with sip that for some reason
// doesn't add this include to the file where the code from
// ConvertToSubClassCode goes.
#include <qgsexternalresourcewidget.h>

#include <qgsexternalstoragefilewidget.h>
%End


class QgsExternalResourceWidget : QWidget
{
%Docstring(signature="appended")
Widget to display file path with a push button for an "open file" dialog
It can also be used to display a picture or a web page.
%End

%TypeHeaderCode
#include "qgsexternalresourcewidget.h"
%End
%ConvertToSubClassCode
    if ( qobject_cast<QgsExternalResourceWidget *>( sipCpp ) )
      sipType = sipType_QgsExternalResourceWidget;
    else
      sipType = NULL;
%End
  public:
    enum DocumentViewerContent /BaseType=IntEnum/
    {
      NoContent,
      Image,
      Web,
      Audio,
      Video,
    };

    explicit QgsExternalResourceWidget( QWidget *parent /TransferThis/ = 0 );
%Docstring
QgsExternalResourceWidget creates a widget with a file widget and a document viewer
Both part of the widget are optional.

.. seealso:: :py:class:`QgsFileWidget`
%End

    QVariant documentPath( QMetaType::Type type = QMetaType::Type::QString ) const;
%Docstring
documentPath returns the path of the current document in the widget

:param type: determines the type of the returned null variant if the document is not defined yet
%End

 QVariant documentPath( QVariant::Type type ) const /Deprecated/;
%Docstring
documentPath returns the path of the current document in the widget

:param type: determines the type of the returned null variant if the document is not defined yet

.. deprecated::
   QGIS 3.38. Use the method with a QMetaType.Type argument instead.
%End

    void setDocumentPath( const QVariant &documentPath );

    QgsExternalStorageFileWidget *fileWidget();
%Docstring
Returns file widget to allow its configuration
%End

    bool fileWidgetVisible() const;
%Docstring
returns if the file widget is visible in the widget
%End
    void setFileWidgetVisible( bool visible );
%Docstring
Sets the visibility of the file widget in the layout
%End

    QgsExternalResourceWidget::DocumentViewerContent documentViewerContent() const;
%Docstring
returns the type of content used in the document viewer
%End
    void setDocumentViewerContent( QgsExternalResourceWidget::DocumentViewerContent content );
%Docstring
setDocumentViewerContent defines the type of content to be shown. Widget will be adapted accordingly
%End

    int documentViewerHeight() const;
%Docstring
returns the height of the document viewer
%End

    void setDocumentViewerHeight( int height );
%Docstring
setDocumentViewerWidth set the height of the document viewer.

:param height: the height. Use 0 for automatic best display.
%End
    int documentViewerWidth() const;
%Docstring
returns the width of the document viewer
%End

    void setDocumentViewerWidth( int width );
%Docstring
setDocumentViewerWidth set the width of the document viewer.

:param width: the width. Use 0 for automatic best display.
%End

    void setReadOnly( bool readOnly );
%Docstring
defines if the widget is readonly
%End

    QgsFileWidget::RelativeStorage relativeStorage() const;
%Docstring
Configures if paths are handled absolute or relative and if relative,
which should be the base path.
%End

    void setRelativeStorage( QgsFileWidget::RelativeStorage relativeStorage );
%Docstring
Configures if paths are handled absolute or relative and if relative,
which should be the base path.
%End


    QString defaultRoot() const;
%Docstring
Configures the base path which should be used if the relativeStorage property
is set to :py:class:`QgsFileWidget`.RelativeDefaultPath.
%End

    void setDefaultRoot( const QString &defaultRoot );
%Docstring
Configures the base path which should be used if the relativeStorage property
is set to :py:class:`QgsFileWidget`.RelativeDefaultPath.
%End

    void setStorageType( const QString &storageType );
%Docstring
Set ``storageType`` storage type unique identifier as defined in :py:class:`QgsExternalStorageRegistry` or
null QString if there is no storage defined, only file selection.

.. seealso:: :py:func:`storageType`

.. versionadded:: 3.22
%End

    QString storageType() const;
%Docstring
Returns storage type unique identifier as defined in :py:class:`QgsExternalStorageRegistry`.
Returns null QString if there is no storage defined, only file selection.

.. seealso:: :py:func:`setStorageType`

.. versionadded:: 3.22
%End

    void setStorageAuthConfigId( const QString &authCfg );
%Docstring
Sets the authentication configuration ID to be used for the current external storage (if
defined)

.. versionadded:: 3.22
%End

    QString storageAuthConfigId() const;
%Docstring
Returns the authentication configuration ID used for the current external storage (if defined)

.. versionadded:: 3.22
%End

    void setMessageBar( QgsMessageBar *messageBar );
%Docstring
Set ``messageBar`` to report messages

.. versionadded:: 3.22
%End

    QgsMessageBar *messageBar() const;
%Docstring
Returns message bar used to report messages

.. versionadded:: 3.22
%End

  signals:
    void valueChanged( const QString & );
%Docstring
emitteed as soon as the current document changes
%End

};

/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/gui/qgsexternalresourcewidget.h                                  *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/