X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FQDS%2FQDS_CheckBox.cxx;h=ae9968385766387be408dd0d0eb14b1c4410dfc4;hb=2bf709c5e3d0dc69f4fac09b55682b5171cc457e;hp=9713ca5e487fb495a27c0f5a4ca19928d1c2f497;hpb=f830c97c748d8f8a6a7eccc8e3a58e19066a1181;p=modules%2Fgui.git diff --git a/src/QDS/QDS_CheckBox.cxx b/src/QDS/QDS_CheckBox.cxx index 9713ca5e4..ae9968385 100644 --- a/src/QDS/QDS_CheckBox.cxx +++ b/src/QDS/QDS_CheckBox.cxx @@ -1,11 +1,14 @@ -// Copyright (C) 2005 CEA/DEN, EDF R&D, OPEN CASCADE, PRINCIPIA R&D +// Copyright (C) 2007-2015 CEA/DEN, EDF R&D, OPEN CASCADE +// +// Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN, +// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Lesser General Public // License as published by the Free Software Foundation; either -// version 2.1 of the License. +// version 2.1 of the License, or (at your option) any later version. // -// This library is distributed in the hope that it will be useful +// This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. @@ -16,31 +19,48 @@ // // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com // + #include "QDS_CheckBox.h" -#include +#include /* \class QDS_CheckBox - - Datum with control corresponding to check box. This control can have only two states: - 1 (on/true) or 0 (off/false). QDS_CheckBox don't take into account standard parameter - properties (minimum, maximum, filter, etc). + \brief Datum with control corresponding to check box. + + This control can have only two states: + - 1 (on/true) + - 0 (off/false). + + QDS_CheckBox don't take into account standard parameter properties + (minimum, maximum, filter, etc). QDS_CheckBox can set and get following values for access methods (setStringValue(), setIntegerValue(), setDoubleValue(), stringValue(), integerValue(), doubleValue()): - \li "1" - check box state is setted as on. - \li "0" - check box state is setted as off. - \li "-1" - check box state is setted as "NoChage" (undefined). + - "1" - check box state is switched on. + - "0" - check box state is switched off. + - "-1" - check box state is "PartiallyChecked" (undefined). - User can set and check a state "NoChange" using methods clear() and isEmpty() accordingly. + User can set and test "PartiallyChecked" check using methods clear() + and isEmpty() correspondingly. */ /*! - Constructor. Create check box datum object with datum identifier \aid under widget \aparent. - Parameter \aflags define behaviour of datum and set of created subwidgets. Default value of - this parameter is QDS::All. Parameter \acomp specify the component name which will be used - during search of dictionary item. + \brief Constructor. + + Create check box datum object with datum identifier \a id + and parent widget \a parent. + + Parameter \a flags defines behaviour of datum and set of created + subwidgets. Default value of this parameter is QDS::All. + + Parameter \a comp specifies the component name which will be used + when searching the dictionary item. + + \param id datum identifier + \param parent parent widget + \param flags datum flags + \param comp component */ QDS_CheckBox::QDS_CheckBox( const QString& id, QWidget* parent, const int flags, const QString& comp ) : QDS_Datum( id, parent, flags, comp ) @@ -48,14 +68,14 @@ QDS_CheckBox::QDS_CheckBox( const QString& id, QWidget* parent, const int flags, } /*! - Destructor. + \brief Destructor. */ QDS_CheckBox::~QDS_CheckBox() { } /*! - Sets the state "NoChange" for checkbox. + \brief Set the state "PartiallyChecked" (undefined) for checkbox. */ void QDS_CheckBox::clear() { @@ -63,20 +83,26 @@ void QDS_CheckBox::clear() } /*! - Returns string from QCheckBox widget. If the check box state is on then 1 returned otherwise 0. + \brief Get string value from the widget. + \return "1" if check box is checked on and "0" otherwise */ QString QDS_CheckBox::getString() const { QString val; - if ( checkBox() && checkBox()->state() != QButton::NoChange ) + if ( checkBox() && checkBox()->checkState() != Qt::PartiallyChecked ) val = checkBox()->isChecked() ? "1" : "0"; return val; } /*! - Sets the string into QCheckBox widget. If argument \atxt is string with number "1" then check box - state is setted as on. If argument \atxt is string with number "0" then state is setted as off. - If argument \atxt is string with number "-1" then state is setted as "NoChage" (undefined). + \brief Set the string value into the widget. + + If string \a txt contains "1", then check box state is switched on. + If string \a txt contains "0", then check box state is switched on. + If string \a txt contains "-1", then check box is reset to + "PartiallyChecked" (undefined) state. + + \param txt string value */ void QDS_CheckBox::setString( const QString& txt ) { @@ -88,22 +114,25 @@ void QDS_CheckBox::setString( const QString& txt ) if ( isOk && val < 0 ) { checkBox()->setTristate(); - checkBox()->setNoChange(); + checkBox()->setCheckState(Qt::PartiallyChecked); } else checkBox()->setChecked( isOk && val != 0 ); } /*! - Returns pointer to QCheckBox widget. + \brief Get internal check box. + \return pointer to QCheckBox widget */ QCheckBox* QDS_CheckBox::checkBox() const { - return ::qt_cast( controlWidget() ); + return ::qobject_cast( controlWidget() ); } /*! - Create QCheckBox widget as control subwidget. + \brief Create internal check box as control widget. + \param parent parent widget + \return created check box widget */ QWidget* QDS_CheckBox::createControl( QWidget* parent ) { @@ -115,7 +144,9 @@ QWidget* QDS_CheckBox::createControl( QWidget* parent ) } /*! - Notify about ñhanging of control state + \brief Called when check box is switched. + + Emits signal paramChanged() to notify about changing of the control state. */ void QDS_CheckBox::onParamChanged() { @@ -123,17 +154,21 @@ void QDS_CheckBox::onParamChanged() } /*! - Notify about ñhanging of control state. Switch off check box property "tristate" when - state changed by user. + \brief Called when check box is switched. + + Switch off check box property "tristate" when state is changed by the user. + + \param state new check box state */ void QDS_CheckBox::onStateChanged( int state ) { - if ( state != QButton::NoChange && checkBox() ) + if ( state != Qt::PartiallyChecked && checkBox() ) checkBox()->setTristate( false ); } /*! - Sets the check box state \atheState. + \brief Set the check box state to \a theState. + \param theState new check box state */ void QDS_CheckBox::setChecked( const bool theState ) { @@ -142,9 +177,16 @@ void QDS_CheckBox::setChecked( const bool theState ) } /*! - Returns current check box state. + \brief Get current check box state. + \return check box state */ bool QDS_CheckBox::isChecked() const { return checkBox() ? checkBox()->isChecked() : false; } + +/*! + \fn void QDS_CheckBox::toggled( bool on ); + \brief Emitted when the check box state is toggled. + \param on new check box state +*/