Replace "drop down" and some dropdown by drop-down

This commit is contained in:
Harrissou Sant-anna 2017-07-04 22:08:17 +02:00
parent 15be88918f
commit 0c967927ef
17 changed files with 86 additions and 85 deletions

2
NEWS
View File

@ -800,7 +800,7 @@ changed so we will just provide a bullet list of key new features here.
- Make NULL value string representation configurable. - Make NULL value string representation configurable.
- Fix feature updates in feature form from attribute table. - Fix feature updates in feature form from attribute table.
- Add support for NULL values in value maps (comboboxes). - Add support for NULL values in value maps (comboboxes).
- Use layer names instead of ids in drop down list when loading value maps from layers. - Use layer names instead of ids in drop-down list when loading value maps from layers.
- Support feature form expression fields: line edits on the form which - Support feature form expression fields: line edits on the form which
name prefix "expr_" are evaluated. Their value is interpreted as field name prefix "expr_" are evaluated. Their value is interpreted as field
calculator string and replaced with the calculated value. calculator string and replaced with the calculated value.

View File

@ -917,7 +917,7 @@ changed so we will just provide a bullet list of key new features here.
<LI>Make NULL value string representation configurable. <LI>Make NULL value string representation configurable.
<LI>Fix feature updates in feature form from attribute table. <LI>Fix feature updates in feature form from attribute table.
<LI>Add support for NULL values in value maps (comboboxes). <LI>Add support for NULL values in value maps (comboboxes).
<LI>Use layer names instead of ids in drop down list when loading value maps from layers. <LI>Use layer names instead of ids in drop-down list when loading value maps from layers.
<LI>Support feature form expression fields: line edits on the form which <LI>Support feature form expression fields: line edits on the form which
name prefix "expr_" are evaluated. Their value is interpreted as field name prefix "expr_" are evaluated. Their value is interpreted as field
calculator string and replaced with the calculated value. calculator string and replaced with the calculated value.

View File

@ -779,7 +779,7 @@ changed so we will just provide a bullet list of key new features here.
- Make NULL value string representation configurable. - Make NULL value string representation configurable.
- Fix feature updates in feature form from attribute table. - Fix feature updates in feature form from attribute table.
- Add support for NULL values in value maps (comboboxes). - Add support for NULL values in value maps (comboboxes).
- Use layer names instead of ids in drop down list when loading value maps from layers. - Use layer names instead of ids in drop-down list when loading value maps from layers.
- Support feature form expression fields: line edits on the form which - Support feature form expression fields: line edits on the form which
name prefix "expr_" are evaluated. Their value is interpreted as field name prefix "expr_" are evaluated. Their value is interpreted as field
calculator string and replaced with the calculated value. calculator string and replaced with the calculated value.

View File

@ -12,7 +12,7 @@ class QgsColorButton : QToolButton
{ {
%Docstring %Docstring
A cross platform button subclass for selecting colors. Will open a color chooser dialog when clicked. A cross platform button subclass for selecting colors. Will open a color chooser dialog when clicked.
Offers live updates to button from color chooser dialog. An attached drop down menu allows for copying Offers live updates to button from color chooser dialog. An attached drop-down menu allows for copying
and pasting colors, picking colors from the screen, and selecting colors from color swatch grids. and pasting colors, picking colors from the screen, and selecting colors from color swatch grids.
.. versionadded:: 2.5 .. versionadded:: 2.5
%End %End
@ -40,7 +40,7 @@ class QgsColorButton : QToolButton
Construct a new color ramp button. Construct a new color ramp button.
Use ``parent`` to attach a parent QWidget to the dialog. Use ``parent`` to attach a parent QWidget to the dialog.
Use ``cdt`` string to define the title to show in the color ramp dialog Use ``cdt`` string to define the title to show in the color ramp dialog
Use a color scheme ``registry`` for color swatch grids to show in the drop down menu. If not specified, Use a color scheme ``registry`` for color swatch grids to show in the drop-down menu. If not specified,
the button will use the global color scheme registry instead the button will use the global color scheme registry instead
%End %End
@ -106,16 +106,16 @@ class QgsColorButton : QToolButton
void setShowMenu( const bool showMenu ); void setShowMenu( const bool showMenu );
%Docstring %Docstring
Sets whether the drop down menu should be shown for the button. The default behavior is to Sets whether the drop-down menu should be shown for the button. The default behavior is to
show the menu. show the menu.
\param showMenu set to false to hide the drop down menu \param showMenu set to false to hide the drop-down menu
.. seealso:: showMenu .. seealso:: showMenu
%End %End
bool showMenu() const; bool showMenu() const;
%Docstring %Docstring
Returns whether the drop down menu is shown for the button. Returns whether the drop-down menu is shown for the button.
:return: true if drop down menu is shown :return: true if drop-down menu is shown
.. seealso:: setShowMenu .. seealso:: setShowMenu
:rtype: bool :rtype: bool
%End %End
@ -138,7 +138,7 @@ class QgsColorButton : QToolButton
void setDefaultColor( const QColor &color ); void setDefaultColor( const QColor &color );
%Docstring %Docstring
Sets the default color for the button, which is shown in the button's drop down menu for the Sets the default color for the button, which is shown in the button's drop-down menu for the
"default color" option. "default color" option.
\param color default color for the button. Set to an invalid QColor to disable the default color \param color default color for the button. Set to an invalid QColor to disable the default color
option. option.
@ -147,7 +147,7 @@ class QgsColorButton : QToolButton
QColor defaultColor() const; QColor defaultColor() const;
%Docstring %Docstring
Returns the default color for the button, which is shown in the button's drop down menu for the Returns the default color for the button, which is shown in the button's drop-down menu for the
"default color" option. "default color" option.
:return: default color for the button. Returns an invalid QColor if the default color :return: default color for the button. Returns an invalid QColor if the default color
option is disabled. option is disabled.
@ -157,7 +157,7 @@ class QgsColorButton : QToolButton
void setShowNoColor( const bool showNoColorOption ); void setShowNoColor( const bool showNoColorOption );
%Docstring %Docstring
Sets whether the "no color" option should be shown in the button's drop down menu. If selected, Sets whether the "no color" option should be shown in the button's drop-down menu. If selected,
the "no color" option sets the color button's color to a totally transparent color. the "no color" option sets the color button's color to a totally transparent color.
\param showNoColorOption set to true to show the no color option. This is disabled by default. \param showNoColorOption set to true to show the no color option. This is disabled by default.
.. seealso:: showNoColor .. seealso:: showNoColor
@ -170,7 +170,7 @@ class QgsColorButton : QToolButton
bool showNoColor() const; bool showNoColor() const;
%Docstring %Docstring
Returns whether the "no color" option is shown in the button's drop down menu. If selected, Returns whether the "no color" option is shown in the button's drop-down menu. If selected,
the "no color" option sets the color button's color to a totally transparent color. the "no color" option sets the color button's color to a totally transparent color.
:return: true if the no color option is shown. :return: true if the no color option is shown.
.. seealso:: setShowNoColor .. seealso:: setShowNoColor
@ -184,7 +184,7 @@ class QgsColorButton : QToolButton
void setNoColorString( const QString &noColorString ); void setNoColorString( const QString &noColorString );
%Docstring %Docstring
Sets the string to use for the "no color" option in the button's drop down menu. Sets the string to use for the "no color" option in the button's drop-down menu.
\param noColorString string to use for the "no color" menu option \param noColorString string to use for the "no color" menu option
.. seealso:: noColorString .. seealso:: noColorString
.. seealso:: setShowNoColor .. seealso:: setShowNoColor
@ -196,7 +196,7 @@ class QgsColorButton : QToolButton
void setShowNull( bool showNull ); void setShowNull( bool showNull );
%Docstring %Docstring
Sets whether a set to null (clear) option is shown in the button's drop down menu. Sets whether a set to null (clear) option is shown in the button's drop-down menu.
\param showNull set to true to show a null option \param showNull set to true to show a null option
.. versionadded:: 2.16 .. versionadded:: 2.16
.. seealso:: showNull() .. seealso:: showNull()
@ -205,7 +205,7 @@ class QgsColorButton : QToolButton
bool showNull() const; bool showNull() const;
%Docstring %Docstring
Returns whether the set to null (clear) option is shown in the button's drop down menu. Returns whether the set to null (clear) option is shown in the button's drop-down menu.
.. versionadded:: 2.16 .. versionadded:: 2.16
.. seealso:: setShowNull() .. seealso:: setShowNull()
.. seealso:: isNull() .. seealso:: isNull()
@ -223,7 +223,7 @@ class QgsColorButton : QToolButton
QString noColorString() const; QString noColorString() const;
%Docstring %Docstring
Returns the string used for the "no color" option in the button's drop down menu. Returns the string used for the "no color" option in the button's drop-down menu.
:return: string used for the "no color" menu option :return: string used for the "no color" menu option
.. seealso:: setNoColorString .. seealso:: setNoColorString
.. seealso:: showNoColor .. seealso:: showNoColor
@ -237,7 +237,7 @@ class QgsColorButton : QToolButton
void setContext( const QString &context ); void setContext( const QString &context );
%Docstring %Docstring
Sets the context string for the color button. The context string is passed to all color swatch Sets the context string for the color button. The context string is passed to all color swatch
grids shown in the button's drop down menu, to allow them to customise their display colors grids shown in the button's drop-down menu, to allow them to customise their display colors
based on the context. based on the context.
\param context context string for the color button's color swatch grids \param context context string for the color button's color swatch grids
.. seealso:: context .. seealso:: context
@ -246,7 +246,7 @@ class QgsColorButton : QToolButton
QString context() const; QString context() const;
%Docstring %Docstring
Returns the context string for the color button. The context string is passed to all color swatch Returns the context string for the color button. The context string is passed to all color swatch
grids shown in the button's drop down menu, to allow them to customise their display colors grids shown in the button's drop-down menu, to allow them to customise their display colors
based on the context. based on the context.
:return: context string for the color button's color swatch grids :return: context string for the color button's color swatch grids
.. seealso:: setContext .. seealso:: setContext
@ -256,18 +256,18 @@ class QgsColorButton : QToolButton
void setColorSchemeRegistry( QgsColorSchemeRegistry *registry ); void setColorSchemeRegistry( QgsColorSchemeRegistry *registry );
%Docstring %Docstring
Sets the color scheme registry for the button, which controls the color swatch grids Sets the color scheme registry for the button, which controls the color swatch grids
that are shown in the button's drop down menu. that are shown in the button's drop-down menu.
\param registry color scheme registry for the button. Set to 0 to hide all color \param registry color scheme registry for the button. Set to 0 to hide all color
swatch grids from the button's drop down menu. swatch grids from the button's drop-down menu.
.. seealso:: colorSchemeRegistry .. seealso:: colorSchemeRegistry
%End %End
QgsColorSchemeRegistry *colorSchemeRegistry(); QgsColorSchemeRegistry *colorSchemeRegistry();
%Docstring %Docstring
Returns the color scheme registry for the button, which controls the color swatch grids Returns the color scheme registry for the button, which controls the color swatch grids
that are shown in the button's drop down menu. that are shown in the button's drop-down menu.
:return: color scheme registry for the button. If returned value is 0 then all color :return: color scheme registry for the button. If returned value is 0 then all color
swatch grids are hidden from the button's drop down menu. swatch grids are hidden from the button's drop-down menu.
.. seealso:: setColorSchemeRegistry .. seealso:: setColorSchemeRegistry
:rtype: QgsColorSchemeRegistry :rtype: QgsColorSchemeRegistry
%End %End

View File

@ -14,7 +14,7 @@ class QgsColorRampButton : QToolButton
{ {
%Docstring %Docstring
A cross platform button subclass for selecting color ramps. Will open color ramp dialogs when clicked. A cross platform button subclass for selecting color ramps. Will open color ramp dialogs when clicked.
Offers live updates to button from color ramp dialog. An attached drop down menu allows for access to Offers live updates to button from color ramp dialog. An attached drop-down menu allows for access to
saved color ramps, as well as option to invert the current color ramp and create new ramps. saved color ramps, as well as option to invert the current color ramp and create new ramps.
.. versionadded:: 3.0 .. versionadded:: 3.0
%End %End
@ -75,23 +75,23 @@ class QgsColorRampButton : QToolButton
void setShowMenu( const bool showMenu ); void setShowMenu( const bool showMenu );
%Docstring %Docstring
Sets whether the drop down menu should be shown for the button. The default behavior is to Sets whether the drop-down menu should be shown for the button. The default behavior is to
show the menu. show the menu.
\param showMenu set to false to hide the drop down menu \param showMenu set to false to hide the drop-down menu
.. seealso:: showMenu .. seealso:: showMenu
%End %End
bool showMenu() const; bool showMenu() const;
%Docstring %Docstring
Returns whether the drop down menu is shown for the button. Returns whether the drop-down menu is shown for the button.
:return: true if drop down menu is shown :return: true if drop-down menu is shown
.. seealso:: setShowMenu .. seealso:: setShowMenu
:rtype: bool :rtype: bool
%End %End
void setDefaultColorRamp( QgsColorRamp *colorramp ); void setDefaultColorRamp( QgsColorRamp *colorramp );
%Docstring %Docstring
Sets the default color ramp for the button, which is shown in the button's drop down menu for the Sets the default color ramp for the button, which is shown in the button's drop-down menu for the
"default color ramp" option. "default color ramp" option.
\param colorramp default color ramp for the button. Set to a null pointer to disable the default color \param colorramp default color ramp for the button. Set to a null pointer to disable the default color
ramp option. The ramp will be cloned and ownership is not transferred. ramp option. The ramp will be cloned and ownership is not transferred.
@ -100,7 +100,7 @@ class QgsColorRampButton : QToolButton
QgsColorRamp *defaultColorRamp() const /Factory/; QgsColorRamp *defaultColorRamp() const /Factory/;
%Docstring %Docstring
Returns a copy of the default color ramp for the button, which is shown in the button's drop down menu for the Returns a copy of the default color ramp for the button, which is shown in the button's drop-down menu for the
"default color ramp" option. "default color ramp" option.
:return: default color ramp for the button. Returns a null pointer if the default color ramp :return: default color ramp for the button. Returns a null pointer if the default color ramp
option is disabled. option is disabled.
@ -110,14 +110,14 @@ class QgsColorRampButton : QToolButton
void setShowRandomColorRamp( bool showRandom ); void setShowRandomColorRamp( bool showRandom );
%Docstring %Docstring
Sets whether a random colors option is shown in the button's drop down menu. Sets whether a random colors option is shown in the button's drop-down menu.
\param showRandom set to true to show a random colors option \param showRandom set to true to show a random colors option
.. seealso:: showRandom() .. seealso:: showRandom()
%End %End
bool showRandomColorRamp() const; bool showRandomColorRamp() const;
%Docstring %Docstring
Returns whether random colors option is shown in the button's drop down menu. Returns whether random colors option is shown in the button's drop-down menu.
.. seealso:: setShowRandom() .. seealso:: setShowRandom()
:rtype: bool :rtype: bool
%End %End
@ -132,7 +132,7 @@ class QgsColorRampButton : QToolButton
void setShowNull( bool showNull ); void setShowNull( bool showNull );
%Docstring %Docstring
Sets whether a set to null (clear) option is shown in the button's drop down menu. Sets whether a set to null (clear) option is shown in the button's drop-down menu.
\param showNull set to true to show a null option \param showNull set to true to show a null option
.. seealso:: showNull() .. seealso:: showNull()
.. seealso:: isNull() .. seealso:: isNull()
@ -140,7 +140,7 @@ class QgsColorRampButton : QToolButton
bool showNull() const; bool showNull() const;
%Docstring %Docstring
Returns whether the set to null (clear) option is shown in the button's drop down menu. Returns whether the set to null (clear) option is shown in the button's drop-down menu.
.. seealso:: setShowNull() .. seealso:: setShowNull()
.. seealso:: isNull() .. seealso:: isNull()
:rtype: bool :rtype: bool
@ -157,7 +157,7 @@ class QgsColorRampButton : QToolButton
void setContext( const QString &context ); void setContext( const QString &context );
%Docstring %Docstring
Sets the context string for the color ramp button. The context string is passed to all color ramp Sets the context string for the color ramp button. The context string is passed to all color ramp
preview icons shown in the button's drop down menu, to (eventually) allow them to customise their display colors preview icons shown in the button's drop-down menu, to (eventually) allow them to customise their display colors
based on the context. based on the context.
\param context context string for the color dialog button's color ramp preview icons \param context context string for the color dialog button's color ramp preview icons
.. seealso:: context .. seealso:: context
@ -166,7 +166,7 @@ class QgsColorRampButton : QToolButton
QString context() const; QString context() const;
%Docstring %Docstring
Returns the context string for the color ramp button. The context string is passed to all color ramp Returns the context string for the color ramp button. The context string is passed to all color ramp
preview icons shown in the button's drop down menu, to (eventually) allow them to customise their display colors preview icons shown in the button's drop-down menu, to (eventually) allow them to customise their display colors
based on the context. based on the context.
:return: context context string for the color dialog button's color ramp preview icons :return: context context string for the color dialog button's color ramp preview icons
.. seealso:: setContext .. seealso:: setContext

View File

@ -18,7 +18,7 @@ class QgsExpressionLineEdit : QWidget
This widget is designed for use in contexts where no layer fields are available for This widget is designed for use in contexts where no layer fields are available for
use in an expression. In contexts where the expression is directly associated with use in an expression. In contexts where the expression is directly associated with
a layer and fields can be used, then QgsFieldExpressionWidget is a more appropriate a layer and fields can be used, then QgsFieldExpressionWidget is a more appropriate
choice as it gives users direct access to select fields from a drop down list. choice as it gives users direct access to select fields from a drop-down list.
QgsExpressionLineEdit also supports a multiline editor mode which is useful where QgsExpressionLineEdit also supports a multiline editor mode which is useful where
more space is available for the widget, but where QgsExpressionBuilderWidget more space is available for the widget, but where QgsExpressionBuilderWidget

View File

@ -1,3 +1,3 @@
<h3>Add SpatiaLite Tables</h3> <h3>Add SpatiaLite Tables</h3>
To define a new connection, click on <label>New</label> button and use the file browser to point to your SpatiaLite database, which is a file with a <i>.sqlite</i> extension.<p> To define a new connection, click on <label>New</label> button and use the file browser to point to your SpatiaLite database, which is a file with a <i>.sqlite</i> extension.<p>
The connections you define will be remembered for further use and available to choose from the drop down menu. The connections you define will be remembered for further use and available to choose from the drop-down menu.

View File

@ -2403,6 +2403,7 @@ Dravadian:Dravidian
dreasm:dreams dreasm:dreams
driectly:directly driectly:directly
drnik:drink drnik:drink
drop down:drop-down
droped:dropped:* droped:dropped:*
droppped:dropped droppped:dropped
druming:drumming druming:drumming

View File

@ -71,7 +71,7 @@ class CORE_EXPORT QgsAttributeTableConfig
enum ActionWidgetStyle enum ActionWidgetStyle
{ {
ButtonList, //!< A list of buttons ButtonList, //!< A list of buttons
DropDown //!< A tool button with a dropdown to select the current action DropDown //!< A tool button with a drop-down to select the current action
}; };
QgsAttributeTableConfig(); QgsAttributeTableConfig();

View File

@ -68,7 +68,7 @@ class CORE_EXPORT QgsColorScheme
enum SchemeFlag enum SchemeFlag
{ {
ShowInColorDialog = 0x01, //!< Show scheme in color picker dialog ShowInColorDialog = 0x01, //!< Show scheme in color picker dialog
ShowInColorButtonMenu = 0x02, //!< Show scheme in color button drop down menu ShowInColorButtonMenu = 0x02, //!< Show scheme in color button drop-down menu
ShowInAllContexts = ShowInColorDialog | ShowInColorButtonMenu //!< Show scheme in all contexts ShowInAllContexts = ShowInColorDialog | ShowInColorButtonMenu //!< Show scheme in all contexts
}; };
Q_DECLARE_FLAGS( SchemeFlags, SchemeFlag ) Q_DECLARE_FLAGS( SchemeFlags, SchemeFlag )

View File

@ -61,7 +61,7 @@ QgsColorButton::QgsColorButton( QWidget *parent, const QString &cdt, QgsColorSch
setMinimumSize( QSize( 24, 16 ) ); setMinimumSize( QSize( 24, 16 ) );
connect( this, &QAbstractButton::clicked, this, &QgsColorButton::buttonClicked ); connect( this, &QAbstractButton::clicked, this, &QgsColorButton::buttonClicked );
//setup dropdown menu //setup drop-down menu
mMenu = new QMenu( this ); mMenu = new QMenu( this );
connect( mMenu, &QMenu::aboutToShow, this, &QgsColorButton::prepareMenu ); connect( mMenu, &QMenu::aboutToShow, this, &QgsColorButton::prepareMenu );
setMenu( mMenu ); setMenu( mMenu );
@ -597,7 +597,7 @@ void QgsColorButton::setButtonBackground( const QColor &color )
{ {
if ( !mIconSize.isValid() ) if ( !mIconSize.isValid() )
{ {
//calculate size of push button part of widget (ie, without the menu dropdown button part) //calculate size of push button part of widget (ie, without the menu drop-down button part)
QStyleOptionToolButton opt; QStyleOptionToolButton opt;
initStyleOption( &opt ); initStyleOption( &opt );
QRect buttonSize = QApplication::style()->subControlRect( QStyle::CC_ToolButton, &opt, QStyle::SC_ToolButton, QRect buttonSize = QApplication::style()->subControlRect( QStyle::CC_ToolButton, &opt, QStyle::SC_ToolButton,

View File

@ -28,7 +28,7 @@ class QgsPanelWidget;
/** \ingroup gui /** \ingroup gui
* \class QgsColorButton * \class QgsColorButton
* A cross platform button subclass for selecting colors. Will open a color chooser dialog when clicked. * A cross platform button subclass for selecting colors. Will open a color chooser dialog when clicked.
* Offers live updates to button from color chooser dialog. An attached drop down menu allows for copying * Offers live updates to button from color chooser dialog. An attached drop-down menu allows for copying
* and pasting colors, picking colors from the screen, and selecting colors from color swatch grids. * and pasting colors, picking colors from the screen, and selecting colors from color swatch grids.
* \since QGIS 2.5 * \since QGIS 2.5
*/ */
@ -71,7 +71,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
/** Construct a new color ramp button. /** Construct a new color ramp button.
* Use \a parent to attach a parent QWidget to the dialog. * Use \a parent to attach a parent QWidget to the dialog.
* Use \a cdt string to define the title to show in the color ramp dialog * Use \a cdt string to define the title to show in the color ramp dialog
* Use a color scheme \a registry for color swatch grids to show in the drop down menu. If not specified, * Use a color scheme \a registry for color swatch grids to show in the drop-down menu. If not specified,
* the button will use the global color scheme registry instead * the button will use the global color scheme registry instead
*/ */
QgsColorButton( QWidget *parent SIP_TRANSFERTHIS = nullptr, const QString &cdt = "", QgsColorSchemeRegistry *registry = nullptr ); QgsColorButton( QWidget *parent SIP_TRANSFERTHIS = nullptr, const QString &cdt = "", QgsColorSchemeRegistry *registry = nullptr );
@ -127,15 +127,15 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
void setAcceptLiveUpdates( const bool accept ) { mAcceptLiveUpdates = accept; } void setAcceptLiveUpdates( const bool accept ) { mAcceptLiveUpdates = accept; }
/** Sets whether the drop down menu should be shown for the button. The default behavior is to /** Sets whether the drop-down menu should be shown for the button. The default behavior is to
* show the menu. * show the menu.
* \param showMenu set to false to hide the drop down menu * \param showMenu set to false to hide the drop-down menu
* \see showMenu * \see showMenu
*/ */
void setShowMenu( const bool showMenu ); void setShowMenu( const bool showMenu );
/** Returns whether the drop down menu is shown for the button. /** Returns whether the drop-down menu is shown for the button.
* \returns true if drop down menu is shown * \returns true if drop-down menu is shown
* \see setShowMenu * \see setShowMenu
*/ */
bool showMenu() const { return menu() ? true : false; } bool showMenu() const { return menu() ? true : false; }
@ -153,7 +153,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
Behavior behavior() const { return mBehavior; } Behavior behavior() const { return mBehavior; }
/** Sets the default color for the button, which is shown in the button's drop down menu for the /** Sets the default color for the button, which is shown in the button's drop-down menu for the
* "default color" option. * "default color" option.
* \param color default color for the button. Set to an invalid QColor to disable the default color * \param color default color for the button. Set to an invalid QColor to disable the default color
* option. * option.
@ -161,7 +161,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
void setDefaultColor( const QColor &color ); void setDefaultColor( const QColor &color );
/** Returns the default color for the button, which is shown in the button's drop down menu for the /** Returns the default color for the button, which is shown in the button's drop-down menu for the
* "default color" option. * "default color" option.
* \returns default color for the button. Returns an invalid QColor if the default color * \returns default color for the button. Returns an invalid QColor if the default color
* option is disabled. * option is disabled.
@ -169,7 +169,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
QColor defaultColor() const { return mDefaultColor; } QColor defaultColor() const { return mDefaultColor; }
/** Sets whether the "no color" option should be shown in the button's drop down menu. If selected, /** Sets whether the "no color" option should be shown in the button's drop-down menu. If selected,
* the "no color" option sets the color button's color to a totally transparent color. * the "no color" option sets the color button's color to a totally transparent color.
* \param showNoColorOption set to true to show the no color option. This is disabled by default. * \param showNoColorOption set to true to show the no color option. This is disabled by default.
* \see showNoColor * \see showNoColor
@ -179,7 +179,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
void setShowNoColor( const bool showNoColorOption ) { mShowNoColorOption = showNoColorOption; } void setShowNoColor( const bool showNoColorOption ) { mShowNoColorOption = showNoColorOption; }
/** Returns whether the "no color" option is shown in the button's drop down menu. If selected, /** Returns whether the "no color" option is shown in the button's drop-down menu. If selected,
* the "no color" option sets the color button's color to a totally transparent color. * the "no color" option sets the color button's color to a totally transparent color.
* \returns true if the no color option is shown. * \returns true if the no color option is shown.
* \see setShowNoColor * \see setShowNoColor
@ -189,7 +189,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
bool showNoColor() const { return mShowNoColorOption; } bool showNoColor() const { return mShowNoColorOption; }
/** Sets the string to use for the "no color" option in the button's drop down menu. /** Sets the string to use for the "no color" option in the button's drop-down menu.
* \param noColorString string to use for the "no color" menu option * \param noColorString string to use for the "no color" menu option
* \see noColorString * \see noColorString
* \see setShowNoColor * \see setShowNoColor
@ -198,7 +198,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
void setNoColorString( const QString &noColorString ) { mNoColorString = noColorString; } void setNoColorString( const QString &noColorString ) { mNoColorString = noColorString; }
/** Sets whether a set to null (clear) option is shown in the button's drop down menu. /** Sets whether a set to null (clear) option is shown in the button's drop-down menu.
* \param showNull set to true to show a null option * \param showNull set to true to show a null option
* \since QGIS 2.16 * \since QGIS 2.16
* \see showNull() * \see showNull()
@ -206,7 +206,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
void setShowNull( bool showNull ); void setShowNull( bool showNull );
/** Returns whether the set to null (clear) option is shown in the button's drop down menu. /** Returns whether the set to null (clear) option is shown in the button's drop-down menu.
* \since QGIS 2.16 * \since QGIS 2.16
* \see setShowNull() * \see setShowNull()
* \see isNull() * \see isNull()
@ -220,7 +220,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
bool isNull() const; bool isNull() const;
/** Returns the string used for the "no color" option in the button's drop down menu. /** Returns the string used for the "no color" option in the button's drop-down menu.
* \returns string used for the "no color" menu option * \returns string used for the "no color" menu option
* \see setNoColorString * \see setNoColorString
* \see showNoColor * \see showNoColor
@ -230,7 +230,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
QString noColorString() const { return mNoColorString; } QString noColorString() const { return mNoColorString; }
/** Sets the context string for the color button. The context string is passed to all color swatch /** Sets the context string for the color button. The context string is passed to all color swatch
* grids shown in the button's drop down menu, to allow them to customise their display colors * grids shown in the button's drop-down menu, to allow them to customise their display colors
* based on the context. * based on the context.
* \param context context string for the color button's color swatch grids * \param context context string for the color button's color swatch grids
* \see context * \see context
@ -238,7 +238,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
void setContext( const QString &context ) { mContext = context; } void setContext( const QString &context ) { mContext = context; }
/** Returns the context string for the color button. The context string is passed to all color swatch /** Returns the context string for the color button. The context string is passed to all color swatch
* grids shown in the button's drop down menu, to allow them to customise their display colors * grids shown in the button's drop-down menu, to allow them to customise their display colors
* based on the context. * based on the context.
* \returns context string for the color button's color swatch grids * \returns context string for the color button's color swatch grids
* \see setContext * \see setContext
@ -246,17 +246,17 @@ class GUI_EXPORT QgsColorButton : public QToolButton
QString context() const { return mContext; } QString context() const { return mContext; }
/** Sets the color scheme registry for the button, which controls the color swatch grids /** Sets the color scheme registry for the button, which controls the color swatch grids
* that are shown in the button's drop down menu. * that are shown in the button's drop-down menu.
* \param registry color scheme registry for the button. Set to 0 to hide all color * \param registry color scheme registry for the button. Set to 0 to hide all color
* swatch grids from the button's drop down menu. * swatch grids from the button's drop-down menu.
* \see colorSchemeRegistry * \see colorSchemeRegistry
*/ */
void setColorSchemeRegistry( QgsColorSchemeRegistry *registry ) { mColorSchemeRegistry = registry; } void setColorSchemeRegistry( QgsColorSchemeRegistry *registry ) { mColorSchemeRegistry = registry; }
/** Returns the color scheme registry for the button, which controls the color swatch grids /** Returns the color scheme registry for the button, which controls the color swatch grids
* that are shown in the button's drop down menu. * that are shown in the button's drop-down menu.
* \returns color scheme registry for the button. If returned value is 0 then all color * \returns color scheme registry for the button. If returned value is 0 then all color
* swatch grids are hidden from the button's drop down menu. * swatch grids are hidden from the button's drop-down menu.
* \see setColorSchemeRegistry * \see setColorSchemeRegistry
*/ */
QgsColorSchemeRegistry *colorSchemeRegistry() { return mColorSchemeRegistry; } QgsColorSchemeRegistry *colorSchemeRegistry() { return mColorSchemeRegistry; }
@ -417,7 +417,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
void stopPicking( QPointF eventPos, bool sampleColor = true ); void stopPicking( QPointF eventPos, bool sampleColor = true );
/** Create a color icon for display in the drop down menu /** Create a color icon for display in the drop-down menu
* \param color for icon * \param color for icon
* \param showChecks set to true to display a checkboard pattern behind * \param showChecks set to true to display a checkboard pattern behind
* transparent colors * transparent colors
@ -444,7 +444,7 @@ class GUI_EXPORT QgsColorButton : public QToolButton
*/ */
void addRecentColor( const QColor &color ); void addRecentColor( const QColor &color );
/** Creates the drop down menu entries /** Creates the drop-down menu entries
*/ */
void prepareMenu(); void prepareMenu();
}; };

View File

@ -53,7 +53,7 @@ QgsColorRampButton::QgsColorRampButton( QWidget *parent, const QString &dialogTi
setMinimumSize( QSize( 24, 16 ) ); setMinimumSize( QSize( 24, 16 ) );
connect( this, &QPushButton::clicked, this, &QgsColorRampButton::buttonClicked ); connect( this, &QPushButton::clicked, this, &QgsColorRampButton::buttonClicked );
//setup dropdown menu //setup drop-down menu
mMenu = new QMenu( this ); mMenu = new QMenu( this );
connect( mMenu, &QMenu::aboutToShow, this, &QgsColorRampButton::prepareMenu ); connect( mMenu, &QMenu::aboutToShow, this, &QgsColorRampButton::prepareMenu );
setMenu( mMenu ); setMenu( mMenu );
@ -524,7 +524,7 @@ void QgsColorRampButton::setButtonBackground( QgsColorRamp *colorramp )
{ {
if ( !mIconSize.isValid() ) if ( !mIconSize.isValid() )
{ {
//calculate size of push button part of widget (ie, without the menu dropdown button part) //calculate size of push button part of widget (ie, without the menu drop-down button part)
QStyleOptionToolButton opt; QStyleOptionToolButton opt;
initStyleOption( &opt ); initStyleOption( &opt );
QRect buttonSize = QApplication::style()->subControlRect( QStyle::CC_ToolButton, &opt, QStyle::SC_ToolButton, QRect buttonSize = QApplication::style()->subControlRect( QStyle::CC_ToolButton, &opt, QStyle::SC_ToolButton,

View File

@ -29,7 +29,7 @@ class QgsPanelWidget;
/** \ingroup gui /** \ingroup gui
* \class QgsColorRampButton * \class QgsColorRampButton
* A cross platform button subclass for selecting color ramps. Will open color ramp dialogs when clicked. * A cross platform button subclass for selecting color ramps. Will open color ramp dialogs when clicked.
* Offers live updates to button from color ramp dialog. An attached drop down menu allows for access to * Offers live updates to button from color ramp dialog. An attached drop-down menu allows for access to
* saved color ramps, as well as option to invert the current color ramp and create new ramps. * saved color ramps, as well as option to invert the current color ramp and create new ramps.
* \since QGIS 3.0 * \since QGIS 3.0
*/ */
@ -84,20 +84,20 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
*/ */
void setAcceptLiveUpdates( const bool accept ) { mAcceptLiveUpdates = accept; } void setAcceptLiveUpdates( const bool accept ) { mAcceptLiveUpdates = accept; }
/** Sets whether the drop down menu should be shown for the button. The default behavior is to /** Sets whether the drop-down menu should be shown for the button. The default behavior is to
* show the menu. * show the menu.
* \param showMenu set to false to hide the drop down menu * \param showMenu set to false to hide the drop-down menu
* \see showMenu * \see showMenu
*/ */
void setShowMenu( const bool showMenu ); void setShowMenu( const bool showMenu );
/** Returns whether the drop down menu is shown for the button. /** Returns whether the drop-down menu is shown for the button.
* \returns true if drop down menu is shown * \returns true if drop-down menu is shown
* \see setShowMenu * \see setShowMenu
*/ */
bool showMenu() const { return menu() ? true : false; } bool showMenu() const { return menu() ? true : false; }
/** Sets the default color ramp for the button, which is shown in the button's drop down menu for the /** Sets the default color ramp for the button, which is shown in the button's drop-down menu for the
* "default color ramp" option. * "default color ramp" option.
* \param colorramp default color ramp for the button. Set to a null pointer to disable the default color * \param colorramp default color ramp for the button. Set to a null pointer to disable the default color
* ramp option. The ramp will be cloned and ownership is not transferred. * ramp option. The ramp will be cloned and ownership is not transferred.
@ -105,7 +105,7 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
*/ */
void setDefaultColorRamp( QgsColorRamp *colorramp ); void setDefaultColorRamp( QgsColorRamp *colorramp );
/** Returns a copy of the default color ramp for the button, which is shown in the button's drop down menu for the /** Returns a copy of the default color ramp for the button, which is shown in the button's drop-down menu for the
* "default color ramp" option. * "default color ramp" option.
* \returns default color ramp for the button. Returns a null pointer if the default color ramp * \returns default color ramp for the button. Returns a null pointer if the default color ramp
* option is disabled. * option is disabled.
@ -113,13 +113,13 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
*/ */
QgsColorRamp *defaultColorRamp() const SIP_FACTORY { return mDefaultColorRamp ? mDefaultColorRamp->clone() : nullptr ; } QgsColorRamp *defaultColorRamp() const SIP_FACTORY { return mDefaultColorRamp ? mDefaultColorRamp->clone() : nullptr ; }
/** Sets whether a random colors option is shown in the button's drop down menu. /** Sets whether a random colors option is shown in the button's drop-down menu.
* \param showRandom set to true to show a random colors option * \param showRandom set to true to show a random colors option
* \see showRandom() * \see showRandom()
*/ */
void setShowRandomColorRamp( bool showRandom ) { mShowRandomColorRamp = showRandom; } void setShowRandomColorRamp( bool showRandom ) { mShowRandomColorRamp = showRandom; }
/** Returns whether random colors option is shown in the button's drop down menu. /** Returns whether random colors option is shown in the button's drop-down menu.
* \see setShowRandom() * \see setShowRandom()
*/ */
bool showRandomColorRamp() const { return mShowRandomColorRamp; } bool showRandomColorRamp() const { return mShowRandomColorRamp; }
@ -130,14 +130,14 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
*/ */
bool isRandomColorRamp() const; bool isRandomColorRamp() const;
/** Sets whether a set to null (clear) option is shown in the button's drop down menu. /** Sets whether a set to null (clear) option is shown in the button's drop-down menu.
* \param showNull set to true to show a null option * \param showNull set to true to show a null option
* \see showNull() * \see showNull()
* \see isNull() * \see isNull()
*/ */
void setShowNull( bool showNull ); void setShowNull( bool showNull );
/** Returns whether the set to null (clear) option is shown in the button's drop down menu. /** Returns whether the set to null (clear) option is shown in the button's drop-down menu.
* \see setShowNull() * \see setShowNull()
* \see isNull() * \see isNull()
*/ */
@ -150,7 +150,7 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
bool isNull() const; bool isNull() const;
/** Sets the context string for the color ramp button. The context string is passed to all color ramp /** Sets the context string for the color ramp button. The context string is passed to all color ramp
* preview icons shown in the button's drop down menu, to (eventually) allow them to customise their display colors * preview icons shown in the button's drop-down menu, to (eventually) allow them to customise their display colors
* based on the context. * based on the context.
* \param context context string for the color dialog button's color ramp preview icons * \param context context string for the color dialog button's color ramp preview icons
* \see context * \see context
@ -158,7 +158,7 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
void setContext( const QString &context ) { mContext = context; } void setContext( const QString &context ) { mContext = context; }
/** Returns the context string for the color ramp button. The context string is passed to all color ramp /** Returns the context string for the color ramp button. The context string is passed to all color ramp
* preview icons shown in the button's drop down menu, to (eventually) allow them to customise their display colors * preview icons shown in the button's drop-down menu, to (eventually) allow them to customise their display colors
* based on the context. * based on the context.
* \returns context context string for the color dialog button's color ramp preview icons * \returns context context string for the color dialog button's color ramp preview icons
* \see setContext * \see setContext
@ -270,7 +270,7 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
QSize mIconSize; QSize mIconSize;
/** Create a color ramp icon for display in the drop down menu /** Create a color ramp icon for display in the drop-down menu
* \param colorramp Color ramp to create an icon from * \param colorramp Color ramp to create an icon from
*/ */
QPixmap createMenuIcon( QgsColorRamp *colorramp ); QPixmap createMenuIcon( QgsColorRamp *colorramp );
@ -299,7 +299,7 @@ class GUI_EXPORT QgsColorRampButton : public QToolButton
*/ */
void loadColorRamp(); void loadColorRamp();
/** Creates the drop down menu entries /** Creates the drop-down menu entries
*/ */
void prepareMenu(); void prepareMenu();
}; };

View File

@ -639,7 +639,7 @@ class GUI_EXPORT QgsColorTextWidget : public QgsColorWidget
QLineEdit *mLineEdit = nullptr; QLineEdit *mLineEdit = nullptr;
/*Dropdown menu button*/ /*Drop-down menu button*/
QToolButton *mMenuButton = nullptr; QToolButton *mMenuButton = nullptr;
/*Display format for colors*/ /*Display format for colors*/
@ -655,7 +655,7 @@ class GUI_EXPORT QgsColorTextWidget : public QgsColorWidget
*/ */
void textChanged(); void textChanged();
/** Called when the dropdown arrow is clicked to show the format selection menu /** Called when the drop-down arrow is clicked to show the format selection menu
*/ */
void showMenu(); void showMenu();
}; };

View File

@ -37,7 +37,7 @@ class QgsCodeEditorSQL;
* This widget is designed for use in contexts where no layer fields are available for * This widget is designed for use in contexts where no layer fields are available for
* use in an expression. In contexts where the expression is directly associated with * use in an expression. In contexts where the expression is directly associated with
* a layer and fields can be used, then QgsFieldExpressionWidget is a more appropriate * a layer and fields can be used, then QgsFieldExpressionWidget is a more appropriate
* choice as it gives users direct access to select fields from a drop down list. * choice as it gives users direct access to select fields from a drop-down list.
* *
* QgsExpressionLineEdit also supports a multiline editor mode which is useful where * QgsExpressionLineEdit also supports a multiline editor mode which is useful where
* more space is available for the widget, but where QgsExpressionBuilderWidget * more space is available for the widget, but where QgsExpressionBuilderWidget

View File

@ -379,7 +379,7 @@ bool QgsDelimitedTextSourceSelect::loadDelimitedFileDefinition()
void QgsDelimitedTextSourceSelect::updateFieldLists() void QgsDelimitedTextSourceSelect::updateFieldLists()
{ {
// Update the x and y field dropdown boxes // Update the x and y field drop-down boxes
QgsDebugMsg( "Updating field lists" ); QgsDebugMsg( "Updating field lists" );
disconnect( cmbXField, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsDelimitedTextSourceSelect::enableAccept ); disconnect( cmbXField, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsDelimitedTextSourceSelect::enableAccept );