HwGUI 2.23: справочное руководство  
назад Александр С. Кресин, Октябрь 2023 вперед


5. Функции

5.1. Стандартные диалоги

hwg_SelectFont( [ oFont ] )
Эта функция вызывает стандартный диалог для выбора шрифта. Обычно нет необходимости вызывать эту функцию напрямую, используйте вместо нее HFont():Select( oFont )

hwg_SelectFile( cDescript,cMask,[ cInitDir ], [ cTitle ] )
Эта функция вызывает стандартный диалог для выбора файла. Пример использования:
   cFileName := hwg_Selectfile( {"dbf files( *.dbf )","All files(*.*)"}, ;
      {"*.dbf","*.*"}, cPath )

hwg_SelectFileEx( [cTitle] [,cInitDir] [,aDescript] ) (GTK only)
Еще один стандартный диалог для выбора файла. Пример использования:
   cFileName := hwg_SelectFileEx( ,, { { "Dbf files", "*.dbf" }, { "All files", "*" } } )

hwg_SelectFolder( cTitle )
Эта функция вызывает стандартный диалог для выбора каталога.
hwg_SaveFile( cPrompt,cDescript,cMask,cInitDir,cTitle ) (Windows only)
Эта функция вызывает стандартный диалог для сохранения файла. Пример использования:
   fname := hwg_Savefile( "*.htm","( *.htm )","*.htm", cPath )

hwg_PrintSetup( @cPrinterName ) (Windows only)
Эта функция вызывает стандартный диалог для выбора принтера.
hwg_ChooseColor( nColorCurrent )
Эта функция вызывает стандартный диалог для выбора цвета.
5.2. MessageBoxes

hwg_MsgInfo( cMessage,cTitle )
hwg_MsgStop( cMessage,cTitle )
hwg_MsgOkCancel( cMessage,cTitle )
hwg_MsgYesNo( cMessage,cTitle )
hwg_MsgYesNoCancel( cMessage,cTitle )
hwg_MsgNoYes( cMessage,cTitle ) (Windows only)
hwg_MsgRetryCancel( cMessage,cTitle ) (Windows only)
hwg_Exclamation( cMessage,cTitle )

Эти функции выводят на экран стандартные message box - окошки с сообщениями, отличающиеся друг от друга набором кнопок.


hwg_MsgBeep( nSound ) (Windows only)


hwg_ShellAbout( cText1, cText2 [,hIcon] ) (Windows only)


hwg_MsgGet( cTitle, cText, nStyle, nLeft, nTop, nDlgStyle, cInitStr )
Создает окно диалога для ввода строки.
hwg_WChoice( arr, cTitle, nLeft, nTop, oFont, clrT, clrB, clrTSel, clrBSel, cOk, cCancel )
Создает диалоговое окно для выбора из списка.
5.3. Функции для рисования.


hwg_DefinePaintStru() Функция вызывается во время процедуры рисования (обычно это метод Paint()) совместно с двумя следующими функциями, hwg_BeginPaint( handle, pps ) and hwg_EndPaint( handle, pps ) - см. параграф про ON PAINT.


hwg_BeginPaint( handle, pps )
Эта функция начинает процесс рисования.
hwg_EndPaint( handle, pps )
Эта функция завершает процесс рисования.
hwg_GetDrawItemInfo( lpDis ) (Windows only)
Если виджет имеет стиль SS_OWNERDRAW и сообщения для него не обрабатываются HwGUI напрямую (см. 3.9. Внутри HwGUI), то обработчику ON PAINT передается в качестве второго параметра указатель на структуру WinAPI DRAWITEMSTRUCT, содержащую информацию, необходимую для рисования этого объекта. Функция hwg_GetDrawItemInfo( lpDis ) извлекает эту информацию и возвращает ее нам в виде массива.
При рисовании этих виджетов не нужно использовать функции hwg_DefinePaintStru(), hwg_BeginPaint(), hwg_EndPaint().
hwg_GetClientRect( handle )
hwg_SelectObject( hDC, handle )
Эта функция устанавливает объект класса HFont, HPen или HBrush как текущий для рисуемой области, т.е. все последующие операции будут использовать именно его. Например:
    // Создаём объект HPen: толщина линии 2px, цвет - красный
    oPen := HPen():Add( BS_SOLID, 2, 255 )
    // Устанавливаем этот объект как текущий для hDC
    hwg_Selectobject( hDC, oPen:handle )
    // Рисуем линию - она будет красного цвета и толщиной 2px
    hwg_Drawline( hDC, 5, 1, 100, 1 )

