- Сообщения
- 5,379
- Репутация
- 2,724
Друзья, нужна ваша помощь. Я хочу сделать небольшую справку для своей библиотеки WinAPIEx.au3. Она должна выглядеть наподобии оффициальной справки AutoIt (это то, когда вы нажимаете F1 в SciTE). Описания для всех функций находятся внутри библиотеки в стандартной шапке для каждой функции, например:
В идеале нужен .au3 файл для генерации .html, но можно и .chm или .html файл(ы). То, что его можно сгенерировать автоматом, я уверен на 100%, но загвоздка в том, что я не работаю с Web, и понятия не имею как это все должно выглядеть, а на изучение всего этого катастрофически не хватает времени. В будующем, я думаю эту библиотеку присоединят к стандартной WinAPI библиотеке, а пока, наверное многие будут рады иметь под рукой удобный справочный файл для этой UDF, чтобы постоянно не лазить внутрь .au3 файла и искать нужную функцию.
Так что буду рад, если кто-нибудь, хорошо знающий HTML (и возможно регулярные выражения), поможет в этом деле. Естественно, ваше имя/ник обязательно будет (если конечно хотите) в справочном файле.
Код:
; #FUNCTION# ====================================================================================================================
; Name...........: _WinAPI_GradientFill
; Description....: Fills rectangle or triangle gradient.
; Syntax.........: _WinAPI_GradientFill ($hDC, $aVertex [, $iStart [, $iEnd [, $fRotate]]] )
; Parameters.....: $hDC - Handle to the destination device context.
; $aVertex - The 2D array ([x1, y1, $rgb1], [x2, y2, $rgb2], ... [xN, yN, $rgbN]) that contains the necessary
; gradient vertices. Each vertex in this array contains the following parameters.
;
; x - The x-coordinate, in logical units.
; y - The y-coordinate, in logical units
; rgb - The color information at the point of x, y.
;
; $iStart - The index of array to start filling at.
; $iEnd - The index of array to stop filling at.
; $fRotate - Specifies whether fills a rectangle from left to right edge (horizontal gradient). $fRotate used
; only for the rectangular gradients, for the triangular gradients this parameter will be ignored,
; valid values:
; |TRUE - Fills from left to right edge.
; |FALSE - Fills from top to bottom edge. (Default)
; Return values..: Success - 1.
; Failure - 0 and sets the @error flag to non-zero.
; Author.........: Yashied
; Modified.......:
; Remarks........: If the number of vertices defined by using $iStart and $iEnd parameters is 2, _WinAPI_GradientFill() function
; fills a rectangle. If the number of vertices is 3, fills a triangle. For the rectangle, the vertices must
; specify its upper left and lower right corners. Note that $aVertex array may contain any number of vertices
; of the gradient, but only 2 or 3 vertices may be used at the same time from this array.
; Otherwise, the function is fails.
;
; _WinAPI_GradientFill() function can only fill the rectangle or triangle at one call. Use multiple calls this
; function to fill a complex gradients.
; Related........:
; Link...........: @@MsdnLink@@ GdiGradientFill
; Example........: Yes
; ===============================================================================================================================
В идеале нужен .au3 файл для генерации .html, но можно и .chm или .html файл(ы). То, что его можно сгенерировать автоматом, я уверен на 100%, но загвоздка в том, что я не работаю с Web, и понятия не имею как это все должно выглядеть, а на изучение всего этого катастрофически не хватает времени. В будующем, я думаю эту библиотеку присоединят к стандартной WinAPI библиотеке, а пока, наверное многие будут рады иметь под рукой удобный справочный файл для этой UDF, чтобы постоянно не лазить внутрь .au3 файла и искать нужную функцию.
Так что буду рад, если кто-нибудь, хорошо знающий HTML (и возможно регулярные выражения), поможет в этом деле. Естественно, ваше имя/ник обязательно будет (если конечно хотите) в справочном файле.