docs: def addRecords(self, records):
          """
          Adds the given record to the system.
          
          :param      records | [<orb.Table>, ..]
          """
          label_mapper    = self.labelMapper()
          icon_mapper     = self.iconMapper()
          
          # create the items to display
          tree = None
          if self.showTreePopup():
              tree = self.treePopupWidget()
              tree.blockSignals(True)
              tree.setUpdatesEnabled(False)
          
          # add the items to the list
          start = self.count()
          self.addItems(map(label_mapper, records))
          
          # update the item information
          for i, record in enumerate(records):
              index = start + i
              
              self.setItemData(index, wrapVariant(record), Qt.UserRole)
              
              if icon_mapper:
                  self.setItemIcon(index, icon_mapper(record))
              
              if tree:
                  XOrbRecordItem(tree, record)
          
          if tree:
              tree.blockSignals(False)
              tree.setUpdatesEnabled(True)