code: def setSearchedRecords(self, records):
          
          self._searchTerms = 'EXTERNAL_SEARCH'
          self._currentRecordSet = records
          
          # update widget and notify any listeners
          if not self.signalsBlocked():
              self.refresh()
              self.recordsChanged.emit()
          return True
docs: Sets a record set based off of an external search.  Searched results
          provide an overridden entry to the tree widget, by passing the
          grouping mechanism.
          
          :param      records | <orb.RecordSet>
          
          :return     <bool> | records