登录
当前位置： 首页 > 文档资料 > Java 函数速查 >

SystemInformation 类

优质
小牛编辑
124浏览
2023-12-01

SystemInformation类

提供有关操作系统的信息。

package com.ms.wfc.app

public class SystemInformation

说明

SystemInformation类提供了几个静态方法，可以用于获取信息，比如Windows显示设备的大小，操作系统设置，网络是否可用以及安装在系统上的硬件性能。该类不能被实化。

方法

SystemInformation.get3DborderSize

检取一个三维边框的大小（以像素为单位）。

语法

public static final Point get3DBorderSize ()

返回值

返回一个Point对象，代表边框的大小。

说明

get3DBorderSize方法是getBorderSize方法的三维对应版本。当你想创建一个三维边框而需要确定边框正确的大小时就使用该方法。

请参阅：getBorderSize

SystemInformation.getArrange

检取一个标记，指明系统如何安排最小化的窗口。

语法

public static final int getArrange ()

返回值

返回一个整数值，是SystemInformation.ArrangeStartingPosition和SystemInforma-tion.ArrangeDirection值的组合。

SystemInformation.getBorderSize

检取窗口边框的宽度和高度，以像素为单位。

语法

public static final Point getBorderSize ()

返回值

返回一个Point对象，代表可变大小的窗口边框的大小。

说明

getBorderSize方法是get3DBorderSize方法的非三维对应版本。当你创建一个控件需要确定其边框的正确大小时使用该方法。

请参阅：get3DborderSize

SystemInformation.getCaptionButtonSize

检取窗口标题或标题栏中按钮的宽度和高度，以像素为单位。

语法

public static final Point getCaptionButtonSize ()

返回值

返回一个Point对象，代表标题栏按钮的大小。

说明

使用getCaptionButtonSize方法来获取窗口标题栏中按钮的大小，或在窗口标题栏中放置其他的标题按钮以便确保以正确的大小显示按钮。

请参阅：getCaptionHeight

SystemInformation.getCaptionHeight

检取窗口标准标题区域的高度，以像素为单位。

语法

public static final int getCaptionHeight ()

返回值

返回一个整数值，代表窗口标题区域的高度。

说明

使用getCaptionHeight方法来确定标准窗口标题的大小。你可以执行特殊的显示操作或给窗口的标题增加一个标题按钮.

请参阅：getCaptionButtonSize

SystemInformation.getCleanBoot

检取一个值，指明系统如何启动。

语法

public static final int getCleanBoot()

返回值

返回一个整数值，指明系统如何启动。

说明

使用getCleanBoot方法来确定系统如何启动。对于运行在Windows95/98上的应用程序，你可以使用该方法来确定系统是否运行在故障－安全模式（fail-safe）。当访问系统服务和硬件时，你的应用程序就可以使用这些信息执行正确的操作。

getClearBoot方法的返回值可以是下列之一：

值描述
0正常启动
1故障－安全模式启动
2故障－安全模式启动，带有网络功能

注意：故障－安全模式启动（也称为SafeBoot）将跳过用户设置的启动文件。

SystemInformation.getComputerName

检取当前系统的计算机名字。

语法

public static final String getComputerName ()

返回值

返回一个String对象，代表计算机的名字。

说明

使用getComputerName方法来确定该计算机的名字，该名字是显示给网络上其他用户看的。

当系统启动时从注册表初始化中建立该名字。

SystemInformation.getCursorSize

检取光标的宽度和高度，以像素为单位。

语法

public static final Point getCursorSize()

返回值

返回一个Point对象，代表系统光标的大小。

说明

操作系统不能创建可变大小的光标。

SystemInformation.getDBCSEnabled

确定操作系统是否支持双字节字符集（DBCS）。

语法

public static final boolean getDBCSEnabled ()

返回值

如果操作系统支持DBCS就返回true；否则，就返回false。

说明

使用getDBCSEnabled方法来确定要运行你的应用程序的操作系统是否支持DBCS。然而，一个操作系统支持DBCS，并不意味着本地化的应用程序就使用DBCS。

SystemInformation.getDebug

确定你的应用程序是否运行在调试版本的操作系统上。

语法

public static final boolean getDebug ()

返回值

如果安装了调试版本的User.exe就返回true；否则，就返回false。

SystemInformation.getDoubleClickSize

检取双击序列中第一次点击鼠标位置周围矩阵的宽度和高度，以像素为单位。

语法

public static final Point getDoubleClickSize ()

返回值

返回一个Point对象，代表发生双击事件周围想象矩阵的大小。

说明

使用getDoubleClickSize方法来确定一个矩形的高度和宽度，Windows用户使用该矩形来确定双击序列中的第二次点击是否是有效操作。必须在给矩形中进行第二次点击操作，以便操作系统将这两次点击事件当成是双击事件。双击事件也必须在一定的时间内才有效（使用getDoubleClickTime方法来确定系统规定的时间限制）。

SystemInformation.getDoubleClickTime

确定鼠标当前的双击时间。

语法

public static final int getDoubleClickTime ()

返回值

返回一个整数值，代表双击中击键之间间隔的毫秒数。

说明

双击是鼠标按钮两次点击序列，第二次必须在第一次点击之后指定的时间内发生才有效。双击时间是指双击时间中第一次点击与第二次点击之间最大的时间间隔毫秒数。要触发双击事件，也必须是在同一个区域内。使用getDoubleClickSize方法来确

定该区域。

SystemInformation.getDragSize

检取拖动点中央矩形的高度和宽度，在开始拖动操作时该矩形用于限制鼠标指针的移动范围。

语法

public static final Point getDragSize ()

返回值

返回一个Point对象，代表一个矩形，拖动操作必须跨出该矩形才认为要开始拖放操作。

说明

使用getDragSize方法来确定一个矩形的大小，Windows使用该矩形做为界定拖放操作是否开始。在该矩形中，用户可以点击并释放鼠标，但系统并不认为发生了拖放操作。

SystemInformation.getFixedFrameBorderSize

确定围绕在不可改变大小的窗口周围框架的宽度，以像素为单位。

语法

public static final Point getFixedFrameBorderSize ()

返回值

返回一个Point对象，代表固定窗口边框的大小。

请参阅：getFrameBorderSize

SystemInformation.getFrameBorderSize

检取可变大小的窗口周围框架的宽度，以像素为单位。

语法

public static final Point getFrameBorderSize ()

返回值

返回一个Point对象，代表可变大小窗口边框的宽度和高度。

请参阅：getFixedFrameBorderSize

SystemInformation.getHorizScrollBarArrowWidth

检取水平滚动条箭头的宽度，以像素为单位。

语法

public static final int getHorizScrollBarArrowWidth ()

返回值

返回一个整数值，代表水平滚动条箭头的宽度。

请参阅：getHorizScrollBarHeight, getHorizScrollBarThumbWidth,getVertScroll-BarArrowHeight

SystemInformation.getHorizScrollBarHeight

检取水平滚动条箭头的高度，以像素为单位。

语法

public static final int getHorizScrollBarHeight ()

返回值

返回一个整数值，代表水平滚动条箭头的高度。

请参阅：getHorizScrollBarThumbWidth, getHorizScrollBarArrowWidth,getVert-ScrollBarWidth

SystemInformation.getHorizScrollBarThumbWidth

检取水平滚动条滚动块的宽度，以像素为单位。

语法

public static final int getHorizScrollBarThumbWidth ()

返回值

返回一个整数值，代表水平滚动条滚动块的宽度。

说明

使用getHorizScrollBarThumbWidth方法来确定滚动块的宽度。滚动块用于指明滚动条的位置以及用于将滚动条拖到新的位置上。

请参阅：getHorizScrollBarArrowWidth, getHorizScrollBarHeight,getVertScrollBar-ThumbHeight

SystemInformation.getIconSize

检取图标的宽度和高度，以像素为单位。

语法

public static final Point getIconSize ()

返回值

返回一个Point对象，代表图标缺省大小。

说明

使用getIconSize方法来确定Windows缺省图标大小。该方法确定你的应用程序中所显示的图标大小是否与系统的一致。该方法所返回的图标大小是用于大图标的。

请参阅：getIconSpacingSize

SystemInformation.getIconSpacingSize

确定大图标视图中图标方块的大小，以像素为单位。

语法

public static final Point getIconSpacingSize ()

返回值

返回一个Point对象，代表用于安排图标的方块大小。

说明

使用getIconSpacingSize方法来确定安排每个图标所需要的方块。该值总是比getIconSize方法所返回的值大或相等。

SystemInformation.getKanjiWindowHeight

对于DBCS版本的Windows，检取屏幕下方kanji (汉字)窗口的高度，以像素为单位。

语法

public static final int getKanjiWindowHeight()

返回值

返回一个整数值，代表Kanji窗口的高度。

说明

使用getKanjiWindowHeight方法来确定支持双字节（DBCS）系统的Kanji窗口的高度。

要确定操作系统是否支持DBCS，使用getDBCSEnabled方法。

SystemInformation.getMaxWindowTrackSize

检取拥有标题和可变边框窗体的缺省最大尺寸，以像素为单位。

语法

public static final Point getMaxWindowTrackSize()

返回值

返回一个Point对象，代表可变大小窗体的最大尺寸。

说明

getMaxWindowTrackSize所返回的值是整个桌面的大小。用户不能拖动窗体边框改变得比该尺寸值还大。窗体可以覆盖getMaxTrackSize方法来覆盖该值。

请参阅：com.ms.wfc.ui.Form

SystemInformation.getMenuButtonSize

检取菜单条按钮的大小，以像素为单位。

语法

public static final Point getMenuButtonSize ()

返回值

返回一个Point对象，代表菜单条按钮的大小。

说明

使用getMenuButtonSize方法来确定菜单按钮的大小，比如在多文档界面应用程序中子窗口关闭按钮。菜单按钮的大小应该跟调用getCaptionButtonSize方法所有返回的标题按钮一样。

请参阅：getMenuCheckSize, getMenuHeight

SystemInformation.getMenuCheckSize

检取缺省菜单选择标记的大小，以像素为单位。

语法

public static final Point getMenuCheckSize ()

返回值

返回一个Point对象，代表菜单选择标记的缺省大小。

说明

使用getMenuCheckSize方法来确定Windows用于显示在选中的菜单项旁边的选择标记图像的大小。

请参阅：getMenuHeight, getMenuButtonSize

SystemInformation.getMenuHeight

检取菜单条的高度，以像素为单位。

语法

public static final int getMenuHeight ()

返回值

返回一个整数值，代表菜单条的高度。

说明

使用getMenuHeight方法来确定Windows当前为菜单条定义的高度。

请参阅：getMenuButtonSize, getMenuCheckSize

SystemInformation.getMidEastEnabled

确定操作系统是否支持希伯来语和阿拉伯语。

语法

public static final boolean getMidEastEnabled ()

返回值

如果系统支持希伯来语或阿拉伯语，就返回true；否则，就返回false。

SystemInformation.getMinimizedWindowSize

检取标准最小化窗口的大小，以像素为单位。

语法

public static final Point getMinimizedWindowSize ()

返回值

返回一个Point对象，代表标准最小化窗口的大小。

说明

使用getMinimizedWindowSize方法来确定Windows所规定的最小化窗口的尺寸。

请参阅：getMinimizedWindowSpacingSize

SystemInformation.getMinimizedWindowSpacingSize

检取最小化窗口方块的尺寸，以像素为单位。

语法

public static final Point getMinimizedWindowSpacingSize ()

返回值

返回一个Point对象，代表最小化窗口所占据方块的大小。

说明

使用getMinimizedWindowSpacingSize方法来确定最小化窗口所占据位置的大小。该值总是比调用getMinimizedWindowSize方法所返回的值大或相等。

SystemInformation.getMinimumWindowSize

检取一个窗口最小的宽度和高度，以像素为单位。

语法

public static final Point getMinimumWindowSize ()

返回值

返回一个Point对象，代表一个窗口所允许的最小尺寸。

说明

使用getMinimumWindowSize方法来确定Windows所指定的窗口最小尺寸。你可以使用该方法限制你的应用程序窗口比该方法所返回的值大。

SystemInformation.getMinWindowTrackSize

检取窗口最小跟踪区域的宽度和高度，以像素为单位。

语法

public static final Point getMinWindowTrackSize ()

返回值

返回一个Point对象，代表Windows所允许的缺省最小跟踪区域尺寸。

说明

使用getMinWindowTrackSize方法来确定在用户拖动窗口框架时所允许的最小尺寸。窗体可以覆盖com.ms.wfc.ui.Form.getMinTrackSize方法来覆盖该限制。

请参阅：com.ms.wfc.ui.Form

SystemInformation.getMonitorCount

检取与系统相连的监视器的数量。

语法

public static final int getMonitorCount ()

返回值

返回一个整数值，代表与系统相连的监视器的数量。

说明

只有目前有多个监视器与系统相连时，该方法返回的值才比1大。

请参阅：getMonitorsSameDisplayFormat

SystemInformation.getMonitorsSameDisplayFormat

确定当前与系统相连的监视器是否相同的颜色格式。

语法

public static final boolean getMonitorsSameDisplayFormat ()

返回值

如果所有的监视器都有相同的颜色格式，就返回true；否则，就返回false。

说明

使用getMonitorsSameDisplayFormat方法来确定当前与系统相连的监视器是否都有相同的颜色格式。例如，红绿蓝像素可使用不同的位数来编码，这些位在像素的颜色值中的位置也可能不同。

注意：两个显示器可以有相同的位数但不同的颜色格式。

请参阅：getMonitorCount

SystemInformation.getMouseButtons

检取与系统相连的鼠标有多少个按键。

语法

public static final int getMouseButtons ()

返回值

返回一个整数值，代表鼠标按键的数量。

说明

如果没有安装鼠标，该方法就返回0。你可以使用该方法来确定鼠标按键的数目，这样如果鼠标有多于两个的按键，你的应用程序就可以支持和提供额外的功能了。

请参阅：getMouseButtonSwapped, getMousePresent

SystemInformation.getMouseButtonsSwapped

确定鼠标的左键和右键是否被交换了。

语法

public static final boolean getMouseButtonsSwapped ()

返回值

如果鼠标左键和右键的作用是交换过来的，就返回true；否则，就返回false。

说明

使用getMouseButtonsSwapped方法来确定鼠标左键和右键的作用是否是相反的。该方法确定系统如何响应鼠标点击和其他的鼠标按钮事件。

请参阅：getMouseButtons, getMousePresent

SystemInformation.getMousePresent

确定系统是否安装了鼠标。

语法

public static final boolean getMousePresent ()

返回值

如果安装了鼠标，就返回true；否则，就返回false。

