/usr/include/Wt/WCheckBox is in libwt-dev 3.3.4+dfsg-6ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 | // This may look like C code, but it's really -*- C++ -*-
/*
* Copyright (C) 2008 Emweb bvba, Kessel-Lo, Belgium.
*
* See the LICENSE file for terms of use.
*/
#ifndef WCHECKBOX_H_
#define WCHECKBOX_H_
#include <Wt/WAbstractToggleButton>
namespace Wt {
/*! \class WCheckBox Wt/WCheckBox Wt/WCheckBox
* \brief A user control that represents a check box.
*
* By default, a checkbox can have two states: Wt::Checked or
* Wt::Unchecked, which can be inspected using isChecked(), and set
* using setChecked().
*
* A checkbox may also provide a third state, Wt::PartiallyChecked,
* which is useful to indicate that it is neither checked nor
* unchecked. %Wt will use native browser support for this HTML5
* extension when available (Safari and MS IE), and use an image-based
* workaround otherwise. You may enable support for the third state
* using setTristate(), and use setCheckState() and checkState() to
* read all three states.
* Once a tri-state checkbox is clicked, it cycles through the states
* Wt::Checked and Wt::Unchecked.
*
* A label is added as a sibling of the checkbox to the same parent.
*
* Usage example:
* \if cpp
* \code
* Wt::WGroupBox *box = new Wt::WGroupBox("In-flight options");
*
* Wt::WCheckBox *w1 = new Wt::WCheckBox("Vegetarian diet", box);
* box->addWidget(new WBreak());
* Wt::WCheckBox *w2 = new Wt::WCheckBox("WIFI access", box);
* box->addWidget(new WBreak());
* Wt::WCheckBox *w3 = new Wt::WCheckBox("AC plug", box);
*
* w1->setChecked(false);
* w2->setChecked(true);
* w3->setChecked(true);
* \endcode
* \elseif java
* \code
* WGroupBox box = new WGroupBox("In-flight options");
*
* WCheckBox w1 = new WCheckBox("Vegetarian diet", box);
* box.addWidget(new WBreak());
* WCheckBox w2 = new WCheckBox("WIFI access", box);
* box.addWidget(new WBreak());
* WCheckBox w3 = new WCheckBox("AC plug", box);
*
* w1.setChecked(false);
* w2.setChecked(true);
* w3.setChecked(true);
* \endcode
* \endif
*
* %WCheckBox is an \link WWidget::setInline(bool) inline \endlink widget.
*
* <h3>CSS</h3>
*
* This widget is rendered using an HTML <tt><input
* type="checkbox"></tt> tag. When a label is specified, the input
* element is nested in a <tt><label></tt>.
*
* This widget does not provide styling, and can be styled using
* inline or external CSS as appropriate.
*
* \sa WAbstractToggleButton
*/
class WT_API WCheckBox : public WAbstractToggleButton
{
public:
/*! \brief Creates a checkbox without label.
*
* A checkbox created by this constructor will not contain a placeholder
* for a label, and therefore it is not possible to assign a label to it
* later through setText().
*/
WCheckBox(WContainerWidget *parent = 0);
/*! \brief Creates a checkbox with given label.
*/
WCheckBox(const WString& text, WContainerWidget *parent = 0);
/*! \brief Makes a tristate checkbox.
*
* \note You should enable tristate functionality right after construction
* and this cannot be modified later.
*/
void setTristate(bool tristate = true);
/*! \brief Returns whether the checkbox is tristate.
*
* \sa setTristate()
*/
bool isTristate() const { return triState_; }
/*! \brief Sets the check state.
*
* Unless it is a tri-state checkbox, only Wt::Checked and Wt::Unchecked are
* valid states.
*/
void setCheckState(CheckState state);
/*! \brief Returns the check state.
*
* \sa setCheckState(), isChecked()
*/
CheckState checkState() const { return state_; }
protected:
virtual void updateInput(DomElement& input, bool all);
private:
bool triState_;
};
}
#endif // WCHECKBOX_H_
|