Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

User Interfaces Frequently Asked Questions

Visual Studio 2005
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

This topic addresses questions from the Visual Studio SDK user community about user interfaces. The topic will continue to be updated with new content from the community.

Contents

Extending the File Convert Dialog

Q: Is there a way to extend the Convert dialog box?

A: Yes, the Convert dialog box is extensible. Use the following guidelines when extending the Convert dialog box:

  • A converter is a wizard. This means it is a COM object and must implement EnvDTE IDTWizard interface. This COM object is instantiated by calling ILocalRegistry::CreateInstance. The COM object can either be registered globally under HKCR\CLSID, or it can be registered under the Visual Studio local hive (for example, HKLM\Microsoft\VisualStudio\8.0\CLSID). Registering under the Visual Studio local hive might facilitate better compatibility with future side-by-side installations of Visual Studio.

  • The converter must have a CLSID added to the HKLM\SOFTWARE\Microsoft\VisualStudio\8.0\Converters registry hive.

  • The converter must have an entry in Converts.dir, in the \Program Files\Microsoft Visual Studio 8\Common7\IDE\ directory, with the following format:

    RelativePathToVSZFile|RelativePathToIcon|LocalizedName|LocalizedDescription|Priority
    

    For example:

    vsz\Sample.vsz|images\Sample.bmp|Sample Wizard|This is a Sample Wizard Description|1
    
  • The application must have a VSZ file with the following information (this file can be installed in the \Program Files\Microsoft Visual Studio 8\Common7\IDE \VSZ\ directory):

    VSWizard 7.0
    Wizard=CLSID
    Param1=”Value=Key”
    ParamN=”Value=Key”
    
  • Note that the first line of this file must be “VSWizard 7.0,” and CLSID is the CLSID of the converter COM object. For example:

    VSWizard 7.0
    Wizard={12161B65-D5B1-49b3-AF4D-0269BC754F7F}
    Param="msg=TEST"
    
  • The following context parameters are passed to the converter wizard in the LaunchWizard method:

    ContextParams
    [0] "{A5B66A92-9F46-4A9D-85F6-ADC9DF03A410}" // Wizard type GUID : Converter Wizard
    [1] true|false // bool fAddToCurrentSolution
    

See Also

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.