请参阅：getMouseButtons, getMouseButtonsSwapped

SystemInformation.getMouseWheelPresent

确定当前安装在系统上的鼠标是否有滑轮。

语法

public static final boolean getMouseWheelPresent ()

返回值

如果当前所安装的鼠标有滑轮，就返回true；否则，就返回false。

说明

当要确定是否执行需要滑轮的代码时使用该方法。

请参阅：getMouseWheelScrollLines, getNativeMouseWheelSupport

SystemInformation.getMouseWheelScrollLines

检取鼠标滑轮滚动时所滚动的线的数量。

语法

public static final int getMouseWheelScrollLines ()

返回值

返回一个整数值，代表滚动过的线的数量。

说明

使用该方法来确定有滚动条的框架中增加或减少多少线。

请参阅：getNativeMouseWheelSupport, getMouseWheelPresent

SystemInformation.getNativeMouseWheelSupport

确定操作系统本身内在地是否支持鼠标滑轮。

语法

public static final boolean getNativeMouseWheelSupport ()

返回值

如果操作系统内在地支持鼠标滑轮，就返回true；否则，就返回false

说明

即使系统内部并不支持鼠标滑轮，鼠标滑轮操作也可以通过com.ms.wfc.ui.Control对象来工作。

请参阅：getMouseWheelPresent, getMouseWheelScrollLines

SystemInformation.getNetwork

确定该计算机是否在网络上。

语法

public static final boolean getNetwork ()

返回值

如果网络可访问，就返回true；否则，就返回false。

说明

在执行网络操作之前，使用getNetwork方法来确定网络是否可用。

SystemInformation.getPenWindows

确定是否安装了Microsoft Windows for Pen Computing扩展。

语法

public static final boolean getPenWindows ()

返回值

如果安装了该扩展软件，就返回true；否则，就返回false。

SystemInformation.getPrimaryMonitorMaximizedWindowSize

检取主监视器上最大化的左上角窗口的缺省尺寸，以像素为单位。

语法

public static final Point getPrimaryMonitorMaximizedWindowSize()

返回值

返回一个Point对象，代表主显示器最大化窗口的尺寸。

请参阅：getPrimaryMonitorSize, com.ms.wfc.ui.Screen

SystemInformation.getPrimaryMonitorSize

当安装了多个监视器时，检取主监视器屏幕的宽度和高度，以像素为单位。

语法

public static final Point getPrimaryMonitorSize()

返回值

返回一个Point对象，代表主显示器的尺寸，以像素为单位。

请参阅：getPrimaryMonitorMaximizedWindowSize

SystemInformation.getRightAlignedMenus

确定下拉菜单是否是右对齐的。

语法

public static final boolean getRightAlignedMenus ()

返回值

如果下拉菜单是右对齐的，就返回true；否则，就返回false。

SystemInformation.getSecure

确定操作系统是否设置了安全限制。

语法

public static final boolean getSecure ()

返回值

如果系统有安全措施，就返回true；否则，就返回false。

说明

getSecure方法允许你确定操作系统上是否安装了SecurityManager。Windows NT提供了Security Manager来确定对注册表和文件系统的访问。Windows 95不提供Security Manager。

SystemInformation.getShowSounds

确定用户是否需要应用程序可视化地显示某些信息，如果不需要，就将给出声音信息。

语法

public static final boolean getShowSounds ()

返回值

如果应用程序应该可视化地显示音频输出结果，就返回true；否则，如果应用程序可随意使用音频手段，就返回false。

说明

使用getShowSounds方法来确定应用程序是否可以播放声音和其他的音频输出或者需要可视化地显示音频结果。对于应用程序的可访问性，该方法很有帮助。

SystemInformation.getSmallIconSize

检取小图标推荐的尺寸，以像素为单位。

语法

public static final Point getSmallIconSize ()

返回值

返回一个Point对象，代表小图标的尺寸。

说明

使用getSmallIcons方法来确定Windows中小图标的大小。通常在窗口标题和Windows浏览器中的小图标视图中显示小图标。

SystemInformation.getSpecialFolderPath

检取每个特殊文件夹的路径。

语法

public static final String getSpecialFolderPath ( int folder )

参数

folder

一个整数值，代表要检取的特殊文件夹路径。

返回值

返回特殊文件夹的路径。

说明

特殊文件夹就是Windows所定义的、用于保存各种数据类型的公共位置。当调用该方法时，使用SpecialFolder类中的常量来确定要检取哪个文件夹。你可以获取诸如文档和声音文件等项目正确的存储目录。

SystemInformation.getToolWindowCaptionButtonSize

检取小图标按钮的尺寸，以像素为单位。

语法

public static final Point getToolWindowCaptionButtonSize ()

返回值

返回一个Point对象，代表小图标按钮的大小。

说明

使用getToolWindowCaptionButtonSize方法来获取工具窗口标题栏中按钮的尺寸。你可以使用该方法来帮助你给工具窗口标题栏添加你自定义的按钮。

请参阅：getToolWindowCaptionHeight

SystemInformation.getToolWindowCaptionHeight

检取小标题的高度，以像素为单位。

语法

public static final int getToolWindowCaptionHeight ()

返回值

返回一个整数值，代表小标题的高度。

说明

使用getToolWindowCaptionHeight方法来确定Windows中工具窗口标题的高度。该方法可帮助你操作工具窗口的标题区域。

请参阅：getToolWindowCaptionButtonSize

SystemInformation.getUserName

检取当前线程的用户名字。

语法

public static final String getUserName ()

返回值

返回一个String对象，代表当前的用户名。

说明

使用getUserName方法来获取当前登陆到系统上的用户名。

SystemInformation.getVertScrollBarArrowHeight

检取垂直滚动条上箭头图像的高度，以像素为单位。

语法

public static final int getVertScrollBarArrowHeight ()

返回值

返回一个整数值，代表垂直滚动条箭头的高度。

说明

使用getVertScrollBarArrowHeight方法来确定垂直滚动条上箭头的高度。

请参阅：getHorizScrollBarArrowWidth

SystemInformation.getVertScrollBarThumbHeight

检取垂直滚动条上滚动块的高度，以像素为单位。

语法

public static final int getVertScrollBarThumbHeight ()

返回值

返回一个整数值，代表垂直滚动条滚动块的高度。

说明

使用getVertScrollBarThumbHeight方法来确定滚动块的高度，滚动块用于指示滚动条的位置以及用于将滚动条拖动到新的位置。

请参阅：getHorizScrollBarThumbWidth

SystemInformation.getVertScrollBarWidth

检取垂直滚动条上的宽度，以像素为单位。

语法

public static final int getVertScrollBarWidth ()

返回值

返回一个整数值，代表垂直滚动条的宽度。

请参阅：getHorizScrollBarHeight

SystemInformation.getVirtualScreen

检取虚拟屏幕的边界。

语法

public static final Rectangle getVirtualScreen ()

返回值

返回一个Rectangle对象，代表整个虚拟屏幕的边界矩阵。

说明

使用getVirtualScreen方法来确定多监视器系统上整个桌面的边界。然后，你就可以安装了多个监视器系统上可用的最大可视空间。

注意：矩阵的左上角坐标可以是非零或负数。

请参阅：getWorkingArea, com.ms.wfc.ui.Screen

SystemInformation.getWorkingArea()

检取工作区域的大小。

语法

public static final Rectangle getWorkingArea ()

返回值

返回一个Rectangle对象，代表屏幕上工作区域的边界，以像素为

单位。

说明

使用getWorkingArea方法来确定屏幕上游泳池可以使用区域的边界。工作区域就是Windows桌面上没有被系统状态条和其他停靠在桌面上的顶层窗口所占据的屏幕部分。

请参阅：getVirtualScreen, com.ms.wfc.ui.Screen

SystemInformation.ArrangeDirection类

定义了一些常量，用于表示操作系统用于安排最小化窗口的方向。

package com.ms.wfc.app

public static class SystemInformation.ArrangeDirection

说明

使用给类中定义的常量以及SystemInformation.ArrangeStartingPosition类中常量来确定调用SystemInformation.getArrange方法所返回的结果。

字段

SystemInformation.ArrangeDirection.DOWN

从上到下垂直安排最小化窗口。

语法

public static final int DOWN;

SystemInformation.ArrangeDirection.LEFT

从左到右水平安排最小化窗口。

语法

public static final int LEFT;

SystemInformation.ArrangeDirection.RIGHT

从右到左水平安排最小化窗口。

语法

public static final int RIGHT;

SystemInformation.ArrangeDirection.UP

从下到上垂直安排最小化窗口。

语法

public static final int UP;

SystemInformation.ArrangeStartingPosition类

定义了一些常量，用于表示系统安排最小化窗口的起始位置。

package com.ms.wfc.app

public static class SystemInformation.ArrangeStartingPosition

说明

使用给类中定义的常量以及SystemInformation.ArrangeDirection类中常量来确定调用SystemInformation.getArrange方法所返回的结果。

字段

SystemInformation.ArrangeStartingPosition.BOTTOMLEFT

从屏幕左下角（缺省位置）开始安排最小化窗口。

语法

public static final int BOTTOMLEFT;

SystemInformation.ArrangeStartingPosition.BOTTOMRIGHT

从屏幕右下角开始安排最小化窗口。

语法

public static final int BOTTOMRIGHT;

SystemInformation.ArrangeStartingPosition.HIDE

从屏幕的可视区域中移走最小化窗口从而隐藏它们。

语法

public static final int HIDE;

SystemInformation.ArrangeStartingPosition.TOPLEFT

从屏幕左上角开始安排最小化窗口

语法

public static final int TOPLEFT;

SystemInformation.ArrangeStartingPosition.TOPRIGHT

从屏幕右上角开始安排最小化窗口。

语法

ublic static final int TOPRIGHT;

ThreadExceptionDialog类

实现了一个对话框，当线程中发生了未处理的异常时就显示该对话框。

Form
   |
   + ThreadExceptionDialog

package com.ms.wfc.apppublic class ThreadExceptionDialog

extends Form

说明

当线程中发生未处理的异常时就显示ThreadExceptionDialog类所提供的对话框。要创建后就立即显示该窗体，使用Form类中的showDialog方法。对话框提供了对导致错误的线程的描述信息，以及一个Details按钮，这样你就可以显示发生异常地方的调用栈。使用ThreadExceptionDialog类来帮助调试应用程序。

注意：如果没有提供异常异常的处理器，则就自动显示ThreadException-Dialog来响应未处理的异常。

请参阅：com.ms.wfc.ui.Form.showDialog, com.ms.wfc.ui.Form,ThreadException-EventHandler

构造器

ThreadExceptionDialog.ThreadExceptionDialog

创建一个新的ThreadExceptionDialog对象。

语法

public ThreadExceptionDialog ( Throwable t )

参数

t

所发生的异常。

说明

当创建完对话框时，使用Form类的showDialog方法来显示该对话框。使用showDialog方法的返回值并与com.ms.wfc.ui.DialogResult类中的字段值进行比较就可以确定用户点击了ThreadExceptionDialog中的哪个按钮。你也可以调用com.ms.wfc.ui.Form.getDialogResult方法并

与DialogResult类中的字段值进行比较来确定用户点击了哪个按钮。

ThreadExceptionEvent类

实现了ThreadExceptionEvent对象。

Event
  |
  +-- ThreadExceptionEvent

package com.ms.wfc.app

public class ThreadExceptionEvent

extends Event

说明

当线程遇到未处理的异常时就创建ThreadExceptionEvent对象。在你的线程异常事件处理器中使用ThreadExceptionEvent对象来确定所产生异常的类型。

请参阅：ThreadExceptionEventHandler

字段

ThreadExceptionEvent.exception

描述所发生的异常。

语法

public Throwable exception;

说明

使用该字段来确定所发生异常的类型并在你的代码中正确地处理它。

构造器

ThreadExceptionEvent.ThreadExceptionEvent

创建一个新的ThreadExceptionEvent对象。

语法

public ThreadExceptionEvent ( Throwable t )

参数

t

所发生的异常。

ThreadExceptionEventHandler代理

激活所发生事件的处理器方法。

package com.ms.wfc.app

public multicast delegatevoid ThreadExceptionEventHandler (Object sender,ThreadExceptionEvent e);

说明

ThreadExceptionEventHandler

代理的语法说明了事件处理器的结构，其中sender是事件源，e是提供事件数据的ThreadExceptionEvent对象。

请参阅：addOnThreadException, ThreadExceptionEvent

Time类

表示时间元件。

package com.ms.wfc.app

public class Time

implements IConstructable, Ipersistable

说明

Time对象代表了从AD100年一月一日开始算起的时间，单位是100毫微秒。你可以使用Time

类来保存和比较基于时间和基于日期的信息。其提供了几种方法来根据系统时钟的日期和时

间来创建Time对象、添加新的时间和日期字段的值、规定Time对象中存储的日期和时间格

式、以及将Time对象与其他的日期或时间进行比较。只能使用类的addXXX方法来修改Time

对象以创建新的Time对象。

请参阅：com.ms.wfc.util.Value

字段

Time.MAX_UNITS

指明最多可以在Time对象中保存多少时间单位（100毫微秒）。

语法

public static final long MAX_UNITS;

Time.MIN_UNITS

指明最少可以在Time对象中保存多少时间单位（100毫微秒）。

语法

public static final long MIN_UNITS;

Time.MIN_SYSTEM_UNITS

指明最少可以在SYSTEMTIME或FILETIME结构中保存多少时间单位（100毫微秒）。

语法

public static final long MIN_SYSTEM_UNITS;

Time.UNITS_PER_DAY

指明每天有多少个时间单位（100毫微秒）。

语法

public static final long UNITS_PER_DAY;

Time.UNITS_PER_HOUR

指明每小时有多少个时间单位（100毫微秒）。

语法

public static final long UNITS_PER_HOUR;

Time.UNITS_PER_MILLISECOND

指明每毫秒有多少个时间单位（100毫微秒）。

语法

public static final long UNITS_PER_MILLISECOND;

Time.UNITS_PER_MINUTE

指明每分钟有多少个时间单位（100毫微秒）。

语法

public static final long UNITS_PER_MINUTE;

Time.UNITS_PER_SECOND

指明每秒有多少个时间单位（100毫微秒）。

语法

public static final long UNITS_PER_SECOND;

构造器

Time.Time

创建一个Time对象。

语法

public Time()

public Time(IDataStream stream )

public Time(double d )

public Time( long units )

public Time( Time t )

public Time ( SYSTEMTIME st )

public Time ( String s )

public Time ( int year, int month, int day )

public Time ( int year, int month, int day, int hour, int min, int sec )

