Copyright © 1998-2010 MultiMedia Soft

How to use the control in your projects

Previous pageReturn to chapter overviewNext page

First, if anything in this guide is unclear to you, please feel free to contact our support team. We are usually able to answer our customer's questions in 24 hours or less.

 

DESIGN-TIME:

 

Add the control to your current project as you would with any other ActiveX control in your current development environment.

Once inserted, the control will appear in its default state. In order to change its appearance and behavior right-click and select the Properties item from the contextual menu. The control's property sheet will appear as follows.

 

3dabm_i000124

 

From this property sheet you can choose from the following options:

Select the button's style (see the How to change the button style section for further details about button styles).
Edit the button's properties.
Refresh the control.

Pressing the Edit properties... button will launch the 3D Button Visual Editor application that will not only allow changing most of the button's settings but also a full control over the button behaviour in its available states (Pressed, Mouse over, Disabled, etc.).

3dabm_i0000b0

After having edited the button with your preferred settings, you can save or discard the new button's settings closing the application.

3dabm_i0000b3

 

RUN-TIME:

The control's appearance and behavior can also be modified at run-time. For those using the product within the C++ environment, the download package includes a module named 3dabm8.h that will help you with the mnemonic constants required by the control. This module can be found inside the Include directory created by the setup package (the default is C:\Program files\3D Active Button Magic\include).

As explained below, the demo modules for Visual Basic 6, Visual Basic.NET and Visual C# (that were available until version 6 of the control) have been discontinued due to the new internal object-oriented design of the control. Go to the How to use Mnemonic Constants section for details.

Using the control inside Microsoft Visual C++.NET

The use of ActiveX controls within projects developed using Visual C++.NET and MFC creates particular issues users must be aware of: as for Visual C++ 6.0, ActiveX controls require wrapper classes in order to be used in this environment. Usually these wrapper classes are generated automatically by the environment but, due to a bug inside Visual C++.NET, the wrapper class will result incomplete when dealing with ActiveX controls that, in order to maintain backward compatibility, alternates identifiers of properties and methods. For this reason our control comes with its already generated C++ wrapper classes, installed by the setup package inside the "include" directory (by default the complete path should be C:\Program files\3D Active Button Magic\\include\wrappers\cpp.net). This issue implies to perform some manual action when creating a variable associated to the control. We recommend integrating these wrapper classes into your projects using the following procedure:

Copy the following wrapper files into your project directory:
BtnEnh.cpp and BtnEnh.h
Cellsmanager.cpp and Cellsmanager.h
Font.cpp and Font.h
TextDescriptor.cpp and TextDescriptor.h
SurfaceColor.cpp and SurfaceColor.h
Texture.cpp and Texture.h
Add the wrapper files to your project.
Create one variable associated with a 3D Active Button Magic button, declaring the variable itself of type CBtnEnh without using the wizard provided by the environment.
Intellisense will now be able to display all the wrapper functions for all the control's COM interfaces.