QGIS API Documentation  3.4.15-Madeira (e83d02e274)
Public Types | Signals | Public Member Functions | Protected Member Functions | Properties | List of all members
QgsExternalResourceWidget Class Reference

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. More...

#include <qgsexternalresourcewidget.h>

Inheritance diagram for QgsExternalResourceWidget:
Inheritance graph
[legend]

Public Types

enum  DocumentViewerContent { NoContent, Image, Web }
 

Signals

void valueChanged (const QString &)
 emitteed as soon as the current document changes More...
 

Public Member Functions

 QgsExternalResourceWidget (QWidget *parent=nullptr)
 QgsExternalResourceWidget creates a widget with a file widget and a document viewer Both part of the widget are optional. More...
 
QString defaultRoot () const
 Configures the base path which should be used if the relativeStorage property is set to QgsFileWidget::RelativeDefaultPath. More...
 
QVariant documentPath (QVariant::Type type=QVariant::String) const
 documentPath returns the path of the current document in the widget More...
 
QgsExternalResourceWidget::DocumentViewerContent documentViewerContent () const
 returns the type of content used in the document viewer More...
 
int documentViewerHeight () const
 returns the height of the document viewer More...
 
int documentViewerWidth () const
 returns the width of the document viewer More...
 
QgsFileWidgetfileWidget ()
 access the file widget to allow its configuration More...
 
bool fileWidgetVisible () const
 returns if the file widget is visible in the widget More...
 
QgsFileWidget::RelativeStorage relativeStorage () const
 Configures if paths are handled absolute or relative and if relative, which should be the base path. More...
 
void setDefaultRoot (const QString &defaultRoot)
 Configures the base path which should be used if the relativeStorage property is set to QgsFileWidget::RelativeDefaultPath. More...
 
void setDocumentPath (const QVariant &documentPath)
 
void setDocumentViewerContent (QgsExternalResourceWidget::DocumentViewerContent content)
 setDocumentViewerContent defines the type of content to be shown. Widget will be adapted accordingly More...
 
void setDocumentViewerHeight (int height)
 setDocumentViewerWidth set the height of the document viewer. More...
 
void setDocumentViewerWidth (int width)
 setDocumentViewerWidth set the width of the document viewer. More...
 
void setFileWidgetVisible (bool visible)
 Sets the visiblity of the file widget in the layout. More...
 
void setReadOnly (bool readOnly)
 defines if the widget is readonly More...
 
void setRelativeStorage (QgsFileWidget::RelativeStorage relativeStorage)
 Configures if paths are handled absolute or relative and if relative, which should be the base path. More...
 

Protected Member Functions

bool eventFilter (QObject *watched, QEvent *event) override
 

Properties

QString defaultRoot
 
DocumentViewerContent documentViewerContent
 
int documentViewerHeight
 
int documentViewerWidth
 
bool fileWidgetVisible
 
QgsFileWidget::RelativeStorage relativeStorage
 

Detailed Description

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.

Definition at line 46 of file qgsexternalresourcewidget.h.

Member Enumeration Documentation

Enumerator
NoContent 
Image 
Web 

Definition at line 67 of file qgsexternalresourcewidget.h.

Constructor & Destructor Documentation

QgsExternalResourceWidget::QgsExternalResourceWidget ( QWidget *  parent = nullptr)
explicit

QgsExternalResourceWidget creates a widget with a file widget and a document viewer Both part of the widget are optional.

See also
QgsFileWidget

Definition at line 31 of file qgsexternalresourcewidget.cpp.

Member Function Documentation

QString QgsExternalResourceWidget::defaultRoot ( ) const

Configures the base path which should be used if the relativeStorage property is set to QgsFileWidget::RelativeDefaultPath.

QVariant QgsExternalResourceWidget::documentPath ( QVariant::Type  type = QVariant::String) const

documentPath returns the path of the current document in the widget

Parameters
typedetermines the type of the returned null variant if the document is not defined yet

Definition at line 71 of file qgsexternalresourcewidget.cpp.

QgsExternalResourceWidget::DocumentViewerContent QgsExternalResourceWidget::documentViewerContent ( ) const

returns the type of content used in the document viewer

int QgsExternalResourceWidget::documentViewerHeight ( ) const

returns the height of the document viewer

int QgsExternalResourceWidget::documentViewerWidth ( ) const

returns the width of the document viewer

bool QgsExternalResourceWidget::eventFilter ( QObject *  watched,
QEvent *  event 
)
overrideprotected

Definition at line 208 of file qgsexternalresourcewidget.cpp.

QgsFileWidget * QgsExternalResourceWidget::fileWidget ( )

access the file widget to allow its configuration

Definition at line 89 of file qgsexternalresourcewidget.cpp.

bool QgsExternalResourceWidget::fileWidgetVisible ( ) const

returns if the file widget is visible in the widget

QgsFileWidget::RelativeStorage QgsExternalResourceWidget::relativeStorage ( ) const

Configures if paths are handled absolute or relative and if relative, which should be the base path.

void QgsExternalResourceWidget::setDefaultRoot ( const QString &  defaultRoot)

Configures the base path which should be used if the relativeStorage property is set to QgsFileWidget::RelativeDefaultPath.

Definition at line 202 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::setDocumentPath ( const QVariant &  documentPath)

Definition at line 84 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::setDocumentViewerContent ( QgsExternalResourceWidget::DocumentViewerContent  content)

setDocumentViewerContent defines the type of content to be shown. Widget will be adapted accordingly

Definition at line 110 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::setDocumentViewerHeight ( int  height)

setDocumentViewerWidth set the height of the document viewer.

Parameters
heightthe height. Use 0 for automatic best display.

Definition at line 121 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::setDocumentViewerWidth ( int  width)

setDocumentViewerWidth set the width of the document viewer.

Parameters
widththe width. Use 0 for automatic best display.

Definition at line 132 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::setFileWidgetVisible ( bool  visible)

Sets the visiblity of the file widget in the layout.

Definition at line 99 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::setReadOnly ( bool  readOnly)

defines if the widget is readonly

Definition at line 138 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::setRelativeStorage ( QgsFileWidget::RelativeStorage  relativeStorage)

Configures if paths are handled absolute or relative and if relative, which should be the base path.

Definition at line 222 of file qgsexternalresourcewidget.cpp.

void QgsExternalResourceWidget::valueChanged ( const QString &  )
signal

emitteed as soon as the current document changes

Property Documentation

QString QgsExternalResourceWidget::defaultRoot
readwrite

Definition at line 64 of file qgsexternalresourcewidget.h.

QgsExternalResourceWidget::DocumentViewerContent QgsExternalResourceWidget::documentViewerContent
readwrite

Definition at line 60 of file qgsexternalresourcewidget.h.

int QgsExternalResourceWidget::documentViewerHeight
readwrite

Definition at line 61 of file qgsexternalresourcewidget.h.

int QgsExternalResourceWidget::documentViewerWidth
readwrite

Definition at line 62 of file qgsexternalresourcewidget.h.

bool QgsExternalResourceWidget::fileWidgetVisible
readwrite

Definition at line 59 of file qgsexternalresourcewidget.h.

QgsFileWidget::RelativeStorage QgsExternalResourceWidget::relativeStorage
readwrite

Definition at line 63 of file qgsexternalresourcewidget.h.


The documentation for this class was generated from the following files: