简单超文本说明文档.docx

上传人:b****6 文档编号:7616618 上传时间:2023-01-25 格式:DOCX 页数:58 大小:35.05KB
下载 相关 举报
简单超文本说明文档.docx_第1页
第1页 / 共58页
简单超文本说明文档.docx_第2页
第2页 / 共58页
简单超文本说明文档.docx_第3页
第3页 / 共58页
简单超文本说明文档.docx_第4页
第4页 / 共58页
简单超文本说明文档.docx_第5页
第5页 / 共58页
点击查看更多>>
下载资源
资源描述

简单超文本说明文档.docx

《简单超文本说明文档.docx》由会员分享,可在线阅读,更多相关《简单超文本说明文档.docx(58页珍藏版)》请在冰豆网上搜索。

简单超文本说明文档.docx

简单超文本说明文档

“汽球提示支持库”所支持的HTML标记(译者注:

原文没有标题,乃译者私自添加:

作者:

pustovoyt@mail.ru

翻译:

大连大有吴涛易语言软件有限公司,

service@,

2005年5月

译者注:

1.本公司已将CPPTooltip及CPPHtmlDrawer封装到易语言支持库“扩展界面支持库五”中,分别对应“汽球提示框”“简单超文本框”两个控件。

翻译此文的初衷即令其作为该支持库的说明文档,因而易语言用户是本译文的主要对象,当然非易语言用户也可参考。

为了保证译文完整,一些在易语言中未得到支持的特性,也仍然保留。

2.译文中多处注明“易语言不支持”,更明确地说法应该是“易语言‘扩展界面支持库五’的当前版本不支持”。

3.“易语言”是一款中文编程语言,集成开发环境,支持可视化、跨平台编程。

功能强大,值得一试。

4.同一目录下有原文英文原版,请参考。

翻译不当之处,请作者及阅者海涵。

 

∙怎样在你的程序中使用CPPHtmlDrawer

∙CPPHtmlDrawer类方法列表(ClassMembers)

∙所支持的HTML标记(Tags)

o-超链接

o-粗体

o-基准线对齐

o-较大字体

o-BMP图片(易语言不支持)

o-底对齐

o
-换行

o

-居中

o-显示代码段

o-强调,通过显示为斜体,类似于

o-字体

o

-
-标题

o


-水平线

o-斜体

o-图标(易语言不支持)

o-图片组(易语言不完全支持)

o-左对齐

o-垂直居中,类似于

o

-预定义格式

o-右对齐

o-删除线,等效于

o-较小字体

o-可容纳其它HTML标记

o-删除线

o-字符串(易语言不支持)

o-下标

o-上标

o-TAB

o

-表格

o

-表格行

o-垂直对齐,类似于

∙颜色表(ColorTable)

∙层叠样式表规范(CSSStylesSpecification)

∙层叠样式表长度单位(CSSLengthUnits)

∙历史(History)

∙联系作者(ContactAuthor)

 

怎样在你的程序中使用CPPHtmlDrawer

(本小节内容,易语言用户无需关心。

要在你的程序中使用HtmlDrawer,首先应将以下文件加入到工程中:

∙PPHtmlDrawer.h

∙PPHtmlDrawer.cpp

∙PPDrawManager.h

∙PPDrawManager.cpp

∙CeXDib.h,CeXDib.cpp(感谢DavidePizzolato和DavideCalabro.这个类用来显示特殊效果的窗口背景.)

如果在PPDrawManager.h定义了USE_SHADE宏:

#defineUSE_SHADE

就可以使用扩展背景效果(由DavidePizzolato和DavideCalabro实现)。

创建CPPHtmlDrawer对象

包含(Include)头文件PPHtmlDrawer.h,然后创建一个类型为CPPHtmlDrawer的成员变量:

CPPHtmlDrawerm_html_drawer;

 

怎样使用CPPHtmlDrawer对象

创建一个CPPHtmlDrawer对象(创建方法参考前面介绍),然后:

∙Ifyoufrequentlyusedrawingsametextthenthebetterwaytousepreparationoftheoutput(PrepareOutputmethod)andthentooutputthepreparedtextwithDrawPreparedOutputmethod.如果需要频繁绘制同一文本,最好的选择是采用输出缓存(使用PrepareOutput()方法准备缓存,使用DrawPreparedOutput()方法将缓存内容输出)。

Thesametechniqueisconvenientatusageofeffectsatdrawingimagesandhyperlinks.

∙IfdrawingspeedisindifferentforyouthenbetterwaytotakeadvantageofDrawmethodforautomatictext'spreparationforoutputandoutputhis.如果不介意绘制效率,可直接使用Draw()方法。

∙IfyoudonotacceptstylesoftheoutputtextbydefaulttakeadvantageofSetCssStylesmethodforchangeofthem.如果认为默认的Style不够好,可使用SetCssStyles()方法设置CSS。

∙IfyouusehyperlinksitisnecessarytocustomizeOnLButtonDownandOnSetCursorhandlers.如果使用了超级链接,则需要重载OnLButtonDown和OnSetCursor。

∙IfyouuseeffectsintheHTMLtextthenintheparentclassisnecessarytoprocessthecallbackmessagesettedbySetCallbackRepaintmethod.AndinthishandleryoumustrepaintaHTMLtext.如果要自行绘制HTML,请使用SetCallbackRepaint()方法设置重画回调函数,该回调函数会在需要绘制的时候被调用,你可在其中做想做的事情。

∙Ifyouusethehyperlinkssendingthemessagetotheparentclass()thenintheparentclassisnecessarytoprocessthecallbackmessagesettedbySetCallbackHyperlinkmethod.如果要使用自定义超链接(…,易语言中也可使用…),需通过SetCallbackHyperlink()方法设置超链接回调函数,以便在自定义超链接被单击时获得通知。

 

CPPHtmlDrawer类方法列表

(本小节内容,易语言用户无需关心。

构造函数

 

CPPHtmlDrawer

构造函数

 

层叠样式表

 

SetCssStyles

设置层叠样式表CSS(用于控制显示风格)

GetCssStyles

读取层叠样式表CSS

 

绘图

 

PrepareOutput

创建HTML文本输出缓存

DrawPreparedOutput

将已缓存的HTML文本输出到指定DC

Draw

在指定DC上绘制HTML文本

SetBorder

设置边框

HideBorder

隐藏边框

 

超链接鼠标指针

 

SetHyperlinkCursor

设置超链接鼠标指针(当鼠标移动到超链接文本上方时的鼠标指针)

GetHyperlinkCursor

取超链接鼠标指针

 

回调函数

 

SetCallbackHyperlink

设置自定义超链接被单击时的消息接收机制。

SetCallbackRepaint

设置重画时的消息接收机制。

 

资源库(ResourceDLL)

 

LoadResourceDll

载入资源库

SetResourceDll

设置(已事先载入的)资源库句柄

 

其它

 

SetImageList

设置图片组

SetImageShadow

设置图片阴影

EnableEscapeSequences

设置允许使用转义字符\n和\tEnablestheescapesequences('\n'and'\t').

OnLButtonDown

在鼠标左键按下时被调用,可重载之。

OnSetCursor

当需要设置鼠标指针时被调用,可重载之。

 

版本

 

GetVersionI

取版本,返回短整数型(short)

GetVersionC

取版本,返回文本

 

CPPHtmlDrawer:

:

CPPHtmlDrawer

CPPHtmlDrawer();

说明

构造函数

 

CPPHtmlDrawer:

:

SetCssStyles

voidSetCssStyles(LPCTSTRlpszCssString/*=NULL*/);

voidSetCssStyles(DWORDdwIdCssString,LPCTSTRlpszPathDll/*=NULL*/);

参数

∙lpszCssString–CSS文本,如果为NULL表示设置默认CSS文本。

∙dwIdCssString–CSS文本的资源ID

∙lpszPathDll–资源库(resourceDLL)的路径。

如果为NULL,将从本程序资源中读取dwIdCssString。

说明

设置HTML文本所使用的CSS(层叠样式表),用于控制HTML的外观显示。

例如以下CSS文本为

标记设置了新的外观:

h2{font-size:

13pt;color:

#ff9900;font-family:

Verdana;font-weight:

bold}

a:

link{text-decoration:

none;color:

blue}

a:

hover{text-decoration:

underline;color:

red}

默认的CSS文本如下:

body{font-size:

10pt;color:

black;font-family:

Verdana}

p{font-size:

10pt;color:

black;font-family:

Verdana;font-weight:

bold}

h1{font-size:

14pt;color:

black;font-family:

Verdana;font-weight:

bold}

h2{font-size:

13pt;color:

#ff9900;font-family:

Verdana;font-weight:

bold}

h3{font-size:

12pt;color:

#ff9900;font-family:

Arial;font-weight:

bold}

h4{font-size:

10pt;color:

black;font-family:

Verdana;font-weight:

bold}

h5{font-size:

9pt;color:

#ff9900;font-family:

Verdana;font-weight:

bold}

h6{font-size:

65%;color:

#626262;font-family:

Verdana;font-weight:

normal}

pre{font-size:

9pt;font-family:

"Courier";background-color:

#fbedbb}

code{color:

#990000;font-family:

Arial}

a:

link{text-decoration:

none;color:

blue}

a:

hover{text-decoration:

underline;color:

blue}

sub{font-size:

65%;vertical-align:

bottom}

sup{font-size:

65%;vertical-align:

top}

big{font-size:

125%}

small{font-size:

75%}

.cpp-comment{color:

green;font-style:

italic}

 

CPPHtmlDrawer:

:

GetCssStyles

LPCTSTRGetCssStyles();

返回值

当前CSS文本

说明

取当前的CSS文本。

 

CPPHtmlDrawer:

:

PrepareOutput

CSizePrepareOutput(CDC*pDC,CString&strHtml);

参数

∙pDC–指向输出设备的CDC指针。

本方法并不向输出设置输出内容,仅通过该参数获取必要的信息。

∙strHtml–欲创建输出缓存的HTML文本。

返回值

返回完整输出指定HTML文本所需区域大小。

说明

本方法创建HTML文本的输出缓存,并计算输出全部HTML所需区域大小。

当实际绘制HTML时,输出设备应至少提供不小于此区域的绘图区域(否则无法完整显示)。

 

CPPHtmlDrawer:

:

DrawPreparedOutput

voidDrawPreparedOutput(CDC*pDC,CString&strHtml,CRectrect);

参数

∙pDC–指向输出设备的CDC指针

∙strHtml–HTML文本

∙rect–输出设备中用于容纳HTML文本绘图的一个矩形区域。

该矩形区域的大小不应小于PrepareOutput()方法的返回值。

说明

将输出缓存输出到pDC中。

注意必须在PrepareOutput()方法之后调用本方法。

 

CPPHtmlDrawer:

:

Draw

voidDraw(CDC*pDC,CString&strHtml,CPointptTopLeft);

参数

∙pDC-指向输出设备的CDC指针

∙strHtml-HTML文本

∙ptTopLeft–为pDC区域中的一个点,实际输出时,将以此点作为绘制区域的左上角。

说明

直接绘制HTML文本(无缓存)。

 

CPPHtmlDrawer:

:

SetBorder

voidSetBorder(COLORREFcolor,intnWidth/*=1*/,intnHeight/*=1*/);

voidSetBorder(HBRUSHhbr,intnWidth/*=1*/,intnHeight/*=1*/);

参数

∙color–边线颜色

∙hbr–边线刷子

∙nWidth–垂直边线宽度

∙nHeight–水平边线高度

说明

设置边线颜色及宽度

 

CPPHtmlDrawer:

:

HideBorder

voidHideBorder();

说明

隐藏边线

 

CPPHtmlDrawer:

:

SetHyperlinkCursor

voidSetHyperlinkCursor(HCURSORhCursor/*=NULL*/);

参数

∙hCursor–鼠标指针句柄。

如果为NULL,将使用“手形(HAND)”指针。

说明

仅当参数指定的鼠标指针与当前鼠标指针不同时,新的鼠标指针才被设置,否则函数直接返回。

当鼠标移动到超链接上方时将显示已设置的鼠标指针。

 

CPPHtmlDrawer:

:

GetHyperlinkCursor

HCURSORGetHyperlinkCursor()const;

返回值

返回当前的超链接鼠标指针句柄

说明

返回当前的超链接鼠标指针句柄

 

CPPHtmlDrawer:

:

SetImageList

voidSetImageList(UINTnIdBitmap,intcx,intcy,intnCount,COLORREFcrMask/*=RGB(255,0,255)*/);

voidSetImageList(HBITMAPhBitmap,intcx,intcy,intnCount,COLORREFcrMask/*=RGB(255,0,255)*/);

参数

∙nIdBitmap–图片资源ID

∙hBitmap–图片句柄

∙cx–图片组中单一图片的宽度

∙cy–图片组中单一图片的高度

∙nCount–图片组中图片的初始个数

∙crMask–透明色

说明

设置图片组。

(可在HTML文本中使用标记以显示图片组中的图片。

 

CPPHtmlDrawer:

:

SetCallbackHyperlink

voidSetCallbackHyperlink(HWNDhWnd,UINTnMessage,LPARAMlParam/*=0*/);

参数

∙hWnd–指定接受消息的窗口句柄

∙nMessage–消息标识

∙lParam–用户自定义值

说明

设置自定义超链接被单击时的消息接收机制。

当自定义超链接()被单击时,CPPHtmlDrawer将向hWnd窗口发送nMessage消息,消息组成如下:

消息组成:

Msg–预定义消息标识(由本方法的nMessage参数指定)

wParam–文本指针,指向标记中msg的属性值

lParam–用户自定义值

CPPHtmlDrawer:

:

SetCallbackRepaint

voidSetCallbackRepaint(HWNDhWnd,UINTnMessage,LPARAMlParam/*=0*/);

参数

∙hWnd-指定接受消息的窗口句柄

∙nMessage-消息标识

∙lParam-用户自定义值

说明

设置重画时的消息接收机制。

当需要重画时,CPPHtmlDrawer将向hWnd窗口发送nMessage消息,消息组成类似于SetCallbackHyperlink()方法中的介绍。

CPPHtmlDrawerOverview|ClassMembers|Styles

 

CPPHtmlDrawer:

:

LoadResourceDll

voidLoadResourceDll(LPCTSTRlpszPathDll,DWORDdwFlags/*=0*/);

参数

∙lpszPathDll-Pointertoanull-terminatedstringthatnamestheresourceDLL.NULLifresourceDLLisn'tavailable.

∙dwFlags-Specifiestheactiontotakewhenloadingthemodule.Look:

:

LoadLibraryExAPIfunctionformoreinformation.

说明

ItisamethodloadsresourceDLLfortheiruseintags,and.

 

CPPHtmlDrawer:

:

SetResourceDll

voidSetResourceDll(HINSTANCEhInstDll/*=NULL*/);

参数

∙hInstDll-aninstanceoftheresourceDLL.NULLifresourceDLLisn'tavailable.

说明

ItisamethodsetstheresourceDLLfortheiruseintags,and.

CPPHtmlDrawerOverview|ClassMembers|Styles

 

CPPHtmlDrawer:

:

SetImageShadow

voidSetImageShadow(intnTypeShadow/*=SHADOW_NONE*/);

voidSetImageShadow(intnTypeShadow,COLORREFcolor);

参数

∙nTypeShadow-Thetypeoftheshadow.Thevaluesareasfollows:

SHADOW_NONE

SHADOW_NORMAL

SHADOW_GRADIENT

∙color-Graycolorforthedarknesscoloroftheshadow.Thebrightnessfortheshadow=GetRValue()/255

说明

Callthisfunctiontodisplaytheshadowforanimage.Theshadowhastherightandbottomimages.

CPPHtmlDrawerOverview|ClassMembers|Styles

 

CPPHtmlDrawer:

:

EnableEscapeSequences

voidEnableEscapeSequences(BOOLbEnable/*=TRUE*/);

参数

∙bEnable-IfTRUEthatwordprocessorwillprocesscharsymbolslessthen0x20code(For例如:

\nand\t).IfFALSEthenwordprocessorwillignoreit.

说明

CallthismethodtocustomizeusageoftheescapesequencesintheHTMLtext.

CPPHtmlDrawerOverview|ClassMembers|Styles

 

CPPHtmlDrawer:

:

OnLButtonDown

voidOnLButtonDown(CPoint&ptClient);

参数

∙ptClient-Specifiesthex-andy-coordinateo

展开阅读全文
相关搜索

当前位置:首页 > 工程科技 > 机械仪表

copyright@ 2008-2022 冰豆网网站版权所有

经营许可证编号:鄂ICP备2022015515号-1

-表格列

o-顶对齐

o