Class: QgsNewDatabaseTableNameWidget

class qgis.gui.QgsNewDatabaseTableNameWidget(browserModel: QgsBrowserGuiModel = None, providersFilter: Iterable[str] = [], parent: QWidget = None)

Bases: QgsPanelWidget

Constructs a new QgsNewDatabaseTableNameWidget

Parameters
  • browserModel – an existing browser model (typically from app), if NULL an instance will be created

  • providersFilter – optional white list of data provider keys that should be shown in the widget, if not specified all providers data items with database capabilities will be shown

  • parent – optional parent for this widget

The QgsNewDatabaseTableNameWidget class embeds the browser view to select a DB schema and a new table name.

The table name is validated for uniqueness and the selected data item provider, schema and table names can be retrieved with getters.

Warning

The data provider that originated the data item provider must support the connections API

New in version 3.14:

Methods

actionEvent

changeEvent

childEvent

closeEvent

connectNotify

contextMenuEvent

create

customEvent

dataProviderKey

Returns the currently selected data item provider key

destroy

disconnectNotify

dragEnterEvent

dragLeaveEvent

dragMoveEvent

dropEvent

enterEvent

event

focusInEvent

focusNextChild

focusNextPrevChild

focusOutEvent

focusPreviousChild

hideEvent

initPainter

inputMethodEvent

isSignalConnected

isValid

Returns True if the widget contains a valid new table name

keyPressEvent

Overridden key press event to handle the esc event on the widget.

keyReleaseEvent

leaveEvent

metric

mouseDoubleClickEvent

mouseMoveEvent

mousePressEvent

mouseReleaseEvent

moveEvent

nativeEvent

paintEvent

receivers

resizeEvent

schema

Returns the currently selected schema or file path (in case of filesystem-based DBs like spatialite or GPKG) for the new table

sender

senderSignalIndex

setAcceptButtonVisible

Sets whether the optional "Ok"/accept button should be visible.

sharedPainter

showEvent

Scroll to last selected index and expand it's children

table

Returns the current name of the new table

tabletEvent

timerEvent

updateMicroFocus

uri

Returns the (possibly blank) string representation of the new table data source URI.

validationError

Returns the validation error or an empty string is the widget status is valid

wheelEvent

Signals

accepted

Emitted when the OK/accept button is clicked.

providerKeyChanged

This signal is emitted when the selects a data provider or a schema name that has a different data provider than the previously selected one.

schemaNameChanged

This signal is emitted when the user selects a schema (or file path for filesystem-based DBs like spatialite or GPKG).

tableNameChanged

This signal is emitted when the user enters a table name

uriChanged

This signal is emitted when the URI of the new table changes, whether or not it is a valid one.

validationChanged

This signal is emitted whenever the validation status of the widget changes.

accepted

Emitted when the OK/accept button is clicked. [signal]

actionEvent(self, QActionEvent)
changeEvent(self, QEvent)
childEvent(self, QChildEvent)
closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
contextMenuEvent(self, QContextMenuEvent)
create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
customEvent(self, QEvent)
dataProviderKey(self) str

Returns the currently selected data item provider key

Return type

str

destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)
dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enterEvent(self, QEvent)
event(self, QEvent) bool
focusInEvent(self, QFocusEvent)
focusNextChild(self) bool
focusNextPrevChild(self, bool) bool
focusOutEvent(self, QFocusEvent)
focusPreviousChild(self) bool
hideEvent(self, QHideEvent)
initPainter(self, QPainter)
inputMethodEvent(self, QInputMethodEvent)
isSignalConnected(self, QMetaMethod) bool
isValid(self) bool

Returns True if the widget contains a valid new table name

Return type

bool

keyPressEvent(self, event: QKeyEvent)

Overridden key press event to handle the esc event on the widget.

Parameters

event – The key event

keyReleaseEvent(self, QKeyEvent)
leaveEvent(self, QEvent)
metric(self, QPaintDevice.PaintDeviceMetric) int
mouseDoubleClickEvent(self, QMouseEvent)
mouseMoveEvent(self, QMouseEvent)
mousePressEvent(self, QMouseEvent)
mouseReleaseEvent(self, QMouseEvent)
moveEvent(self, QMoveEvent)
nativeEvent(self, Union[QByteArray, bytes, bytearray], sip.voidptr) Tuple[bool, int]
paintEvent(self, QPaintEvent)
providerKeyChanged

This signal is emitted when the selects a data provider or a schema name that has a different data provider than the previously selected one.

Parameters

providerKey (str) – the data provider key of the selected schema [signal]

receivers(self, PYQT_SIGNAL) int
resizeEvent(self, QResizeEvent)
schema(self) str

Returns the currently selected schema or file path (in case of filesystem-based DBs like spatialite or GPKG) for the new table

Return type

str

schemaNameChanged

This signal is emitted when the user selects a schema (or file path for filesystem-based DBs like spatialite or GPKG).

Parameters

schemaName (str) – the name of the selected schema [signal]

sender(self) QObject
senderSignalIndex(self) int
setAcceptButtonVisible(self, visible: bool)

Sets whether the optional “Ok”/accept button should be visible.

By default this is hidden, to better allow the widget to be embedded inside other widgets and dialogs.

Parameters

visible (bool) –

sharedPainter(self) QPainter
showEvent(self, e: QShowEvent)

Scroll to last selected index and expand it’s children

Parameters

e (QShowEvent) –

table(self) str

Returns the current name of the new table

Return type

str

tableNameChanged

This signal is emitted when the user enters a table name

Parameters

tableName (str) – the name of the new table [signal]

tabletEvent(self, QTabletEvent)
timerEvent(self, QTimerEvent)
updateMicroFocus(self)
uri(self) str

Returns the (possibly blank) string representation of the new table data source URI. The URI might be invalid in case the widget is not in a valid state.

Return type

str

uriChanged

This signal is emitted when the URI of the new table changes, whether or not it is a valid one.

Parameters

uri (str) – URI string representation [signal]

validationChanged

This signal is emitted whenever the validation status of the widget changes.

Parameters

isValid (bool) – True if the current status of the widget is valid [signal]

validationError(self) str

Returns the validation error or an empty string is the widget status is valid

Return type

str

wheelEvent(self, QWheelEvent)