Creating a Redistributable Setup

To distribute an ink-enabled application to computers that are not running either Windows Vista or Windows XP Tablet PC Edition 2005 (that is, computers running Windows XP, Windows Server 2003, or Windows 2000), you must include the necessary merge modules in your setup.

The Mstpcrt.msm merge module includes all of the files, resources, registry entries, and setup logic necessary for Windows Installer to install the shared files that other platforms require to run unmanaged applications developed for the Tablet PC. Mstpcrt.msm is consumed by Windows Installer (.msi) files. For applications that use the InkDivider object, you must also redistribute InkDiv.msm. For applications that use managed components, you must also include the merge module files for those managed components.

The following table describes the merge module files that ship with the Windows XP Tablet PC Edition Software Development Kit (SDK).

Redistributable Merge Module	Description	Files
InkDiv.msm	Installs the unmanaged version of the InkDivider object.	InkDiv.dll
Mstpcrt.msm	Installs the unmanaged components of the Tablet PC Platform version 1.0.	Gdiplus.dll, InkEd.dll, Tpcps.dll, Wisptis.exe
Msvcp60.msm	Installs components of the Microsoft Visual C++ runtime.	Msvcp60.dll
Msvcrt.msm	Installs components of the Microsoft Visual C runtime.	Msvcrt.dll
Tpcman17.msm	Installs the managed components of the Tablet PC Platform runtime. Requires that the mstpcrt.msm file is installed.	Microsoft.Ink.dll, Microsoft.Ink.resources.dll
iaCOM.msm	Installs the Automation components of the InkAnalysis API.	IACom.dll
iacore.msm	Installs the base class components of the InkAnalysis API.	IACore.dll IALoader.dll
IAWinFrm.msm	Installs the managed library components of the InkAnalysis API.	Microsoft.Ink.Analysis.dll
IAWinFX.msm	Installs the Windows Presentation Foundation components of the InkAnalysis API.	IAWinFX.dll
journal.msm	Installs the Journal Reader components.	Journal.dll Microsoft.ink.journal.dll
rtscom.msm	Installs the Automation components of the StylusInput namespace.	Rtscom.dll

Note

To use the functionality of the Microsoft .NET Framework that is included in merge modules for managed components, you must have installed Service Pack 2 of the Framework on the target computer.

Reduced Feature Set

Ink-enabled applications treat mouse events as pen movements to simulate working with a tablet pen. Users can add ink, erase ink, and save ink documents. However, recognition and gestures are not available for users other than those running Windows XP Tablet PC Edition.

Mstpcrt.msm does not include Windows Journal or Tablet PC Input Panel.

The PenInputPanel object does not function on any operating systems besides Windows XP Tablet PC Edition.

Deployment

Note

If your application uses managed code, you must also deploy the Framework. The Framework must be installed before your Tablet PC managed assemblies are installed.

To include Mstpcrt.msm in a Microsoft Visual Studio .NET Setup project:

1. In the Solution Explorer, select your Setup project.

2. On the Project menu, click Add, and then click Merge Module.

   Note

   You can also reach the Add Modules dialog box by right-clicking the installer project name in the Solution Explorer, clicking Add, and then selecting Merge Module.

3. In the Add Modules dialog box, navigate to and select Mstpcrt.msm.

4. Click Open.

Mstpcrt.msm is added to your Setup project and appears in the Solution Explorer window.

Windows Installer adds the files contained in the merge module to the Program Files folder. To use these files, end users must be logged on with an account that has access to the Program Files folder.

Note

You must add SelfRegModules Action and SelfUnregModules Action actions to the installation sequence. The MsiPublishAssemblies Action and MsiUnpublishAssemblies Action actions receive their order in the installation sequence from these actions.