LibreOffice Module vcl (master)  1
wizdlg.hxx
Go to the documentation of this file.
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 #ifndef INCLUDED_VCL_WIZDLG_HXX
21 #define INCLUDED_VCL_WIZDLG_HXX
22 
23 #include <memory>
24 #include <vcl/button.hxx>
25 #include <vcl/dialog.hxx>
26 #include <vcl/roadmapwizard.hxx>
27 #include <vcl/tabpage.hxx>
28 
30 {
33 };
34 
35 namespace vcl
36 {
37  struct RoadmapWizardImpl;
38  class RoadmapWizard;
39 
40  namespace RoadmapWizardTypes
41  {
42  typedef VclPtr<TabPage> (* RoadmapPageFactory)( RoadmapWizard& );
43  };
44 
45  //= RoadmapWizard
46 
65  class RoadmapWizard : public Dialog
66  {
67  private:
76  sal_uInt16 mnCurLevel;
78  sal_Int16 mnLeftAlignCount;
80 
81  DECL_LINK( ImplHandleWizardLayoutTimerHdl, Timer*, void );
82 
83  // IMPORTANT:
84  // traveling pages should not be done by calling these base class member, some mechanisms of this class
85  // here (e.g. committing page data) depend on having full control over page traveling.
86  // So use the travelXXX methods if you need to travel
87 
88  protected:
89  long LogicalCoordinateToPixel(int iCoordinate);
94  void SetLeftAlignedButtonCount( sal_Int16 _nCount );
95 
96  void CalcAndSetSize();
97 
98  public:
104 
105  private:
106  std::unique_ptr<WizardMachineImplData> m_xWizardImpl;
107  // hold members in this structure to allow keeping compatible when members are added
108  std::unique_ptr<RoadmapWizardImpl> m_xRoadmapImpl;
109 
110  public:
111  RoadmapWizard(vcl::Window* pParent, WinBits nStyle = WB_STDDIALOG, InitFlag eFlag = InitFlag::Default);
112  virtual ~RoadmapWizard( ) override;
113  virtual void dispose() override;
114 
115  virtual void Resize() override;
116  virtual void StateChanged( StateChangedType nStateChange ) override;
117  virtual bool EventNotify( NotifyEvent& rNEvt ) override;
118 
119  void ActivatePage();
120 
121  virtual void queue_resize(StateChangedType eReason = StateChangedType::Layout) override;
122 
123  bool ShowPage( sal_uInt16 nLevel );
124  bool Finish( long nResult = 0 );
125  sal_uInt16 GetCurLevel() const { return mnCurLevel; }
126 
127  void AddPage( TabPage* pPage );
128  void RemovePage( TabPage* pPage );
129  void SetPage( sal_uInt16 nLevel, TabPage* pPage );
130  TabPage* GetPage( sal_uInt16 nLevel ) const;
131 
132  void AddButton( Button* pButton, long nOffset = 0 );
133  void RemoveButton( Button* pButton );
134 
135  void SetPageSizePixel( const Size& rSize ) { maPageSize = rSize; }
136  const Size& GetPageSizePixel() const { return maPageSize; }
137 
139  void enableButtons(WizardButtonFlags _nWizardButtonFlags, bool _bEnable);
140 
142  bool canAdvance() const;
143 
144  void SetRoadmapHelpId( const OString& _rId );
145 
146  void InsertRoadmapItem(int nIndex, const OUString& rLabel, int nId, bool bEnabled);
147  void DeleteRoadmapItems();
148  int GetCurrentRoadmapItemID() const;
149  void SelectRoadmapItemByID(int nId);
150  void SetItemSelectHdl( const Link<LinkParamNone*,void>& _rHdl );
151  void ShowRoadmap(bool bShow);
152 
153  protected:
154 
157 
159  void enterState(WizardTypes::WizardState _nState);
160 
172 
182 
184  bool travelNext();
185 
187  bool travelPrevious();
188 
195 
199 
214  bool skipUntil(WizardTypes::WizardState nTargetState);
215 
232  bool skipBackwardUntil(WizardTypes::WizardState nTargetState);
233 
239 
240  static IWizardPageController* getPageController( TabPage* _pCurrentPage );
241 
249  OUString getStateDisplayName(WizardTypes::WizardState nState) const;
250 
251  private:
252  DECL_LINK( OnRoadmapItemSelected, LinkParamNone*, void );
253 
257  void implUpdateRoadmap( );
258 
259  void impl_construct();
260 
261  public:
263  {
265  private:
267  };
268 
269  void suspendTraveling( AccessGuard );
270  void resumeTraveling( AccessGuard );
271  bool isTravelingSuspended() const;
272 
273  protected:
275 
276  private:
277  void ImplInitData();
278  void ImplCalcSize( Size& rSize );
279  void ImplPosCtrls();
280  void ImplPosTabPage();
281  void ImplShowTabPage( TabPage* pPage );
282  TabPage* ImplGetPage( sal_uInt16 nLevel ) const;
283 
284 
285  DECL_LINK(OnNextPage, Button*, void);
286  DECL_LINK(OnPrevPage, Button*, void);
287  DECL_LINK(OnFinish, Button*, void);
288 
289  void implUpdateTitle();
290  void implConstruct( const WizardButtonFlags _nButtonFlags );
291  };
292 
295  {
296  public:
298  : m_pOWizard(&rWizard)
299  {
300  m_pOWizard->suspendTraveling(RoadmapWizard::AccessGuard());
301  }
302 
304  {
305  if (m_pOWizard)
306  m_pOWizard->resumeTraveling(RoadmapWizard::AccessGuard());
307  }
308 
309  private:
311  };
312 
313 } // namespace vcl
314 
315 #endif
316 
317 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
WindowAlign
virtual void queue_resize(StateChangedType eReason=StateChangedType::Layout) override
wizard for a roadmap
Definition: wizdlg.hxx:65
void resumeTraveling(AccessGuard)
void ShowRoadmap(bool bShow)
VclPtr< vcl::Window > mpViewWindow
Definition: wizdlg.hxx:75
sal_uInt16 mnCurLevel
Definition: wizdlg.hxx:76
void removePageFromHistory(WizardTypes::WizardState nToRemove)
removes a page from the history.
std::unique_ptr< WizardMachineImplData > m_xWizardImpl
Definition: wizdlg.hxx:106
void ImplCalcSize(Size &rSize)
void SetItemSelectHdl(const Link< LinkParamNone *, void > &_rHdl)
sal_Int16 mnLeftAlignCount
Definition: wizdlg.hxx:78
RoadmapWizard(vcl::Window *pParent, WinBits nStyle=WB_STDDIALOG, InitFlag eFlag=InitFlag::Default)
ImplWizPageData * mpFirstPage
Definition: wizdlg.hxx:70
void AddButton(Button *pButton, long nOffset=0)
bool skipUntil(WizardTypes::WizardState nTargetState)
skips one or more states, until a given state is reached
TabPage * GetOrCreatePage(const WizardTypes::WizardState i_nState)
WizardButtonFlags
Definition: vclenum.hxx:276
StateChangedType
Definition: window.hxx:311
sal_Int64 WinBits
WizardTypes::WizardState getCurrentState() const
returns the current state of the machine
Definition: wizdlg.hxx:238
VclPtr< RoadmapWizard > m_pOWizard
Definition: wizdlg.hxx:310
VclPtr< TabPage > mpPage
Definition: wizdlg.hxx:32
virtual void dispose() override
This is intended to be used to clear any locally held references to other Window-subclass objects...
void SetLeftAlignedButtonCount(sal_Int16 _nCount)
sets the number of buttons which should be left-aligned.
ImplWizPageData * mpNext
Definition: wizdlg.hxx:31
VclPtr< TabPage > mpCurTabPage
Definition: wizdlg.hxx:72
void RemoveButton(Button *pButton)
VclPtr< TabPage > createPage(WizardTypes::WizardState nState)
to override to create new pages
sal_uInt16 GetCurLevel() const
Definition: wizdlg.hxx:125
ImplWizButtonData * mpFirstBtn
Definition: wizdlg.hxx:71
Use given parent or get a default one using GetDefaultParent(...)
void SelectRoadmapItemByID(int nId)
bool Finish(long nResult=0)
TabPage * GetPage(sal_uInt16 nLevel) const
VclPtr< PushButton > m_pNextPage
Definition: wizdlg.hxx:101
DECL_LINK(ImplHandleWizardLayoutTimerHdl, Timer *, void)
sal_Int16 WizardState
OUString getStateDisplayName(WizardTypes::WizardState nState) const
returns a human readable name for a given state
WizardTypes::WizardState determineNextState(WizardTypes::WizardState nCurrentState) const
determine the next state to travel from the given one
virtual bool EventNotify(NotifyEvent &rNEvt) override
WindowAlign meViewAlign
Definition: wizdlg.hxx:77
const Size & GetPageSizePixel() const
Definition: wizdlg.hxx:136
void implUpdateRoadmap()
updates the roadmap control to show the given path, as far as possible (modulo conflicts with other p...
VclPtr< PushButton > mpNextBtn
Definition: wizdlg.hxx:74
virtual void Resize() override
bool isTravelingSuspended() const
virtual void StateChanged(StateChangedType nStateChange) override
void suspendTraveling(AccessGuard)
InitFlag
Definition: dialog.hxx:37
helper class to temporarily suspend any traveling in the wizard
Definition: wizdlg.hxx:294
long LogicalCoordinateToPixel(int iCoordinate)
VclPtr< PushButton > mpPrevBtn
Definition: wizdlg.hxx:73
std::unique_ptr< RoadmapWizardImpl > m_xRoadmapImpl
Definition: wizdlg.hxx:108
void SetRoadmapHelpId(const OString &_rId)
bool travelNext()
travel to the next state
void RemovePage(TabPage *pPage)
void implConstruct(const WizardButtonFlags _nButtonFlags)
bool travelPrevious()
travel to the previous state
VclPtr< CancelButton > m_pCancel
Definition: wizdlg.hxx:100
void SetPageSizePixel(const Size &rSize)
Definition: wizdlg.hxx:135
void ImplShowTabPage(TabPage *pPage)
void enterState(WizardTypes::WizardState _nState)
will be called when a new page is about to be displayed
void AddPage(TabPage *pPage)
bool skipBackwardUntil(WizardTypes::WizardState nTargetState)
moves back one or more states, until a given state is reached
int GetCurrentRoadmapItemID() const
bool ShowPage(sal_uInt16 nLevel)
Definition: timer.hxx:26
void enableButtons(WizardButtonFlags _nWizardButtonFlags, bool _bEnable)
enable (or disable) buttons
void InsertRoadmapItem(int nIndex, const OUString &rLabel, int nId, bool bEnabled)
VclPtr< PushButton > m_pPrevPage
Definition: wizdlg.hxx:102
bool mbEmptyViewMargin
Definition: wizdlg.hxx:79
TabPage * ImplGetPage(sal_uInt16 nLevel) const
RoadmapWizardTravelSuspension(RoadmapWizard &rWizard)
Definition: wizdlg.hxx:297
static IWizardPageController * getPageController(TabPage *_pCurrentPage)
VclPtr< OKButton > m_pFinish
Definition: wizdlg.hxx:99
VclPtr< HelpButton > m_pHelp
Definition: wizdlg.hxx:103
bool isAutomaticNextButtonStateEnabled() const
enables the automatic enabled/disabled state of the "Next" button
An idle is a timer to be scheduled immediately.
Definition: idle.hxx:30
Idle maWizardLayoutIdle
Definition: wizdlg.hxx:68
void SetPage(sal_uInt16 nLevel, TabPage *pPage)
virtual ~RoadmapWizard() override
bool prepareLeaveCurrentState(WizardTypes::CommitPageReason eReason)
will be called when the current state is about to be left for the given reason
bool canAdvance() const
determines whether there is a next state to which we can advance