UiEdit类参考

#include <UiEdit.h>

继承自UiWin及IUiMovingBarListener。

所有成员的列表。

公有成员
void	AddChar (TCHAR ch)
	在当前光标位置添加一个字符
void	AddCommandGlyph (Glyph *pg)
void	AddImage (CMzString sImagePath)
	添加图片
void	AdjustRect ()
virtual int	CalcContentHeight (int nRow, int nRowCount)
	计算文本框的内容高度
virtual int	CalcContentHeight ()
	计算文本框的内容高度
virtual int	CalcContentTopPosV ()
	计算（返回）控件的内容竖直方向的位置
void	CalcCoordByRowCol (size_t nRow, size_t nCol, int *xPos, int *yPos)
void	CalcRowColByCoord (int xPos, int yPos, __out size_t *nRow, __out size_t *nCol)
	根据指定坐标算出光标应在的行和列，但不重设光标
virtual int	CalRowNumber (int yPos)
void	Clear ()
	清空文本框的内容
void	ClearMapFaceInfo ()
void	CreateCommand (UINT uFlags)
void	EnableAutoOpenSip (bool bEnable)
void	EnableCopy (bool bEnable)
void	EnableGridlines (bool bEnable)
	启用默认表格线
void	EnableInsideScroll (bool bEnable)
	设置内部滚动
void	EnableRichTextFormat (bool bEnable)
	是否使文字呈现多样化。
virtual MZFC_INLINE void	EnableScrollableParent (bool bEnable)
	设置当鼠标拖动时，是否通知其所在的可滚动容器
void	EnableSimpleCopy (bool bEnable)
void	EnableUndo (bool bEnable)
void	EnableZoomIn (bool bEnable)
	设置编辑器是否支持放大镜
DWORD	GetAlignMode ()
	获取图元的排版样式
int	GetBottomInvalid ()
	获取编辑框的底部无效区域
void	GetCaretPos (size_t *nRow=0, size_t *nCol=0)
	获取当前光标位置
size_t	GetCharCount (size_t nBeginRow, size_t nBeginCol, size_t nEndRow, size_t nEndCol)
size_t	GetCharCount ()
	统计字符数,表情按照所对应的字符统计
COLORREF	GetColorBg ()
DWORD	GetComposeCount ()
	启用多线程分行时, 获得当前完成分行的字符个数
size_t	GetCurDisplyRow_First ()
size_t	GetCurDisplyRow_Last ()
MZFC_INLINE int	GetEditBgType ()
	获取编辑控件的背景类型
BOOL	GetExtendedProperty_UiEdit (int nPropertyType, void *pValue, int nBufSize)
	获取或设置对象的扩展属性值
size_t	GetFaceCount ()
CFaceInfo *	GetFaceInfo (LPCWSTR faceStr)
Glyph_Face *	GetFirstFace (size_t nRow, size_t nCol, __out int *nPos)
	以指定位置为0点,获得第一个表情。并返回所在位置
size_t	GetFirtCharPos (__out CMzString &lineStr)
	获取当前屏幕显示的第一个字符的位置
COLORREF	GetFontColor ()
bool	GetFontItalic ()
int	GetFontSize ()
bool	GetFontUnderline ()
LONG	GetFontWeight ()
Glyph *	GetGlyph (size_t row, size_t col)
	获取指定位置的图元对象
size_t	GetGlyphCount (size_t nBeginRow, size_t nBeginCol, size_t nEndRow, size_t nEndCol)
size_t	GetGlyphCount ()
size_t	GetImageCount (size_t nRow, int nRowCount)
	计算从第nRow行开始,nRowCount行的图片个数
CMzString	GetImagePath (int nPos)
	获得指定位置的图片路径
CMzString	GetImagePath (size_t nRow, size_t nCol)
	获得指定位置的图片路径
bool	GetImagePos (int nPos, size_t &nRow, size_t &nCol)
	获得图片位置
int	GetImageSize ()
	获得当前图片尺寸
int	GetInitHeight ()
	返回编辑框的最小高度。仅设置外部滚动时此属性生效
int	GetLeftInvalid ()
	获取编辑器左边的无效区域宽度
int	GetLingSpace ()
	获取行距
UINT	GetLinkMode ()
int	GetRightInvalid ()
	获取编辑器右边的无效区域宽度
size_t	GetRowCount ()
	获取文本的总行数
void	GetSelectPos (size_t &nBeginRow, size_t &nBeginCol, size_t &nEndRow, size_t &nEndCol)
	获得被选中内容的起始位置与结束位置
DWORD	GetShowCount ()
int	GetShowHeight ()
bool	GetShowState ()
virtual CMzString &	GetText ()
	获取编辑器字符串.
int	GetTopInvalid ()
	获取编辑器右边的无效区域宽度
void	GoToCharPos (int pos)
bool	HasComposition ()
	是否含有未完成联想的组合字符串
void	InitMapFaceInfo ()
	[[ 自定义表情图片功能
void	InsertGlyph (Glyph *pg, size_t nRow, size_t nCol, DWORD flag=UIEDIT_DEFAULT_GLYPH)
void	InsertString (WCHAR *pStr, size_t nRow, size_t nCol)
	在指定位置添加一个字符串
void	InsertString (WCHAR *pStr)
	在当前光标位置添加一个字符串
bool	IsEmpty ()
	判断文本框是否为空
bool	isEnableAutoOpenSip ()
bool	IsEnableCopy ()
bool	IsFinishCompose ()
	启用多线程分行时, 查看是否完成分行
bool	IsGridlinesEnabled ()
	是否启用了表格线
bool	IsInsideScroll ()
	查看内部是否可以滚动
bool	IsOpenFace ()
	查看编辑器是否支持表情识别
bool	IsReadOnly ()
	编辑框是否只读
bool	IsRichTextFormat ()
	编辑框是否支持丰富的文字排版,表情识别,图片功能
bool	IsUndoEnabled ()
virtual void	MoveTopPos (int nOffset)
	移动内容顶部位置
virtual void	OnClick (size_t nIndex)
void	OpenFace (bool bOpenFace)
	设置编辑器是否支持表情识别
void	Redo ()
void	RemoveChar (size_t nRow, size_t nCol)
	删除指定光标位置的字符
size_t	RemoveString (size_t nRow, size_t nCol, size_t nCount)
virtual void	ScrollStart (double fScrollSpeed)
	开始滚动
virtual void	ScrollStop ()
	结束滚动
virtual void	ScrollTo (int nScrollToType=UI_SCROLLTO_TOP, int nDstTopPos=0, bool bAnimate=true)
	滚动控件内容至某个位置
bool	ScrollToNextScreen ()
	滚动到下一屏,编辑框内部滚动时有效
bool	ScrollToPreviousScreen ()
	滚动到上一屏,编辑框内部滚动时有效
Glyph_Face *	SearchFace (__in GlyphRow *pGlyph, size_t nEndPos)
void	SetAlignMode (DWORD dwMode)
	设置图元排列方式
void	SetBottomInvalid (int nInvalid)
	设置编辑框的底部无效区域
void	SetCaretPos (size_t nRow, size_t nCol)
	指定当前光标位置
void	SetColorBg (COLORREF crBgColor)
void	SetEditBgType (int nEditBgType)
	设置编辑器背景类型
BOOL	SetExtendedProperty_UiEdit (int nPropertyType, void *pValue, int nBufSize)
	获取或设置对象的扩展属性值
void	SetFontColor (COLORREF clrFont)
void	SetFontItalic (bool bFontItalic)
void	SetFontSize (int nFontSize)
void	SetFontUnderline (bool bFontUnderline)
void	SetFontWeight (LONG lFontWeight)
void	SetImageSize (int nImageSize)
	设置显示图片高度尺寸，并根据原尺寸比例缩放图片
void	SetInitHeight (int nHeight)
	编辑框的最小高度。仅设置外部滚动时此属性生效
void	SetLeftInvalid (int offset)
	设置编辑器左边的无效区域宽度
void	SetLineSpace (int nLineSpace)
	设置行距
void	SetLinkMode (UINT linkMode)
virtual void	SetMaxChar (int n)
	设置最大的字符数
virtual void	SetPos (int x, int y, int w, int h, UINT flags=0)
	设置控件的位置
void	SetReadOnly (bool status)
	设置只读
void	SetRightInvalid (int nInvalid)
	设置编辑器右边的无效区域宽度
void	SetShowCount (DWORD charCount)
void	SetShowHeight (int height)
void	SetSipMode (DWORD dwMode, DWORD dwSipOffset=0xffffffff)
	设置编辑器输入法模式
void	SetSipModeEx (DWORD dwMode, DWORD dwSipOffset=0xffffffff, LPCTSTR strSip=NULL)
virtual void	SetText (LPCTSTR text, bool isMultiThread=false)
	设置编辑器字符串.
virtual void	SetTextColor (COLORREF cr)
	设置文本颜色
virtual void	SetTextSize (int nFontSize)
void	SetTip (LPCTSTR text)
	设置提示文字，该文字在有输入后消失
void	SetTopInvalid (int nInvalid)
	设置编辑器右边的无效区域宽度
virtual void	SetTopPos (int nTopPos)
	设置内容顶部位置
void	ShowCaret ()
	根据当前光标的行列位置,重画光标
void	ShowCopyButton (bool bShow)
virtual void	StartSelect (size_t nRow, size_t nCol, int nCount)
bool	StopComposeThread (DWORD dwMilliseconds)
void	SwitchSipMode (DWORD dwMode, DWORD dwSipOffset=0xffffffff)
	UiEdit (void)
void	Undo ()
void	UpdateAlignMode (DWORD dwMode, size_t nRow)
	以某一行所在的段为单位，更新此段的排列方式
void	UpdateFace ()
	检查当前文本框内容，并根据表情识别功能是否打开的情况，更新文本框内容
void	UpdateFaceRes (LPCWSTR faceStr, int resId)
	增加或替换表情资源
void	UpdateFaceRes (LPCWSTR faceStr, CMzString resPath)
	增加或替换表情资源
void	UpdateFontColor (COLORREF clrFont, size_t nBeginRow, size_t nBeginCol, size_t nEndRow, size_t nEndCol)
void	UpdateFontSize (int nFontSize, size_t nBeginRow, size_t nBeginCol, size_t nEndRow, size_t nEndCol)
virtual	~UiEdit (void)
静态公有成员
static void CALLBACK	OnFinish (PVOID pParam, int nDiff)
static void CALLBACK	OnShow (PVOID pParam, int nDiff)
保护成员
void	CalcTooltipsPos (size_t beginRow, size_t beginCol, size_t endRow, size_t endCol, __out int *pXPos=NULL, __out int *pYPos=NULL, __out POINT *pPtArrow=NULL)
virtual int	ClearComposition ()
virtual int	OnChar (TCHAR chCharCode, LPARAM lKeyData)
	当有键盘字符输入时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual void	OnCopy ()
	当控件WM_COPY消息时，此函数会被调用
virtual void	OnCut ()
	当控件WM_CUT消息时，此函数会被调用
virtual void	OnFocused (UiWin *pWinPrev)
virtual int	OnImeComposition (BOOL fFlags)
	当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual int	OnKeyDown (int nVirtKey, DWORD lKeyData)
	当有键盘按键按下时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual int	OnLButtonDown (UINT fwKeys, int xPos, int yPos)
	mouse message handlers
virtual int	OnLButtonUp (UINT fwKeys, int xPos, int yPos)
	当控件被左键放开时，此函数会被调用.
virtual void	OnLostFocus (UiWin *pWinNext)
virtual int	OnMouseMove (UINT fwKeys, int xPos, int yPos)
	当控件上鼠标移动时，此函数会被调用.
virtual void	OnParentScrollStart ()
virtual void	OnParentScrollStop ()
virtual void	OnPaste ()
	当控件WM_PASTE消息时，此函数会被调用
virtual void	OnPressedHoldTimeup ()
	当 pressed-hold 结束时，此函数会被调用，可重载以自定义处理
virtual int	OnTimer (UINT_PTR nIDEvent)
	当Timer到达时，此函数会被调用.
virtual void	OnWmA4M8 (WPARAM wParam, WPARAM lParam)
	当控件WM_A4M8消息时，此函数会被调用
virtual void	PaintWin (HDC hdcDst, RECT *prcWin, RECT *prcUpdate)
	绘制控件
virtual void	PaintWinBg (HDC hdc, RECT *prcWin, RECT *prcUpdate)

---

构造及析构函数文档

UiEdit::UiEdit

(

void

)

virtual UiEdit::~UiEdit

(

void

)

[virtual]

---

成员函数文档

void UiEdit::AddChar

(

TCHAR

ch

)

在当前光标位置添加一个字符

参数:

ch

添加的字符.

void UiEdit::AddCommandGlyph

(

Glyph *

pg

)

void UiEdit::AddImage

(

CMzString

sImagePath

)

添加图片

参数:

sImagePath

要添加图片的路径

void UiEdit::AdjustRect

(

)

virtual int UiEdit::CalcContentHeight	(	int	nRow,
		int	nRowCount
	)			[virtual]

计算文本框的内容高度

参数:

	nRow	起始行位置
	nRowCount	共计算的行数

返回:

返回内容高度

virtual int UiEdit::CalcContentHeight

(

)

[virtual]

计算文本框的内容高度

重载UiWin。

virtual int UiEdit::CalcContentTopPosV

(

)

[virtual]

计算（返回）控件的内容竖直方向的位置

重载UiWin。

void UiEdit::CalcCoordByRowCol	(	size_t	nRow,
		size_t	nCol,
		int *	xPos,
		int *	yPos
	)

void UiEdit::CalcRowColByCoord	(	int	xPos,
		int	yPos,
		__out size_t *	nRow,
		__out size_t *	nCol
	)

根据指定坐标算出光标应在的行和列，但不重设光标

参数:

	xPos	x坐标
	yPos	y坐标
	nRow	[out] 计算得出光标行位置
	nCol	[out] 计算得出光标列位置

void UiEdit::CalcTooltipsPos	(	size_t	beginRow,
		size_t	beginCol,
		size_t	endRow,
		size_t	endCol,
		__out int *	pXPos = NULL,
		__out int *	pYPos = NULL,
		__out POINT *	pPtArrow = NULL
	)			[protected]

virtual int UiEdit::CalRowNumber

(

int

yPos

)

[virtual]

void UiEdit::Clear

(

)

清空文本框的内容

virtual int UiEdit::ClearComposition

(

)

[protected, virtual]

void UiEdit::ClearMapFaceInfo

(

)

void UiEdit::CreateCommand

(

UINT

uFlags

)

void UiEdit::EnableAutoOpenSip

(

bool

bEnable

)

void UiEdit::EnableCopy

(

bool

bEnable

)

void UiEdit::EnableGridlines

(

bool

bEnable

)

启用默认表格线

参数:

bEnable

true:启用; false:禁用;默认禁用

void UiEdit::EnableInsideScroll

(

bool

bEnable

)

设置内部滚动

参数:

bEnable

true:启用; false:禁用;默认启用

void UiEdit::EnableRichTextFormat

(

bool

bEnable

)

是否使文字呈现多样化。

true: 每个文字使用自己的字体,颜色等; false: 文字使用相同的字体颜色

参数:

bEnable

true:打开; false: 关闭

virtual MZFC_INLINE void UiEdit::EnableScrollableParent

(

bool

bEnable

)

[virtual]

设置当鼠标拖动时，是否通知其所在的可滚动容器

重载UiWin。

void UiEdit::EnableSimpleCopy

(

bool

bEnable

)

void UiEdit::EnableUndo

(

bool

bEnable

)

void UiEdit::EnableZoomIn

(

bool

bEnable

)

设置编辑器是否支持放大镜

参数:

bEnable

true: 支持放大镜; false: 不支持放大镜

DWORD UiEdit::GetAlignMode

(

)

获取图元的排版样式

返回:

返回图元排列方式

int UiEdit::GetBottomInvalid

(

)

获取编辑框的底部无效区域

void UiEdit::GetCaretPos	(	size_t *	nRow = 0,
		size_t *	nCol = 0
	)

获取当前光标位置

size_t UiEdit::GetCharCount	(	size_t	nBeginRow,
		size_t	nBeginCol,
		size_t	nEndRow,
		size_t	nEndCol
	)

size_t UiEdit::GetCharCount

(

)

统计字符数,表情按照所对应的字符统计

COLORREF UiEdit::GetColorBg

(

)

DWORD UiEdit::GetComposeCount

(

)

启用多线程分行时, 获得当前完成分行的字符个数

返回:

字符个数

size_t UiEdit::GetCurDisplyRow_First

(

)

size_t UiEdit::GetCurDisplyRow_Last

(

)

MZFC_INLINE int UiEdit::GetEditBgType

(

)

获取编辑控件的背景类型

BOOL UiEdit::GetExtendedProperty_UiEdit	(	int	nPropertyType,
		void *	pValue,
		int	nBufSize
	)

获取或设置对象的扩展属性值

参数:

	nPropertyType	要获取或设置的属性类型
	pValue	要获取或设置的属性值的指针
	nBufSize	pValue所指向的变量的size大小（单位: 字节）

返回:

操作是否成功

size_t UiEdit::GetFaceCount

(

)

CFaceInfo* UiEdit::GetFaceInfo

(

LPCWSTR

faceStr

)

Glyph_Face* UiEdit::GetFirstFace	(	size_t	nRow,
		size_t	nCol,
		__out int *	nPos
	)

以指定位置为0点,获得第一个表情。并返回所在位置

参数:

	nRow	行位置
	nCol	列位置
	nPos	[out] 返回表情所在相对位置,未找到则为-1

返回:

返回表情对象

size_t UiEdit::GetFirtCharPos

(

__out CMzString &

lineStr

)

获取当前屏幕显示的第一个字符的位置

COLORREF UiEdit::GetFontColor

(

)

bool UiEdit::GetFontItalic

(

)

int UiEdit::GetFontSize

(

)

bool UiEdit::GetFontUnderline

(

)

LONG UiEdit::GetFontWeight

(

)

Glyph* UiEdit::GetGlyph	(	size_t	row,
		size_t	col
	)

获取指定位置的图元对象

参数:

	row	行位置 0为起始位置
	col	列位置 0为起始位置

返回:

返回获得的图元对象指针

size_t UiEdit::GetGlyphCount	(	size_t	nBeginRow,
		size_t	nBeginCol,
		size_t	nEndRow,
		size_t	nEndCol
	)

size_t UiEdit::GetGlyphCount

(

)

size_t UiEdit::GetImageCount	(	size_t	nRow,
		int	nRowCount
	)

计算从第nRow行开始,nRowCount行的图片个数

参数:

	nRow	起始行
	nRowCount	行数, -1表示到最后一行

CMzString UiEdit::GetImagePath

(

int

nPos

)

获得指定位置的图片路径

参数:

nPos

编辑框中的图片序号,从1开始

CMzString UiEdit::GetImagePath	(	size_t	nRow,
		size_t	nCol
	)

获得指定位置的图片路径

参数:

	nRow	图片所在行
	nCol	图片所在列

bool UiEdit::GetImagePos	(	int	nPos,
		size_t &	nRow,
		size_t &	nCol
	)

获得图片位置

参数:

	nPos	图片序号
	nRow	[out] 图片所在行
	nCol	[out] 图片所在列

int UiEdit::GetImageSize

(

)

获得当前图片尺寸

int UiEdit::GetInitHeight

(

)

返回编辑框的最小高度。仅设置外部滚动时此属性生效

int UiEdit::GetLeftInvalid

(

)

获取编辑器左边的无效区域宽度

int UiEdit::GetLingSpace

(

)

获取行距

UINT UiEdit::GetLinkMode

(

)

int UiEdit::GetRightInvalid

(

)

获取编辑器右边的无效区域宽度

size_t UiEdit::GetRowCount

(

)

获取文本的总行数

void UiEdit::GetSelectPos	(	size_t &	nBeginRow,
		size_t &	nBeginCol,
		size_t &	nEndRow,
		size_t &	nEndCol
	)

获得被选中内容的起始位置与结束位置

参数:

	nBeginRow	[out]起始行
	nBeginCol	[out]起始列
	nEndRow	[out]结束行
	nEndCol	[out]结束列

DWORD UiEdit::GetShowCount

(

)

int UiEdit::GetShowHeight

(

)

bool UiEdit::GetShowState

(

)

virtual CMzString& UiEdit::GetText

(

)

[virtual]

获取编辑器字符串.

返回:

编辑器字符串.

重载UiWin。

int UiEdit::GetTopInvalid

(

)

获取编辑器右边的无效区域宽度

void UiEdit::GoToCharPos

(

int

pos

)

bool UiEdit::HasComposition

(

)

是否含有未完成联想的组合字符串

void UiEdit::InitMapFaceInfo

(

)

[[ 自定义表情图片功能

void UiEdit::InsertGlyph	(	Glyph *	pg,
		size_t	nRow,
		size_t	nCol,
		DWORD	flag = UIEDIT_DEFAULT_GLYPH
	)

[[ 编辑框内容相关功能 在指定位置插入图元.可从文字,图片,表情等多种图元中派生

参数:

	pg	要插入的图元
	nRow	行位置 0为起始位置
	nCol	列位置 0为起始位置
	flag	插入特殊图元的标志位.UIEDIT_SMS_GLYPH:用于短信图片的特殊行. 此行只有一个图元,输入退格删除整行

void UiEdit::InsertString	(	WCHAR *	pStr,
		size_t	nRow,
		size_t	nCol
	)

在指定位置添加一个字符串

参数:

	pStr	添加的字符串指针.
	nRow	要添加位置的行数,从0开始.
	nCol	要添加位置的列数,从0开始.

void UiEdit::InsertString

(

WCHAR *

pStr

)

在当前光标位置添加一个字符串

参数:

pStr

添加的字符串指针.

bool UiEdit::IsEmpty

(

)

判断文本框是否为空

bool UiEdit::isEnableAutoOpenSip

(

)

bool UiEdit::IsEnableCopy

(

)

bool UiEdit::IsFinishCompose

(

)

启用多线程分行时, 查看是否完成分行

返回:

线程是否结束

bool UiEdit::IsGridlinesEnabled

(

)

是否启用了表格线

bool UiEdit::IsInsideScroll

(

)

查看内部是否可以滚动

bool UiEdit::IsOpenFace

(

)

查看编辑器是否支持表情识别

bool UiEdit::IsReadOnly

(

)

编辑框是否只读

bool UiEdit::IsRichTextFormat

(

)

编辑框是否支持丰富的文字排版,表情识别,图片功能

bool UiEdit::IsUndoEnabled

(

)

virtual void UiEdit::MoveTopPos

(

int

nOffset

)

[virtual]

移动内容顶部位置

重载UiWin。

virtual int UiEdit::OnChar	(	TCHAR	chCharCode,
		LPARAM	lKeyData
	)			[protected, virtual]

当有键盘字符输入时，此函数会被调用.(仅当控件拥有键盘焦点时)

重载UiWin。

virtual void UiEdit::OnClick

(

size_t

nIndex

)

[virtual]

重载IUiMovingBarListener。

virtual void UiEdit::OnCopy

(

)

[protected, virtual]

当控件WM_COPY消息时，此函数会被调用

重载UiWin。

virtual void UiEdit::OnCut

(

)

[protected, virtual]

当控件WM_CUT消息时，此函数会被调用

重载UiWin。

static void CALLBACK UiEdit::OnFinish	(	PVOID	pParam,
		int	nDiff
	)			[static]

virtual void UiEdit::OnFocused

(

UiWin *

pWinPrev

)

[protected, virtual]

virtual int UiEdit::OnImeComposition

(

BOOL

fFlags

)

[protected, virtual]

当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)

重载UiWin。

virtual int UiEdit::OnKeyDown	(	int	nVirtKey,
		DWORD	lKeyData
	)			[protected, virtual]

当有键盘按键按下时，此函数会被调用.(仅当控件拥有键盘焦点时)

重载UiWin。

virtual int UiEdit::OnLButtonDown	(	UINT	fwKeys,
		int	xPos,
		int	yPos
	)			[protected, virtual]

mouse message handlers

重载UiWin。

virtual int UiEdit::OnLButtonUp	(	UINT	fwKeys,
		int	xPos,
		int	yPos
	)			[protected, virtual]

当控件被左键放开时，此函数会被调用.

重载UiWin。

virtual void UiEdit::OnLostFocus

(

UiWin *

pWinNext

)

[protected, virtual]

virtual int UiEdit::OnMouseMove	(	UINT	fwKeys,
		int	xPos,
		int	yPos
	)			[protected, virtual]

当控件上鼠标移动时，此函数会被调用.

重载UiWin。

virtual void UiEdit::OnParentScrollStart

(

)

[protected, virtual]

重载UiWin。

virtual void UiEdit::OnParentScrollStop

(

)

[protected, virtual]

重载UiWin。

virtual void UiEdit::OnPaste

(

)

[protected, virtual]

当控件WM_PASTE消息时，此函数会被调用

重载UiWin。

virtual void UiEdit::OnPressedHoldTimeup

(

)

[protected, virtual]

当 pressed-hold 结束时，此函数会被调用，可重载以自定义处理

重载UiWin。

static void CALLBACK UiEdit::OnShow	(	PVOID	pParam,
		int	nDiff
	)			[static]

virtual int UiEdit::OnTimer

(

UINT_PTR

nIDEvent

)

[protected, virtual]

当Timer到达时，此函数会被调用.

重载UiWin。

virtual void UiEdit::OnWmA4M8	(	WPARAM	wParam,
		WPARAM	lParam
	)			[protected, virtual]

当控件WM_A4M8消息时，此函数会被调用

重载UiWin。

void UiEdit::OpenFace

(

bool

bOpenFace

)

设置编辑器是否支持表情识别

参数:

bOpenFace

true: 支持表情识别; false: 不支持表情识别

virtual void UiEdit::PaintWin	(	HDC	hdcDst,
		RECT *	prcWin,
		RECT *	prcUpdate
	)			[protected, virtual]

绘制控件

重载此函数可以自定义控件的绘制

参数:

	hdcDst	目的DC
	prcWin	控件所在区域（以HDC的左上角为原点）
	prcUpdate	需要更新的区域（以HDC的左上角为原点)

重载UiWin。

virtual void UiEdit::PaintWinBg	(	HDC	hdc,
		RECT *	prcWin,
		RECT *	prcUpdate
	)			[protected, virtual]

void UiEdit::Redo

(

)

void UiEdit::RemoveChar	(	size_t	nRow,
		size_t	nCol
	)

删除指定光标位置的字符

参数:

	nRow	光标所在行.
	nCol	光标所在列.

size_t UiEdit::RemoveString	(	size_t	nRow,
		size_t	nCol,
		size_t	nCount
	)

virtual void UiEdit::ScrollStart

(

double

fScrollSpeed

)

[virtual]

开始滚动

重载UiWin。

virtual void UiEdit::ScrollStop

(

)

[virtual]

结束滚动

重载UiWin。

virtual void UiEdit::ScrollTo	(	int	nScrollToType = UI_SCROLLTO_TOP,
		int	nDstTopPos = 0,
		bool	bAnimate = true
	)			[virtual]

滚动控件内容至某个位置

参数:

	nScrollToType	UI_SCROLLTO_TOP, UI_SCROLLTO_BOTTOM, UI_SCROLLTO_POS
	nDstTopPos	目的位置，只当 nScrollToType==UI_SCROLLTO_POS 时有效
	bAnimate	是否显示滚动过程

重载UiWin。

bool UiEdit::ScrollToNextScreen

(

)

滚动到下一屏,编辑框内部滚动时有效

bool UiEdit::ScrollToPreviousScreen

(

)

滚动到上一屏,编辑框内部滚动时有效

Glyph_Face* UiEdit::SearchFace	(	__in GlyphRow *	pGlyph,
		size_t	nEndPos
	)

void UiEdit::SetAlignMode

(

DWORD

dwMode

)

设置图元排列方式

参数:

dwMode

图元的排列方式: UIEDIT_ALIGN_LEFT,UIEDIT_ALIGN_CENTER,UIEDIT_ALIGN_RIGHT

void UiEdit::SetBottomInvalid

(

int

nInvalid

)

设置编辑框的底部无效区域

参数:

nInvalid

无效区域大小

void UiEdit::SetCaretPos	(	size_t	nRow,
		size_t	nCol
	)

指定当前光标位置

参数:

	nRow	光标行位置.
	nCol	光标列位置.

void UiEdit::SetColorBg

(

COLORREF

crBgColor

)

void UiEdit::SetEditBgType

(

int

nEditBgType

)

设置编辑器背景类型

参数:

nEditBgType

从下面选项中取值: UI_EDIT_BGTYPE_NONE, UI_EDIT_BGTYPE_ROUND_RECT, UI_EDIT_BGTYPE_FILL_WHITE, UI_EDIT_BGTYPE_FILL_WHITE_AND_TOPSHADOW

BOOL UiEdit::SetExtendedProperty_UiEdit	(	int	nPropertyType,
		void *	pValue,
		int	nBufSize
	)

获取或设置对象的扩展属性值

参数:

	nPropertyType	要获取或设置的属性类型
	pValue	要设置的属性值的指针
	nBufSize	pValue所指向的变量的size大小（单位: 字节）

返回:

操作是否成功

void UiEdit::SetFontColor

(

COLORREF

clrFont

)

void UiEdit::SetFontItalic

(

bool

bFontItalic

)

void UiEdit::SetFontSize

(

int

nFontSize

)

void UiEdit::SetFontUnderline

(

bool

bFontUnderline

)

void UiEdit::SetFontWeight

(

LONG

lFontWeight

)

void UiEdit::SetImageSize

(

int

nImageSize

)

设置显示图片高度尺寸，并根据原尺寸比例缩放图片

参数:

nImageSize

图片高尺寸

void UiEdit::SetInitHeight

(

int

nHeight

)

编辑框的最小高度。仅设置外部滚动时此属性生效

void UiEdit::SetLeftInvalid

(

int

offset

)

设置编辑器左边的无效区域宽度

参数:

offset

无效区域宽度.

void UiEdit::SetLineSpace

(

int

nLineSpace

)

设置行距

void UiEdit::SetLinkMode

(

UINT

linkMode

)

virtual void UiEdit::SetMaxChar

(

int

n

)

[virtual]

设置最大的字符数

参数:

n

最大字符数

virtual void UiEdit::SetPos	(	int	x,
		int	y,
		int	w,
		int	h,
		UINT	flags = 0
	)			[virtual]

设置控件的位置

参数:

	x	X 坐标
	y	Y 坐标
	w	宽
	h	高
	flags	可以是以下值的合并：0，SP_NOSIZE, SP_NOMOVE

重载UiWin。

void UiEdit::SetReadOnly

(

bool

status

)

设置只读

参数:

status

true:只读; false:可写;默认可写

void UiEdit::SetRightInvalid

(

int

nInvalid

)

设置编辑器右边的无效区域宽度

参数:

nInvalid

无效区域宽度.

void UiEdit::SetShowCount

(

DWORD

charCount

)

设置分行线程第一次显示需要完成指定字符数。当启用多线程分行时,在SetText之前调用, 分行线程分完charCount个字符时,SetText函数返回,线程继续对剩下内容分行。默认为0

参数:

charCount

字符个数

void UiEdit::SetShowHeight

(

int

height

)

设置分行线程第一次显示需要完成指定高度。当启用多线程分行时,在SetText之前调用,线程分行达到height高度时,SetText函数返回, 线程继续对剩下内容分行。当设置SetShowCount(0)时,此设置生效。默认为600

参数:

height

高度

void UiEdit::SetSipMode	(	DWORD	dwMode,
		DWORD	dwSipOffset = 0xffffffff
	)

设置编辑器输入法模式

参数:

	dwMode	输入法模式
	dwSipOffset	输入法离屏幕底部的偏移高度,如果值为0xffffffff，采用系统默认值

参见:

MzOpenSip()

void UiEdit::SetSipModeEx	(	DWORD	dwMode,
		DWORD	dwSipOffset = 0xffffffff,
		LPCTSTR	strSip = NULL
	)

virtual void UiEdit::SetText	(	LPCTSTR	text,
		bool	isMultiThread = false
	)			[virtual]

设置编辑器字符串.

参数:

	text	编辑器字符串.
	isMultiThread	是否启用多线程.

virtual void UiEdit::SetTextColor

(

COLORREF

cr

)

[virtual]

设置文本颜色

重载UiWin。

virtual void UiEdit::SetTextSize

(

int

nFontSize

)

[virtual]

void UiEdit::SetTip

(

LPCTSTR

text

)

设置提示文字，该文字在有输入后消失

参数:

text

提示文字.

void UiEdit::SetTopInvalid

(

int

nInvalid

)

设置编辑器右边的无效区域宽度

参数:

nInvalid

无效区域大小.

virtual void UiEdit::SetTopPos

(

int

nTopPos

)

[virtual]

设置内容顶部位置

重载UiWin。

void UiEdit::ShowCaret

(

)

根据当前光标的行列位置,重画光标

void UiEdit::ShowCopyButton

(

bool

bShow

)

virtual void UiEdit::StartSelect	(	size_t	nRow,
		size_t	nCol,
		int	nCount
	)			[virtual]

bool UiEdit::StopComposeThread

(

DWORD

dwMilliseconds

)

void UiEdit::SwitchSipMode	(	DWORD	dwMode,
		DWORD	dwSipOffset = 0xffffffff
	)

切换编辑器输入法模式

参数:

	dwMode	输入法模式
	dwSipOffset	输入法离屏幕底部的偏移高度,如果值为0xffffffff，采用系统默认值

参见:

MzOpenSip()

void UiEdit::Undo

(

)

void UiEdit::UpdateAlignMode	(	DWORD	dwMode,
		size_t	nRow
	)

以某一行所在的段为单位，更新此段的排列方式

参数:

	dwMode	图元的排列方式: UIEDIT_ALIGN_LEFT,UIEDIT_ALIGN_CENTER,UIEDIT_ALIGN_RIGHT
	nRow	行位置

void UiEdit::UpdateFace

(

)

检查当前文本框内容，并根据表情识别功能是否打开的情况，更新文本框内容

void UiEdit::UpdateFaceRes	(	LPCWSTR	faceStr,
		int	resId
	)

增加或替换表情资源

参数:

	faceStr	表情字符串 当表情字符串已经存在则更新该表情的图片资源,否则增加此表情
	resId	表情图片的资源id

void UiEdit::UpdateFaceRes	(	LPCWSTR	faceStr,
		CMzString	resPath
	)

增加或替换表情资源

参数:

	faceStr	表情字符串 当表情字符串已经存在则更新该表情的图片资源,否则增加此表情
	resPath	表情图片的路径

void UiEdit::UpdateFontColor	(	COLORREF	clrFont,
		size_t	nBeginRow,
		size_t	nBeginCol,
		size_t	nEndRow,
		size_t	nEndCol
	)

void UiEdit::UpdateFontSize	(	int	nFontSize,
		size_t	nBeginRow,
		size_t	nBeginCol,
		size_t	nEndRow,
		size_t	nEndCol
	)

---

该类的文档由以下文件生成：

• UiEdit.h