Windows XP Media Center Edition SDK Adding the Triple-tap/Soft-keyboard Control to an Application 

Adding the Triple-tap/Soft-keyboard Control to an Application

The Triple-tap/Soft-keyboard control is implemented as a dynamic link library (DLL) called Ehkeyctl.dll that is installed on all Windows XP Media Center Edition 2005 and later PCs in the following location:

where %windir% specifies the location where Windows is installed.

You can use any ActiveX-enabled Web page design tool (for example, Microsoft FrontPage) to add the Triple-tap/Soft-keyboard control to an HTML page. For information about using ActiveX controls with your specific Web page design tool, please see the documentation for your design tool.

Microsoft provides the Triple-tap/Soft-keyboard control as a redistributable cabinet file (tripletap.cab) that you can include on your Web page for download by users of Windows XP Media Center Edition 2004. Please see the redist.txt file included with the Media Center SDK for information about your redistribution rights. The CODEBASE attribute of your page's OBJECT element should specify your server and version number. For example:

A version number of "#Version=-1,-1,-1,-1" ensure that the control is only downloaded when it is not already present on the user's computer.

You add the Triple-tap/Soft-keyboard control to an HTML page by using the HTML OBJECT element, specifying the following value for the CLASSID attribute:

The CLSID is the registered, globally unique identifier (GUID) for the control on the local machine.

The control exposes many properties that you can use to affect the control's appearance and behavior. You can set the values of these properties by using PARAM elements inside the OBJECT element used to create the control. For information about the properties exposed by the control, see Triple-tap/Soft-keyboard Control Object Model Reference.

The attributes and settings of the control are configurable through scripting. For example, an HTML application can set the magnification scale of the Triple-tap/Soft-keyboard control by setting the value of the body.style.zoom DHTML attribute. The application typically sets this attribute by using a handler for the MediaCenter.onScaleEvent event.

The following topics provide examples that show how to use the triple-tap and soft keyboard modes of the Triple-tap/Soft-keyboard control.

See Also

• Using the Triple-tap/Soft-keyboard Control

© 2005 Microsoft Corporation. All rights reserved.