QGIS/python/gui/editorwidgets/core/qgssearchwidgetwrapper.sip

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





%MappedType QList<QgsSearchWidgetWrapper::FilterFlag>
{
%TypeHeaderCode
#include <QList>
%End

%ConvertFromTypeCode
  // Create the list.
  PyObject *l;

  if ( ( l = PyList_New( sipCpp->size() ) ) == NULL )
    return NULL;

  // Set the list elements.
  QList<QgsSearchWidgetWrapper::FilterFlag>::iterator it = sipCpp->begin();
  for ( int i = 0; it != sipCpp->end(); ++it, ++i )
  {
    PyObject *tobj;

    if ( ( tobj = sipConvertFromEnum( *it, sipType_QgsSearchWidgetWrapper_FilterFlag ) ) == NULL )
    {
      Py_DECREF( l );
      return NULL;
    }
    PyList_SET_ITEM( l, i, tobj );
  }

  return l;
%End

%ConvertToTypeCode
  // Check the type if that is all that is required.
  if ( sipIsErr == NULL )
    return PyList_Check( sipPy );

  QList<QgsSearchWidgetWrapper::FilterFlag> *qlist = new QList<QgsSearchWidgetWrapper::FilterFlag>;

  for ( int i = 0; i < PyList_GET_SIZE( sipPy ); ++i )
  {
    *qlist << ( QgsSearchWidgetWrapper::FilterFlag )SIPLong_AsLong( PyList_GET_ITEM( sipPy, i ) );
  }

  *sipCppPtr = qlist;
  return sipGetState( sipTransferObj );
%End
};

class QgsSearchWidgetWrapper : QgsWidgetWrapper
{
%Docstring
 Manages an editor widget
 Widget and wrapper share the same parent

 A wrapper controls one attribute editor widget and is able to create a default
 widget or use a pre-existent widget. It is able to set the widget to the value implied
 by a field of a vector layer, or return the value it currently holds. Every time it is changed
 it has to emit a valueChanged signal. If it fails to do so, there is no guarantee that the
 changed status of the widget will be saved.
%End

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

    enum FilterFlag
    {
      EqualTo,
      NotEqualTo,
      GreaterThan,
      LessThan,
      GreaterThanOrEqualTo,
      LessThanOrEqualTo,
      Between,
      CaseInsensitive,
      Contains,
      DoesNotContain,
      IsNull,
      IsNotBetween,
      IsNotNull,
    };
    typedef QFlags<QgsSearchWidgetWrapper::FilterFlag> FilterFlags;


    static QList< QgsSearchWidgetWrapper::FilterFlag > exclusiveFilterFlags();
%Docstring
 Returns a list of exclusive filter flags, which cannot be combined with other flags (e.g., EqualTo/NotEqualTo)
.. versionadded:: 2.16
.. seealso:: nonExclusiveFilterFlags()
 :rtype: list of QgsSearchWidgetWrapper.FilterFlag
%End

    static QList< QgsSearchWidgetWrapper::FilterFlag > nonExclusiveFilterFlags();
%Docstring
 Returns a list of non-exclusive filter flags, which can be combined with other flags (e.g., CaseInsensitive)
.. versionadded:: 2.16
.. seealso:: exclusiveFilterFlags()
 :rtype: list of QgsSearchWidgetWrapper.FilterFlag
%End

    static QString toString( QgsSearchWidgetWrapper::FilterFlag flag );
%Docstring
 Returns a translated string representing a filter flag.
 \param flag flag to convert to string
.. versionadded:: 2.16
 :rtype: str
%End

    explicit QgsSearchWidgetWrapper( QgsVectorLayer *vl, int fieldIdx, QWidget *parent /TransferThis/ = 0 );
%Docstring
 Create a new widget wrapper

 \param vl        The layer on which the field is
 \param fieldIdx  The field which will be controlled
 \param parent    A parent widget for this widget wrapper and the created widget.
%End

    virtual FilterFlags supportedFlags() const;
%Docstring
 Returns filter flags supported by the search widget.
.. versionadded:: 2.16
.. seealso:: defaultFlags()
 :rtype: FilterFlags
%End

    virtual FilterFlags defaultFlags() const;
%Docstring
 Returns the filter flags which should be set by default for the search widget.
.. versionadded:: 2.16
.. seealso:: supportedFlags()
 :rtype: FilterFlags
%End

    virtual QString expression() = 0;
%Docstring
 Will be used to access the widget's value. Read the value from the widget and
 return it properly formatted to be saved in the attribute.

 If an invalid variant is returned this will be interpreted as no change.
 Be sure to return a NULL QVariant if it should be set to NULL.

 :return: The current value the widget represents
 :rtype: str
%End

    virtual bool applyDirectly() = 0;
%Docstring
 If this is true, then this search widget should take effect directly
 when its expression changes
 :rtype: bool
%End

    virtual QString createExpression( FilterFlags flags ) const;
%Docstring
 :rtype: str
%End

  public slots:

    virtual void clearWidget();
%Docstring
 Clears the widget's current value and resets it back to the default state
.. versionadded:: 2.16
%End

    virtual void setEnabled( bool enabled );
%Docstring
 Toggles whether the search widget is enabled or disabled.
 \param enabled set to true to enable widget
%End

  signals:

    void expressionChanged( const QString &exp );
%Docstring
 Emitted whenever the expression changes
 \param exp The new search expression
%End

    void valueChanged();
%Docstring
 Emitted when a user changes the value of the search widget.
.. versionadded:: 2.16
%End

    void valueCleared();
%Docstring
 Emitted when a user changes the value of the search widget back
 to an empty, default state.
.. versionadded:: 2.16
%End

  protected slots:

    virtual void setExpression( QString value ) = 0;
    virtual void setFeature( const QgsFeature &feature );


  protected:
    void clearExpression();
%Docstring
clears the expression to search for all features
%End


};

QFlags<QgsSearchWidgetWrapper::FilterFlag> operator|(QgsSearchWidgetWrapper::FilterFlag f1, QFlags<QgsSearchWidgetWrapper::FilterFlag> f2);


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