public Time ( Variant v )

参数

stream

实现了IDataStream界面的对象，用于从永久性存储中检取日期和时间。

D

包含OLE格式时间值的double值。

Units

包含了要存储到新Time对象时间值的long数值。

T

要克隆的Time对象。

St

用于设置Time对象的SYSTEMTIME结构。

S

分析为Time对象的String对象。

Year

一个整数值，代表要设置为Time对象的年份。

Month

一个整数值，代表要设置为Time对象的月份。

Day

一个整数值，代表要设置为Time对象的日期。

Hour

一个整数值，代表要设置为Time对象的小时。该数值必须是24制的。

Min

一个整数值，代表要设置为Time对象的分钟。

Sec

一个整数值，代表要设置为Time对象的秒数。

V

用于设置Time对象的com.ms.Variant对象。

说明

Time类提供了几种构建Time对象的构造器。如果你调用第一种构造器，则所创建的Time对象就包含了当前的本地时间。如果你从OLE源中获取了时间值，你可以使用第三种接受double值为参数的构造器正确的保存时间和日期值。第八种构造器严格根据日期定义Time对象。该方法所创建的Time对象中的时间字段都初始化为午夜时间。最后一种构造器从Variant对象中构建Time对象。使用该方法与COM对象和ActiveX控件中的时间值打交道。

方法

Time.add

创建新的Time对象，代表该Time对象指定时间单位（100毫微秒）数之后的时间。

语法

public Time add( long interval )

参数

interval

一个整数值，代表给当前时间所增加的时间单位（100毫微秒）数量。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用add方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的时间单位。

下面的例子演示了如何使用add方法创建新的Time对象，该新的Time对象比初始化为当前时间的Time对象晚两个小时。

public void AddTwoHours ()

{
    // Create object that is set to current time
    Time now = new Time () ;
    //Output the current time
    System.out.println("The current time is;"+now.toString() ) ;
    //Increment the current time by two hours
   Time twoHoursLater = now.add ( Time.UNITS_PER_HOUR * 2 ) ;
    //Output the time
    System.out.println ("The time two hours from now ig"+twoHoursLater.toString() );
}

请参阅：Time.UNITS_PER_HOUR

Time.addDays

创建新的Time对象，代表该Time对象之后数天的时间。

语法

public Time addDays( double interval )

public Time addDays ( int interval )

参数

interval

一个整数值，代表给当前时间所增加的天数。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用addDays方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的天数。

下面的例子演示了如何使用addDays方法创建新的Time对象，该新的Time对象比初始化为当前日期的Time对象晚两天。

public void AddTwoDays ()

{
    // Create object that is set to current date
    Time now = new Time () ;
    //Output the current date
    System.out.println("The current date is:"+now.formatShortDate() ) ;
    //Increment the current time by two days
    Time twoDaysLater = now.addDays( 2 ) ;
    //Output the time
    System.out.println ("The date two days from now is;"+twoDaysLater.formatShortDate()  )  ;
}

请参阅：formatShortDate, addMonths, addYears

Time.addHours

创建新的Time对象，代表该Time对象之后数小时的时间。

语法

public Time addHours( long interval )

参数

interval

一个整数值，代表给当前时间所增加的小时数。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用addHours方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的小时数。

下面的例子演示了如何使用addHours方法创建新的Time对象，该新的Time对象比初始化为当前日期的Time对象晚两小时。

public void AddTwoHours ()

{
    // Create object that is set to current time
    Time now = new Time () ;
    //Output the current time
    System.out.println("The current time is;"+ now.toString() ) ;
    //Increment the current time by two hours
    Time twoHoursLater = now.addHours( 2 ) ;
    //Output the time
    System.out.println ("The time two hours from now is"+twoHoursLater.formatShortTime() ) ;
}

请参阅：addMillis, addMinutes, addSeconds, formatShortTime

Time.addMillis

创建新的Time对象，代表该Time对象之后数毫秒的时间。

语法

public Time addHours( long interval )

参数

interval

一个整数值，代表给当前时间所增加的毫秒数。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用addMillis方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的毫秒数。

请参阅：addHours, addMinutes, addSeconds

Time.addMinutes

创建新的Time对象，代表该Time对象之后数分钟的时间。

语法

public Time addMinutes( long interval )

参数

interval

一个整数值，代表给当前时间所增加的分钟数。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用addMinutes方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的分钟数。

下面的例子演示了如何使用addMinutes方法创建新的Time对象，该新的Time对象比初始化为当前日期的Time对象晚30分钟。

public void AddTwoMinutes ()

{
    // Create object that is set to current time
    Time now = new Time () ;
    //Output the current time
    System.out.println("The current date is;"+ now.toString() ) ;
    //Increment the current time by 30 minutes
    Time thirtyMinutes = now.addMinutes( 30 ) ;
    //Output the time
    System.out.println ("The time 30 minutes from now is;"+ thirtyMinutes.formatShortTime() ) ;
}

请参阅：addMillis, addHours, addSeconds, formatShortTime

Time.addMonths

创建新的Time对象，代表该Time对象之后数月的时间。

语法

