33ba8b3e4def735ffb7ac8e223046c0256f541c8
[WebKit-https.git] / WebCore / kwq / KWQListBox.h
1 /*
2  * Copyright (C) 2003 Apple Computer, Inc.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
24  */
25
26 #ifndef KWQLISTBOX_H_
27 #define KWQLISTBOX_H_
28
29 #include "KWQScrollView.h"
30 #include "KWQString.h"
31 #include "KWQSignal.h"
32
33 class QListBoxItem;
34
35 #ifdef __OBJC__
36 @class NSMutableArray;
37 @class NSObject;
38 #else
39 class NSMutableArray;
40 class NSObject;
41 #endif
42
43 class QListBox : public QScrollView {
44 friend class QListBoxItem;
45 public:
46     enum SelectionMode { Single, Extended };
47
48     QListBox(QWidget *parent);
49     ~QListBox();
50
51     QSize sizeForNumberOfLines(int numLines) const;
52     
53     uint count() const;
54     void clear();
55     void setSelectionMode(SelectionMode);
56
57     void beginBatchInsert();
58     void insertItem(const QString &s, int i) { insertItem(s, i, false); }
59     void insertGroupLabel(const QString &s, int i) { insertItem(s, i, true); }
60     void endBatchInsert();
61
62     void setSelected(int, bool);
63     bool isSelected(int) const;
64
65     void setEnabled(bool enabled);
66     bool isEnabled();
67     
68     bool itemIsGroupLabel(int index) const;
69     
70     void setWritingDirection(QPainter::TextDirection);
71     
72     bool changingSelection() { return _changingSelection; }
73     void clicked() { _clicked.call(); }
74     void selectionChanged() { _selectionChanged.call(); }
75
76     virtual FocusPolicy focusPolicy() const;
77     virtual bool checksDescendantsForFocus() const;
78     
79 private:
80     void insertItem(const QString &, int index, bool isLabel);
81
82     NSMutableArray *_items;
83     bool _insertingItems;
84     bool _changingSelection;
85     bool _enabled;
86     mutable float _width;
87     mutable bool _widthGood;
88     
89     KWQSignal _clicked;
90     KWQSignal _selectionChanged;
91 };
92
93 #endif