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
|
/*
* Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; version 2 of the
* License.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA
*/
#pragma once
#include "mforms/container.h"
/**
* Special window class to be used as a popup with child controls and a special border. It is
* used as a "fly-out" or support window similar to tooltips showing e.g. larger amounts of text
* and can act otherwise like a normal (but floating) window.
* Other than the mforms popup class (which is meant for menus and the like) the popover cannot
* be transparent and is non-modal.
* Outer form, drop shadow etc. is provided by the platform implementations.
*/
namespace mforms {
class Popover;
// Determines the initial position of the popover with respect to the reference point.
enum StartPosition {
StartLeft, // The popover is initially left to the ref point, having its arrow pointing to the right.
StartRight, // Similar for the other positions.
StartAbove,
StartBelow
};
enum PopoverStyle {
PopoverStyleNormal, // With large rounded corners, tip (arrow) etc.
PopoverStyleTooltip // Simplified version with now tip, smaller corners etc.
};
#ifndef DOXYGEN_SHOULD_SKIP_THIS
#ifndef SWIG
struct MFORMS_EXPORT PopoverImplPtrs
{
bool (*create)(Popover* self, PopoverStyle style);
void (*destroy)(Popover* self);
void (*set_content)(Popover *self, View *content);
void (*set_size)(Popover *self, int, int);
void (*show)(Popover *self, int, int, StartPosition); // Position of the popover's tip in screen coordinates.
void (*show_and_track)(Popover *self, View*, int, int, StartPosition); // Position of the popover's tip in screen coordinates.
void (*close)(Popover* self);
};
#endif
#endif
class MFORMS_EXPORT Popover : public Object
{
PopoverImplPtrs *_popover_impl;
public:
Popover(PopoverStyle style = PopoverStyleNormal);
virtual ~Popover();
void set_content(View* content);
// Size of the main body. The arrow is added implicitly and is not part of the size
// (nor is the shadow or other decoration, if any). Size must be set before showing the
// popover as it determines the overall shape.
void set_size(int width, int height);
// Displays the popover so that its arrow tip is at the given screen position. The popover itself
// will be arranged to not overlap screen borders.
// Parameter position indicates how the popover is to position initially, with respect to the
// reference point. The actual screen position also depends on the size of the popover and the given location.
// The position parameter applies only to the normal popover style. The tooltip style has no
// arrow and is positioned with the left upper corner at the given position.
void show(int x, int y, StartPosition position);
void close();
// Same as show, but the popover will call the _bound_close callback when the mouse leaves the area
// of the tracked view (which usually is to close the popover).
void show_and_track(View *tracked_view, int x, int y, StartPosition position);
boost::signals2::signal<void ()> *signal_close() { return &_bound_close; }
private:
boost::signals2::signal<void ()> _bound_close;
};
};
|
