QGIS/python/PyQt6/gui/auto_generated/auth/qgsauthsettingswidget.sip.in

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




class QgsAuthSettingsWidget : QWidget
{
%Docstring(signature="appended")
Widget for entering authentication credentials both in the form username/password
and by using QGIS Authentication Database and its authentication configurations.

The widget also offers the functionality to convert username/password credentials
to an authentication configuration.
%End

%TypeHeaderCode
#include "qgsauthsettingswidget.h"
%End
  public:

    enum WarningType /BaseType=IntEnum/
    {
      ProjectFile,
      UserSettings
    };

    explicit QgsAuthSettingsWidget( QWidget *parent /TransferThis/ = 0,
                                    const QString &configId = QString(),
                                    const QString &username = QString(),
                                    const QString &password = QString(),
                                    const QString &dataprovider = QString() );
%Docstring
Create a dialog for setting an associated authentication config, either
from existing configs, or creating/removing them from auth database

:param parent: Parent widget
:param configId: authentication configuration id
:param username:
:param password:
:param dataprovider: The key of the calling layer provider, if applicable
%End

    void setWarningText( const QString &warningText );
%Docstring
setWarningText set the text of the warning label

:param warningText: the text of the warning label

.. seealso:: :py:func:`formattedWarning`
%End

    void setBasicText( const QString &basicText );
%Docstring
setBasicText set the text of the warning label

:param basicText: the text of the basic tab label
%End

    QString username() const;
%Docstring
username

:return: basic authentication username
%End

    void setUsername( const QString &username );
%Docstring
setUsername set the username

:param username: the user name
%End

    QString password() const;
%Docstring
password

:return: basic authentication password
%End

    void setPassword( const QString &password );
%Docstring
setPassword set the password

:param password: the password
%End

    QString configId() const;
%Docstring
configId

:return: authentication configuration id
%End

    void setConfigId( const QString &configId );
%Docstring
setConfigId set the authentication configuration id
param configId the authentication configuration id
%End

    void setDataprovider( const QString &dataprovider );
%Docstring
setDataprovider set the data provider key for filtering compatible authentication configurations

:param dataprovider: data provider key
%End

    QString dataprovider() const;
%Docstring
dataprovider

:return: the data provider key used to filter compatible authentication configurations
%End

    static QString formattedWarning( WarningType warning );
%Docstring
warning text message based upon where credentials are stored

:param warning: enum of warning type

:return: pre-formatted warning text
%End

    bool btnConvertToEncryptedIsEnabled() const;
%Docstring
convertButtonEnabled, mainly useful for unit tests

:return: ``True`` if the convert button is enabled
%End

    void showStoreCheckboxes( bool enabled );
%Docstring
showStoreCheckboxes show the "Store" checkboxes for basic auth.
Some connection configurations allow the user to enter credentials
for testing the connection without storing them in the project.
"Store" checkboxes are disabled by default.

:param enabled:
%End

    void setStoreUsernameChecked( bool checked );
%Docstring
setStoreUsernameChecked check the "Store" checkbox for the username

:param checked:

.. seealso:: :py:func:`showStoreCheckboxes`
%End

    void setStorePasswordChecked( bool checked );
%Docstring
setStorePasswordCheched check the "Store" checkbox for the password

:param checked:

.. seealso:: :py:func:`showStoreCheckboxes`
%End

    bool storePasswordIsChecked() const;
%Docstring
storePassword

:return: ``True`` if "Store" checkbox for the password is checked
%End

    bool storeUsernameIsChecked() const;
%Docstring
storeUsername

:return: ``True`` if "Store" checkbox for the username is checked
%End

    bool configurationTabIsSelected();
%Docstring
configurationTabIsSelected

:return: ``True`` if the configuration tab is the currently selected tab
%End

  public slots:

    bool convertToEncrypted();
%Docstring
convertToEncrypted is called when the convert to encrypted button is
clicked and it creates a Basic authentication configuration from
username and password specified in the Basic tab

:return: return ``True`` on success
%End

  signals:

    void usernameChanged();
%Docstring
Emitted when the plain text username defined in the dialog is changed.

.. versionadded:: 3.22
%End

    void passwordChanged();
%Docstring
Emitted when the plain text password defined in the dialog is changed.

.. versionadded:: 3.22
%End

    void configIdChanged();
%Docstring
Emitted when the auth configuration ID selected in the dialog is changed.

.. versionadded:: 3.22
%End

};

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