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
|
// 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 OPTIONLIST_H_
#define OPTIONLIST_H_
#include <Wt/WContainerWidget>
using namespace Wt;
class Option;
/**
* @addtogroup composerexample
*/
/*@{*/
/*! \brief A list of options, separated by '|'
*
* This widget is part of the %Wt composer example.
*
* An OptionList displays a list of Option widgets, which are
* separated by a '|' separator.
*
* For example, Foo | Bar | Huu
*
* When Options are hidden, the separators are adjusted so that
* there is no separator after the last visible option. However,
* this requires a call of update() each time an option is hidden
* or shown. This is because the removing of separators is optimized
* in stateless implementations, and thus in client-side JavaScript
* code. Since the behaviour is not entirely stateless, the update()
* method resets stateless implementations if necessary.
*
* \sa OptionList
*/
class OptionList : public WContainerWidget
{
public:
/*! \brief Create an OptionList.
*/
OptionList(WContainerWidget *parent = 0);
/*! \brief Add an Option to the list.
*/
void add(Option *option);
/*! \brief Updates the stateless implementations after an Option has been
* hidden or shown.
*/
void update();
private:
//! The list of options.
std::vector<Option *> options_;
//! The option that needs its stateless code updated.
Option *optionNeedReset_;
//! An option changed visibility: possibly update the separators inbetween
void optionVisibilityChanged(Option *opt, bool hidden);
friend class Option;
};
/*@}*/
#endif // OPTIONLIST_H_
|