hwg_DeleteObject( handle )
Удаляет font, pen, brush, bitmap или icon. Обратите внимание, что эта функция действует на уровне WinAPI или GTK, она удаляет не объект соответствующего HwGUI класса, а объект WinaPI/GTK. Обычно нет необходимости вызывать ее напрямую, все нужные действия осуществляет метод Release() соответствующего класса HwGUI.
hwg_MoveTo( hDC, x1, y1 )
Устанавливает новую позицию пера на рисуемой области.
hwg_LineTo( hDC, x1, y1 )
Рисует линию от текущего положения до точки с указанными координатами. Используется перо, предварительно выбранное при помощи hwg_SelectObject().
hwg_Rectangle( hDC, x1, y1, x2, y2 )
Рисует прямоугольник с заданными координатами. Используется перо (pen), предварительно выбранное при помощи hwg_SelectObject().
hwg_Rectangle( hDC, x1, y1, x2, y2 [, hPen] )
Рисует прямоугольник с заданными координатами. Используется перо (pen), предварительно выбранное при помощи hwg_SelectObject(), если не задан параметр hPen.
hwg_Rectangle_Filled( hDC, x1, y1, x2, y2 [, hPen | lPen] [, hBrush] )
Draws a rectangle with given coordinates and fills it. Uses a pen, selected with the help of hwg_SelectObject(), if hPen parameter is not passed. If logical .F. passed instead, the rectangle border will be absent.
hwg_Triangle( hDC, x1, y1, x2, y2, x3, y3 [, hPen] )
Draws a triangle with given coordinates. Uses a pen, selected with the help of hwg_SelectObject(), if hPen parameter is not passed. If logical .F. passed instead, the triangle border will be absent.
hwg_Triangle_Filled( hDC, x1, y1, x2, y2, x3, y3 [, hPen | lPen] [, hBrush] )
Draws a triangle with given coordinates. Uses a pen, selected with the help of hwg_SelectObject(), if hPen parameter is not passed. If logical .F. passed instead, the triangle border will be absent.
hwg_RoundRect( hDC, x1, y1, x2, y2, iRadius [, hPen] )
Draws a rectangle with rounded corners. Uses a pen, selected with the help of hwg_SelectObject(), if hPen parameter is not passed.
hwg_RoundRect_Filled( hDC, x1, y1, x2, y2, iRadius [, hPen | lPen] [, hBrush] )
Draws a rectangle with rounded corners. Uses a pen, selected with the help of hwg_SelectObject(), if hPen parameter is not passed. If logical .F. passed instead, the rectangle border will be absent.
hwg_Ellipse( hDC, x1, y1, x2, y2 [, hPen] )
Draws an ellipse in a rectangle with given coordinates. Uses a pen and a brush, selected with the help of hwg_SelectObject(), if hPen is not passed.
hwg_Ellipse_Filled( hDC, x1, y1, x2, y2 [, hPen | lPen] [, hBrush] )
Draws an ellipse in a rectangle with given coordinates and fills area inside. Uses a pen and a brush, selected with the help of hwg_SelectObject(), if hPen or hBrush parameter are not passed. If logical .F. passed instead of hPen, the border will be absent.
hwg_DrawLine( hDC, x1, y1, x2, y2 )
Рисует линию от одной точки до другой. Используется перо (pen), предварительно выбранное при помощи hwg_SelectObject().
hwg_Pie( hDC, x1, y1, x2, y2, xr1, yr1, xr2, yr2 ) (Windows only)
Рисует сектор эллипса в границах прямоугольника, ограниченный двумя радиальными линиями и заполняет его. Используется перо (pen) и кисть (brush), предварительно выбранные при помощи hwg_SelectObject().
hwg_Ellipse( hDC, x1, y1, x2, y2 )
Рисует эллипс в границах прямоугольника и заполняет его. Используется перо (pen) и кисть (brush), предварительно выбранные при помощи hwg_SelectObject().
hwg_FillRect( hDC, x1, y1, x2, y2, hBrush )
Заполняет прямоугольник с заданными координатами при помощи кисти (brush).
hwg_Drawbutton( hDC, x1, y1, x2, y2, nFlag )
Рисует кнопку.
hwg_DrawEdge( hDC, x1, y1, x2, y2, nFlag, nBorder ) (Windows only)
Рисует края прямоугольника.
hwg_gtk_DrawEdge( hDC, x1, y1, x2, y2, nFlag ) (GTK only)
Рисует края прямоугольника.
hwg_drawGradient( hDC, x1, y1, x2, y2, int type, array_colors, array_stops, array_radiuses )
Эта функция рисует прямоугольник с закругленными (если задан параметр array_radiuses) углами и заполняет его градиентом цветов.
hwg_OpenImage( cName | cBody [, lMem] )
Создает bitmap из файла изображения или из строки, в которой хранится содержимое файла изображения. В большинстве случаев вам не надо вызывать эту функцию напрямую, используйте вместо этого HBitmap():AddFile(cName).
hwg_OpenBitmap( cName [, hDC] )
Создает bitmap из bmp файла. В большинстве случаев вам не надо вызывать эту функцию напрямую, используйте вместо этого HBitmap():AddFile(cName).
hwg_SaveBitmap( cName, hBitmap )


hwg_StockBitmap( cName [,nSizeType] ) (GTK only)
GTK предоставляет набор так называемых стоковых иконок, которые хранятся внутри программы. Это очень удобно, потому что избавляет программиста от необходимости хранить файлы изображений в комплекте с исполняемым файлом программы. Функция создает bitmap из такой вот стоковой иконки. В большинстве случаев вам не надо вызывать эту функцию напрямую, используйте вместо этого HBitmap():AddStandard(cName).
hwg_DrawBitmap( hDC, hBitmap, style, x, y [, width, height] )
Рисует картинку.
hwg_DrawTransparentBitmap( hDC, hBitmap, x, y [,trColor] [, width, height] )
Рисует прозрачную картинку.
hwg_Drawgraybitmap( hDC, hBitmap, x, y ) (Windows only)
Рисует картинку серым.
hwg_SpreadBitmap( hDC, hBitmap [, nLeft, nTop, nRight, nBottom] )
Эта функция заполняет всю рисуемую область, или прямоугольный фрагмент, ограниченный координатами, переданными этой функции в качестве параметров, картинкой из bmp-файла. Заполнение происходит многократным копированием картинки, ее "размножением".
hwg_Drawicon( hDC, hIcon, x1, y1 ) (Windows only)
Рисует иконку.
hwg_CenterBitmap( hDC, hWnd, hBitmap, style, brush ) (Windows only)


