THtmlPort: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		### About
2	2
3	3		THtmlPort is a Lazarus/Free Pascal version of Dave Baldwin's HTML Components, including THtmlViewer, TFrameViewer and TFrameBrowser. The ported code retains full compatibility with Delphi.
4	4
5	5		The original unported source (version 9.45) is available from <http://www.pbear.com/>
6	6
7	7		For a browser implemented using this component one can see [[fpbrowser]].
8	8
9	9		### Screenshots
10	10
11		-	~~<img src="THtmlPort_Framedem_Carbon.jpg" title="FrameDem sample app using the Carbon widgetset" width="500" />~~
	11	+	![](/wiki-images/5/59/THtmlPort_Framedem_Carbon.jpg)
12	12
13		-	~~<img src="THtmlPort_Framedem_Win32.jpg" title="FrameDem sample app using the Win32 widgetset" width="500" />~~
	13	+	![](/wiki-images/e/eb/THtmlPort_Framedem_Win32.jpg)
14	14
15		-	~~<img src="THtmlPort_Framedem_GTK2.jpg" title="FrameDem sample app using the GTK2 widgetset" width="500" />~~
	15	+	![](/wiki-images/8/86/THtmlPort_Framedem_GTK2.jpg)
16	16
17	17		### Download
18	18
19	19		You can download the ported source using Subversion:
20	20
21	21		` svn co `[`https://svn.code.sf.net/p/lazarus-ccr/svn/components/thtmlport`](https://svn.code.sf.net/p/lazarus-ccr/svn/components/thtmlport)` [local dir]`
22	22
23	23		New download:
24	24
25	25		<https://github.com/BerndGabriel/HtmlViewer>
26	26
27	27		### License
28	28
29	29		The original Delphi code on which this port is based has been released by Dave Baldwin into the public domain. Additional code supplied with this port is released under the MPL 1.1 license.
30	30
31	31		### Installation
32	32
33	33		To install the HtmlComp package in Lazarus:
34	34
35	35		- Choose Package \\| Open package file, then select htmlcomp.lpk (in the package subfolder).
36	36		- Click Compile to compile the package.
37	37		- Click Compile a second time. A quirk in FPC \< 2.7.1 apparently make this extra compile necessary. (Q solution to this problem is to move htmlun2.pas before htmlgif1.pas in the package file list)
38	38		- Click Install to rebuild and relaunch Lazarus.
39	39
40	40		To compile a sample application that uses the HtmlComp package:
41	41
42	42		- Choose File \\| Open, then select framedem.lpi or htmldemo.lpi (both in the demo_src subfolder).
43	43		- Choose Run \\| Run to compile and run the sample app.
44	44
45	45		### Status
46	46
47	47		Win32 widgetset, GTK2 widgetset, Carbon widgetset: both FrameDem and HtmlDemo sample apps are working. Works good with Lazarus 1.0+.
48	48
49	49		### Contact
50	50
51	51		If you have fixes for any problems in the package, please contact Phil:
52	52
53	53		` MacPgmr (at) fastermac (dot) net`
54	54
55	55		### Known Issues
56	56
57	57		#### Carbon widgetset
58	58
59	59		- In FrameDem app, title and subtitle at top (readme2.htm) display in sans serif font even though style in demo.css specifies Times New Roman, which is a Mac font.
60	60
61	61		- In FrameDem app, Wingding characters (sample3.htm) are not correct.
62	62
63	63		- In FrameDem app, image files that are inlined in text (sample3.htm) or tables (properties.htm) do not display. This is accompanied by many errors outputted to the Console app window by the Carbon widgetset code. ==\> Note that raster operations are not implemented yet in Carbon widgetset, so some images display very rough looking.
64	64
65	65		- Vertical scroll bar thumb does not move all the way to bottom of scroll bar when window is scrolled all the way down.
66	66
67	67		- In FrameDem app, shelling to whatsnew.htm does not work since can't start second copy of app and app is not MDI.
68	68
69	69		- In FrameDem app, clicking Preview in Print dialog gives error that Copies is set to 0. Changing Copies to 1 allows Preview to proceed, but not much is shown. In HtmlDemo app, previewing works fairly well, although doesn't display quite as good as in app itself. With both apps, the second time Preview button is clicked, processing hangs displays preview of all pages, but pages 2+ are blank.
70	70
71	71		#### Win32 widgetset
72	72
73	73		- HtmlDemo sample app throws exception at startup / loads but does not display HTML files.
74	74
75	75		- FrameDem sample app sometimes fails to load samples3.htm when HTML Samples link is clicked; other times it loads fine.
76	76
77	77		- In FrameDem app, shelling to whatsnew.htm starts another copy of app okay, but nothing displayed. Same issue with starting FrameDem with a file other than demo.htm specified on command line.
78	78
79	79		- In Lazarus form designer, dropping THtmlViewer on form displays a scroll bar in the upper left corner of the control. Changing THtmlViewer's BorderStyle, for example, hides the scroll bar. Looks like a form designer bug.
80	80
81	81		#### GTK2 widgetset
82	82
83	83		- HtmlDemo sample app won't load anything / loads but does not display HTML files.
84	84
85	85		- FrameDem sample app throws exception in several places (for example, clicking Stylesheet Support link). In debugger, enter "break gdk_x_error" and run backtrace following exception to see where error is occurring.
86	86
87	87		- Font issues in FrameDem app. This may be due to inability to match font against Windows font that is specified in .css files. For example, no underlining or strikethrough, text in \<PRE\> tag is not indented properly, text looks too big in About box, etc.
88	88
89	89		- In FrameDem app, first two Wingding characters (sample3.htm) are not correct (probably a font matching issue).
90	90
91	91		- In FrameDem app, File \\| Printer Setup throws exception in /printers/unix/cupslcl.pas if selected before clicking in one of the frames. Clicking in a frame enables File \\| Print and once Printing dialog has been displayed, File \\| Printer Setup is okay.
92	92
93	93		- In both apps' Fonts dialog (Options \\| Default Font/Colors), the Font Name list will be empty if HasX was not defined when GTK2 was compiled (default on OS X; without HasX, EnumFontFamiliesEx is not implemented, meaning Screen.Fonts is empty list). But even if the list does contain fonts (HasX defined), clicking one blanks the example HTML (LoadAgain failing?).
94	94
95	95		- In FrameDem app, shelling to whatsnew.htm starts another copy of app okay and loads file, but no vertical scroll bar is displayed, although clicking on invisible scroll bar does scroll the window.
96	96
97	97		#### All widgetsets
98	98
99	99		- In the sample apps' Fonts dialog (Options \\| Default Font/Colors), the Font Color and Link Color areas are blank since a TColorGrid was used in the original Delphi apps. TColorGrid is not an LCL control and has been removed from the .lfm files.
100	100
101	101		- Preview has been disabled since this depends on TMetaFile, which is not part of LCL.
102	102
103	103		- Copying to clipboard does not yet work is basically functional but only on first copy (note also that GTK2 apparently does not support text/html clipboard format).
104	104
105	105		- Does not yet support 64-bit. ==\> Package should now compile, install, and compile and run sample apps okay with 64-bit compilers on Win64 and Linux64 (CPU64).
106	106
107	107		- No support for PNG image files (except on Windows - current support is still written for a Windows DLL).
108	108
109	109		### See Also
110	110
111	111		- [[Webbrowser]]
112	112
113	113		---
114	114		From the Free Pascal wiki, page "THtmlPort", as it stood on 2018-01-25 after a change by Alextp, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
115	115		Category: Components
116	116		Category: Lazarus-CCR

Back to history