first steps documentation changes

doc/first-steps.md

@@ -609,7 +609,7 @@ With `delCallback(...)` you can remove a connection to a signal handler
 or a widget instance. Alternatively, you can use `delCallbacks()` to
 remove all existing callbacks from an object.
 
-To delete functions or static methods callbacks via a pointer:(4)
+(1) To delete functions or static methods callbacks via a pointer:
 
 ```cpp
 template<typename FunctionPtr
@@ -618,7 +618,7 @@ void FWidget::delCallback (FunctionPtr&& cb_func_ptr)
 {...}
 ```
 
-To delete functions or static methods callbacks via a reference:(5)
+(2) To delete functions or static methods callbacks via a reference:
 
 ```cpp
 template<typename Function
@@ -627,7 +627,7 @@ void FWidget::delCallback (Function& cb_function)
 {...}
 ```
 
-To delete all callbacks from a specific instance:(1)
+(3) To delete all callbacks from a specific instance:
 
 ```cpp
 template<typename Object
@@ -636,14 +636,14 @@ void FWidget::delCallback (Object&& cb_instance)
 {...}
 ```
 
-To delete all callbacks of a signal:(2)
+(4) To delete all callbacks of a signal:
 
 ```cpp
 void delCallback (const FString& cb_signal)
 {...}
 ```
 
-To delete all callbacks of a signal and specific instance:(3)
+(5) To delete all callbacks of a signal and specific instance:
 
 ```cpp
 template<typename Object
@@ -652,7 +652,7 @@ void delCallback (const FString& cb_signal, Object&& cb_instance)
 {...}
 ```
 
-To delete all callbacks from a widget:(6)
+(6) To delete all callbacks from a widget:
 
 ```cpp
 void delCallback()

examples/windows.cpp

@@ -197,7 +197,7 @@ class Window final : public finalcut::FDialog
     // Method
     void configureFileMenuItems();
     void configureDialogButtons();
-    void activateWindow (finalcut::FDialog*);
+    void activateWindow (finalcut::FDialog*) const;
     void adjustSize() override;
     template<typename InstanceT, typename CallbackT, typename... Args>
     void addClickedCallback ( finalcut::FWidget*
@@ -330,7 +330,7 @@ void Window::configureDialogButtons()
 }
 
 //----------------------------------------------------------------------
-void Window::activateWindow (finalcut::FDialog* win)
+void Window::activateWindow (finalcut::FDialog* win) const
 {
   if ( ! win || win->isWindowHidden() || win->isWindowActive() )
     return;

src/fbutton.cpp

@@ -353,7 +353,7 @@ void FButton::onAccel (FAccelEvent* ev)
 
   if ( ! hasFocus() )
   {
-    auto focused_widget = static_cast<FWidget*>(ev->focusedWidget());
+    auto focused_widget = ev->focusedWidget();
 
     if ( focused_widget && focused_widget->isWidget() )
     {

src/flabel.cpp

@@ -221,7 +221,7 @@ void FLabel::onAccel (FAccelEvent* ev)
 
   if ( ! accel_widget->hasFocus() )
   {
-    auto focused_widget = static_cast<FWidget*>(ev->focusedWidget());
+    auto focused_widget = ev->focusedWidget();
 
     if ( focused_widget && focused_widget->isWidget() )
     {

src/flineedit.cpp

@@ -544,7 +544,7 @@ void FLineEdit::onAccel (FAccelEvent* ev)
 
   if ( ! hasFocus() )
   {
-    auto focused_widget = static_cast<FWidget*>(ev->focusedWidget());
+    auto focused_widget = ev->focusedWidget();
 
     if ( focused_widget && focused_widget->isWidget() )
     {

src/fmenuitem.cpp

@@ -225,7 +225,7 @@ void FMenuItem::delAccelerator (FWidget* obj)
 }
 
 //----------------------------------------------------------------------
-void FMenuItem::openMenu()
+void FMenuItem::openMenu() const
 {
   if ( ! hasMenu() )
     return;
@@ -402,7 +402,7 @@ void FMenuItem::onAccel (FAccelEvent* ev)
     setSelected();
     mbar->setSelectedItem(this);
     openMenu();
-    auto focused_widget = static_cast<FWidget*>(ev->focusedWidget());
+    auto focused_widget = ev->focusedWidget();
     menu->unselectItem();
     menu->selectFirstItem();
 

src/ftogglebutton.cpp

@@ -273,7 +273,7 @@ void FToggleButton::onAccel (FAccelEvent* ev)
 
   if ( ! hasFocus() )
   {
-    auto focused_widget = static_cast<FWidget*>(ev->focusedWidget());
+    auto focused_widget = ev->focusedWidget();
 
     if ( focused_widget && focused_widget->isWidget() )
     {

src/fvterm.cpp

@@ -153,7 +153,7 @@ void FVTerm::setTermXY (int x, int y) const
 }
 
 //----------------------------------------------------------------------
-void FVTerm::setTerminalUpdates (terminal_update refresh_state)
+void FVTerm::setTerminalUpdates (terminal_update refresh_state) const
 {
   if ( refresh_state == stop_terminal_updates )
   {
@@ -240,7 +240,7 @@ void FVTerm::resizeVTerm (const FSize& size) const
 }
 
 //----------------------------------------------------------------------
-void FVTerm::putVTerm()
+void FVTerm::putVTerm() const
 {
   for (int i{0}; i < vterm->height; i++)
   {
@@ -1311,7 +1311,7 @@ void FVTerm::clearArea (FTermArea* area, int fillchar) const
 }
 
 //----------------------------------------------------------------------
-void FVTerm::processTerminalUpdate()
+void FVTerm::processTerminalUpdate() const
 {
   // Retains terminal updates if there are unprocessed inputs
   static constexpr int max_skip = 8;

src/include/final/fmenuitem.h

@@ -125,7 +125,7 @@ class FMenuItem : public FWidget
     // Methods
     void                addAccelerator (FKey, FWidget*) override;
     void                delAccelerator (FWidget*) override;
-    void                openMenu();
+    void                openMenu() const;
 
     // Event handlers
     void                onKeyPress (FKeyEvent*) override;

src/include/final/fvterm.h

@@ -152,7 +152,7 @@ class FVTerm
 
     // Mutators
     void                  setTermXY (int, int) const;
-    void                  setTerminalUpdates (terminal_update);
+    void                  setTerminalUpdates (terminal_update) const;
     void                  hideCursor (bool) const;
     void                  hideCursor() const;
     void                  showCursor() const;
@@ -252,7 +252,7 @@ class FVTerm
     virtual void          clearArea (int = ' ');
     void                  createVTerm (const FSize&);
     void                  resizeVTerm (const FSize&) const;
-    void                  putVTerm();
+    void                  putVTerm() const;
     void                  updateTerminal() const;
     virtual void          addPreprocessingHandler ( const FVTerm*
                                                   , const FPreprocessingFunction& );
@@ -314,7 +314,7 @@ class FVTerm
     void                  scrollAreaForward (FTermArea*) const;
     void                  scrollAreaReverse (FTermArea*) const;
     void                  clearArea (FTermArea*, int = ' ') const;
-    void                  processTerminalUpdate();
+    void                  processTerminalUpdate() const;
     static void           startTerminalUpdate();
     static void           finishTerminalUpdate();
     virtual void          initTerminal();