docs: def qteSetWidgetFocusOrder(self, widList: tuple):
          """
          Change the focus order of the widgets in this applet.
  
          This method re-arranges the internal (cyclic) widget list so
          that all widgets specified in ``widList`` will be focused in
          the given order.
  
          |Args|
  
          * ``widList`` (**tuple**): a tuple of widget objects.
  
          |Returns|
  
          * **None**
  
          |Raises|
  
          * **None**
          """
          # A list with less than two entries cannot be re-ordered.
          if len(widList) < 2:
              return
  
          # Housekeeping: remove non-existing widgets from the admin structure.
          self.qteAutoremoveDeletedWidgets()
  
          # Remove all **None** widgets.
          widList = [_ for _ in widList if _ is not None]
  
          # Ensure that all widgets exist in the current applet.
          for wid in widList:
              if wid not in self._qteAdmin.widgetList:
                  msg = 'Cannot change focus order because some '
                  msg += 'widgets do not exist.'
                  self.qteLogger.warning(msg)
                  return
  
          # Remove all duplicates from the user supplied list.
          newList = [widList[0]]
          for wid in widList[1:]:
              if wid not in newList:
                  newList.append(wid)
  
          # If the duplicate free list has only one entry then there is
          # nothing left to reorder.
          if len(newList) < 2:
              return
  
          # The purpose of the code is the following: suppose
          # _qteAdmin.widgetList = [0,1,2,3,4,5] and newList=[2,5,1].
          # Then change _qteAdmin.widgetList to [0,1,2,5,1,3,4]. Step
          # 1: remove all but the first widget in newList from
          # _qteAdmin.widgetList.
          for wid in newList[1:]:
              self._qteAdmin.widgetList.remove(wid)
  
          # 2: re-insert the removed elements as a sequence again.
          startIdx = self._qteAdmin.widgetList.index(newList[0]) + 1
          for idx, wid in enumerate(newList[1:]):
              self._qteAdmin.widgetList.insert(startIdx + idx, wid)