isToggled（Key.isToggled 方法） --Flash CS3

如果激活 Caps Lock 或 Num Lock 键（切换到活动状态），则返回 true；否则返回 false。尽管“切换”一词通常是指在两个选项之间切换，但只有该键切换到活动状态，Key.isToggled() 方法才返回 true。在 Macintosh 上，Caps Lock 键和 Num Lock 键的键控代码值相同。

Flash 应用程序只能监视其焦点内发生的键盘事件。Flash 应用程序无法检测其它应用程序中的键盘事件。

参数

code:Number ― Caps Lock 键 (20) 或 Num Lock 键 (144) 的键控代码。

Boolean ― 如果激活 Caps Lock 或 Num Lock 键（切换到活动状态），则返回 true；否则返回 false。

示例

下面的示例在每次按某个键时调用 isToggled() 方法，并且在每次 Caps Lock 键切换到活动状态时执行 trace 语句。该示例通过调用 Key.isToggled() 创建名为 keyListener 的侦听器对象并定义响应 onKeyDown 事件的函数。接着，向 Key 对象注册 keyListener 对象，这样，在播放 SWF 文件时，只要按任意键，都会广播 onKeyDown 消息。

var keyListener:Object = new Object();
keyListener.onKeyDown = function() {
if (Key.isDown(Key.CAPSLOCK)) {
trace("you pressed the Caps Lock key.");
trace("\tCaps Lock == "+Key.isToggled(Key.CAPSLOCK));
}
};
Key.addListener(keyListener);

当您按 Caps Lock 键时，将在“输出”面板中显示信息。“输出”面板显示 true 或 false，具体取决于是否使用 isToggled 方法激活了 Caps Lock。

下面的示例创建两个文本字段，它们会在切换 Caps Lock 键和 Num Lock 键时更新。每个文本字段在键被激活时显示 true，在键被取消激活时显示 false。

this.createTextField("capsLock_txt", this.getNextHighestDepth(), 0, 0, 100, 22);
capsLock_txt.autoSize = true;
capsLock_txt.html = true;
this.createTextField("numLock_txt", this.getNextHighestDepth(), 0, 22, 100, 22);
numLock_txt.autoSize = true;
numLock_txt.html = true;
//
var keyListener:Object = new Object();
keyListener.onKeyDown = function() {
capsLock_txt.htmlText = "<b>Caps Lock:</b> "+Key.isToggled(Key.CAPSLOCK);
numLock_txt.htmlText = "<b>Num Lock:</b> "+Key.isToggled(144);
};
Key.addListener(keyListener);

此示例中使用的 MovieClip.getNextHighestDepth() 方法要求 Flash Player 7 或更高版本。如果您的 SWF 文件包括第 2 版的组件，请使用第 2 版组件的 DepthManager 类代替 MovieClip.getNextHighestDepth() 方法。