hwg_GetBitmapSize( hBitmap )
Возвращает массив с размерами (ширина и высота) картинки.
hwg_GetIconSize( hIcon ) (Windows only)
Возвращает массив с размерами (ширина и высота) иконки.
hwg_Getsyscolor( nCode )
Возвращает стандартный системный цвет, соответствующий переданному коду. В GTK версии всегда возвращает стандартный цвет фона главного окна.
hwg_GetsyscolorBrush( nCode ) (Windows only)
Возвращает дескриптор кисти (brush) стандартного системного цвета, соответствующего переданному коду.
hwg_Createpen( nStyle, nWidth, nColor )
Создает перо (pen) с заданными параметрами. Обычно нет необходимости вызывать эту функцию напрямую, используйте вместо нее HPen():Add().
hwg_Createsolidbrush( nColor )
Создает кисть (brush) с заданным цветом. Обычно нет необходимости вызывать эту функцию напрямую, используйте вместо нее HBrush():Add().
hwg_Createhatchbrush( nHatch, nColor ) (Windows only)
Создает кисть (brush) с заданным цветом и шаблоном штриховки. Обычно нет необходимости вызывать эту функцию напрямую, используйте вместо нее HBrush():Add().
hwg_GetDC( hWnd )
Возвращает hDC GUI элемента. После использования полученный таким образом hDC должен быть освобожден с помощью hwg_ReleaseDC( hWnd, hDC ).
hwg_ReleaseDC( hWnd, hDC )
Освобождает hDC, полученный с помощью hwg_GetDC( hWnd ).
hwg_SaveDC( hDC ) (Windows only)


hwg_DeleteDC( hDC ) (Windows only)


hwg_Restoredc( hDC, nSavedDC ) (Windows only)


hwg_CreateCompatibleDC( hDC )


hwg_CreateCompatibleBitmap( hDC, nWidth, nHeight ) (Windows only)


hwg_Patblt( hDc, a, s, d, f, g ) (Windows only)


hwg_Bitblt( hDc, x, y, nWidth, nHeight, pSrcDC, xSrc, ySrc, nFlag )


hwg_Setmapmode( hDC, nMapMode ) (Windows only)


hwg_Setwindoworgex( hDC, x, y, @point ) (Windows only)


hwg_Setwindowextex( hDC, x, y, @point ) (Windows only)


hwg_Setviewportorgex( hDC, x, y, @point ) (Windows only)


hwg_Setviewportextex( hDC, x, y, @point ) (Windows only)


hwg_Setarcdirection( hDC, nArcDirection ) (Windows only)


hwg_Setrop2( hDC, nDrawMode ) (Windows only)


hwg_DrawFrameControl( hDC, nType, nState ) (Windows only)