public Time addMonths( long interval

参数

interval

一个整数值，代表给当前时间所增加的月数。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用addMonths方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的月数。

下面的例子演示了如何使用addMonths方法创建新的Time对象，该新的Time对象比初始化为1999年新年的Time对象晚3个月。

public String ReturnFirstQuarter( )

{
    // Create object that is set to the beginning of 1999
    Time newYears = new Time (1999.01.01) ;
    //Increment the current time by 3 moths
    Time firstQuarter = newYears.addMonths( 3) ;
    Output the date
    return firstQuarter.formatLongDate () ;
}

请参阅：formatLongDate, addDays, addYears

Time.addSeconds

创建新的Time对象，代表该Time对象之后数秒的时间。

语法

public Time addSeconds( long interval )

参数

interval

一个整数值，代表给当前时间所增加的秒数。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用addSeconds方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的秒数。

下面的例子演示了如何使用addSeconds方法创建新的Time对象，该新的Time对象比初始化为当前日期的Time对象晚30秒。

public void AddThirtySeconds ()

{
    // Create object that is set to current time
    Time now = new Time () ;
    //Output the current time
    System.out.println("The current time is;"+ now.toString() ) ;
    //Increment the current time by 30 seconds
    Time thirtySeconds = now.addSeconds( 30 ) ;
    //Output the time
    System.out.println ("The time 30 minutes from now is;"+thirtySeconds.formatShortTime() ) ;
}

请参阅：addMillis, addHours, addMinutes, formatShortTime

Time.addYears

创建新的Time对象，代表该Time对象之后数年的时间。

语法

public Time addYears( int interval )

参数

interval

一个整数值，代表给当前时间所增加的年数。

返回值

返回代表新时间的Time对象。

说明

Time对象不能被修改。可以使用addYears方法创建新的Time对象，该新Time对象的日期和时间都是根据当前的Time对象得来的，但增加interval所指定数量的年数。

下面的例子演示了如何使用addYears方法创建新的Time对象，该新的Time对象比初始化为当前日期的Time对象晚6年。

public int ReturnMastersYear ()

{
    // Create object that is set to current date
    Time StartCollege = new Time () ;
    //Increment startCollege by 6 years
    Time endMasters = startCollege.addYears( 6 ) ;
    return endMasters.getYear() ;
}

请参阅：getYear, addDays, addMonths

Time.compare

比较两个Time对象。

语法

public static int compare ( Time t1, Time t2)

参数

t1

要比较的第一个Time对象。

t2

要比较的第二个Time对象。

返回值

如果t1比t2大，就返回1；如果两个Time对象相等，就返回0；如果t2 比t1大，就返回-1。

请参阅：compareTo, equals

Time.compareTo

将该Time对象与另一个Time对象进行比较。

语法

public int compareTo ( Time t )

参数

t

要与当前Time对象进行比较的Time对象。

返回值

如果t比当前时间大，就返回1；如果两个Time对象相等，就返回0；如果当前Time对象比t大，就返回-1。

请参阅：compare, equals

Time.equals

检查是否相等。

语法

public boolean equals (Object object )

参数

object

要比较的对象。

返回值

如果object所代表的Time对象与该Time对象相同，就返回true。

说明

如果你不能确定某个对象是不是有效的Time对象，就使用该方法。要比较两个已知的Time对象，使用compare或compareTo方法。

Time.formatLongDate

以使用长日期格式的字符串形式检取Time对象。

语法

public String formatLongDate ( )

返回值

返回代表长日期格式Time对象的String对象。

说明

使用formatLongDate方法从Time对象中抽取一个日期字段。有关如何使用该方法的例子，请参阅addMonths方法。

请参阅：formatShortDate, formatLongTime

Time.formatLongTime

以使用长时间格式的字符串形式检取Time对象。

语法

public String formatLongTime ( )

返回值

返回代表长时间格式Time对象的String对象。

说明

使用formatLongTmie方法从Time对象中抽取一个时间字段。有关如何使用该方法的例子，请参阅addSeconds方法。

请参阅：formatShortTime, formatLongDate

Time.formatShortDate

以使用短日期格式的字符串形式检取Time对象。

语法

public String formatShortDate ( )

返回值

返回代表短日期格式Time对象的String对象。

说明

使用formatShortDate方法从Time对象中抽取一个日期字段。有关如何使用该方法的例子，请参阅addDays方法。

请参阅：formatLongDate, formatShortTime

Time.formatShortTime

以使用短时间格式的字符串形式检取Time对象。

语法

public String formatShortTime ( )

返回值

返回代表短时间格式Time对象的String对象。

说明

使用formatShortTime方法从Time对象中抽取一个时间字段。有关如何使用该方法的例子，

请参阅addHours方法。

请参阅：formatlongTime, formatShortDate

Time.fromFileTime

根据指定的值创建Time对象。

语法

public static Time fromFileTime ( long fileTime )

参数

fileTime

一个long值，代表创建新Time对象的Win32 FILETIME值。

返回值

返回代表fileTime参数中保存时间等价的新的Time对象。

说明

保存在fileTime参数中的值必须是Win32 FILETIME格式，这就意味着fileTime参数保存的是从1601年1月1日以来的时间单位（100毫微秒）数，即UTC时间。该方法调整基准时间，并将时间转换为本地时间。

Time.getDate

检取代表与该Time对象相同的一个Time对象，但只有日期，没有当天的时间。

语法

public Time getDate ()

返回值

返回代表该Time对象日期的新的Time对象。

请参阅：getTimeOfDay

Time.getDay

检取该Time对象所表示月份中的日期（指该月中的哪一天）。

语法

public int getDay ()

返回值

返回一个整数值，代表该Time对象所表示月份的日期。

说明

getDay方法所返回的数值总是在1和31之间。

请参阅：getDayOfWeek, getDayOfYear, getDate

Time.getDayOfWeek

检取该Time对象所表示当周中的日期（指该周中的星期几）。

语法

public int getDayOfWeek ()

返回值

返回一个整数值，代表该Time对象所表示周中的日期。

说明

getDayOfWeek方法所返回的数值总是在1和7之间，1表示星期一。

请参阅：getDayOfYear, getDay

Time.getDayOfYear

检取该Time对象所表示年份中的日期。

语法

public int getDayOfYear ()

返回值

返回一个整数值，代表该Time对象所表示年份中的日期。

说明

getDayOfYear方法所返回的数值总是在1和366之间。

请参阅：getDayOfWeek, getDay

Time.getHour

检取该Time对象所代表日期中的时间（指当天中的小时）。

语法

public int getHour ()

返回值

返回一个整数值，代表该Time对象表示日期中的时间。

说明

getHour方法所返回的数值总是在0和23之间。

请参阅：getMinute, getSecond, getMillis, getTimeOfDay

Time.getMillis

检取该Time对象所代表秒中的毫秒数。

语法

public int getMillis()

返回值

返回一个整数值，代表该Time对象表示秒中的毫秒时间。

说明

getMillis方法所返回的数值总是在0和999之间。

请参阅：getMinute, getSecond, getHour, getTimeOfDay

Time.getMinute

检取该Time对象所代表小时中的分钟数。

语法

public int getMinute()

返回值

返回一个整数值，代表该Time对象表示小时中的分钟。

说明

getMinute方法所返回的数值总是在0和59之间。

请参阅：getMillis, getSecond, getHour, getTimeOfDay

Time.getMonth

检取该Time对象所代表年份中的月份。

语法

public int getMonth()

返回值

返回一个整数值，代表该Time对象表示年份中的月份。

说明

getMonth方法所返回的数值总是在1和12之间。

请参阅：getDay, getYear, getDate

Time.getSecond

检取该Time对象所代表分钟中的秒数。

语法

public int getSecond()

返回值

返回一个整数值，代表该Time对象表示分钟中的秒数。

说明

getSecond方法所返回的数值总是在0和59之间。

请参阅：getHour, getMinute, getMillis, getTimeOfDay

Time.getTimeOfDay

创建与Time对象代表的同一天日期的Time对象，但没有指明日期（指某天中的时间）。

语法

public int getTimeOfDay()

返回值

返回代表该Time对象当天中时间的新Time对象。

请参阅：getDate

Time.getYear

检取该Time对象所代表的年份。

语法

public int getYear()

返回值

返回一个整数值，代表该Time对象所表示的年份。

说明

getYear方法所返回的数值总是在100和10000之间。

请参阅：getDay, getMonth, getDate

Time.save

将Time对象保存到永久性存储媒介中。

语法

public void save ( IDataStream stream )

参数

stream

实现了IDataStream界面的对象，用于将Time对象保存到永久性媒介中。

说明

使用save方法将Time对象保存到永久性存储媒介中，这样就可以保存Time对象的状态并在以后的时间中恢复它。你可以使用该类中的

构造器恢复所保存的Time对象。

请参阅：Time

Time.setDate

创建一个新的Time对象，包含了另外一个Time对象中的日期和本Time对象中日期中的时间。

语法

public Time setDate (Time date )

参数

date

一个Time对象，包含了与当前Time对象的时间值组合的日期。

返回值

返回一个新的Time对象，组合了date参数中的日期和当前Time对象中的时间。

说明

使用该方法创建新的Time对象，该对象是两个不同Time对象的组合。

请参阅：setTimeOfDay

Time.setTimeOfDay

创建新的Time对象，包含了该Time对象的日期和另外一个Time对象的时间。

语法

public Time setTimeOfDay (Time timeOfDay )

参数

timeOfDay

一个Time对象，包含了要与当前Time对象的日期组合的时间。

返回值

返回一个新的Time对象，是timeOfDay参数中时间值与当前Time

对象日期值的组合。

说明

使用该方法创建新的Time对象，该对象是两个不同Time对象的组合。

请参阅：setDate

Time.toDouble

检取OLE格式double类型的Time对象。

语法

public double toDouble ()

返回值

返回一个double值，包含了该Time对象的OLE格式时间值。

Time.toFileTime

检取Win32 FILETIME类型的Time对象。

语法

public long toFileTime ()

返回值

返回一个long值，包含了该Time对象的Win32 FILETIME的值。

说明

比1601年1月1日还早的时间不能转换为FILETIME值。

Time.toLocalTime

创建一个Time对象，以用户当地时区来表示该Time对象。

语法

public long toLocalTime ()

返回值

返回一个新的Time对象，以用户当地时区来表示该Time对象。

Time.toLong

检取保存在该Time对象中时间单位（100毫微秒）的数量。

语法

public long toLong ()

返回值

返回long值，代表该Time对象中从AD100年1月以来所保存时间单位（100毫微秒）的数量。

Time.toString

检取该Time对象的String对象。

语法

public String toString ()

返回值

返回一个String对象，代表保存在Time对象中时间和日期的字符串。

说明

要以长日期或短日期格式检取Time对象的字符串表达式，使用formatLongDate,formatShortDate, formatLongTime和formatShortTime方法。

Time.toSystemTime

以Win32 SYSTEMTIME结构的形式检取Time对象。

语法

public SYSTEMTIME toSystemTime ()

返回值

返回代表存储在Time对象中时间的Win32 SYSTEMTIME结构。

说明

当你需要在Win32 API中使用时间值时，就使用toSystemTime方法。比1601年1月1日还早的日期不能转换为SYSTEMTIME值。

Time.toUniversalTime

创建一个新的Time对象，以UTC时区来表示该Time对象。

语法

public Time toUniversalTime ()

返回值

返回一个新的Time对象，代表UTC时区格式的Time对象。

Time.toVariant

以com.ms.com.Variant对象的格式检取该Time对象。

语法

public Variant toVariant ()

返回值

返回com.ms.com.Variant，代表保存在该Time对象中的时间和日期。

说明

使用该方法可以将该Time对象转换为COM对象和ActiveX控件中可以使用的值。

Timer类

实现了Timer控件。

Component
   |
   +-- Timer

package com.ms.wfc.app

public class Timer

extends Component

说明

Timer控件用于在用户规定的时间间隔触发一个事件。使用该控件的timer事件来执行查询操作或每隔指定的时间就刷新屏幕。当Timer控件的enabled属性设置为true而且interval属性比0大，则每个interval属性设置值指定的时间间隔内就触发timer事件。

构造器

Timer.Timer

创建一个Timer控件。

语法

public Timer ()

public Timer ( IContainer container )

参数

container

拥有该Timer的Container对象。

说明

创建一个Timer控件实例。第二种构造器方法指明包含该Timer控件的容器，当该容器被释放时，Timer控件也将被释放。

注意：如果Timer控件的enabled属性设置为true，则在垃圾回收过程中将不释放Timer控件。

应总是将一个容器对象传递给Timer控件，这样，容器就可以正确地释放Timer控件了。

语法

public Timer ()

public Timer ( IContainer container )

参数

container

拥有该Timer的Container对象。

说明

创建一个Timer控件实例。第二种构造器方法指明包含该Timer控件的容器，当该容器被释放时，Timer控件也将被释放。

注意：如果Timer控件的enabled属性设置为true，则在垃圾回收过程中将不释放Timer控件。

应总是将一个容器对象传递给Timer控件，这样，容器就可以正确地释放Timer控件了。

方法

Timer.addOnTimer

给Timer控件增加一个timer事件处理器。

语法

public final void addOnTimer ( EventHandler value )

参数

value

要增加的EventHandler。

说明

在timer事件中你就可以放置定期运行的程序代码。当Timer控件的enabled属性设置为true而且interval属性比0大，则每个interval属性设置值指定的时间间隔内就触发timer事件。

请参阅：removeOnTimer

Timer.dispose

释放一个Timer控件。

语法

public void dispose ()

说明

Timer控件的dispose方法覆盖了com.ms.wfc.core.Component.dispose方法。Timer控件的实现在释放控件之前将控件的enabled属性设置为false。这就允许在垃圾回收过程中正确的分解并释放该控件。如果你要覆盖Timer控件，则在释放控件之前，使用该方法来执行某些必要的操作。

Timer.getEnabled

检取一个boolean值，指明控件是否处于使能状态。

语法

public final boolean getEnabled ()

返回值

如果定时器当前是使能的，就返回true；否则，就返回false。

说明

getEnabled方法允许你确定Timer控件是否处于使能状态，从而在规定的间隔内触发timer事件。

请参阅：setEnabled, start, stop

Timer.getInterval

检取Timer控件定时的时间间隔，以毫秒为单位。

语法

public final int getInterval ()

返回值

返回Timer控件定时时间间隔，以毫秒为单位。

说明

使用getInterval方法来确定Timer控件要等多少毫秒的时间才触发一次timer事件。

请参阅：setInterval

Timer.onTimer

根据Timer控件的interval属性设置值反复调用。

语法

protected void onTimer ( Event e )

参数

e

timer事件对象，总是定义为Event.EMPTY。

说明

Timer控件实现的该方法调用了任何通过addOnTimer所添加的EventHandler对象。如果你扩展了Timer控件，你可以覆盖该方法以提供自己的timer事件对象。

请参阅：com.ms.wfc.core.Event

Timer.removeOnTimer

删除Timer控件的time事件处理器。

语法

public final void removeOnTimer ( EventHandler value )

参数

value

要删除的EventHandler 对象。

说明

在timer事件中你就可以放置定期运行的程序代码。当Timer控件的enabled属性设置为true而且interval属性比0大，则每个interval属性设置值指定的时间间隔内就触发timer事件。

请参阅：addOnTimer

Timer.setEnabled

确定是否可以触发Time控件的timer事件。

语法

public final synchronized setEnabled ( boolean value )

参数

value

设置为true将使得Time控件可以触发timer事件；否则，就设置为false。

说明

使用setEnabled方法来使能或禁止触发timer事件。你可以使用该方法打开或关闭Timer控件的能力。要允许在垃圾回收过程中正确地释放Timer控件，你必须要确保在控件释放前将其

enabled属性设置为false。

请参阅：getEnabled, start, stop

Timer.setInterval

设置timer事件的时间间隔。

语法

public final synchronized void getInterval (int value)

参数

value

定时器事件之间间隔的毫秒数。如果该值比1毫秒小，则就设置为1毫秒。

说明

Timer控件并不是一个线程控件。因此，timer事件可能不是严格地按照interval属性指定的时间间隔触发的。很长的系统进程或加载其他的应用程序都可能导致timer事件延迟。

请参阅：getInterval

Timer.start

启动Timer控件。

语法

public final void start ()

说明

使用start方法来启动Timer控件从而根据interval属性的设置值定期触发timer事件。start方法与调用setEnabled方法并将true做为参数是等价的。

请参阅：stop, getEnabled

Timer.stop

停止Timer控件。

语法

public final void stop()

说明

stop方法用于停止Timer控件。从而就不再触发timer事件。stop方法与调用setEanbled方法并将false做为参数是等价的。

请参阅：start, getEnabled

Version类

检取底层操作系统的版本信息。

package com.ms.wfc.app

public class Version

说明

使用

Version方法来确定你的应用程序所运行在的操作系统版本信息，并由此决定如何在特定的系统上执行操作。不能实化Version类。

注意：不能使用Version类来确定诸如系统是否支持DirectX和MouseWheel等特征，不能由此来判断你的应用程序是否可以使用这些特征。要确定特征信息，直接查询操作系统，因为升级和服务包可以给操作系统添加新的特征。

字段

Version.bulidNumber

指明操作系统的编译版本号码。

语法

public final int bulidNumber;

说明

版本号码通常都表示为下列格式：major.minor.buildNumber。

Version.major

指明操作系统的主版本号。

语法

public final int major ;

说明

版本号码通常都表示为下列格式：major.minor.buildNumber。

Version.minor

指明操作系统的副版本号。

语法

public final int minor ;

说明

版本号码通常都表示为下列格式：major.minor.buildNumber。

Version.platformId

指明操作系统平台标识符。

语法

public final int platformId;

说明

使用platformId字段来确定你的应用程序所运行在的操作系统。该字段的值等于Version类中的WIN32S, WIN32_WINDOWS或WIN32_NT。

Version.text

指明操作系统定义的版本信息。

语法

public final String text ;

说明

text字段提供了操作系统内部定义的版本信息字符串。

Version.WIN32_NT

确定操作系统是否是Windows NT。

语法

public static final int WIN32_NT；

说明

要确定你的应用程序运行在哪个操作系统上，将该字段值与platformId字段值比较就可以了。

请参阅：platformId

Version.WIN32_WINDOWS

确定操作系统是否是Windows 95或更高版本。

语法

public static final int WIN32_WINDOWS；

说明

要确定你的应用程序运行在哪个操作系统上，将该字段值与platformId字段值比较就可以了。

请参阅：platformId

Version.WIN32S

确定操作系统是否是运行在16 Windows上的Win32s。

语法

public static final int WIN32S；

说明

要确定你的应用程序运行在哪个操作系统上，将该字段值与platformId字段值比较就可以了。

Win32s平台是16位Windows系统上的一层代码，用于提供对32应用程序的访问。

请参阅：platformId

方法

Version.getVersion

从操作系统中检取版本信息。

语法

public static Version getVersion ()

返回值

返回一个Version对象，代表操作系统的版本信息。

说明

使用getVersion方法来检取一个Version对象，该对象包含了操作系统的类型、操作系统的主版本号、副版本号以及编译版本号。

Window类

提供窗口句柄和窗口过程的底层封装。

Callback
   |
   +-- Window

package com.ms.wfc.app

public class Window

extends Callback

说明

Window类支持窗口的创建、子类和超类化。它自动管理Window类的创建和注册。在创建了Window对象之后，就可以使用createHandle方法创建窗口句柄。或者，也可以使用assignHandle方法对现有的窗口句柄子类化。使用destryHandle方法可以撤销窗口句柄。或者，也可以使用releaseHandle方法来收回对句柄的子类化。

如果窗口收到WM_NCDESTROY窗口信息，Window类就自动调用releaseHandle方法。WM_NCDESTROY消息指明Windows将撤销该句柄。

注意：当Window对象与窗口句柄关联时，其并没有资格进行垃圾回收。要正确地进行垃圾回收，必须调用destroyHandle方法或DestroyWindow Windows API函数手工撤销窗口句柄。

也可以使用releaseHandle方法来释放该句柄。一旦Window对象不再与Win32窗口句柄关联，Window对象就可以进行垃圾回收了。

方法

Window.assignHandle

给Window对象分配一个句柄。

语法

public void assignHandle ( int handle )

参数

handle

分配给该对象的句柄。

异常

如果Window对象已经有一个句柄，就产生WFCException异常。

说明

做为参数传递给assignHandle的句柄就被子类化，注意任何发送给句柄的消息都被wndProc方法接受。使用releaseHandle方法可以撤销句柄的子类化，从而将句柄窗口过程恢复为原来的值。assignHandle方法调用onHandleChange方法来指明被改变的句柄值。

请参阅：wndProc, releaseHandle, onHandleChange

Window.createHandle

创建该Window对象的窗口句柄。

语法

public void createHandle ( CreateParams cp)

参数

cp

一个com.ms.wfc.ui.CreateParams对象，代表该窗口的创建参数。

说明

分配给createHandle方法的CreateParams对象指明了那些传递给CreateWindowEx WindowsAPI函数以便创建窗口及其句柄的参数值。CreateParams对象中，如果className字段值非空，就标明新创建的窗口句柄应该子类化所指定的窗口类。例如，如果className设置为UTTON indows所定义的BUTTON窗口类的子类。CreateParams对象的param字段可以是null，也可以是使用@dll.struct命令所声明的类的实例。

请参阅：com.ms.wfc.ui.CreateParams, assignHandle, releaseHandle

Window.defWndProc

激活与该Window对象关联的缺省窗口过程。

语法

protected void defWndProc ( Message m )

参数

m

当前正被处理的消息。

说明

defWndProc是你的应用程序缺省的窗口过程。如果你子类化了Window类，你就可以覆盖该方法以便提供自己的缺省窗口过程。

注意：当Window对象的句柄是0时调用defWndProc将产生错误。

Window.destroyHandle

撤销与Window对象关联的句柄。

语法

public void destroyHandle ()

说明

使用destroyHandle方法来撤销窗口句柄。调用该方法将句柄设置为0，调用onHandleChange方法来响应对窗口句柄的修改。

请参阅：onHandleChange

Window.fromHandle

检取与特定句柄关联的Window对象。

语法

public static Window fromHandle ( int handle )

参数

handle

窗口的句柄。

返回值

返回与指定句柄关联的Window对象。如果句柄没有关联的Window对象，就返回null。

说明

fromHandle方法允许你获取与窗口句柄关联的Window对象。如果你从另外的方法中获得了

一个句柄，就可以使用该方法来检取该句柄的Window对象。

请参阅：getHandle

Window.getHandle

检取Window对象的句柄。

语法

public final int getHandle ()

返回值

返回一个窗口句柄，如果该Window对象没有关联的句柄，就返回0。

说明

当调用那些需要窗口或控件句柄的Java WFC或Windows API方法时就要使用该方法了。

请参阅：fromHandle

Window.onHandleChange

指明当窗口句柄改变时要调用的通知方法。

语法

protected void onHandleChange ()

说明

如果你子类化一个Window类，你可以覆盖该方法以便跟踪对窗口句柄的修改。

Window.releaseHandle

释放与Window对象关联的句柄。

语法

public void releaseHandle ()

说明

使用releaseHandle方法来释放与Window对象关联的句柄。该方法并不撤销句柄。相反，其将句柄的窗口过程设置为缺省窗口过程，从而收回对窗口句柄的子类化。调用该方法将句柄设置为0，调用onHandleChange方法来响应对窗口句柄的修改。

请参阅：onHandleChange, destroyHandle

Window.wndProc

指明Window对象的窗口过程。

语法

protected void wndProc ( Message m )

参数

m

与当前Windows消息关联的Message对象。

说明

当给窗口句柄发送窗口消息时就激活该方法。如果你正子类化该Window类，你就可以覆盖该方法来实施特殊的消息处理过程。Message对象包含了窗口句柄(hWnd)、窗口消息(msg)以及两个消息参数(wParam和lParam)。通过修改Message对象的result字段来设置窗口过程的结果。缺省结果是0。当覆盖wndProc时，务必为那些未处理的消息调用super.wndProc

方法。

请参阅：Message

免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn