Using the Microsoft 3-D Controls Library

Note

Usage of Ctl3d is now obsolete and should be used only for backward compatibility

You can load and unload the Microsoft 3-D Controls Library with the function TApplication::EnableCtl3d(). EnableCtl3d takes one parameter, a bool, and returns a void. When you pass true to EnableCtl3d, the function loads the DLL if it is not already loaded. When you pass false to EnableCtl3d, the function unloads the DLL if it is not already unloaded.

You can find out if the Microsoft 3-D Controls Library DLL is loaded by calling the function TApplication::Ctl3dEnabled(). Ctl3dEnabled takes no parameters. If the DLL is loaded, Ctl3dEnabled returns true; if not, Ctl3dEnabled returns false.

To create a 3-D effect with non-ObjectWindows dialogs, you can turn autosubclassing on with the EnableCtl3dAutosubclass function. To use this function, first load the Microsoft 3-D Controls Library DLL with EnableCtl3d. EnableCtl3dAutosubclass takes one parameter, a bool, and returns a void. You can pass true to EnableCtl3dAutosubclass to turn autosubclassing on or false to turn autosubclassing off.

You can turn autosubclassing off immediately after creating the dialog box; it is not necessary to leave it on while displaying the dialog box.

See Also

• Application message handling
• Application objects overview
• Closing applications
• Initializing applications