QtHelp.pyi 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349
  1. # Copyright (C) 2022 The Qt Company Ltd.
  2. # SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
  3. """
  4. This file contains the exact signatures for all functions in module
  5. PySide6.QtHelp, except for defaults which are replaced by "...".
  6. """
  7. # mypy: disable-error-code="override, overload-overlap"
  8. # Module `PySide6.QtHelp`
  9. import PySide6.QtHelp
  10. import PySide6.QtCore
  11. import PySide6.QtGui
  12. import PySide6.QtWidgets
  13. import enum
  14. import typing
  15. import collections.abc
  16. from PySide6.QtCore import Signal
  17. from shiboken6 import Shiboken
  18. class QCompressedHelpInfo(Shiboken.Object):
  19. @typing.overload
  20. def __init__(self, /) -> None: ...
  21. @typing.overload
  22. def __init__(self, other: PySide6.QtHelp.QCompressedHelpInfo, /) -> None: ...
  23. def __copy__(self, /) -> typing.Self: ...
  24. def component(self, /) -> str: ...
  25. @staticmethod
  26. def fromCompressedHelpFile(documentationFileName: str, /) -> PySide6.QtHelp.QCompressedHelpInfo: ...
  27. def isNull(self, /) -> bool: ...
  28. def namespaceName(self, /) -> str: ...
  29. def swap(self, other: PySide6.QtHelp.QCompressedHelpInfo, /) -> None: ...
  30. def version(self, /) -> PySide6.QtCore.QVersionNumber: ...
  31. class QHelpContentItem(Shiboken.Object):
  32. def child(self, row: int, /) -> PySide6.QtHelp.QHelpContentItem: ...
  33. def childCount(self, /) -> int: ...
  34. def childPosition(self, child: PySide6.QtHelp.QHelpContentItem, /) -> int: ...
  35. def parent(self, /) -> PySide6.QtHelp.QHelpContentItem: ...
  36. def row(self, /) -> int: ...
  37. def title(self, /) -> str: ...
  38. def url(self, /) -> PySide6.QtCore.QUrl: ...
  39. class QHelpContentModel(PySide6.QtCore.QAbstractItemModel):
  40. contentsCreated : typing.ClassVar[Signal] = ... # contentsCreated()
  41. contentsCreationStarted : typing.ClassVar[Signal] = ... # contentsCreationStarted()
  42. def columnCount(self, /, parent: PySide6.QtCore.QModelIndex | PySide6.QtCore.QPersistentModelIndex = ...) -> int: ...
  43. def contentItemAt(self, index: PySide6.QtCore.QModelIndex | PySide6.QtCore.QPersistentModelIndex, /) -> PySide6.QtHelp.QHelpContentItem: ...
  44. def createContents(self, customFilterName: str, /) -> None: ...
  45. def createContentsForCurrentFilter(self, /) -> None: ...
  46. def data(self, index: PySide6.QtCore.QModelIndex | PySide6.QtCore.QPersistentModelIndex, role: int, /) -> typing.Any: ...
  47. def index(self, row: int, column: int, /, parent: PySide6.QtCore.QModelIndex | PySide6.QtCore.QPersistentModelIndex = ...) -> PySide6.QtCore.QModelIndex: ...
  48. def isCreatingContents(self, /) -> bool: ...
  49. @typing.overload
  50. def parent(self, /) -> PySide6.QtCore.QObject: ...
  51. @typing.overload
  52. def parent(self, index: PySide6.QtCore.QModelIndex | PySide6.QtCore.QPersistentModelIndex, /) -> PySide6.QtCore.QModelIndex: ...
  53. def rowCount(self, /, parent: PySide6.QtCore.QModelIndex | PySide6.QtCore.QPersistentModelIndex = ...) -> int: ...
  54. class QHelpContentWidget(PySide6.QtWidgets.QTreeView):
  55. linkActivated : typing.ClassVar[Signal] = ... # linkActivated(QUrl)
  56. def indexOf(self, link: PySide6.QtCore.QUrl | str, /) -> PySide6.QtCore.QModelIndex: ...
  57. class QHelpEngine(PySide6.QtHelp.QHelpEngineCore):
  58. def __init__(self, collectionFile: str, /, parent: PySide6.QtCore.QObject | None = ...) -> None: ...
  59. def contentModel(self, /) -> PySide6.QtHelp.QHelpContentModel: ...
  60. def contentWidget(self, /) -> PySide6.QtHelp.QHelpContentWidget: ...
  61. def indexModel(self, /) -> PySide6.QtHelp.QHelpIndexModel: ...
  62. def indexWidget(self, /) -> PySide6.QtHelp.QHelpIndexWidget: ...
  63. def searchEngine(self, /) -> PySide6.QtHelp.QHelpSearchEngine: ...
  64. class QHelpEngineCore(PySide6.QtCore.QObject):
  65. currentFilterChanged : typing.ClassVar[Signal] = ... # currentFilterChanged(QString)
  66. readersAboutToBeInvalidated: typing.ClassVar[Signal] = ... # readersAboutToBeInvalidated()
  67. setupFinished : typing.ClassVar[Signal] = ... # setupFinished()
  68. setupStarted : typing.ClassVar[Signal] = ... # setupStarted()
  69. warning : typing.ClassVar[Signal] = ... # warning(QString)
  70. def __init__(self, collectionFile: str, /, parent: PySide6.QtCore.QObject | None = ..., *, autoSaveFilter: bool | None = ..., readOnly: bool | None = ..., currentFilter: str | None = ...) -> None: ...
  71. def addCustomFilter(self, filterName: str, attributes: collections.abc.Sequence[str], /) -> bool: ...
  72. def autoSaveFilter(self, /) -> bool: ...
  73. def collectionFile(self, /) -> str: ...
  74. def copyCollectionFile(self, fileName: str, /) -> bool: ...
  75. def currentFilter(self, /) -> str: ...
  76. def customFilters(self, /) -> typing.List[str]: ...
  77. def customValue(self, key: str, /, defaultValue: typing.Any = ...) -> typing.Any: ...
  78. def documentationFileName(self, namespaceName: str, /) -> str: ...
  79. @typing.overload
  80. def documentsForIdentifier(self, id: str, /) -> typing.List[PySide6.QtHelp.QHelpLink]: ...
  81. @typing.overload
  82. def documentsForIdentifier(self, id: str, filterName: str, /) -> typing.List[PySide6.QtHelp.QHelpLink]: ...
  83. @typing.overload
  84. def documentsForKeyword(self, keyword: str, /) -> typing.List[PySide6.QtHelp.QHelpLink]: ...
  85. @typing.overload
  86. def documentsForKeyword(self, keyword: str, filterName: str, /) -> typing.List[PySide6.QtHelp.QHelpLink]: ...
  87. def error(self, /) -> str: ...
  88. def fileData(self, url: PySide6.QtCore.QUrl | str, /) -> PySide6.QtCore.QByteArray: ...
  89. @typing.overload
  90. def files(self, namespaceName: str, filterName: str, /, extensionFilter: str = ...) -> typing.List[PySide6.QtCore.QUrl]: ...
  91. @typing.overload
  92. def files(self, namespaceName: str, filterAttributes: collections.abc.Sequence[str], /, extensionFilter: str = ...) -> typing.List[PySide6.QtCore.QUrl]: ...
  93. def filterAttributeSets(self, namespaceName: str, /) -> typing.List[typing.List[str]]: ...
  94. @typing.overload
  95. def filterAttributes(self, /) -> typing.List[str]: ...
  96. @typing.overload
  97. def filterAttributes(self, filterName: str, /) -> typing.List[str]: ...
  98. def filterEngine(self, /) -> PySide6.QtHelp.QHelpFilterEngine: ...
  99. def findFile(self, url: PySide6.QtCore.QUrl | str, /) -> PySide6.QtCore.QUrl: ...
  100. def isReadOnly(self, /) -> bool: ...
  101. @staticmethod
  102. def metaData(documentationFileName: str, name: str, /) -> typing.Any: ...
  103. @staticmethod
  104. def namespaceName(documentationFileName: str, /) -> str: ...
  105. def registerDocumentation(self, documentationFileName: str, /) -> bool: ...
  106. def registeredDocumentations(self, /) -> typing.List[str]: ...
  107. def removeCustomFilter(self, filterName: str, /) -> bool: ...
  108. def removeCustomValue(self, key: str, /) -> bool: ...
  109. def setAutoSaveFilter(self, save: bool, /) -> None: ...
  110. def setCollectionFile(self, fileName: str, /) -> None: ...
  111. def setCurrentFilter(self, filterName: str, /) -> None: ...
  112. def setCustomValue(self, key: str, value: typing.Any, /) -> bool: ...
  113. def setReadOnly(self, enable: bool, /) -> None: ...
  114. def setUsesFilterEngine(self, uses: bool, /) -> None: ...
  115. def setupData(self, /) -> bool: ...
  116. def unregisterDocumentation(self, namespaceName: str, /) -> bool: ...
  117. def usesFilterEngine(self, /) -> bool: ...
  118. class QHelpFilterData(Shiboken.Object):
  119. @typing.overload
  120. def __init__(self, /) -> None: ...
  121. @typing.overload
  122. def __init__(self, other: PySide6.QtHelp.QHelpFilterData, /) -> None: ...
  123. def __copy__(self, /) -> typing.Self: ...
  124. def __eq__(self, other: PySide6.QtHelp.QHelpFilterData, /) -> bool: ...
  125. def components(self, /) -> typing.List[str]: ...
  126. def setComponents(self, components: collections.abc.Sequence[str], /) -> None: ...
  127. def setVersions(self, versions: collections.abc.Sequence[PySide6.QtCore.QVersionNumber], /) -> None: ...
  128. def swap(self, other: PySide6.QtHelp.QHelpFilterData, /) -> None: ...
  129. def versions(self, /) -> typing.List[PySide6.QtCore.QVersionNumber]: ...
  130. class QHelpFilterEngine(PySide6.QtCore.QObject):
  131. filterActivated : typing.ClassVar[Signal] = ... # filterActivated(QString)
  132. def __init__(self, helpEngine: PySide6.QtHelp.QHelpEngineCore, /) -> None: ...
  133. def activeFilter(self, /) -> str: ...
  134. def availableComponents(self, /) -> typing.List[str]: ...
  135. def availableVersions(self, /) -> typing.List[PySide6.QtCore.QVersionNumber]: ...
  136. def filterData(self, filterName: str, /) -> PySide6.QtHelp.QHelpFilterData: ...
  137. def filters(self, /) -> typing.List[str]: ...
  138. @typing.overload
  139. def indices(self, /) -> typing.List[str]: ...
  140. @typing.overload
  141. def indices(self, filterName: str, /) -> typing.List[str]: ...
  142. def namespaceToComponent(self, /) -> typing.Dict[str, str]: ...
  143. def namespaceToVersion(self, /) -> typing.Dict[str, PySide6.QtCore.QVersionNumber]: ...
  144. def namespacesForFilter(self, filterName: str, /) -> typing.List[str]: ...
  145. def removeFilter(self, filterName: str, /) -> bool: ...
  146. def setActiveFilter(self, filterName: str, /) -> bool: ...
  147. def setFilterData(self, filterName: str, filterData: PySide6.QtHelp.QHelpFilterData, /) -> bool: ...
  148. class QHelpFilterSettingsWidget(PySide6.QtWidgets.QWidget):
  149. def __init__(self, /, parent: PySide6.QtWidgets.QWidget | None = ...) -> None: ...
  150. def applySettings(self, filterEngine: PySide6.QtHelp.QHelpFilterEngine, /) -> bool: ...
  151. def readSettings(self, filterEngine: PySide6.QtHelp.QHelpFilterEngine, /) -> None: ...
  152. def setAvailableComponents(self, components: collections.abc.Sequence[str], /) -> None: ...
  153. def setAvailableVersions(self, versions: collections.abc.Sequence[PySide6.QtCore.QVersionNumber], /) -> None: ...
  154. class QHelpGlobal(Shiboken.Object):
  155. @typing.overload
  156. def __init__(self, /) -> None: ...
  157. @typing.overload
  158. def __init__(self, QHelpGlobal: PySide6.QtHelp.QHelpGlobal, /) -> None: ...
  159. def __copy__(self, /) -> typing.Self: ...
  160. @staticmethod
  161. def documentTitle(content: str, /) -> str: ...
  162. @staticmethod
  163. def uniquifyConnectionName(name: str, pointer: int, /) -> str: ...
  164. class QHelpIndexModel(PySide6.QtCore.QStringListModel):
  165. indexCreated : typing.ClassVar[Signal] = ... # indexCreated()
  166. indexCreationStarted : typing.ClassVar[Signal] = ... # indexCreationStarted()
  167. def createIndex(self, customFilterName: str, /) -> None: ...
  168. def createIndexForCurrentFilter(self, /) -> None: ...
  169. def filter(self, filter: str, /, wildcard: str = ...) -> PySide6.QtCore.QModelIndex: ...
  170. def helpEngine(self, /) -> PySide6.QtHelp.QHelpEngineCore: ...
  171. def isCreatingIndex(self, /) -> bool: ...
  172. class QHelpIndexWidget(PySide6.QtWidgets.QListView):
  173. documentActivated : typing.ClassVar[Signal] = ... # documentActivated(QHelpLink,QString)
  174. documentsActivated : typing.ClassVar[Signal] = ... # documentsActivated(QList<QHelpLink>,QString)
  175. linkActivated : typing.ClassVar[Signal] = ... # linkActivated(QUrl,QString)
  176. linksActivated : typing.ClassVar[Signal] = ... # linksActivated(QMultiMap<QString,QUrl>,QString)
  177. def activateCurrentItem(self, /) -> None: ...
  178. def filterIndices(self, filter: str, /, wildcard: str = ...) -> None: ...
  179. class QHelpLink(Shiboken.Object):
  180. @typing.overload
  181. def __init__(self, /) -> None: ...
  182. @typing.overload
  183. def __init__(self, QHelpLink: PySide6.QtHelp.QHelpLink, /) -> None: ...
  184. def __copy__(self, /) -> typing.Self: ...
  185. class QHelpSearchEngine(PySide6.QtCore.QObject):
  186. indexingFinished : typing.ClassVar[Signal] = ... # indexingFinished()
  187. indexingStarted : typing.ClassVar[Signal] = ... # indexingStarted()
  188. searchingFinished : typing.ClassVar[Signal] = ... # searchingFinished(int)
  189. searchingStarted : typing.ClassVar[Signal] = ... # searchingStarted()
  190. def __init__(self, helpEngine: PySide6.QtHelp.QHelpEngineCore, /, parent: PySide6.QtCore.QObject | None = ...) -> None: ...
  191. def cancelIndexing(self, /) -> None: ...
  192. def cancelSearching(self, /) -> None: ...
  193. def hitCount(self, /) -> int: ...
  194. def hits(self, start: int, end: int, /) -> typing.List[typing.Tuple[str, str]]: ...
  195. def hitsCount(self, /) -> int: ...
  196. def query(self, /) -> typing.List[PySide6.QtHelp.QHelpSearchQuery]: ...
  197. def queryWidget(self, /) -> PySide6.QtHelp.QHelpSearchQueryWidget: ...
  198. def reindexDocumentation(self, /) -> None: ...
  199. def resultWidget(self, /) -> PySide6.QtHelp.QHelpSearchResultWidget: ...
  200. def scheduleIndexDocumentation(self, /) -> None: ...
  201. @typing.overload
  202. def search(self, searchInput: str, /) -> None: ...
  203. @typing.overload
  204. def search(self, queryList: collections.abc.Sequence[PySide6.QtHelp.QHelpSearchQuery], /) -> None: ...
  205. def searchInput(self, /) -> str: ...
  206. def searchResultCount(self, /) -> int: ...
  207. def searchResults(self, start: int, end: int, /) -> typing.List[PySide6.QtHelp.QHelpSearchResult]: ...
  208. class QHelpSearchEngineCore(PySide6.QtCore.QObject):
  209. indexingFinished : typing.ClassVar[Signal] = ... # indexingFinished()
  210. indexingStarted : typing.ClassVar[Signal] = ... # indexingStarted()
  211. searchingFinished : typing.ClassVar[Signal] = ... # searchingFinished()
  212. searchingStarted : typing.ClassVar[Signal] = ... # searchingStarted()
  213. def __init__(self, helpEngine: PySide6.QtHelp.QHelpEngineCore, /, parent: PySide6.QtCore.QObject | None = ...) -> None: ...
  214. def cancelIndexing(self, /) -> None: ...
  215. def cancelSearching(self, /) -> None: ...
  216. def reindexDocumentation(self, /) -> None: ...
  217. def scheduleIndexDocumentation(self, /) -> None: ...
  218. def search(self, searchInput: str, /) -> None: ...
  219. def searchInput(self, /) -> str: ...
  220. def searchResultCount(self, /) -> int: ...
  221. def searchResults(self, start: int, end: int, /) -> typing.List[PySide6.QtHelp.QHelpSearchResult]: ...
  222. class QHelpSearchQuery(Shiboken.Object):
  223. class FieldName(enum.Enum):
  224. DEFAULT = 0x0
  225. FUZZY = 0x1
  226. WITHOUT = 0x2
  227. PHRASE = 0x3
  228. ALL = 0x4
  229. ATLEAST = 0x5
  230. @typing.overload
  231. def __init__(self, /) -> None: ...
  232. @typing.overload
  233. def __init__(self, field: PySide6.QtHelp.QHelpSearchQuery.FieldName, wordList_: collections.abc.Sequence[str], /) -> None: ...
  234. @typing.overload
  235. def __init__(self, QHelpSearchQuery: PySide6.QtHelp.QHelpSearchQuery, /) -> None: ...
  236. def __copy__(self, /) -> typing.Self: ...
  237. class QHelpSearchQueryWidget(PySide6.QtWidgets.QWidget):
  238. search : typing.ClassVar[Signal] = ... # search()
  239. def __init__(self, /, parent: PySide6.QtWidgets.QWidget | None = ...) -> None: ...
  240. def changeEvent(self, event: PySide6.QtCore.QEvent, /) -> None: ...
  241. def collapseExtendedSearch(self, /) -> None: ...
  242. def expandExtendedSearch(self, /) -> None: ...
  243. def focusInEvent(self, focusEvent: PySide6.QtGui.QFocusEvent, /) -> None: ...
  244. def isCompactMode(self, /) -> bool: ...
  245. def query(self, /) -> typing.List[PySide6.QtHelp.QHelpSearchQuery]: ...
  246. def searchInput(self, /) -> str: ...
  247. def setCompactMode(self, on: bool, /) -> None: ...
  248. def setQuery(self, queryList: collections.abc.Sequence[PySide6.QtHelp.QHelpSearchQuery], /) -> None: ...
  249. def setSearchInput(self, searchInput: str, /) -> None: ...
  250. class QHelpSearchResult(Shiboken.Object):
  251. @typing.overload
  252. def __init__(self, /) -> None: ...
  253. @typing.overload
  254. def __init__(self, other: PySide6.QtHelp.QHelpSearchResult, /) -> None: ...
  255. @typing.overload
  256. def __init__(self, url: PySide6.QtCore.QUrl | str, title: str, snippet: str, /) -> None: ...
  257. def snippet(self, /) -> str: ...
  258. def title(self, /) -> str: ...
  259. def url(self, /) -> PySide6.QtCore.QUrl: ...
  260. class QHelpSearchResultWidget(PySide6.QtWidgets.QWidget):
  261. requestShowLink : typing.ClassVar[Signal] = ... # requestShowLink(QUrl)
  262. def changeEvent(self, event: PySide6.QtCore.QEvent, /) -> None: ...
  263. def linkAt(self, point: PySide6.QtCore.QPoint, /) -> PySide6.QtCore.QUrl: ...
  264. class QIntList: ...
  265. # eof