C S tatic

CStatic 类 提 供 了 一 个 W indows 静 态 控 件 的 性 能 。 一 个 静 态 控 件 用 来 显 示 一 个文 本 字 符 串 ， 框 ， 矩 形 ， 图 标 ， 光 标 ， 位 图 ， 或 增 强 的 图 元 文 件 。 它 可 以 被 用来 作 为 标 签 ， 框 ， 或 用 来 分 隔 其 它 的 控 件 。 一 个 静 态 控 件 不 接 收 输 入 ， 也 不 提供 输 出 ； 但 是 ， 如 果 它 是 用 SS_NOTIFY 风 格 创 建 的 ， 则 它 可 以 通 知 其 父 有 关设 备 点 击 的 消 息 。

创 建 一 个 静 态 控 件 分 两 步 。 首 先 ， 调 用 构 造 函 数 来 构 造 此 CStatic 对 象 ， 然 后调 用 Create 成 员 函 数 来 创 建 此 静 态 控 件 并 将 它 与 该 CStatic 对 象 连 接 。

如 果 你 是 在 一 个 对 话 框 中 创 建 了 一 个 静 态 控 件 （ 通 过 一 个 对 话 框 资 源 ） ， 则 当用 户 关 闭 这 个 对 话 框 时 ， 此 CStatic 对 象 被 自 动 销 毁 。

如 果 你 是 在 一 个 窗 口 中 创 建 了 一 个 CStatic 对 象 ， 则 必 须 由 你 来 销 毁 它 。 在 一个 窗 口 的 堆 栈 中 创 建 的 CStatic 对 象 将 自 动 被 销 毁 。 如 果 你 是 使 用 new 函 数 在堆 中 创 建 CStatic 对 象 ， 则 当 你 使 用 完 后 ， 必 须 调 用 delete 来 销 毁 这 个 CStatic

对 象 。

#include <afxwin.h>

请 参 阅 CWnd, CButton, CComboBox, CEdit, CListBox, CScrollBar, CDialog

CStatic 类 成 员

Construction

Cstatic 构 造 一 个 CStatic 对 象

Initialization

Create 创 建 W indows 静 态 控 件 并 将 它 与 该 CStatic 对 象 连接

Operation s SetBitmap 指 定 要 在 此 静 态 控 件 中 显 示 的 位 图

GetBitmap 获 取 先 前 用 SetBitmap 设 置 的 位 图 的 句 柄

SetIcon 指 定 一 个 要 在 此 静 态 控 件 中 显 示 的 图 标

GetIcon 获 取 先 前 用 SetIcon 设 置 的 图 标 的 句 柄

SetCursor 指 定 要 显 示 在 此 静 态 控 件 中 的 光 标 图 像

GetCursor 获 取 先 前 用 SetCursor 设 置 的 光 标 图 像 的 句 柄SetEnhMetaFile 指 定 要 显 示 在 此 静 态 控 件 中 的 增 强 的 图 元 文 件GetEnhMetaFile 获 取 先 前 用 SetEnhMetaFile 设 置 的 增 强 图 元 文 件

的 句 柄

成 员 函 数

CStatic::Create

BOOL Create( LPCTSTR lpszTex t, D W O R D dwStyle , const RECT& rect , CWnd* pParentWnd , U INT nID = 0xffff );

返 回 值

如 果 成 功 则 返 回 非 零 值 ； 否 则 返 回 0 ；

参 数

lpszText

指 定 要 放 置 在 控 件 中 的 文 本 。 如 果 是 NULL ， 则 表 示 没 有 文 本 是 可 见 的 。

dwStyle

指 定 静 态 控 件 的 窗 口 风 格 。 任 何 静 态 控 件 风 格 的 组 合 都 可 以 用 于 这 个 控

件 。

rect

指 定 静 态 控 件 的 位 置 和 大 小 。它 可 以 是 一 个 RECT 结 构 或 一 个 CRect 对 象 。

pParentWnd

指定 CStatic 父 窗 口 ， 通 常 是 一 个 CDialog 对 象 。 它 不 能 是 NULL 。

nID

指 定 静 态 控 件 的 控 件 ID 。

说 明

可 以 将 下 列 窗 口 风 格 用 于 一 个 静 态 控 件 ：

• WS_CHILD 总 要 使 用 。

• WS_VISIBLE 经 常 使 用 。

• WS_DISABLED 很 少 使 用 。

如 果 你 准 备 在 此 静 态 控 件 中 显 示 一 个 位 图 ， 光 标 ， 图 标 ， 或 图 元 文 件 ， 你 必 须使 用 下 列 风 格 之 一 ：

• SS_BITMAP 此 风 格 用 于 位 图 。

• SS_ICON 此 风 格 用 于 光 标 和 图 标 。

• SS_ENHMETAFILE 此 风 格 用 于 增 强 的 图 元 文 件 。对 于 光 标 ，

  位 图 ， 或 图 标 ， 你 也 可 以 使 用 下 面 的 风 格 ：

• SS_CENTERIMAGE 用 来 使 静 态 控 件 中 的 图 像 居 中 。

请 参 阅 CStatic::CStatic

CStatic::CStatic

CStatic( );

说 明

此 成 员 函 数 用 来 构 造 一 个 CStatic 对 象 。

请 参 阅 CStatic::Create

CStatic::GetBitmap HBITMAP GetBitmap( ) const; 返 回 值

返 回 一 个 当 前 位 图 的 句 柄 ， 如 果 没 有 设 置 位 图 ， 则 返 回 NULL 。

说 明

此 成 员 函 数 用 来 获 取 先 前 用 SetBitmap 设 置 的 与 CStatic 关 联 的 位 图 句 柄 。

请 参 阅 CStatic::SetBitmap, STM_GETIMAGE, Bitmaps

CStatic::GetCursor

HCURSOR GetCursor( );

返 回 值

返 回 一 个 当 前 图 标 句 柄 。 如 果 没 有 设 置 图 标 则 返 回 NULL 。

说 明

此 成 员 函 数 用 来 获 取 先 前 用 SetCursor 设 置 的 与 CStatic 关 联 的 光 标 句 柄 。

请 参 阅 CStatic::SetCursor, STM_GETIMAGE, Cursors

CStatic::GetEnhMetaFile HENHMETAFILE GetEnhMetaFile( ) const; 返 回 值

返 回 一 个 当 前 增 强 图 元 文 件 句 柄 。 如 果 没 有 设 置 增 强 的 图 元 文 件 则 返 回 NULL 。

说 明

此 成 员 函 数 用 来 获 取 先 前 用 SetEnhMetaFile 设 置 的 与 CStatic 关 联 的 增 强 的 图元 文 件 句 柄 。

请 参 阅 CStatic::SetEnhMetafile, STM_GETIMAGE

CStatic::GetIcon HICON GetIcon( ) const; 返 回 值

返 回 一 个 当 前 图 标 句 柄 。 如 果 没 有 设 置 增 强 的 图 标 则 返 回 NULL 。

说 明

此 成 员 函 数 用 来 获 取 先 前 用 SetIcon 设 置 的 与 CStatic 关 联 的 图 标 句 柄 。

请 参 阅 CStatic::SetIcon, STM_GETICON, Icons

CStatic::SetBitmap

HBITMAP SetBitmap( HBITMAP hBitmap );

返 回 值

返 回 先 前 与 此 静 态 控 件 关 联 的 位 图 的 句 柄 。 如 果 没 有 与 此 静 态 控 件 关 联 的 位图 ， 则 返 回 NULL 。

参 数

hBitmap

要 绘 制 在 此 静 态 控 件 中 的 位 图 句 柄 。

说 明

此 成 员 函 数 用 来 将 一 个 新 的 位 图 与 此 静 态 控 件 关 联 。

这 个 位 图 将 被 自 动 绘 制 在 此 静 态 控 件 中 。 缺 省 的 ， 它 将 被 绘 制 在 左 上 角 ， 并 且此 静 态 控 件 将 根 据 位 图 的 大 小 来 调 整 尺 寸 。

你 可 以 使 用 不 同 的 窗 口 和 静 态 控 件 风 格 ， 包 括 下 列 值 ：

• SS_BITMAP 此 风 格 总 是 用 于 位 图 。

• SS_CENTERIMAGE 用 来 在 此 静 态 控 件 中 居 中 。 如 果 图 像 比

  静 态 控 件 大 ， 则 它 将 被 剪 切 掉 。 如 果 它 比 静 态 控 件 小 ， 则 图 像 周 围 的 空 间 将 被 用 位 图 左上 角 的 像 素 的 颜 色 填 充 。

请 参 阅 CStatic::GetBitmap, STM_SETIMAGE, Bitmaps

CStatic::SetCursor

HCURSOR SetCursor( HCURSOR hCursor );

返 回 值

返 回 先 前 与 此 静 态 控 件 关 联 的 光 标 的 句 柄 。 如 果 没 有 与 此 静 态 控 件 关 联 的 光标 ， 则 返 回 NULL 。

参 数

hCursor

要 绘 制 在 此 静 态 控 件 中 的 光 标 句 柄 。

说 明

此 成 员 函 数 用 来 将 一 个 新 的 光 标 与 此 静 态 控 件 关 联 。

这 个 光 标 将 被 自 动 绘 制 在 此 静 态 控 件 中 。 缺 省 的 ， 它 将 被 绘 制 在 左 上 角 ， 并 且此 静 态 控 件 将 根 据 光 标 的 大 小 来 调 整 尺 寸 。

你 可 以 使 用 不 同 的 窗 口 和 静 态 控 件 风 格 ， 包 括 下 列 值 ：

• SS_ICON 此 风 格 总 是 用 于 位 图 。

• SS_CENTERIMAGE 用 来 在 此 静 态 控 件 中 居 中 。 如 果 图 像 比

  静 态 控 件 大 ， 则 它 将 被 剪 切 掉 。 如 果 它 比 静 态 控 件 小 ， 则 图 像 周 围 的 空 间 将 被 用 位 图 左上 角 的 像 素 颜 色 填 充 。

请 参 阅 CStatic::GetCursor, STM_SETIMAGE, Cursors

CStatic::SetEnhMetaFile

HENHMETAFILE SetEnhMetaFile( HENHMETAFILE hMetaFile );

返 回 值

返 回 先 前 与 此 静 态 控 件 关 联 的 增 强 图 元 文 件 的 句 柄 。 如 果 没 有 与 此 静 态 控 件 关联 的 增 强 图 元 文 件 ， 则 返 回 NULL 。

参 数

hMetaFile

要 绘 制 在 此 静 态 控 件 中 的 增 强 图 元 文 件 句 柄 。

说 明

此 成 员 函 数 用 来 将 一 个 新 的 增 强 图 元 文 件 与 此 静 态 控 件 关 联 。

这 个 增 强 图 元 文 件 将 被 自 动 绘 制 在 此 静 态 控 件 中 。 缺 省 的 ， 它 将 被 绘 制 在 左 上角 ， 并 且 此 静 态 控 件 将 根 据 增 强 图 元 文 件 的 大 小 来 调 整 尺 寸 。

你 可 以 使 用 不 同 的 窗 口 和 静 态 控 件 风 格 ， 包 括 下 列 值 ：

• SS_ENHMETAFILE 此 风 格 总 是 用 于 位 图 。

请 参 阅 CStatic::GetEnhMetafile, STM_SETIMAGE

CStatic::SetIcon

HICON SetIcon( HICON hIcon );

返 回 值

返 回 先 前 与 此 静 态 控 件 关 联 的 图 标 的 句 柄 。 如 果 没 有 与 此 静 态 控 件 关 联 的 图标 ， 则 返 回 NULL 。

参 数

hIcon

要 绘 制 在 此 静 态 控 件 中 的 图 标 句 柄 。

说 明

此 成 员 函 数 用 来 将 一 个 新 的 图 标 与 此 静 态 控 件 关 联 。

这 个 图 标 将 被 自 动 绘 制 在 此 静 态 控 件 中 。 缺 省 的 ， 它 将 被 绘 制 在 左 上 角 ， 并 且此 静 态 控 件 将 根 据 图 标 的 大 小 来 调 整 尺 寸 。

你 可 以 使 用 不 同 的 窗 口 和 静 态 控 件 风 格 ， 包 括 下 列 值 ：

• SS_ICON 此 风 格 总 是 用 于 图 标 。

• SS_CENTERIMAGE 用 来 在 此 静 态 控 件 中 居 中 。 如 果 图 像 比

  静 态 控 件 大 ， 则 它 将 被 剪 切 掉 。 如 果 它 比 静 态 控 件 小 ， 则 图 像 周 围 的 空 间 将 被 用 位 图 左上 角 的 像 素 颜 色 填 充 。

请 参 阅 CStatic::GetIcon, STM_SETICON, Icons