hwg_TextOut( hDC, x, y, cText )
Рисует текст. Используется шрифт, предварительно выбранный при помощи hwg_SelectObject().
hwg_DrawText( hDC, cText, x1 | aRect [, y1, x2, y2, nStyle [,aRect]] )
Рисует текст в пределах заданного прямоугольника, выровненный в соответствии с переданным параметром. Используется шрифт, предварительно выбранный при помощи hwg_SelectObject().
hwg_GetTextMetric( hDC )
Возвращает массив с геометрическими параметрами текста для заданного hDC, для шрифта, предварительно выбранного при помощи hwg_SelectObject().
hwg_GetTextSize( hDC, cText )
Возвращает массив с геометрическими размерами текста для заданного hDC, для шрифта, предварительно выбранного при помощи hwg_SelectObject().
  • hDC - hDC;
  • Возвращаемое значение - массив:
       array[1] - ширина текста,
       array[2] - высота текста.
    hwg_GetClientRect( handle )


    hwg_GetWindowRect( handle )


    hwg_SetTextColor( hDC, nColor )
    Устанавливает цвет текста для рисования.
    • hDC - hDC;
    • nColor - новое значение цвета текста;
    • Возвращаемое значение - предыдущее значение цвета текста.

    hwg_GetTextColor( hDC )
    Возвращает текущее значение цвета текста для рисования.
    • hDC - hDC;
    • Возвращаемое значение - текущее значение цвета текста.

    hwg_SetBkColor( hDC, nColor )
    Устанавливает цвет фона для рисования.
    • hDC - hDC;
    • nColor - новое значение цвета фона;
    • Возвращаемое значение - предыдущее значение цвета фона.

    hwg_GetBkColor( hDC )
    Возвращает текущее значение цвета фона для рисования.
    • hDC - hDC;
    • Возвращаемое значение - текущее значение цвета текста.

    hwg_SetTransparentMode( hDC, lTransparent )


    hwg_Exttextout( hDC, x, y, x1, y1, x2, y2, cText ) (Windows only)


    hwg_WindowFromDC( hDC )
    Получить дескриптор GUI элемента по его hDC.
    • hDC - hDC;
    • Возвращаемое значение - дескриптор GUI элемента.

    hwg_Loadimage( hInstance, cName, nType, nWidth, nHeight, nFlags ) (Windows only)


    hwg_Loadbitmap( nId | cName [,l] ) (Windows only)


    hwg_Window2bitmap( hWnd [, x1, y1, width, height] )
    Создает битмап из заданной области окна или виджета. Если координаты области не заданы, окно/виджет берется целиком.
    • hWnd - дескриптор рисуемого окна или виджета;
    • x1, y1 - координаты левого верхнего угла заданной области;
    • width, height - ширина и высота заданной области;
    • Return value - дескриптор битмапки.

    hwg_RedrawWindow( handle, nFlags, x1, y1, nWidth, nHeight )


    hwg_Invalidaterect( handle, lEraseBack, x1, y1, x2, y2 )


    hwg_GetPpsRect( pps ) (Windows only)


    hwg_GetPpsErase( pps ) (Windows only)


    hwg_GetUpdateRect( hWnd ) (Windows only)


    5.4. Функции для управления окнами.


    hwg_GetModalDlg()
    • Возвращаемое значение - объект класса HDialog, текущий модальный диалог; Nil - если нет открытого в данный момент модального диалога.

    hwg_EndDialog( [handle] )
    Закрывает диалог с дескриптором handle; если handle не указан, закрывается текущий модальный диалог.
    • handle - необязательный параметр, дескриптор закрываемого диалогового окна.

    hwg_EndWindow()
    Закрывает главное окно.


    hwg_isWindow( hWnd ) (Windows only)
    Определяет, идентифицирует ли дескриптор определяемого окна существующее окно.
    • Возвращаемое значение (логическое) - .T., если дескриптор окна идентифицирует существующее окно.

    hwg_FlashWindow( hWnd ) (Windows only)
    Заставляет окно "моргнуть" - при этом его заголовок как бы переходит из активного состояния в неактивное и наоборот.
    • hWnd - дескриптор окна.

    hwg_GetActiveWindow()
    • Возвращаемое значение дескриптор активного в данный момент окна.

    hwg_GetInstance (Windows only)


    hwg_SetWindowStyle( handle, nStyle ) (Windows only)
    Эта функция устанавливает WinAPI стиль для GUI эемента.
    • handle - дескриптор GUI элемента;
    • nStyle - WinAPI стиль.

    hwg_GetWindowStyle( handle ) (Windows only)
    Эта функция возвращает WinAPI стиль GUI эемента.
    • handle - дескриптор GUI элемента;
    • Return value - (число) WinAPI стиль.

    hwg_SetWindowExtStyle( handle, nStyle ) (Windows only)
    Эта функция устанавливает расширенный WinAPI стиль для GUI эемента.
    • handle - дескриптор GUI элемента;
    • nStyle - расширенный WinAPI стиль.

    hwg_GetWindowExtStyle( handle ) (Windows only)
    Эта функция возвращает расширенный WinAPI стиль GUI эемента.
    • handle - дескриптор GUI элемента;
    • Return value - (число) расширенный WinAPI стиль.

    hwg_FindWindow( cClassName, cWindowName) (Windows only)


    hwg_SetForegroundWindow( handle ) (Windows only)


    hwg_BringToTop( handle ) (Windows only)
    Устанавливает окно над всеми остальными окнами.
    • handle - дескриптор окна.

    hwg_ResetWindowPos( handle ) (Windows only)


    hwg_UpdateWindow( handle ) (Windows only)


    hwg_CenterWindow( handle )
    Центрирует окно на экране.
    • handle - дескриптор окна.

    hwg_RestoreWindow( handle )
    Восстанавливает размер окна.
    • handle - дескриптор окна.

    hwg_EnableWindow( handle, lEnable )
    Включает или отключает мышь и ввод с клавиатуры для GUI элемента. Когда ввод заблокирован, GUI элемент не принимает ввод типа щелчков мыши и нажатий клавиш. Когда ввод включен, окно принимает всю вводимую информацию.
    • handle - дескриптор GUI элемента.
    • lEnable - лошическое значение, определяющее, включить или отключить GUI элемент.

    hwg_isWindowEnabled( handle )
    Проверяет, включен или отключен GUI элемент.
    • handle - дескриптор GUI элемента.

    hwg_HideWindow( handle )
    Прячет GUI элемент, убирает его с экрана.
    • handle - дескриптор GUI элемента.

    hwg_ShowWindow( handle )
    Показывает GUI элемент на экране.
    • handle - дескриптор GUI элемента.

    hwg_ProcessMessage( [lMdi] [, nSleep] )


    hwg_PeekMessage( hWnd ) (Windows only)


    hwg_DoEvents() (Windows only)


    hwg_SendMessage( handle, nMessage, wParam, lParam ) (Windows only)


    hwg_PostMessage( handle, nMessage, wParam, lParam ) (Windows only)


    hwg_SetWindowObject( handle, object )


    hwg_GetWindowObject( handle )


    hwg_SetWindowText( handle, cTitle )
    Изменяет текст заголовка заданного окна или текст виджета.
    • handle - дескриптор GUI элемента;
    • cTitle - текст.

    hwg_GetWindowText( handle )
    Возвращает текст заголовка заданного окна или текст виджета.
    • handle - дескриптор GUI элемента;
    • Возвращаемое значение - текст.

    hwg_SetWindowFont( handle, hFont, l ) (Windows only)


    hwg_GetLastError() (Windows only)
    Извлекает значение кода последней ошибки вызывающего потока.
    • Возвращаемое значение - код ошибки.

    hwg_isIconic( hWnd ) (Windows only)
    Определяет, не свернуто ли окно.
    • hWnd - дескриптор окна.
    • Возвращаемое значение - .T., если окно свернуто (минимизировано).

    hwg_isWindowVisible( hWnd ) (Windows only)
    Возвращает информацию о состоянии окна (видимо/спрятано).
    • hWnd - дескриптор окна.
    • Возвращаемое значение - .T., если окно видимое, .F. - если спрятано.

    hwg_ExitProcess() (Windows only)


    hwg_WindowSetResize( hWnd, lResizeable )
    Sets the window resizeable or no resizeable.
    • hWnd - - дескриптор окна.
    • lResizeable - логический параметр.

    hwg_SetTopmost( hWnd )
    Устанавливает окно как Topmost, т.е. видимым независимо от того, активно оно или нет.
    • hWnd - дескриптор окна.

    hwg_RemoveTopmost( hWnd )
    Сбрасывает режим Topmost (см. hwg_SetTopmost()).
    • hWnd - дескриптор окна.

    hwg_ChildWindowFromPoint( hWnd, x, y ) (Windows only)


    hwg_WindowFromPoint( hWnd, x, y ) (Windows only)


    hwg_GetFontDialogUnits( hWnd ) (Windows only)


    hwg_GetWindowPlacement( handle ) (Windows only)


    hwg_ClearKeyboard() (Windows only)


    5.5. Функции для управления виджетами.


    hwg_SetFocus( handle )
    Устанавливает фокус клавиатуры в указанный GUI элемент.
    • handle - дескриптор GUI элемента;
    • Возвращаемое значение - дескриптор GUI элемента, который имел клавиатурный фокус.

    hwg_GetFocus()
    Возвращает дескриптор GUI элемента, имеющего клавиатурный фокус.
    • Возвращаемое значение - дескриптор GUI элемента, который имеет клавиатурный фокус.

    hwg_WriteStatus( oWnd, nPart, cText, lRedraw )
    Записывает текст в определенный фрагмент панели статуса. Функция работает как для стандартного Status, так и для Status Panel.
    • oWnd - окно с панелью статуса, объект одного из субклассов класса HWindow;
    • nPart - номер фрагмента панели статуса;
    • CText - текст для панели;
    • lRedraw - .T., чтобы сразу перерисовать панель.

    hwg_FindParent( hCtrl )
    Возвращает объект родительского GUI элемента для виджета по его дескриптору.
    • hCtrl - дескриптор виджета;
    • Возвращаемое значение - объект родительского GUI элемента.

    hwg_FindSelf( hCtrl )
    Возвращает объект виджета по его дескриптору.
    • hCtrl - дескриптор виджета;
    • Возвращаемое значение - объект виджета.

    hwg_getParentForm( o )
    Возвращает объект ркна, которому принадлежит данный виджет. Отличие от hwg_FindParent() состоит в том, что hwg_FindParent() ищет непосредственного родителя, это может быть другой виджет, такой как Tab, Panel или Toolbar. hwg_getParentForm() всегда возвращает окно, которое включает данный виджет и его возможных родителей - виджетов.
    • oCtrl - объект виджета;
    • Возвращаемое значение - объект окна.

    hwg_MoveWindow( handle, nLeft, nTop, nWidth, nHeight, lRepaint )


    hwg_DestroyWindow( handle )


    hwg_Createarlist( oBrw, arr )


    hwg_CreateList( oBrw, lEditable )


    hwg_VScrollPos( oBrw, nType, lEof, nPos )


    hwg_HScrollPos( oBrw, nType, lEof, nPos )


    hwg_ColumnArBlock()


    hwg_ShowProgress( nStep, maxPos, nRange, cTitle, oWnd, x1, y1, width, height ) (Windows only)


    hwg_UpdateProgressBar( handle )


    hwg_SetProgressBar( handle, nPos )


    hwg_SetRangeProgressBar( handle, nValue )


    hwg_trackbarsetrange( handle, nLow, nHigh ) (Windows only)


    hwg_SetMonthCalendarDate( handle , dValue )


    hwg_GetMonthCalendarDate( handle )


    hwg_Setctrlfont( parentHandle, nId, hFont ) (Windows only)


    hwg_Setctrlfont( handle, hFont ) (GTK only)


    hwg_AddTooltip( handle, cTooltip )
    Добавляет подсказку (tooltip) для виджета.
    • handle - дескриптор виджета;
    • cTooltip - текст подсказки.

    hwg_DelTooltip( handle )
    Удаляет подсказку (tooltip) для виджета.
    • handle - дескриптор виджета.

    hwg_SetTooltipTitle( handle, cTooltip )
    Изменяет текст подсказки (tooltip) для виджета.
    • handle - дескриптор виджета;
    • cTooltip - новый текст подсказки.

    hwg_SetUpdown( handle, nValue )


    hwg_SetRangeUpdown( handle, n1, n2 )


    hwg_SetDatePicker( handle, dValue ) (Windows only)


    hwg_SetDatePickerNull( handle ) (Windows only)


    hwg_GetDatePicker( handle ) (Windows only)


    hwg_GetTimePicker( handle ) (Windows only)


    hwg_AddTab( handle, cName )


    hwg_DeleteTab( handle, nPage )


    hwg_GetCurrentTab( handle )


    hwg_SetCurrentTab( handle, nPage ) (GTK only)


    hwg_SetTabSize( handle, nWidth, nHeight ) (Windows only)


    hwg_GetTabHeight( handle ) (Windows only)


    hwg_SetTabName( handle, nPage, cName )


    hwg_CreateImageList( aImages, nWidth, nHeight, nGrow, nFlags ) (Windows only)


    hwg_DestroyImageList( handle ) (Windows only)


    hwg_Imagelist_Add( handle, hBitmap ) (Windows only)


    hwg_Imagelist_AddMasked( handle, hBitmap, nMask ) (Windows only)


    hwg_ImageList_GetImageCount( handle ) (Windows only)


    hwg_getParent( handle )
    Возврашает дескриптор родительского GUI элемента, используя системный вызов WinAPI/GTK - и, следовательно, быстрее, чем с помощью переменной соответствующего объекта oParent.
    • handle - дескриптор виджета, родителя которого надо найти;
    • Возвращаемое значение - дескриптор родительского GUI элемента.

    hwg_getAncestor( handle ) (Windows only)


    hwg_LoadCursor( cursor )


    hwg_SetCursor( cursor, hCtrl )
    Устанавливает вид курсора мыши.
    • cursor - дескриптор курсора;
    • hCtrl - дескриптор виджета под курсором (параметр нужен только для GTK версии).

    hwg_GetCursor() (Windows only)


    hwg_SetTooltipBalloon( lBalloon ) (Windows only)


    hwg_GetTooltipBalloon() (Windows only)


    hwg_SetDlgItemText( parentHandle, nId, cText ) (Windows only)
    Устанавливает текст виджета.
    • parentHandle - дескриптор родительского окна (oCtrl:oParent:handle);
    • nId - идентификатор виджета (oCtrl:id);
    • cText - текстовая строка для виджета.

    hwg_GetDlgItemText( parentHandle, nId ) (Windows only)
    Читает текст виджета.
    • parentHandle - дескриптор родительского окна (oCtrl:oParent:handle);
    • nId - идентификатор виджета (oCtrl:id);
    • Возвращаемое значение - текстовая строка, отображаемая виджетом.

    hwg_GetEditText( parentHandle, nId ) (Windows only)
    Читает текст виджета клвсса HEdit.
    • parentHandle - дескриптор родительского окна (oCtrl:oParent:handle);
    • nId - идентификатор виджета (oCtrl:id);
    • Возвращаемое значение - текстовая строка виджета.

    hwg_CheckDlgButton( parentHandle, nId, lValue ) (Windows only)


    hwg_isDlgButtonChecked( parentHandle, nId ) (Windows only)


    hwg_ComboAddString( handle, cText ) (Windows only)


    hwg_ComboInsertString( handle, nPos, cText ) (Windows only)


    hwg_ComboSetString( handle, nPos ) (Windows only)


    hwg_ListboxAddString( handle, cValue ) (Windows only)


    hwg_ModifyStyle( hWnd, nStyleDel, nStyleAdd ) (Windows only)


    hwg_re_SetCharFormat( hCtrl, n1, n2, nColor, cName, nHeight, lBold, lItalic, lUnderline, nCharset, lSuperScript/lSubscript, lProtected ) (Windows only)


    hwg_re_SetDefault( hCtrl, nColor, cName, nHeight, lBold, lItalic, lUnderline, nCharset ) (Windows only)


    hwg_re_CharFromPos( hEdit, xPos, yPos ) (Windows only)


    hwg_re_GetTextRange( hEdit, n1, n2 ) (Windows only)


    hwg_re_GetLine( hEdit, nLine ) (Windows only)


    hwg_re_InsertText( hEdit, cText ) (Windows only)


    hwg_re_FindText( hEdit, cFind, nStart, bCase, bWholeWord, bSearchUp ) (Windows only)


    hwg_re_SetZoom( hEdit, nNum, nDen ) (Windows only)


    hwg_re_SetZoomOff( hEdit ) (Windows only)


    hwg_re_GetZoom( hEdit, @nNum, @nDen ) (Windows only)


    hwg_PrintRtf( hEdit, hDC ) (Windows only)


    hwg_SaveRichedit( hEdit, cFileName ) (Windows only)


    hwg_LoadRichedit( hEdit, cFileName ) (Windows only)



    5.6. Функции для меню.


    Hwg_AddMenuItem( aMenu, cItem, nMenuId, lSubMenu, bItem, nPos )


    Hwg_DefineMenuItem( cItem, nId, bItem, lDisabled, accFlag, accKey, lBitmap, lResource, lCheck )


    Hwg_DefineAccelItem( nId, bItem, accFlag, accKey )


    Hwg_InsertBitmapMenu( aMenu, nId, lBitmap, oResource ) (Windows only)


    Hwg_SetMenuItemBitmaps( aMenu, nId, abmp1, abmp2 ) (Windows only)


    hwg_DeleteMenuItem( oWnd, nId )


    Hwg_FindMenuItem( aMenu, nId, nPos )


    hwg_CheckMenuItem( hWnd, nId, lValue )


    hwg_IsCheckedMenuItem( hWnd, nId )


    hwg_EnableMenuItem( hWnd, nId, lValue )


    hwg_IsEnabledMenuItem( hWnd, nId )


    hwg_SetMenuCaption( hWnd, nId, cText )


    hwg_GetMenuCaption( hWnd, nId )


    hwg_DrawMenuBar( hWnd )


    hwg_SetMenuBackColor( hWnd, nColor[, lSubmenus] )



    5.7. Регистр Windows.


    hwg_RegCreateKey( handle, cKeyName ) (Windows only)


    hwg_RegOpenKey( handle, cKeyName ) (Windows only)


    hwg_RegCloseKey( handle ) (Windows only)


    hwg_RegSetString( handle, cKeyName, cKeyValue ) (Windows only)


    hwg_RegSetBinary( handle, cKeyName, cBinValue ) (Windows only)


    hwg_RegGetValue( handle, cKeyName [,nType] ) (Windows only)


    5.8. Всякие другие функции.


    hwg_GetItemByName( arr, cName )
    Возвращает HwGUI объект из массива, находя его по имени (:objname).
    • arr - массив HwGUI объектоа,
    • cName - имя HwGUI объекта.


    hwg_Version( n )
    Возвращает информацию о текущей версии HwGUI. Необязательный параметр n определяет вид информации:
    • n == 1: возвращает короткую строку с номером версии, например, "2.20",
    • n == 2: возвращает номер сборки (число),
    • n == 3: возвращает .T., если это сборка с поддержкой UNICODE, и .F. в обратном случае,
    • n отсутствует: возвращает строку с полной информацией о версии.

    hwg_WriteLog( cText [, fname] )
    Adds a text to a file, the functions is intended for debugging purposes.
    • cText - the text to be written;
    • fname - (optional) a file name, the default is "a.log".

    hwg_SetDlgKey( [oDlg], nCtrl, nKey, block [, lGlobal] )
    Устанавливает "горячую клавишу" для окна/диалога или глобально - для всего приложения. ИМеется и соответствующая команда: SET KEY.
    • oDlg - (необязательный параметр, по умолчанию - текущее родительское оекно) объект субкласса HWindow, окно, для которого устанавливается "горячая клавиша";
    • nCtrl - код управляющей клавиши (например, FCONTROL), 0 - если управляющая клавиша не определена;
    • nKey - код клавиши,
    • block - кодоблок, выполняемый при нажатии на клавишу;
    • lGlobal - (необязательный параметр, по умолчанию - .F.) - логическое значение, определяющее, глобально ли устанавливается "горячая клавиша".

    hwg_ColorC2N( cColor )
    Конвертирует представление цвета из строкового в численный формат.
    • cColor - строка в формате #RRGGBB;
    • Возвращаемое значение - численное представление цвета.

    hwg_ColorN2C( nColor )
    Конвертирует представление цвета из численного в строковый формат.
    • nColor - численное представление цвета;
    • Возвращаемое значение - строка в формате #RRGGBB.

    hwg_ColorN2RGB( nColor [, @nRed, @nGreen, @nBlue] )
    Конвертирует представление цвета из одного числа в три, соответствующие красной, зеленой и синей составляющим. Результат преобразования можно получить, передав переменные по ссылке или использую возвращаемое значение.
    • cColor - численное представление цвета;
    • nRed - (optional) красная составляющая, переданная по ссылке;
    • nGreen - (optional) зеленая составляющая, переданная по ссылке;
    • nBlue - (optional) синяя составляющая, переданная по ссылке;
    • Возвращаемое значение - массив из трех чисел, соответствующих красной, зеленой и синей составляющим.

    hwg_ColorRgb2N( nRed, nGreen, nBlue )
    Конвертирует три составляющих цвета (красную, зеленую и синюю) в численное представление цвета.
    • nRed - красная составляющая;
    • nGreen - зеленая составляющая;
    • nBlue - синяя составляющая;
    • Возвращаемое значение - численное представление цвета.

    hwg_BmpFromRes( cBmp )
    Создает bitmap из ресурсов или бинарного контейнера (если он предварительно открыт функцией hwg_SetResContainer()). В большинстве случаев вам не надо вызывать эту функцию напрямую, используйте вместо этого HBitmap():AddResource(cBmp).
    • cName - имя bmp ресурса;
    • Возвращаемое значение - дескриптор картинки.

    hwg_SetResContainer( cName )
    Открывает файл бинарного контейнера и устанавливает его как текущий для извлечения ресурсов. Соответствующая команда: SET RESOURCES CONTAINER TO.
    • cName - полный путь и имя файла бинарного контейнера;
    • Возвращаемое значение - (логическое) .T., если файл открыт успешно и .F. - в противном случае.

    hwg_SetCtrlName( oCtrl, cName )


    hwg_RefreshAllGets( oDlg )
    Обновляет состояние всех GET-элементов в окне.
    • oDlg - окно с GET-элементами, объект одного из субклассов класса HWindow.

    hwg_IsCtrlShift( lCtrl, lShift ) (Windows only)


    hwg_GetSkip( oParent, hCtrl, nSkip )
    Устанавливает фокус ввода на другой GET-элемент.
    • oParent - объект родительского окна;
    • hCtrl - дескриптор виджета;
    • nSkip - количество GET-элементов, которые надо пропустить (положительное или отрицательное).

    hwg_SetGetUpdated( o )
    Устанавливает состояние GET-элемента как updated.
    • oEdit - GET-элемент, объект класса HEDIT.

    hwg_SetColorinFocus( lDef, tColor, bColor )


    hwg_Chr( nCode )
    hwg_Substr( cString, nPos, nLen )
    hwg_Left( cString, nLen )
    hwg_Len( cString )


    hwg__isUnicode()
    Позволяет определить, доступна ли поддержка Unicode.
    • Возвращаемое значение - (логическое) .T., если библиотека HwGUI собрана с поддержкой Unicode.

    hwg_GetPrinters()
    Возвращает список принтеров, зарегистрированных в ОС.
    • Возвращаемое значение - массив с именами принтеров.

    hwg_Createfont( fontName, nWidth, nHeight, fnWeight, fdwCharSet, fdwItalic, fdwUnderline, fdwStrikeOut )


    hwg_GetFontsList()
    Возвращает список шрифтов, зарегистрированных в ОС.
    • Возвращаемое значение - массив с именами шрифтов.

    hwg_HdSerial( cDrive ) (Windows only)


    hwg_HdGetSerial( cDrive ) (Windows only)


    Hwg_GetIni( cSection, cEntry, cDefault, cFile ) (Windows only)


    Hwg_WriteIni( cSection, cEntry, cValue, cFile ) (Windows only)


    hwg_TxtRect( cTxt, oWin, oFont )


    hwg_ErrMsg( oError )


    hwg_ShellNotifyIcon( lAdd, hWnd, hIcon, cTooltip ) (Windows only)


    hwg_ShellModifyIcon( hWnd, hIcon, cTooltip ) (Windows only)


    hwg_ShellExecute( cFile, cOperation, cParams, cDir, nFlag )


    hwg_GetLocaleInfo() (Windows only)


    Hwg_SetDlgResult( handle, nValue ) (Windows only)


    hwg_SetCapture( hWnd ) (Windows only)


    hwg_ReleaseCapture() (Windows only)


    hwg_CopyStringToClipboard( cString )


    hwg_GetClipboardText( hWnd )


    hwg_GetStockObject( nId ) (Windows only)


    hwg_LoWord( n )
    Функция извлекает младшее слово из данного 32-разрядного значения.
    • n - число, из которого надо извлечь результат;
    • Возвращаемое значение - младшее слово из переданного числа.

    hwg_HiWord( n )
    Функция извлекает старшее слово из данного 32-разрядного значения.
    • n - число, из которого надо извлечь результат;
    • Возвращаемое значение - старшее слово из переданного числа.

    hwg_BitOr( n1, n2 )
    hwg_BitAnd( n1, n2 )
    hwg_BitAndInverse( n1, n2 )
    hwg_SetBit( n, nBit )
    hwg_CheckBit( n, nBit )
    Битовые функции, аналогичные таким же функциям Harbour ( hb_bitand(),... ).


    hwg_Sin( n )
    hwg_Cos( n )
    Две математические функции.


    hwg_ClientToScreen( handle, x1, y1 ) (Windows only)


    hwg_ScreenToClient( handle, x1, y1 ) (Windows only)


    hwg_GetCursorPos() (Windows only)


    hwg_SetCursorPos( x, y ) (Windows only)


    hwg_WinExec( cCommand, nFlag ) (Windows only)


    hwg_GetKeyboardState( nState )
    Эта функция возвращает строку, которая позволяет определить, нажаты ли клавиши Ctrl, Shift или Alt. Она должна вызываться из обработчика событий, в GTK версии lParam должен передаваться как параметр nState.
    • nState - lParam (третий параметр в обработчике событий) - только для GTK версии;
    • Возвращаемое значение - строкa длиной 255 байт.

    hwg_Getkeystate( nKey ) (Windows only)


    hwg_GetKeyNameText( nCode ) (Windows only)


    hwg_Pts2Pix( nPoints [,hDC] ) (Windows only)


    hwg_GetWindowsDir() (Windows only)


    hwg_GetSystemDir() (Windows only)


    hwg_GetTempDir() (Windows only)


    hwg_Postquitmessage( nExitCode ) (Windows only)


    hwg_GetDesktopWidth()
    Возвращает ширину экрана в пикселах.


    hwg_GetDesktopHeight()
    Возвращает высоту экрана в пикселах.


    hwg_GetNextDlgTabItem ( parentHandle, handle, lNext ) (Windows only)
    Возвращает дескриптор следующего или предыдущего по порядку виджета в окне.
    • parentHandle - дескриптор родительского окна;
    • handle - дескриптор текущего виджета;
    • lNext - .T., если требуется следующий виджет, .F. - если предыдущий;
    • Возвращаемое значение - дескриптор следующего или предыдущего виджета.

    hwg_Sleep( n )


    hwg_SetScrollInfo( handle, nType, nRedraw, nHScrollPos , nPage, nHscrollMax ) (Windows only)


    hwg_GetScrollRange( handle, nType, @minPos, @maxPos ) (Windows only)


    hwg_SetScrollRange( handle, nType, minPos, maxPos ) (Windows only)


    hwg_GetScrollPos( handle, nType ) (Windows only)


    hwg_SetScrollPos( handle, nType, nPos ) (Windows only)


    hwg_ShowScrollBar( handle, nType, lShow ) (Windows only)


    hwg_ScrollWindow( handle, n1, n2 ) (Windows only)


    hwg_isCapslockActive() (Windows only)


    hwg_isNumlockActive() (Windows only)


    hwg_isScrolllockActive() (Windows only)


    hwg_CreateDirectory( cDirName ) (Windows only)


    hwg_RemoveDirectory( cDirName ) (Windows only)


    hwg_SetCurrentDirectory( cDirName ) (Windows only)


    hwg_DeleteFile( cFileName ) (Windows only)


    hwg_GetFileAttributes( cFileName ) (Windows only)


    hwg_SetFileAttributes( cFileName, nAttr ) (Windows only)


    hwg_GetComputerName() (Windows only)


    hwg_GetUserName( [@nLength] ) (Windows only)


    hwg_PtrToUlong( ptr )
    Преобразует переменную типа Pointer в целое число. Нужно в ряде случаев для обработки параметров системных сообщений.
    • ptr - переменная типа Pointer;
    • Возвращаемое значение - целое число.

    hwg_IsPtrEq( handle1, handle2 )
    Сравнивает два указателя, возвращает истину, если они равны.


    hwg_OutputDebugString( cText ) (Windows only)


    hwg_Getsystemmetrics( nCode ) (Windows only)


    hwg_GetBackBrush( handle ) (Windows only)


    hwg_LastKey() (Windows only)


    hwg_isWin7() (Windows only)


    hwg_ProcessRun( cCommand ) (Windows only)


    hwg_RunConsoleApp( cCommand [, cOutFile] )
    Запускает на исполнение консольную программу в синхронном режиме, дожидается результата.
    • cCommand - строка с командой: название исполняемого модуля и параметры;
    • cOutFile - необязательный параметр, имя файла куда записывается выходной поток программы;
    • Возвращаемое значение - целое число, код завершения.

    hwg_RunApp( cCommand [, nFlag] [, lAsync] )


    hwg_onAnchor( oWnd, wold, hold, wnew, hnew )


    hwg_redirOn


    hwg_redirOff


    hwg_Trace


    edi_utf8_Upper( cText )


    edi_utf8_Lower( cText )


    назад содержание вперед
    Команды   Классы