VG.net Readme

Thank you for using VG.net!

This document contains notes for using VG.net. You can find additional tips and tricks for VG.net at the development blog: http://weblogs.asp.net/frank_hileman. The VG.net home page is www.vgdotnet.com.

1. Getting Started

Please see the VG.net Users Guide section titled "Getting Started". You will find a shortcut to the Users Guide on the Start Menu, under the folder VG.net.

Some sample code is installed by the regular VG.net installation. You will find a link to the sample code in your start menu, under VG.net X/Samples, where "X" is the main VG.net version number. Extra sample code is also provided. This is called the Extras package, and must be installed separately when using Visual Studio versions prior to 2012. With later versions, the Samples and Extras are both combined and installed with the regular installer, and can be found in a single zip file. There is a short cut to this zip file in the start menu.

Missing Toolbar buttons? Sometimes the toolbar buttons and context menu items for Visual Studio fail to install correctly. If you notice missing items, please open the Add/Remove Programs window in the Control Panel, find VG.net, click on the link called "Click here for support information", and click on the Repair button.

2. License Agreement

The end user license agreement can be found in the file EULA.rtf, found in the main VG.net installation folder. Please note that the file Prodige.Drawing.dll may be redistributed only by companies who have purchased a designer license. No other files may be redistributed.

3. Support

If you have purchased a VG.net Picture Designer license, you will receive support contact information in your email receipt. If you are using a Lite or evaluation version of the Picture Designer, there is no official support, but please send bug reports or comments to support at vgdotnet.com, or post a message on the VG.net discussion forums at www.vgdotnet.com/forums.

4. Version Numbers and Source Code Compatibility

The major VG.net version number indicates the corresponding compatible Visual Studio version:

As much as possible, VG.net APIs are source code compatible between 8.x, 7.x, 6.x, and 5.x releases. In the future, enhancements made in 8.x versions will appear in version 7.x and 6.x releases. If you purchase a VG.net designer license, you receive setup files for 8.x, 7.x, and 6.x versions.

5. Visual Studio 2013, 2012, and 2010 Notes

If you install multiple versions of VG.net on the same computer, please select the correct version of Prodige.Drawing.dll for your project references. Normally the dll reference SpecificVersion property can be left false, but when using multiple versions of Visual Studio, the SpecificVersion property must be set to true, to ensure the correct dll version is used. Use an 8.x version of Prodige.Drawing.dll for Visual Studio 2013; use a 7.x version for Visual Studio 2012; use a 6.x version for Visual Studio 2010; use a 5.x version for Visual Studio 2008.

6. Upgrading and Incompatibility of .resx Files

When using Visual Studio 2003, .resx files produced for Forms and UserControls containing Pictures have data later versions of Visual Studio cannot process. To work around this problem, delete .resx files for Forms and UserControls containing Pictures. If the .resx files contain important information, such as bitmaps, repair them: delete elements in the xml containing a Location property for a Picture. These elements are type System.Drawing.Point, for example:

<data name="autoSizeTest.Location" type="System.Drawing.Point, System.Drawing, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"><value>17, 17</value>

Design-Time Properties

Modifiers property: Use this property, under “Design,” to make the corresponding generated field for each Element private, public, protected, shared/friend, etc.

GenerateMember property: Use this property, under “Design,” to specify whether a member or field is generated for each Element. By generating members only for animated Elements, you can reduce the memory consumed by your Picture: select each non-animated Element and set GenerateMember to false.

Known Issues

C++ Picture Designer: The VG.net Picture Designer works for C++ classes. Unfortunately a C++ compiler bug prevents use of the generated files in Visual Studio.

Superflous Toolbox Items: If you find your projects are opening or closing slowly, try resetting the toolbox. Another solution is to delete .suo files periodically. Set the option Windows Forms Designer\AutoToolboxPopulate to false, to avoid creating bad toolbox items.

7. Changes

Version 8.5

This version has no run-time changes. The main change is Visual Studio 2013 support.

Version 7.4b

Bug Fixes

Versions 7.4a, 6.4a, and 5.4a

Designer Enhancements and Bug Fixes

Bug Fixes and Breaking Changes

Samples

Versions 6.3b and 5.3b

Bug Fixes

Samples

Versions 6.3a and 5.3a

Bug Fixes

Versions 6.2 and 5.2

Designer Enhancements

Samples

Bug Fixes and Obsolete Members

Versions 3.1, 4.1, 5.1

Designer Enhancements

Run-time Only Enhancements

Bug Fixes and Obsolete Members

Versions 3.0 and 4.0

Designer Enhancements

Run-time Only Enhancements

Bug Fixes and Obsolete Members

Version 2.7a

Designer Enhancements

Samples

Run-time Only Enhancements

Bug Fixes and Obsolete Members

Version 2.6b

Run-time Only Enhancements

Bug Fixes and Obsolete Members

Version 2.6a

Designer Enhancements

Run-time Only Enhancements

Bug Fixes and Obsolete Members

Version 2.5

This version contained only internal changes.

Version 2.4b

Designer Enhancements

Run-time Only Enhancements

Bug Fixes and Obsolete Members

Version 2.4a

Designer Enhancements

Run-time Only Enhancements

Bug Fixes and Obsolete Members

Version 2.3

Version 2.2

Version 2.1b

Version 2.1

8. Future Features

To request an enhancment, please post to the Enhancements forum at:

www.vgdotnet.com/forums

Some possible future features: