2010-02-09 18:25 UTC-0800 Pritpal Bedi (pritpal@vouchcac.com)

+ contrib/hbide/docs
  + contrib/hbide/docs/idemainpage.html
  + contrib/hbide/docs/interfaceelements.html
  + contrib/hbide/docs/multiviews.html
    
  * contrib/hbide/resources/help.png

  * contrib/hbide/hbide.prg
  * contrib/hbide/ideactions.prg
  * contrib/hbide/idedocks.prg
  * contrib/hbide/ideobject.prg
    
    + Implemented basics of ib-build help mechanism.
      It is working in a limited manner and is scheduled to be 
      matured in next few days, at-least from operations 
      point-of-view. QtextBrowser() accepts a sub-set of 
      html commands and hence is very limited in appearnce.
      As we have decided against QtWebkit, this implementation
      may not look highly professional, will surely solve 
      our purpose. 

      If someone is willing to extend help in this direction,
      then following are the guidelines how you should design
      html page:
         1. Open Qt Creator
         2. Create a widget in the designer.
         3. Place a QTextBrowser control somewhere.
         4. Double-click within the control.
         5. A rich-text editing box will appear.
         6. Design the page.
         7. Click on the "Source" tab at the bottom.
         8. Select the whole source with Ctrl+A and copy with Ctrl+C.
         9. Create a .html file with notepad, paste the source, and save.

      The process is lengthy, but no other html editor solves our 
      purpose due to limited html tags availability in QTextBrowser.
This commit is contained in:
Pritpal Bedi
2010-02-10 02:35:23 +00:00
parent d35a1a4ecd
commit 0c4be0f362
9 changed files with 124 additions and 6 deletions

View File

@@ -17,6 +17,44 @@
past entries belonging to author(s): Viktor Szakats.
*/
2010-02-09 18:25 UTC-0800 Pritpal Bedi (pritpal@vouchcac.com)
+ contrib/hbide/docs
+ contrib/hbide/docs/idemainpage.html
+ contrib/hbide/docs/interfaceelements.html
+ contrib/hbide/docs/multiviews.html
* contrib/hbide/resources/help.png
* contrib/hbide/hbide.prg
* contrib/hbide/ideactions.prg
* contrib/hbide/idedocks.prg
* contrib/hbide/ideobject.prg
+ Implemented basics of ib-build help mechanism.
It is working in a limited manner and is scheduled to be
matured in next few days, at-least from operations
point-of-view. QtextBrowser() accepts a sub-set of
html commands and hence is very limited in appearnce.
As we have decided against QtWebkit, this implementation
may not look highly professional, will surely solve
our purpose.
If someone is willing to extend help in this direction,
then following are the guidelines how you should design
html page:
1. Open Qt Creator
2. Create a widget in the designer.
3. Place a QTextBrowser control somewhere.
4. Double-click within the control.
5. A rich-text editing box will appear.
6. Design the page.
7. Click on the "Source" tab at the bottom.
8. Select the whole source with Ctrl+A and copy with Ctrl+C.
9. Create a .html file with notepad, paste the source, and save.
The process is lengthy, but no other html editor solves our
purpose due to limited html tags availability in QTextBrowser.
2010-02-09 21:57 UTC+0100 Viktor Szakats (harbour.01 syenar.hu)
* include/hbdefs.h
+ Added more info on HB_SIZE/HB_ISIZ future plans.

View File

@@ -0,0 +1,16 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html><head><meta name="qrichtext" content="1" /><style type="text/css">
p, li { white-space: pre-wrap; }
</style></head><body style=" font-family:'MS Shell Dlg 2'; font-size:8.25pt; font-weight:400; font-style:normal;">
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:14pt; font-weight:600; text-decoration: underline;">hbIDE Help</span></p>
<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:14pt; font-weight:600; text-decoration: underline;"></p>
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">This effort may not bring desired results but hopefully solve some of the issues supporting the project.</span></p>
<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p>
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><a href="interfaceelements.html"><span style=" text-decoration: underline; color:#0000ff;">Interface Elements</span></a></p>
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><a href="multiviews.html"><span style=" text-decoration: underline; color:#0000ff;">Multi Views</span></a></p>
<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; text-decoration: underline; color:#0000ff;"></p>
<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p>
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">Please bear with me if things appear to be simple.</span></p>
<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p>
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">Pritpal Bedi</span></p>
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">_a_student_of_software_analysis_&amp;_design</span></p></body></html>

View File

@@ -0,0 +1,15 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html><head><meta name="qrichtext" content="1" /><style type="text/css">
p, li { white-space: pre-wrap; }
</style></head><body style=" font-family:'MS Shell Dlg 2'; font-size:8.25pt; font-weight:400; font-style:normal;">
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:14pt;">Interface Elements</span></p>
<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:14pt; font-weight:600; text-decoration: underline;"></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">hbIDE interface contains</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">1. Main Frame</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">2. Menubar</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">3. Toolbar</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">4. Statusbar</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">5. Left docking Project Tree</span></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">6. Left docking Tabs Tree</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p></body></html>

View File

@@ -0,0 +1,10 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html><head><meta name="qrichtext" content="1" /><style type="text/css">
p, li { white-space: pre-wrap; }
</style></head><body style=" font-family:'MS Shell Dlg 2'; font-size:8.25pt; font-weight:400; font-style:normal;">
<p align="center" style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:14pt;">Multi Views</span></p>
<p align="center" style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:14pt; font-weight:600; text-decoration: underline;"></p>
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-size:8pt;">hbIDE interface provides multiple views to organize your sources in a convenient way. The creation of a panel is a few clicks away. Switching is even simple.</span></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; font-size:8pt;"></p></body></html>

View File

@@ -121,6 +121,7 @@ CLASS HbIde
DATA oThemes
DATA oFindInFiles
DATA oDockFind
DATA oHelp
DATA oUI
@@ -152,6 +153,7 @@ CLASS HbIde
DATA qFontWrkProject
DATA qBrushWrkProject
DATA qProcess
DATA qHelpBrw
ACCESS oCurEditor INLINE ::oEM:getEditorCurrent()
ACCESS qCurEdit INLINE ::oEM:getEditCurrent()
@@ -309,8 +311,7 @@ METHOD HbIde:create( cProjIni )
::oAC:buildToolBar()
/* Main Menu */
::oAC:buildMainMenu()
/* StatusBar */
// ::oDK:buildStatusBar()
/* Docking Widgets */
::oDK:buildDockWidgets()
@@ -518,7 +519,9 @@ METHOD HbIde:execAction( cKey )
CASE "ToggleFuncList"
::execWindowsAction( cKey )
EXIT
CASE "Help"
::oHelp:show()
EXIT
ENDSWITCH
::manageFocusInEditor()
@@ -610,8 +613,6 @@ METHOD HbIde:execEditorAction( cKey )
EXIT
CASE "MatchPairs"
//
//::oDockFind:show()
::oStackedWidget:oWidget:setCurrentIndex( iif( ::oStackedWidget:oWidget:currentIndex() == 1, 0, 1 ) )
EXIT
CASE "InsertSeparator"
::oEM:insertSeparator()

View File

@@ -206,6 +206,7 @@ METHOD IdeActions:loadActions()
aadd( aAct, { "TB_ZoomIn" , "ZoomIn" , "zoomin" , "" , "No", "Yes" } )
aadd( aAct, { "TB_ZoomOut" , "ZoomOut" , "zoomout" , "" , "No", "Yes" } )
//
aadd( aAct, { "Help" , "~Help" , "help" , "F1" , "No", "Yes" } )
aadd( aAct, { "Exit" , "E~xit" , "exit" , "Sh+^W", "No", "Yes" } )
aadd( aAct, { "New" , "~Source" , "new" , "^N" , "No", "Yes" } )
aadd( aAct, { "Open" , "~Open" , "open" , "^O" , "No", "Yes" } )
@@ -318,6 +319,7 @@ METHOD IdeActions:buildToolBar()
oTBar:buttonClick := {|oButton| ::oIde:execAction( oButton:key ) }
oTBar:addItem( ::getAction( "TB_Exit" ), , , , , , "Exit" )
oTBar:addItem( ::getAction( "Help" ), , , , , , "Help" )
oTBar:addItem( , , , , , nSep )
oTBar:addItem( ::getAction( "TB_New" ), , , , , , "New" )
oTBar:addItem( ::getAction( "TB_Open" ), , , , , , "Open" )

View File

@@ -81,6 +81,7 @@ CLASS IdeDocks INHERIT IdeObject
METHOD destroy()
METHOD execEvent( nMode, p )
METHOD setView( cView )
METHOD buildHelpWidget()
METHOD buildDialog()
METHOD buildViewWidget()
METHOD buildStackedWidget()
@@ -296,7 +297,8 @@ METHOD IdeDocks:buildDockWidgets()
::buildCompileResults()
::buildLinkResults()
::buildOutputResults()
//::buildFindInFiles()
* ::buildFindInFiles()
::buildHelpWidget()
::oDlg:oWidget:tabifyDockWidget( ::oDockB:oWidget , ::oDockB1:oWidget )
::oDlg:oWidget:tabifyDockWidget( ::oDockB1:oWidget, ::oDockB2:oWidget )
@@ -432,6 +434,38 @@ METHOD IdeDocks:buildFuncList()
/*----------------------------------------------------------------------*/
METHOD IdeDocks:buildHelpWidget()
STATIC qUrl
IF empty( qUrl )
qUrl := QUrl():new( "docs/idemainpage.html" )
ENDIF
::oIde:oHelp := XbpWindow():new()
::oHelp:oWidget := QDockWidget():new( ::oDlg:oWidget )
::oHelp:oWidget:setObjectName( "dockHelp" )
::oDlg:addChild( ::oHelp )
::oHelp:oWidget:setFeatures( QDockWidget_DockWidgetClosable )
::oHelp:oWidget:setAllowedAreas( Qt_RightDockWidgetArea )
::oHelp:oWidget:setWindowTitle( "hbIDE Help" )
::oHelp:oWidget:setFocusPolicy( Qt_NoFocus )
::oIde:qHelpBrw := QTextBrowser():new( ::oHelp:oWidget )
::oIde:qHelpBrw:show()
::oIde:qHelpBrw:setOpenExternalLinks( .t. )
::qHelpBrw:setSource( qUrl )
::oHelp:oWidget:setWidget( ::oIde:qHelpBrw )
// ::oHelp:connect( ::qHelpBrw )
::oDlg:oWidget:addDockWidget_1( Qt_RightDockWidgetArea, ::oHelp:oWidget, Qt_Horizontal )
::oHelp:hide()
RETURN Self
/*----------------------------------------------------------------------*/
METHOD IdeDocks:buildCompileResults()
::oIde:oDockB := XbpWindow():new()

View File

@@ -111,6 +111,7 @@ CLASS IdeObject
ACCESS oTabParent INLINE ::oIde:oTabParent
ACCESS qBrushWrkProject INLINE ::oIde:qBrushWrkProject
ACCESS qViewsCombo INLINE ::oIde:qViewsCombo
ACCESS qHelpBrw INLINE ::oIde:qHelpBrw
ACCESS cWrkProject INLINE ::oIde:cWrkProject
ACCESS cWrkTheme INLINE ::oIde:cWrkTheme
@@ -156,6 +157,7 @@ CLASS IdeObject
ACCESS oOutputResult INLINE ::oIde:oOutputResult
ACCESS oStackedWidget INLINE ::oIde:oStackedWidget
ACCESS oFrame INLINE ::oIde:oFrame
ACCESS oHelp INLINE ::oIde:oHelp
ACCESS lProjTreeVisible INLINE ::oIde:lProjTreeVisible
ACCESS lDockRVisible INLINE ::oIde:lDockRVisible

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 KiB