中国象棋窗体，完成中国象棋的界面更多...

#include <FrmChineseChess.h>

类 CFrmChineseChess 继承关系图:

[图例]

CFrmChineseChess 的协作图:

[图例]

信号
void	sigGoChess (int i, int j, CPiece::ENUM_QiZi chess)

Public 成员函数
	CFrmChineseChess (QWidget *parent=nullptr)

void	AboutBox ()

棋局信息
QDateTime	GetStartTime ()
	得到开始时间

int	SetStartTime (const QDateTime &t)

QDateTime	GetEndTime ()

int	SetEndTime (const QDateTime &t)

QString	GetRedName ()

int	SetRedName (const QString &name)

QString	GetBlackName ()

int	SetBlackName (const QString &name)

Public 成员函数继承自 CChineseChess
int	SetBoardLayout (ENUM_BoardLayout layout)

ENUM_BoardLayout	GetBoardLayout ()

bool	GoChess (int i, int j, bool bNext=false)
	走棋

int	NextStep ()
	函数名：NextStep 功能：下步棋参数：无返回值：走棋步数作者：康林版本：1.0.0.1 日期：2004-10-5 时间：10:19:33

int	PreviouStep ()
	函数名：PreviouStep 功能：上步棋参数：无返回值：走棋步数作者：康林版本：1.0.0.1 日期：2004-10-5 时间：10:19:51

virtual int	SaveChessGame (const char *pszFile)
	保存棋局。根据文件扩展名来保存为相应的格式。当前支持自定义格式、PGN格式

virtual int	LoadChessGame (const char *pszFile)
	加载棋局。根据文件扩展名来解析文件的格式。当前支持自定义格式、PGN格式

time_t	GetStartTime ()

int	SetStartTime (const time_t &t)

time_t	GetEndTime ()

int	SetEndTime (const time_t &t)

std::string	GetRedName ()

int	SetRedName (const char *pszName)

std::string	GetBlackName ()

int	SetBlackName (const char *pszName)

std::string	GetGameTag (const std::string &tag)

int	AddGameTag (const std::string &szTag, const std::string &szVal)

int	EnablePromptSound (bool sound=true)

bool	getEnablePromptSound ()

int	EnablePromptMessage (bool bMsg=true)

bool	getEnablePromptMessage ()

静态 Public 成员函数
资源
static int	InitResource (const QString szLanguage)
	初始化资源，仅在程序开始时调用一次

static int	CleanResource ()
	清理资源，仅在程序结束时调用一次

Protected 成员函数
virtual void	mouseReleaseEvent (QMouseEvent *event) override

virtual void	paintEvent (QPaintEvent *event) override

virtual void	resizeEvent (QResizeEvent *event) override

virtual int	onPromptSound (PROMPT_SOUND sound) override

virtual int	onPromptMessage (CGoRule::ENUM_ReturnValue val) override
	提示错误消息

virtual int	onCleanPrompt (int i, int j) override
	清除提示框

virtual int	onDrawPrompt (int i, int j) override
	画提示框

virtual int	onGoChess (int i, int j, CPiece::ENUM_QiZi chess) override
	走棋事件

Protected 成员函数继承自 CChineseChess
int	CleanPrompt (int &i, int &j)
	清理提示，并把提示框位置设置成无效值

bool	IsValidPosition (int i, int j)

int	Initial ()

int	ConvertQiPang (const int &i, const int &j, int &x, int &y)

属性
QString	RedName

QString	BlackName

QDateTime	StartTime

QDateTime	EndTime

Private 类型
enum	ENUM_ConvertCoordinate { XYToIJ , IJToXY }
	坐标转换更多...

enum	ENUM_XINWEI { XinWei , Left_XinWei , Right_XinWei }
	棋盘星位更多...

Private 成员函数
bool	ConvertCoordinate (long x, long y, int i, int j, ENUM_ConvertCoordinate eCC=XYToIJ)
	坐标转换

bool	SetQiPang (int width, int height)
	设置棋盘位置

void	DrawXinWei (QPainter *pPainter, int i, int j, ENUM_XINWEI xinwei=XinWei)
	画星位

bool	DrawTiShiBox (QPainter *pPainter, int i, int j)
	画提示框

int	DrawQiZi (QPainter *pPainter, int i, int j, CPiece::ENUM_QiZi eQiZi)
	画棋子

void	DrawQiPang (QPainter *pPainter, QRect rect)
	画棋盘

int	DrawPicture (QPainter *pPainter, int i, int j, QImage image, bool CHHJKL=false)
	画图片

int	DrawImage (QPainter *pPainter, QRect rect, QImage image)
	在指定位置绘图

int	SetTransparentImage (QImage &image, const QColor &col=QColor(255, 255, 255))
	设置 QImage 透明

int	SetTransparentPixmap (QPixmap &pixmap, const QColor &col=QColor(255, 255, 255))
	设置 Pixmap 透明

Private 属性
Ui::CFrmChineseChess *	ui

int	m_QiPangStartX
	棋盘的开始横坐标

int	m_QiPangStartY
	棋盘的开始横坐标

int	m_QiPangDistance
	棋盘格的距离

QColor	m_QiPangColor
	棋盘格的颜色

QColor	m_TiShiBoxColor
	提示框的颜色

QImage	m_QiPangPicture
	棋盘背景图片

棋子图片
QImage	m_RedShuai
	红帅

QImage	m_RedShi
	红仕

QImage	m_RedXiang
	红相

QImage	m_RedMa
	红马

QImage	m_RedChe
	红车

QImage	m_RedBing
	红兵

QImage	m_RedPao
	红炮

QImage	m_BlackShuai
	黑帅

QImage	m_BlackShi
	黑仕

QImage	m_BlackXiang
	黑相

QImage	m_BlackMa
	黑马

QImage	m_BlackChe
	黑车

QImage	m_BlackBing
	黑兵

QImage	m_BlackPao
	黑炮

楚河汉界图片
QImage	m_Chu
	楚

QImage	m_He
	河

QImage	m_Han
	汉

QImage	m_Jie
	界

QImage	m_KL
	版本图片

额外继承的成员函数
Public 类型继承自 CChineseChess
enum	_ENUM_BoardLayout { NoQi = 0 , OnlyTopBlack = 1 , OnlyBottomRed = 2 , SwapRedBetweenBlack = 4 , OnlyTopRed = OnlyBottomRed \| SwapRedBetweenBlack , OnlyBottomBlack = OnlyTopBlack \| SwapRedBetweenBlack , TopBlackAndBottomRed = OnlyTopBlack \| OnlyBottomRed , TopRedAndBottomBlack = TopBlackAndBottomRed \| SwapRedBetweenBlack }
	标准棋盘布局:详见《象棋竞赛规则(2011)》第一章第1条。红棋在下，黑棋在上。界面可以支持非标准棋盘布局（红在上，黑在下）更多...

typedef enum CChineseChess::_ENUM_BoardLayout	ENUM_BoardLayout
	标准棋盘布局:详见《象棋竞赛规则(2011)》第一章第1条。红棋在下，黑棋在上。界面可以支持非标准棋盘布局（红在上，黑在下）

Protected 类型继承自 CChineseChess
enum	PROMPT_SOUND { JiangJun , Eat , Go , NoGo , Select }
	提示音更多...

enum	_ENUM_WalkState { RedReadly , RedWalked , BlackReadly , BlackWalked }

typedef enum CChineseChess::_ENUM_WalkState	ENUM_WalkState

Protected 属性继承自 CChineseChess
CPiece::ENUM_QiZi	m_ChessBoard [9][10]
	棋盘描述

ENUM_BoardLayout	m_BoardLayout

ENUM_WalkState	m_WalkState

int	m_PreviouPositionX

int	m_PreviouPositionY

int	m_CurrentPositionX

int	m_CurrentPositionY

详细描述

中国象棋窗体，完成中国象棋的界面

注解

在程序开始时，仅调用一次 InitResource
在程序结束时，仅调用一次 CleanResource

