include/svtools/ctrlbox.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #pragma once
  21
  22 #include <svtools/svtdllapi.h>
  23 #include <svtools/toolbarmenu.hxx>
  24 #include <editeng/borderline.hxx>
  25 #include <vcl/idle.hxx>
  26 #include <vcl/metric.hxx>
  27 #include <vcl/weld.hxx>
  28
  29 #include <memory>
  30
  31 namespace weld { class CustomWeld; }
  32
  33 class BitmapEx;
  34 class BorderWidthImpl;
  35 class FontList;
  36 class VclSimpleEvent;
  37 class VirtualDevice;
  38
  39 /** Utility class storing the border line width, style and colors. The widths
  40     are defined in Twips.
  41   */
  42 class ImpLineListData
  43 {
  44 private:
  45     BorderWidthImpl const m_aWidthImpl;
  46
  47     Color  ( * m_pColor1Fn )( Color );
  48     Color  ( * m_pColor2Fn )( Color );
  49     Color  ( * m_pColorDistFn )( Color, Color );
  50
  51     tools::Long    m_nMinWidth;
  52     SvxBorderLineStyle m_nStyle;
  53
  54 public:
  55     ImpLineListData( BorderWidthImpl aWidthImpl,
  56            SvxBorderLineStyle nStyle, tools::Long nMinWidth, Color ( *pColor1Fn )( Color ),
  57            Color ( *pColor2Fn )( Color ), Color ( *pColorDistFn )( Color, Color ) ) :
  58         m_aWidthImpl( aWidthImpl ),
  59         m_pColor1Fn( pColor1Fn ),
  60         m_pColor2Fn( pColor2Fn ),
  61         m_pColorDistFn( pColorDistFn ),
  62         m_nMinWidth( nMinWidth ),
  63         m_nStyle( nStyle )
  64     {
  65     }
  66
  67     /** Returns the computed width of the line 1 in twips. */
  68     tools::Long GetLine1ForWidth( tools::Long nWidth ) const { return m_aWidthImpl.GetLine1( nWidth ); }
  69
  70     /** Returns the computed width of the line 2 in twips. */
  71     tools::Long GetLine2ForWidth( tools::Long nWidth ) const { return m_aWidthImpl.GetLine2( nWidth ); }
  72
  73     /** Returns the computed width of the gap in twips. */
  74     tools::Long GetDistForWidth( tools::Long nWidth ) const { return m_aWidthImpl.GetGap( nWidth ); }
  75
  76     Color GetColorLine1( const Color& rMain ) const
  77     {
  78         return ( *m_pColor1Fn )( rMain );
  79     }
  80
  81     Color GetColorLine2( const Color& rMain ) const
  82     {
  83         return ( *m_pColor2Fn )( rMain );
  84     }
  85
  86     Color GetColorDist( const Color& rMain, const Color& rDefault ) const
  87     {
  88         return ( *m_pColorDistFn )( rMain, rDefault );
  89     }
  90
  91     /** Returns the minimum width in twips */
  92     tools::Long   GetMinWidth( ) const { return m_nMinWidth;}
  93     SvxBorderLineStyle GetStyle( ) const { return m_nStyle;}
  94 };
  95
  96 enum class SvxBorderLineStyle : sal_Int16;
  97
  98 typedef ::std::vector< FontMetric         > ImplFontList;
  99
 100 /*************************************************************************
 101
 102 class LineListBox
 103
 104 Description
 105
 106 Allows selection of line styles and sizes. Note that before first insert,
 107 units and window size need to be set. Supported units are typographic point
 108 (pt) and millimeters (mm). For SourceUnit, pt, mm and twips are supported.
 109 All scalar numbers in 1/100 of the corresponding unit.
 110
 111 Line1 is the outer, Line2 the inner line, Distance is the distance between
 112 these two lines. If Line2 == 0, only Line1 will be shown. Defaults for
 113 source and target unit are FieldUnit::POINT.
 114
 115 SetColor() sets the line color.
 116
 117 Remarks
 118
 119 Contrary to a simple ListBox, user-specific data are not supported.
 120 If UpdateMode is disabled, no data should be read, no selections
 121 should be set, and the return code shall be ignore, as in these are
 122 not defined in this mode. Also the bit WinBit WB_SORT may not be set.
 123
 124 --------------------------------------------------------------------------
 125
 126 class FontNameBox
 127
 128 Description
 129
 130 Allows selection of fonts. The ListBox will be filled using Fill parameter,
 131 which is pointer to an FontList object.
 132
 133 Calling EnableWYSIWYG() enables rendering the font name in the currently
 134 selected font.
 135
 136 See also
 137
 138 FontList; FontStyleBox; FontSizeBox; FontNameMenu
 139
 140 --------------------------------------------------------------------------
 141
 142 class FontStyleBox
 143
 144 Description
 145
 146 Allows select of FontStyle's. The parameter Fill points to a list
 147 of available font styles for the font.
 148
 149 Reproduced styles are always added - this could change in future, as
 150 potentially not all applications [Draw,Equation,FontWork] can properly
 151 handle synthetic fonts. On filling, the previous name will be retained
 152 if possible.
 153
 154 For DontKnow, the FontStyleBox should be filled with OUString(),
 155 so it will contain a list with the default attributes. The currently
 156 shown style probably needs to be reset by the application.
 157
 158 See also
 159
 160 FontList; FontNameBox; FontSizeBox;
 161
 162 --------------------------------------------------------------------------
 163
 164 class FontSizeBox
 165
 166 Description
 167
 168 Allows selection of font sizes. The values are retrieved via GetValue()
 169 and set via SetValue(). The Fill parameter fills the ListBox with the
 170 available sizes for the passed font.
 171
 172 All sizes are in 1/10 typographic point (pt).
 173
 174 The passed FontList must be retained until the next fill call.
 175
 176 Additionally it supports a relative mod, which allows entering
 177 percentage values. This, eg., can be useful for template dialogs.
 178 This mode can only be enabled, but not disabled again.
 179
 180 For DontKnow the FontSizeBox should be filled FontMetric(), so it will
 181 contain a list with the standard sizes. Th currently shown size
 182 probably needs to be reset by the application.
 183
 184 See also
 185
 186 FontList; FontNameBox; FontStyleBox; FontSizeMenu
 187
 188 *************************************************************************/
 189
 190 inline Color sameColor( Color rMain )
 191 {
 192     return rMain;
 193 }
 194
 195 inline Color sameDistColor( Color /*rMain*/, Color rDefault )
 196 {
 197     return rDefault;
 198 }
 199
 200 class ValueSet;
 201
 202 class SVT_DLLPUBLIC SvtLineListBox final : public WeldToolbarPopup
 203 {
 204 public:
 205     typedef Color (*ColorFunc)(Color);
 206     typedef Color (*ColorDistFunc)(Color, Color);
 207
 208     SvtLineListBox(std::unique_ptr<weld::MenuButton> pControl);
 209     ~SvtLineListBox();
 210
 211     static OUString GetLineStyleName(SvxBorderLineStyle eStyle);
 212
 213     /** Set the width in Twips */
 214     void SetWidth(tools::Long nWidth)
 215     {
 216         m_nWidth = nWidth;
 217         UpdateEntries();
 218         UpdatePreview();
 219     }
 220
 221     tools::Long GetWidth() const { return m_nWidth; }
 222
 223     /** Insert a listbox entry with all widths in Twips. */
 224     void            InsertEntry(const BorderWidthImpl& rWidthImpl,
 225                         SvxBorderLineStyle nStyle, tools::Long nMinWidth = 0,
 226                         ColorFunc pColor1Fn = &sameColor,
 227                         ColorFunc pColor2Fn = &sameColor,
 228                         ColorDistFunc pColorDistFn = &sameDistColor);
 229
 230     void            SelectEntry( SvxBorderLineStyle nStyle );
 231     SvxBorderLineStyle GetSelectEntryStyle() const;
 232
 233     void            SetSourceUnit( FieldUnit eNewUnit ) { eSourceUnit = eNewUnit; }
 234
 235     void            SetColor( const Color& rColor )
 236     {
 237         aColor = rColor;
 238         UpdateEntries();
 239         UpdatePreview();
 240     }
 241
 242     const Color&    GetColor() const { return aColor; }
 243
 244     void            SetSelectHdl(const Link<SvtLineListBox&,void>& rLink) { maSelectHdl = rLink; }
 245
 246     void            set_sensitive(bool bSensitive) { m_xControl->set_sensitive(bSensitive); }
 247
 248     virtual void    GrabFocus() override;
 249
 250 private:
 251
 252     SVT_DLLPRIVATE void         ImpGetLine( tools::Long nLine1, tools::Long nLine2, tools::Long nDistance,
 253                                     Color nColor1, Color nColor2, Color nColorDist,
 254                                     SvxBorderLineStyle nStyle, BitmapEx& rBmp );
 255
 256     DECL_DLLPRIVATE_LINK(ValueSelectHdl, ValueSet*, void);
 257     DECL_DLLPRIVATE_LINK(ToggleHdl, weld::Toggleable&, void);
 258     DECL_DLLPRIVATE_LINK(NoneHdl, weld::Button&, void);
 259     DECL_DLLPRIVATE_LINK(StyleUpdatedHdl, weld::Widget&, void);
 260
 261     void            UpdateEntries();
 262
 263     void UpdatePreview();
 264
 265                     SvtLineListBox( const SvtLineListBox& ) = delete;
 266     SvtLineListBox&    operator =( const SvtLineListBox& ) = delete;
 267
 268     std::unique_ptr<weld::MenuButton> m_xControl;
 269     std::unique_ptr<weld::Button> m_xNoneButton;
 270     std::unique_ptr<ValueSet> m_xLineSet;
 271     std::unique_ptr<weld::CustomWeld> m_xLineSetWin;
 272
 273     std::vector<std::unique_ptr<ImpLineListData>> m_vLineList;
 274     tools::Long            m_nWidth;
 275     ScopedVclPtr<VirtualDevice>   aVirDev;
 276     Color           aColor;
 277     FieldUnit       eSourceUnit;
 278     Link<SvtLineListBox&,void> maSelectHdl;
 279 };
 280
 281 class SVT_DLLPUBLIC SvtCalendarBox
 282 {
 283 public:
 284     SvtCalendarBox(std::unique_ptr<weld::MenuButton> pControl, bool bUseLabel = true);
 285     ~SvtCalendarBox();
 286
 287     weld::MenuButton& get_button() { return *m_xControl; }
 288
 289     void set_date(const Date& rDate);
 290     Date get_date() const { return m_xCalendar->get_date(); }
 291
 292     void set_label(const OUString& rLabel) { m_xControl->set_label(rLabel); }
 293     OUString get_label() const { return m_xControl->get_label(); }
 294
 295     void set_sensitive(bool bSensitive) { m_xControl->set_sensitive(bSensitive); }
 296     bool get_sensitive() const { return m_xControl->get_sensitive(); }
 297     void set_visible(bool bSensitive) { m_xControl->set_visible(bSensitive); }
 298     void show() { set_visible(true); }
 299     void grab_focus() { m_xControl->grab_focus(); }
 300
 301     void connect_activated(const Link<SvtCalendarBox&, void>& rActivatedHdl) { m_aActivatedHdl = rActivatedHdl; }
 302     void connect_selected(const Link<SvtCalendarBox&, void>& rSelectHdl) { m_aSelectHdl = rSelectHdl; }
 303
 304     void connect_focus_in(const Link<weld::Widget&, void>& rLink) { m_xControl->connect_focus_in(rLink); }
 305     void connect_focus_out(const Link<weld::Widget&, void>& rLink) { m_xControl->connect_focus_out(rLink); }
 306 private:
 307     DECL_DLLPRIVATE_LINK(SelectHdl, weld::Calendar&, void);
 308     DECL_DLLPRIVATE_LINK(ActivateHdl, weld::Calendar&, void);
 309
 310     bool m_bUseLabel;
 311
 312     std::unique_ptr<weld::MenuButton> m_xControl;
 313     std::unique_ptr<weld::Builder> m_xBuilder;
 314     std::unique_ptr<weld::Widget> m_xTopLevel;
 315     std::unique_ptr<weld::Calendar> m_xCalendar;
 316
 317     Link<SvtCalendarBox&, void> m_aActivatedHdl;
 318     Link<SvtCalendarBox&, void> m_aSelectHdl;
 319
 320     void set_label_from_date();
 321 };
 322
 323 class SVT_DLLPUBLIC FontNameBox
 324 {
 325 private:
 326     std::unique_ptr<weld::ComboBox> m_xComboBox;
 327     std::unique_ptr<ImplFontList> mpFontList;
 328     size_t          mnPreviewProgress;
 329     bool            mbWYSIWYG;
 330     OUString        maFontMRUEntriesFile;
 331     Idle            maUpdateIdle;
 332     Link<const FontMetric&, void> m_aLivePreviewHdl;
 333
 334     SVT_DLLPRIVATE void         ImplDestroyFontList();
 335
 336     DECL_DLLPRIVATE_LINK(CustomRenderHdl, weld::ComboBox::render_args, void);
 337     DECL_DLLPRIVATE_LINK(CustomGetSizeHdl, OutputDevice&, Size);
 338     DECL_DLLPRIVATE_LINK(SettingsChangedHdl, VclSimpleEvent&, void);
 339     DECL_DLLPRIVATE_LINK(UpdateHdl, Timer*, void);
 340
 341     void            LoadMRUEntries( const OUString& aFontMRUEntriesFile );
 342     void            SaveMRUEntries( const OUString& aFontMRUEntriesFile ) const;
 343
 344     OutputDevice&   CachePreview(size_t nIndex, Point* pTopLeft,
 345                                  sal_Int32 nDPIX = 96, sal_Int32 nDPIY = 96);
 346
 347 public:
 348     FontNameBox(std::unique_ptr<weld::ComboBox> p);
 349     ~FontNameBox();
 350
 351     void            Fill( const FontList* pList );
 352
 353     void            EnableWYSIWYG(bool bEnable);
 354     bool            IsWYSIWYGEnabled() const { return mbWYSIWYG; }
 355
 356     void connect_changed(const Link<weld::ComboBox&, void>& rLink) { m_xComboBox->connect_changed(rLink); }
 357     void connect_focus_in(const Link<weld::Widget&, void>& rLink) { m_xComboBox->connect_focus_in(rLink); }
 358     void connect_focus_out(const Link<weld::Widget&, void>& rLink) { m_xComboBox->connect_focus_out(rLink); }
 359     void connect_key_press(const Link<const KeyEvent&, bool>& rLink) { m_xComboBox->connect_key_press(rLink); }
 360     void connect_popup_toggled(const Link<weld::ComboBox&, void>& rLink){ m_xComboBox->connect_popup_toggled(rLink); }
 361     void connect_live_preview(const Link<const FontMetric&, void>& rLink) { m_aLivePreviewHdl = rLink; }
 362     int get_active() const { return m_xComboBox->get_active(); }
 363     OUString get_active_text() const { return m_xComboBox->get_active_text(); }
 364     void set_active_or_entry_text(const OUString& rText);
 365     void set_active(int nPos) { m_xComboBox->set_active(nPos); }
 366     int get_count() const { return m_xComboBox->get_count(); }
 367     OUString get_text(int nIndex) const { return m_xComboBox->get_text(nIndex); }
 368     void set_sensitive(bool bSensitive) { m_xComboBox->set_sensitive(bSensitive); }
 369     void save_value() { m_xComboBox->save_value(); }
 370     OUString const& get_saved_value() const { return m_xComboBox->get_saved_value(); }
 371     void select_entry_region(int nStartPos, int nEndPos) { m_xComboBox->select_entry_region(nStartPos, nEndPos); }
 372     bool get_entry_selection_bounds(int& rStartPos, int& rEndPos) { return m_xComboBox->get_entry_selection_bounds(rStartPos, rEndPos); }
 373     void clear() { m_xComboBox->clear(); }
 374     void grab_focus() { m_xComboBox->grab_focus(); }
 375     bool has_focus() const { return m_xComboBox->has_focus(); }
 376     void connect_entry_activate(const Link<weld::ComboBox&, bool>& rLink) { m_xComboBox->connect_entry_activate(rLink); }
 377     void connect_get_property_tree(const Link<tools::JsonWriter&, void>& rLink) { m_xComboBox->connect_get_property_tree(rLink); }
 378     void set_entry_width_chars(int nWidth) { m_xComboBox->set_entry_width_chars(nWidth); }
 379     void set_size_request(int nWidth, int nHeight) { m_xComboBox->set_size_request(nWidth, nHeight); }
 380     int get_max_mru_count() const { return m_xComboBox->get_max_mru_count(); }
 381     void set_max_mru_count(int nCount) { m_xComboBox->set_max_mru_count(nCount); }
 382
 383     // font size is in points, not pixels, e.g. see Window::[G]etPointFont
 384     void set_entry_font(const vcl::Font& rFont) { m_xComboBox->set_entry_font(rFont); }
 385     vcl::Font get_entry_font() { return m_xComboBox->get_entry_font(); }
 386
 387     void set_tooltip_text(const OUString& rTip) { m_xComboBox->set_tooltip_text(rTip); }
 388
 389 private:
 390     void            InitFontMRUEntriesFile();
 391
 392                     FontNameBox( const FontNameBox& ) = delete;
 393     FontNameBox&    operator =( const FontNameBox& ) = delete;
 394 };
 395
 396 class SVT_DLLPUBLIC FontStyleBox
 397 {
 398     std::unique_ptr<weld::ComboBox> m_xComboBox;
 399     OUString m_aLastStyle;
 400     Link<weld::ComboBox&, void> m_aChangedLink;
 401 public:
 402     FontStyleBox(std::unique_ptr<weld::ComboBox> p);
 403
 404     void Fill(std::u16string_view rName, const FontList* pList);
 405
 406     void connect_changed(const Link<weld::ComboBox&, void>& rLink) { m_aChangedLink = rLink; }
 407     OUString get_active_text() const { return m_xComboBox->get_active_text(); }
 408     void set_active_text(const OUString& rText)
 409     {
 410         m_aLastStyle = rText;
 411         m_xComboBox->set_active_text(rText);
 412     }
 413     void set_size_request(int nWidth, int nHeight) {  m_xComboBox->set_size_request(nWidth, nHeight); }
 414
 415     void append_text(const OUString& rStr) { m_xComboBox->append_text(rStr); }
 416     void set_sensitive(bool bSensitive) { m_xComboBox->set_sensitive(bSensitive); }
 417     void save_value() { m_xComboBox->save_value(); }
 418     OUString const& get_saved_value() const { return m_xComboBox->get_saved_value(); }
 419     int get_count() const { return m_xComboBox->get_count(); }
 420     int find_text(const OUString& rStr) const { return m_xComboBox->find_text(rStr); }
 421 private:
 422     FontStyleBox(const FontStyleBox& ) = delete;
 423     FontStyleBox& operator=(const FontStyleBox&) = delete;
 424
 425     DECL_LINK(ChangeHdl, weld::ComboBox&, void);
 426 };
 427
 428 class SVT_DLLPUBLIC FontSizeBox
 429 {
 430     const FontList* pFontList;
 431     int             nSavedValue;
 432     int             nMin;
 433     int             nMax;
 434     FieldUnit       eUnit;
 435     sal_uInt16      nDecimalDigits;
 436     sal_uInt16      nRelMin;
 437     sal_uInt16      nRelMax;
 438     sal_uInt16      nRelStep;
 439     short           nPtRelMin;
 440     short           nPtRelMax;
 441     short           nPtRelStep;
 442     bool            bRelativeMode:1,
 443                     bRelative:1,
 444                     bPtRelative:1,
 445                     bStdSize:1;
 446     Link<weld::ComboBox&, void> m_aChangeHdl;
 447     Link<weld::Widget&, void> m_aFocusOutHdl;
 448     std::unique_ptr<weld::ComboBox> m_xComboBox;
 449
 450     sal_uInt16 GetDecimalDigits() const { return nDecimalDigits; }
 451     void SetDecimalDigits(sal_uInt16 nDigits) { nDecimalDigits = nDigits; }
 452     FieldUnit GetUnit() const { return eUnit; }
 453     void SetUnit(FieldUnit _eUnit) { eUnit = _eUnit; }
 454     void SetRange(int nNewMin, int nNewMax) { nMin = nNewMin; nMax = nNewMax; }
 455     void SetValue(int nNewValue, FieldUnit eInUnit);
 456
 457     void InsertValue(int i);
 458
 459     OUString format_number(int nValue) const;
 460
 461     DECL_DLLPRIVATE_LINK(ModifyHdl, weld::ComboBox&, void);
 462     DECL_DLLPRIVATE_LINK(ReformatHdl, weld::Widget&, void);
 463 public:
 464     FontSizeBox(std::unique_ptr<weld::ComboBox> p);
 465
 466     void Fill(const FontList* pList);
 467
 468     void EnableRelativeMode(sal_uInt16 nMin, sal_uInt16 nMax, sal_uInt16 nStep = 5);
 469     void EnablePtRelativeMode(short nMin, short nMax, short nStep = 10);
 470     bool IsRelativeMode() const { return bRelativeMode; }
 471     void SetRelative( bool bRelative );
 472     bool IsRelative() const { return bRelative; }
 473     void SetPtRelative( bool bPtRel )
 474     {
 475         bPtRelative = bPtRel;
 476         SetRelative(true);
 477     }
 478     bool IsPtRelative() const { return bPtRelative; }
 479
 480     void connect_changed(const Link<weld::ComboBox&, void>& rLink) { m_aChangeHdl = rLink; }
 481     void connect_focus_out(const Link<weld::Widget&, void>& rLink) { m_aFocusOutHdl = rLink; }
 482     void connect_key_press(const Link<const KeyEvent&, bool>& rLink) { m_xComboBox->connect_key_press(rLink); }
 483     OUString get_active_text() const { return m_xComboBox->get_active_text(); }
 484     void set_active_or_entry_text(const OUString& rText);
 485     void set_sensitive(bool bSensitive) { m_xComboBox->set_sensitive(bSensitive); }
 486     void set_size_request(int nWidth, int nHeight) { m_xComboBox->set_size_request(nWidth, nHeight); }
 487
 488     int get_active() const { return m_xComboBox->get_active(); }
 489     int get_value() const;
 490     void set_value(int nValue);
 491     void save_value() { nSavedValue = get_value(); }
 492     int get_saved_value() const { return nSavedValue; }
 493     bool get_value_changed_from_saved() const { return get_value() != get_saved_value(); }
 494     int get_count() const { return m_xComboBox->get_count(); }
 495     OUString get_text(int i) const { return m_xComboBox->get_text(i); }
 496     void grab_focus() { m_xComboBox->grab_focus(); }
 497     bool has_focus() const { return m_xComboBox->has_focus(); }
 498     void connect_entry_activate(const Link<weld::ComboBox&, bool>& rLink) { m_xComboBox->connect_entry_activate(rLink); }
 499     void disable_entry_completion() { m_xComboBox->set_entry_completion(false, false); }
 500     void connect_get_property_tree(const Link<tools::JsonWriter&, void>& rLink) { m_xComboBox->connect_get_property_tree(rLink); }
 501
 502 private:
 503     FontSizeBox(const FontSizeBox&) = delete;
 504     FontSizeBox& operator=(const FontSizeBox&) = delete;
 505 };
 506
 507 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */