searchHighlights
Search hits to paint as translucent quads over their pages (colour: PdfViewColors.searchHighlight). Feed it from PdfDocument.search / KiteStructuredText.search (quads are display-space, as both produce); clear it by assigning an empty list.
Every hit here paints in the same colour. For marks that each carry their own colour, or that want a marker in the page margin, use highlights instead. Both channels paint, searchHighlights first.