在文件 FrmChineseChess.h 第 25 行定义.

成员枚举类型说明

◆ ENUM_ConvertCoordinate

enum CFrmChineseChess::ENUM_ConvertCoordinate

private

坐标转换

在文件 FrmChineseChess.h 第 128 行定义.

◆ ENUM_XINWEI

enum CFrmChineseChess::ENUM_XINWEI

private

棋盘星位

在文件 FrmChineseChess.h 第 133 行定义.

构造及析构函数说明

◆ CFrmChineseChess()

CFrmChineseChess::CFrmChineseChess ( QWidget * parent = nullptr )

explicit

在文件 FrmChineseChess.cpp 第 19 行定义.

◆ ~CFrmChineseChess()

CFrmChineseChess::~CFrmChineseChess ( )

overridevirtual

在文件 FrmChineseChess.cpp 第 73 行定义.

成员函数说明

◆ AboutBox()

void CFrmChineseChess::AboutBox ( )

在文件 FrmChineseChess.cpp 第 217 行定义.

◆ CleanResource()

int CFrmChineseChess::CleanResource ( )

static

清理资源，仅在程序结束时调用一次

在文件 FrmChineseChess.cpp 第 95 行定义.

◆ ConvertCoordinate()

bool CFrmChineseChess::ConvertCoordinate	(	long *	x,
		long *	y,
		int *	i,
		int *	j,
		ENUM_ConvertCoordinate	eCC = `XYToIJ`
	)

private

坐标转换

参数

x	设备横坐标
y	设备纵坐标
i	棋盘横坐标[0,8]
j	棋盘纵坐标[0,9]
eCC	转换方式 XYToIJ: 从设备坐标转换到棋盘坐标(默认值) IJToXY: 从棋盘坐标转换到设备坐标

返回: 返回真值。成功：返回 true；失败：返回 false。

在文件 FrmChineseChess.cpp 第 289 行定义.

◆ DrawImage()

int CFrmChineseChess::DrawImage	(	QPainter *	pPainter,
		QRect	rect,
		QImage	image
	)

private

在指定位置绘图

参数

pPainter	设备上下文
rect	绘图区域
image	图片

返回: 如果成功返回 0,否则返回非零

在文件 FrmChineseChess.cpp 第 653 行定义.

◆ DrawPicture()

int CFrmChineseChess::DrawPicture	(	QPainter *	pPainter,
		int	i,
		int	j,
		QImage	image,
		bool	CHHJKL = `false`
	)

private

画图片

参数

pPainter
i	图片位置横坐标[0-8]
j	图片位置纵坐标[0-9]
image	图片
CHHJKL	画楚河汉界（默认值为 false）

返回: 如果成功返回 0,否则返回非零

在文件 FrmChineseChess.cpp 第 627 行定义.

◆ DrawQiPang()

void CFrmChineseChess::DrawQiPang	(	QPainter *	pPainter,
		QRect	rect
	)

private

画棋盘

参数

pPainter	设备上下文
rect	控件区域(包括边界)

在文件 FrmChineseChess.cpp 第 333 行定义.

◆ DrawQiZi()

int CFrmChineseChess::DrawQiZi	(	QPainter *	pPainter,
		int	i,
		int	j,
		CPiece::ENUM_QiZi	eQiZi
	)

private

画棋子

参数

pPainter	设备上下文
i	棋盘横坐标[0-8]
j	棋盘纵坐标[0-9]
eQiZi	棋子

返回: 如果成功返回 0,否则返回非零

在文件 FrmChineseChess.cpp 第 556 行定义.

◆ DrawTiShiBox()

bool CFrmChineseChess::DrawTiShiBox	(	QPainter *	pPainter,
		int	i,
		int	j
	)

private

画提示框

参数

pPainter	设备上下文
i	棋盘横坐标[0-8]
j	棋盘纵坐标[0-9]

返回: 返回真值。成功：返回 true；失败：返回 false。

在文件 FrmChineseChess.cpp 第 517 行定义.

