1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/richtext/richtextsymboldlg.h
4 // Author: Julian Smart
6 // Created: 10/5/2006 3:11:58 PM
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _RICHTEXTSYMBOLDLG_H_
13 #define _RICHTEXTSYMBOLDLG_H_
19 #include "wx/dialog.h"
20 #include "wx/vscroll.h"
23 * Forward declarations
26 ////@begin forward declarations
27 class wxSymbolListCtrl
;
28 ////@end forward declarations
30 // __UNICODE__ is a symbol used by DialogBlocks-generated code.
41 #define SYMBOL_WXSYMBOLPICKERDIALOG_STYLE (wxDEFAULT_DIALOG_STYLE|wxRESIZE_BORDER|wxCLOSE_BOX)
42 #define SYMBOL_WXSYMBOLPICKERDIALOG_TITLE _("Symbols")
43 #define SYMBOL_WXSYMBOLPICKERDIALOG_IDNAME ID_SYMBOLPICKERDIALOG
44 #define SYMBOL_WXSYMBOLPICKERDIALOG_SIZE wxSize(400, 300)
45 #define SYMBOL_WXSYMBOLPICKERDIALOG_POSITION wxDefaultPosition
48 * wxSymbolPickerDialog class declaration
51 class WXDLLIMPEXP_RICHTEXT wxSymbolPickerDialog
: public wxDialog
53 DECLARE_DYNAMIC_CLASS( wxSymbolPickerDialog
)
58 wxSymbolPickerDialog( );
59 wxSymbolPickerDialog( const wxString
& symbol
, const wxString
& fontName
, const wxString
& normalTextFont
,
60 wxWindow
* parent
, wxWindowID id
= SYMBOL_WXSYMBOLPICKERDIALOG_IDNAME
, const wxString
& caption
= SYMBOL_WXSYMBOLPICKERDIALOG_TITLE
, const wxPoint
& pos
= SYMBOL_WXSYMBOLPICKERDIALOG_POSITION
, const wxSize
& size
= SYMBOL_WXSYMBOLPICKERDIALOG_SIZE
, long style
= SYMBOL_WXSYMBOLPICKERDIALOG_STYLE
);
63 bool Create( const wxString
& symbol
, const wxString
& fontName
, const wxString
& normalTextFont
,
64 wxWindow
* parent
, wxWindowID id
= SYMBOL_WXSYMBOLPICKERDIALOG_IDNAME
, const wxString
& caption
= SYMBOL_WXSYMBOLPICKERDIALOG_TITLE
, const wxPoint
& pos
= SYMBOL_WXSYMBOLPICKERDIALOG_POSITION
, const wxSize
& size
= SYMBOL_WXSYMBOLPICKERDIALOG_SIZE
, long style
= SYMBOL_WXSYMBOLPICKERDIALOG_STYLE
);
66 /// Initialises members variables
69 /// Creates the controls and sizers
70 void CreateControls();
72 /// Update the display
73 void UpdateSymbolDisplay(bool updateSymbolList
= true, bool showAtSubset
= true);
75 /// Respond to symbol selection
76 void OnSymbolSelected( wxCommandEvent
& event
);
79 void SetUnicodeMode(bool unicodeMode
);
81 /// Show at the current subset selection
84 /// Get the selected symbol character
85 int GetSymbolChar() const;
87 /// Is there a selection?
88 bool HasSelection() const { return !m_symbol
.IsEmpty(); }
90 /// Specifying normal text?
91 bool UseNormalFont() const { return m_fontName
.IsEmpty(); }
93 /// Should we show tooltips?
94 static bool ShowToolTips() { return sm_showToolTips
; }
96 /// Determines whether tooltips will be shown
97 static void SetShowToolTips(bool show
) { sm_showToolTips
= show
; }
100 virtual bool TransferDataToWindow();
102 ////@begin wxSymbolPickerDialog event handler declarations
104 /// wxEVT_COMMAND_COMBOBOX_SELECTED event handler for ID_SYMBOLPICKERDIALOG_FONT
105 void OnFontCtrlSelected( wxCommandEvent
& event
);
107 #if defined(__UNICODE__)
108 /// wxEVT_COMMAND_COMBOBOX_SELECTED event handler for ID_SYMBOLPICKERDIALOG_SUBSET
109 void OnSubsetSelected( wxCommandEvent
& event
);
112 #if defined(__UNICODE__)
113 /// wxEVT_COMMAND_COMBOBOX_SELECTED event handler for ID_SYMBOLPICKERDIALOG_FROM
114 void OnFromUnicodeSelected( wxCommandEvent
& event
);
117 #if defined(__WXMSW__) || defined(__WXGTK__) || defined(__WXOS2__) || defined(__WXMGL__) || defined(__WXMOTIF__) || defined(__WXCOCOA__) || defined(__WXX11__) || defined(__WXPALMOS__)
118 /// wxEVT_UPDATE_UI event handler for wxID_OK
119 void OnOkUpdate( wxUpdateUIEvent
& event
);
122 #if defined(__WXMAC__)
123 /// wxEVT_UPDATE_UI event handler for wxID_OK
124 void OnOkUpdate( wxUpdateUIEvent
& event
);
127 ////@end wxSymbolPickerDialog event handler declarations
129 ////@begin wxSymbolPickerDialog member function declarations
131 wxString
GetFontName() const { return m_fontName
; }
132 void SetFontName(wxString value
) { m_fontName
= value
; }
134 wxString
GetSymbol() const { return m_symbol
; }
135 void SetSymbol(wxString value
) { m_symbol
= value
; }
137 bool GetFromUnicode() const { return m_fromUnicode
; }
138 void SetFromUnicode(bool value
) { m_fromUnicode
= value
; }
140 wxString
GetNormalTextFontName() const { return m_normalTextFontName
; }
141 void SetNormalTextFontName(wxString value
) { m_normalTextFontName
= value
; }
143 /// Retrieves bitmap resources
144 wxBitmap
GetBitmapResource( const wxString
& name
);
146 /// Retrieves icon resources
147 wxIcon
GetIconResource( const wxString
& name
);
148 ////@end wxSymbolPickerDialog member function declarations
150 ////@begin wxSymbolPickerDialog member variables
151 wxComboBox
* m_fontCtrl
;
152 #if defined(__UNICODE__)
153 wxComboBox
* m_subsetCtrl
;
155 wxSymbolListCtrl
* m_symbolsCtrl
;
156 wxStaticText
* m_symbolStaticCtrl
;
157 wxTextCtrl
* m_characterCodeCtrl
;
158 #if defined(__UNICODE__)
159 wxComboBox
* m_fromUnicodeCtrl
;
164 wxString m_normalTextFontName
;
165 /// Control identifiers
167 ID_SYMBOLPICKERDIALOG
= 10600,
168 ID_SYMBOLPICKERDIALOG_FONT
= 10602,
169 ID_SYMBOLPICKERDIALOG_SUBSET
= 10605,
170 ID_SYMBOLPICKERDIALOG_LISTCTRL
= 10608,
171 ID_SYMBOLPICKERDIALOG_CHARACTERCODE
= 10601,
172 ID_SYMBOLPICKERDIALOG_FROM
= 10603
174 ////@end wxSymbolPickerDialog member variables
177 static bool sm_showToolTips
;
181 * The scrolling symbol list.
184 class WXDLLIMPEXP_RICHTEXT wxSymbolListCtrl
: public wxVScrolledWindow
187 // constructors and such
188 // ---------------------
190 // default constructor, you must call Create() later
191 wxSymbolListCtrl() { Init(); }
193 // normal constructor which calls Create() internally
194 wxSymbolListCtrl(wxWindow
*parent
,
195 wxWindowID id
= wxID_ANY
,
196 const wxPoint
& pos
= wxDefaultPosition
,
197 const wxSize
& size
= wxDefaultSize
,
199 const wxString
& name
= wxPanelNameStr
)
203 (void)Create(parent
, id
, pos
, size
, style
, name
);
206 // really creates the control and sets the initial number of items in it
207 // (which may be changed later with SetItemCount())
209 // returns true on success or false if the control couldn't be created
210 bool Create(wxWindow
*parent
,
211 wxWindowID id
= wxID_ANY
,
212 const wxPoint
& pos
= wxDefaultPosition
,
213 const wxSize
& size
= wxDefaultSize
,
215 const wxString
& name
= wxPanelNameStr
);
217 // dtor does some internal cleanup
218 virtual ~wxSymbolListCtrl();
224 // set the current font
225 virtual bool SetFont(const wxFont
& font
);
227 // set Unicode/ASCII mode
228 void SetUnicodeMode(bool unicodeMode
);
230 // get the index of the currently selected item or wxNOT_FOUND if there is no selection
231 int GetSelection() const;
233 // is this item selected?
234 bool IsSelected(int item
) const;
236 // is this item the current one?
237 bool IsCurrentItem(int item
) const { return item
== m_current
; }
239 // get the margins around each cell
240 wxPoint
GetMargins() const { return m_ptMargins
; }
242 // get the background colour of selected cells
243 const wxColour
& GetSelectionBackground() const { return m_colBgSel
; }
248 // set the selection to the specified item, if it is wxNOT_FOUND the
249 // selection is unset
250 void SetSelection(int selection
);
252 // make this item visible
253 void EnsureVisible(int item
);
255 // set the margins: horizontal margin is the distance between the window
256 // border and the item contents while vertical margin is half of the
257 // distance between items
259 // by default both margins are 0
260 void SetMargins(const wxPoint
& pt
);
261 void SetMargins(wxCoord x
, wxCoord y
) { SetMargins(wxPoint(x
, y
)); }
264 void SetCellSize(const wxSize
& sz
) { m_cellSize
= sz
; }
265 const wxSize
& GetCellSize() const { return m_cellSize
; }
267 // change the background colour of the selected cells
268 void SetSelectionBackground(const wxColour
& col
);
270 virtual wxVisualAttributes
GetDefaultAttributes() const
272 return GetClassDefaultAttributes(GetWindowVariant());
275 static wxVisualAttributes
276 GetClassDefaultAttributes(wxWindowVariant variant
= wxWINDOW_VARIANT_NORMAL
);
278 // Get min/max symbol values
279 int GetMinSymbolValue() const { return m_minSymbolValue
; }
280 int GetMaxSymbolValue() const { return m_maxSymbolValue
; }
282 // Respond to size change
283 void OnSize(wxSizeEvent
& event
);
287 // draws a line of symbols
288 virtual void OnDrawItem(wxDC
& dc
, const wxRect
& rect
, size_t n
) const;
290 // gets the line height
291 virtual wxCoord
OnGetLineHeight(size_t line
) const;
294 void OnPaint(wxPaintEvent
& event
);
295 void OnKeyDown(wxKeyEvent
& event
);
296 void OnLeftDown(wxMouseEvent
& event
);
297 void OnLeftDClick(wxMouseEvent
& event
);
299 // common part of all ctors
302 // send the wxEVT_COMMAND_LISTBOX_SELECTED event
303 void SendSelectedEvent();
305 // change the current item (in single selection listbox it also implicitly
306 // changes the selection); current may be wxNOT_FOUND in which case there
307 // will be no current item any more
309 // return true if the current item changed, false otherwise
310 bool DoSetCurrent(int current
);
312 // flags for DoHandleItemClick
315 ItemClick_Shift
= 1, // item shift-clicked
316 ItemClick_Ctrl
= 2, // ctrl
317 ItemClick_Kbd
= 4 // item selected from keyboard
320 // common part of keyboard and mouse handling processing code
321 void DoHandleItemClick(int item
, int flags
);
323 // calculate line number from symbol value
324 int SymbolValueToLineNumber(int item
);
326 // initialise control from current min/max values
327 void SetupCtrl(bool scrollToSelection
= true);
330 int HitTest(const wxPoint
& pt
);
333 // the current item or wxNOT_FOUND
339 // the selection bg colour
343 wxBitmap
* m_doubleBuffer
;
348 // minimum and maximum symbol value
349 int m_minSymbolValue
;
351 // minimum and maximum symbol value
352 int m_maxSymbolValue
;
354 // number of items per line
355 int m_symbolsPerLine
;
357 // Unicode/ASCII mode
360 DECLARE_EVENT_TABLE()
361 DECLARE_NO_COPY_CLASS(wxSymbolListCtrl
)
362 DECLARE_ABSTRACT_CLASS(wxSymbolListCtrl
)
366 // _RICHTEXTSYMBOLDLG_H_