Search

Atalasoft Knowledge Base

INFO: Solutions for missing Atalasoft controls from within Visual Studio toolbox

Administrator
DotImage

If you have recently installed the Atalasoft SDK and the controls are not showing in your Visual Studio toolbox, we can assist you in solving this.

Please note that the older "Client Profile" versions of .NET Framework as well as modern UWP and .NET Core (.NET Core 3.1 / .NET 5/6) are not supported.

So first and foremost, you want to be targeting Windows Forms Application (.NET Framework)

DotImage has legacy web controls but these are being phased out and should not be used for new web projects - so if you came here looking for help on getting toolbox items for Web Forms apps, please note that this is a deprecated/legacy feature that should not be used - instead, please head over to
INFO: WebDocumentViewer Whitepaper - Getting Started With Web Viewing and use the modern WebDocumentViewer instead.

Easy Mode

DotImage registers toolbox items in whatever Visual Studio versions are currently installed at install time. Sometimes it's just a matter of
installing/updating to the latest version of DotImage.

If that resolves the issue, yay! If not, the next step is to try manually adding the controls to your toolbox.

Manually Adding Toolbox Items

Open / start a new Windows Forms project for either C# or VB.NET

Make sure if you're on newer visual studio versions, that you explicitly are choosing Windows Forms Application (.NET Framework) as the somewhat confusing naming for modern MS development may lead you to accidentally choose .NET Windows Forms Application, which is (in newer versions) actually .NET Core and not compatible with DotImage (at this time)

For Visual Studio 2019 and older, make sure you set your application's platform target to x86, for VS2022 and newer, set it to x64.

You can do this by right clicking on your project in Solution Explorer and selecting Properties, Then go to the Build tab (C#) or Compile tab (VB), and set the appropriate "bitness" for Platform Target

Next, make sure the form designer tab is visible (toolbox will not populate if it's not) and have a look at your toolbox. If there's an Atalasoft tab there, you may be all set.

If there's not, or if the Atalasoft tab is empty, then move on to next steps

If it's not there, create a new tab called Atalasoft

Right click on that tab and select the Choose Items option

The Choose Items dialog will take some time to populate, you want the .NET Components tab which should be the default on opening

Once it's done populating, you may want to widen the dialog a bit to make the next steps easier

Click on the Directory column so that it sorts by directory, and look to see if there's directories starting with

C:\Program Files (x86)\Atalasoft\ ...

If so, then look carefully at the rest of the path.. it will follow the pattern

... \DotImage 11.3\bin\3.5\x86\
... \DotImage 11.3\bin\3.5\x64\
... \DotImage 11.3\bin\4.5.2\x86\
... \DotImage 11.3\bin\4.5.2\x64\

If you do not see any such directories listed then you can click the Browse button

What you want to do here is browse to the correct path depending on specifics.. if you're using VS2019 or older you want either

C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\3.5\x86\
or
C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\4.5.2\x86\

Which one depends entirely on which .NET Framework you're targeting - the 3.5 path is only if you're targeting .NET framework 3.5. Otherwise, you want the 4.5.2 path to target .NET Framework 4.5.2. or up (up to 4.8). NOTE we do not support .NET Core 3.1 or .NET 5 or .NET 6 at this time

Select that path and then within that find the

Atalasoft.dotImage.WinControls.dll

Select that and hit Open

When you go back to the dialog you should now have multiple Atalasoft toolbox items among your choices. Select those and Click the OK button

NOTE if the list already has items pay EXTRA CAREFUL ATTENTION to the path - you want to ONLY add items for the framework and bitness you're targeting - otherwise you'll fill your toolbox with incorrectly targeted duplicates and it will be a bit of a mess to decide which one

If you're supporting multiple different versions of DotImage consider making separate tab for each version such as Atalasoft 11.3 and Atalasoft 11.4 as separate items to avoid confusion

Visual Studio 2022 and Newer

Visual Studio 2022 represents an important change in the Visual Studio line. Up until this version, every past Visual Studio edition has been a 32 bit (x86) application. Starting with VS2022, it is now a 64 bit app. This has important ramifications.

For toolbox items and Visual Studio designer it means you need to now be targeting x64 in your winforms apps for the designer to work and for your app to debug correctly in Visual Studio. For previous versions, you would need to taret x86 and reference our x86 dlls.

So, just make sure you translate any instructions in this article to reference x64 and use the dlls from

C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\4.5.2\x64\
or
C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\3.5\x64

as appropriate

Client Profile Versions Not Supported

Side note for those using older Visual Studio where this applies: Please ensure you are targeting .NET Framework 3.5 or .NET Framework 4.5.2 through 4.8. In C# it is under your project properties, in the "Application" tab. There is a drop down titled "Target framework:", also, make sure it doesn't have "Client Profile" in the name. If it does, change it to the equivalent .Net target without "Client Profile" and the controls should appear if they were registered on installation.

Original Article:
Q10352 - INFO: Solutions for missing Atalasoft controls from within Visual Studio toolbox

Details
Last Modified: 2 Months Ago
Last Modified By: Tananda
Type: INFO
Article not rated yet.
Article has been viewed 239 times.
Options
Also In This Category