◆ DrawXinWei()

void CFrmChineseChess::DrawXinWei	(	QPainter *	pPainter,
		int	i,
		int	j,
		ENUM_XINWEI	xinwei = `XinWei`
	)

private

画星位

参数

pPainter	设备上下文
i	星位的横坐标[0-8]
j	星位的纵坐标[0-9]
xinwei	画的位置取下列值勤之一: XinWei:全画(默认值) Left_XinWei:画左边的星位 Right_XinWei:画右边的星位

在文件 FrmChineseChess.cpp 第 473 行定义.

◆ GetBlackName()

QString CFrmChineseChess::GetBlackName ( )

在文件 FrmChineseChess.cpp 第 268 行定义.

◆ GetEndTime()

QDateTime CFrmChineseChess::GetEndTime ( )

在文件 FrmChineseChess.cpp 第 246 行定义.

◆ GetRedName()

QString CFrmChineseChess::GetRedName ( )

在文件 FrmChineseChess.cpp 第 258 行定义.

◆ GetStartTime()

QDateTime CFrmChineseChess::GetStartTime ( )

得到开始时间

在文件 FrmChineseChess.cpp 第 233 行定义.

◆ InitResource()

int CFrmChineseChess::InitResource ( const QString szLanguage )

static

初始化资源，仅在程序开始时调用一次

参数

szLanguage 使用语言

返回

在文件 FrmChineseChess.cpp 第 79 行定义.

◆ mouseReleaseEvent()

void CFrmChineseChess::mouseReleaseEvent ( QMouseEvent * event )

overrideprotectedvirtual

在文件 FrmChineseChess.cpp 第 106 行定义.

◆ onCleanPrompt()

int CFrmChineseChess::onCleanPrompt	(	int	i,
		int	j
	)

overrideprotectedvirtual

清除提示框

实现了 CChineseChess.

在文件 FrmChineseChess.cpp 第 193 行定义.

◆ onDrawPrompt()

int CFrmChineseChess::onDrawPrompt	(	int	i,
		int	j
	)

overrideprotectedvirtual

画提示框

实现了 CChineseChess.

在文件 FrmChineseChess.cpp 第 202 行定义.

◆ onGoChess()

int CFrmChineseChess::onGoChess	(	int	i,
		int	j,
		CPiece::ENUM_QiZi	chess
	)

overrideprotectedvirtual

走棋事件

实现了 CChineseChess.

在文件 FrmChineseChess.cpp 第 211 行定义.

◆ onPromptMessage()

int CFrmChineseChess::onPromptMessage ( CGoRule::ENUM_ReturnValue val )

overrideprotectedvirtual

提示错误消息

实现了 CChineseChess.

在文件 FrmChineseChess.cpp 第 173 行定义.

◆ onPromptSound()

int CFrmChineseChess::onPromptSound ( PROMPT_SOUND sound )

overrideprotectedvirtual

实现了 CChineseChess.

在文件 FrmChineseChess.cpp 第 136 行定义.

◆ paintEvent()

void CFrmChineseChess::paintEvent ( QPaintEvent * event )

overrideprotectedvirtual

在文件 FrmChineseChess.cpp 第 120 行定义.

◆ resizeEvent()

void CFrmChineseChess::resizeEvent ( QResizeEvent * event )

overrideprotectedvirtual

在文件 FrmChineseChess.cpp 第 130 行定义.

◆ SetBlackName()

int CFrmChineseChess::SetBlackName ( const QString & name )

在文件 FrmChineseChess.cpp 第 273 行定义.

◆ SetEndTime()

int CFrmChineseChess::SetEndTime ( const QDateTime & t )

在文件 FrmChineseChess.cpp 第 253 行定义.

◆ SetQiPang()

bool CFrmChineseChess::SetQiPang	(	int	width,
		int	height
	)

private

设置棋盘位置

参数

width	控件窗口宽度
height	控件窗口高度

返回: 返回真值。成功：返回 true；失败：返回 false。

在文件 FrmChineseChess.cpp 第 311 行定义.

◆ SetRedName()

int CFrmChineseChess::SetRedName ( const QString & name )

在文件 FrmChineseChess.cpp 第 263 行定义.

◆ SetStartTime()

int CFrmChineseChess::SetStartTime ( const QDateTime & t )

在文件 FrmChineseChess.cpp 第 241 行定义.

◆ SetTransparentImage()

int CFrmChineseChess::SetTransparentImage	(	QImage &	image,
		const QColor &	col = `QColor(255, 255, 255)`
	)

private

设置 QImage 透明

参数

image
col	透明颜色

返回: 如果成功返回 0,否则返回非零

在文件 FrmChineseChess.cpp 第 673 行定义.

◆ SetTransparentPixmap()

int CFrmChineseChess::SetTransparentPixmap	(	QPixmap &	pixmap,
		const QColor &	col = `QColor(255, 255, 255)`
	)

private

设置 Pixmap 透明

参数

pixmap
col	透明颜色

返回: 如果成功返回 0,否则返回非零

在文件 FrmChineseChess.cpp 第 687 行定义.

类成员变量说明

◆ m_BlackBing

QImage CFrmChineseChess::m_BlackBing

private

黑兵

在文件 FrmChineseChess.h 第 111 行定义.

◆ m_BlackChe

QImage CFrmChineseChess::m_BlackChe

private

黑车

在文件 FrmChineseChess.h 第 110 行定义.

◆ m_BlackMa

QImage CFrmChineseChess::m_BlackMa

private

黑马

在文件 FrmChineseChess.h 第 109 行定义.

◆ m_BlackPao

QImage CFrmChineseChess::m_BlackPao

private

黑炮

在文件 FrmChineseChess.h 第 112 行定义.

◆ m_BlackShi

QImage CFrmChineseChess::m_BlackShi

private

黑仕

在文件 FrmChineseChess.h 第 107 行定义.

◆ m_BlackShuai

QImage CFrmChineseChess::m_BlackShuai

private

黑帅

在文件 FrmChineseChess.h 第 106 行定义.

◆ m_BlackXiang

QImage CFrmChineseChess::m_BlackXiang

private

黑相

在文件 FrmChineseChess.h 第 108 行定义.

◆ m_Chu

QImage CFrmChineseChess::m_Chu

private

楚

在文件 FrmChineseChess.h 第 119 行定义.

◆ m_Han

QImage CFrmChineseChess::m_Han

private

汉

在文件 FrmChineseChess.h 第 121 行定义.

◆ m_He

QImage CFrmChineseChess::m_He

private

河

在文件 FrmChineseChess.h 第 120 行定义.

◆ m_Jie

QImage CFrmChineseChess::m_Jie

private

界

在文件 FrmChineseChess.h 第 122 行定义.

◆ m_KL

QImage CFrmChineseChess::m_KL

private

版本图片

在文件 FrmChineseChess.h 第 123 行定义.

◆ m_QiPangColor

QColor CFrmChineseChess::m_QiPangColor

private

棋盘格的颜色

在文件 FrmChineseChess.h 第 89 行定义.

◆ m_QiPangDistance

int CFrmChineseChess::m_QiPangDistance

private

棋盘格的距离

在文件 FrmChineseChess.h 第 87 行定义.

◆ m_QiPangPicture

QImage CFrmChineseChess::m_QiPangPicture

private

棋盘背景图片

在文件 FrmChineseChess.h 第 92 行定义.

◆ m_QiPangStartX

int CFrmChineseChess::m_QiPangStartX

private

棋盘的开始横坐标

在文件 FrmChineseChess.h 第 85 行定义.

◆ m_QiPangStartY

int CFrmChineseChess::m_QiPangStartY

private

棋盘的开始横坐标

在文件 FrmChineseChess.h 第 86 行定义.

◆ m_RedBing

QImage CFrmChineseChess::m_RedBing

private

红兵

在文件 FrmChineseChess.h 第 103 行定义.

◆ m_RedChe

QImage CFrmChineseChess::m_RedChe

private

红车

在文件 FrmChineseChess.h 第 102 行定义.

◆ m_RedMa

QImage CFrmChineseChess::m_RedMa

private

红马

在文件 FrmChineseChess.h 第 101 行定义.

◆ m_RedPao

QImage CFrmChineseChess::m_RedPao

private

红炮

在文件 FrmChineseChess.h 第 104 行定义.

◆ m_RedShi

QImage CFrmChineseChess::m_RedShi

private

红仕

在文件 FrmChineseChess.h 第 99 行定义.

◆ m_RedShuai

QImage CFrmChineseChess::m_RedShuai

private

红帅

在文件 FrmChineseChess.h 第 98 行定义.

◆ m_RedXiang

QImage CFrmChineseChess::m_RedXiang

private

红相

在文件 FrmChineseChess.h 第 100 行定义.

◆ m_TiShiBoxColor

QColor CFrmChineseChess::m_TiShiBoxColor

private

提示框的颜色

在文件 FrmChineseChess.h 第 90 行定义.

◆ ui

Ui::CFrmChineseChess* CFrmChineseChess::ui

private

在文件 FrmChineseChess.h 第 83 行定义.

属性说明

◆ BlackName

QString CFrmChineseChess::BlackName

readwrite

在文件 FrmChineseChess.h 第 30 行定义.

◆ EndTime

QDateTime CFrmChineseChess::EndTime

readwrite

在文件 FrmChineseChess.h 第 32 行定义.

◆ RedName

QString CFrmChineseChess::RedName

readwrite

在文件 FrmChineseChess.h 第 29 行定义.

◆ StartTime

QDateTime CFrmChineseChess::StartTime

readwrite

在文件 FrmChineseChess.h 第 31 行定义.

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

/home/runner/work/ChineseChessControl/ChineseChessControl/UI/Qt/FrmChineseChess.h
/home/runner/work/ChineseChessControl/ChineseChessControl/UI/Qt/FrmChineseChess.cpp

信号

Public 成员函数

静态 Public 成员函数

Protected 成员函数

属性

Private 类型

Private 成员函数

Private 属性

额外继承的成员函数

详细描述

成员枚举类型说明

◆ ENUM_ConvertCoordinate

◆ ENUM_XINWEI

构造及析构函数说明

◆ CFrmChineseChess()

◆ ~CFrmChineseChess()

成员函数说明

◆ AboutBox()

◆ CleanResource()

◆ ConvertCoordinate()

◆ DrawImage()

◆ DrawPicture()

◆ DrawQiPang()

◆ DrawQiZi()

◆ DrawTiShiBox()

◆ DrawXinWei()

◆ GetBlackName()

◆ GetEndTime()

◆ GetRedName()

◆ GetStartTime()

◆ InitResource()

◆ mouseReleaseEvent()

◆ onCleanPrompt()

◆ onDrawPrompt()

◆ onGoChess()

◆ onPromptMessage()

◆ onPromptSound()

◆ paintEvent()

◆ resizeEvent()

◆ SetBlackName()

◆ SetEndTime()

◆ SetQiPang()

◆ SetRedName()

◆ SetStartTime()

◆ SetTransparentImage()

◆ SetTransparentPixmap()

类成员变量说明

◆ m_BlackBing

◆ m_BlackChe

◆ m_BlackMa

◆ m_BlackPao

◆ m_BlackShi

◆ m_BlackShuai

◆ m_BlackXiang

◆ m_Chu

◆ m_Han

◆ m_He

◆ m_Jie

◆ m_KL

◆ m_QiPangColor

◆ m_QiPangDistance

◆ m_QiPangPicture

◆ m_QiPangStartX

◆ m_QiPangStartY

◆ m_RedBing

◆ m_RedChe

◆ m_RedMa

◆ m_RedPao

◆ m_RedShi

◆ m_RedShuai

◆ m_RedXiang

◆ m_TiShiBoxColor

◆ ui

属性说明

◆ BlackName

◆ EndTime

◆ RedName

◆ StartTime