ASP.NET Text Menu - How-To and Help





For any questions send us a support request.




1. How to use Text Menu in my asp.net page?

At the top of your ASP.NET source-code page add:
    <%@ Register TagPrefix="tm" Namespace="OboutInc.TextMenu" Assembly="Obout_TextMenu" %>
You can now use Text Menu just like in the examples.

Text Menu can also be added to the Toolbox of Visual Studio and you can drag it on the page where you want it to appear.
To see how to do this, take a look at How to add Text Menu to the Visual Studio Toolbox?





2. How to add a reference to Text Menu in VS?

Go to toolbar menu Project > Add Reference > Click button 'Browse' >
> Find obout_TextMenu.dll > Click 'Open' > Click OK

Text Menu can also be added to the Toolbox of Visual Studio and you can drag it on the page where you want it to appear.
To see how to do this, take a look at How to add Text Menu to the Visual Studio Toolbox?





3. How to install component on shared hosting server?

Make request to Customer Service of your hosting service.
They will install the component for you.






4. How to change the theme of the menu?

Change the property StyleFolder to match the folder with theme you want.
Take a look at examples to see the available themes (styles).






5. How to use images for SubMenus?

Take a look at this tutorial: Using Submenu Icons






7. How to create my own menu theme?

See tutorial page here

Create a new folder inside Styles with the name of your new theme.
Copy the file Styles/style.css inside this folder.
Modify the included CSS classes:
.parentMenuContainer
.parentMenuContainer a
.parentMenuContainer #tm_subMenuWidthImage

.parentMenuItem
.parentMenuItem #tm_contentCell
.parentMenuItem #tm_contentCell a
.parentMenuItem #tm_submenuCell

.parentMenuItemOver
.parentMenuItemOver #tm_contentCell
.parentMenuItemOver #tm_contentCell a
.parentMenuItemOver #tm_submenuCell

.menuContainer
.menuContainer a
.menuContainer #tm_subMenuWidthImage

.menuItem
.menuItem #tm_contentCell
.menuItem #tm_contentCell a
.menuItem #tm_submenuCell

.menuItemOver
.menuItemOver #tm_contentCell
.menuItemOver #tm_contentCell a
.menuItemOver #tm_submenuCell


Note: you might not need to define all the styles above.

Take a look at the existing themes for examples.






10. Can the menu overlap frames?

At the current version, the menu cannot overlap frames.
To overcome this, you can use inline frames (IFRAME), tables or layers (DIV, SPAN) in combination with CSS.
For more info on how to use layers instead of frames, take a look here:
      http://www.456bereastreet.com/lab/cssframes/
      http://www.gyford.com/phil/writing/2004/03/26/goodbye_frames_.php






13. How to add Text Menu to the Visual Studio Toolbox?

For Visual Studio:
Go to toolbar menu Tools > Choose Toolbox Items... > Click button 'Browse...' >
> Find obout_TextMenu.dll > Click 'Open' > Click OK

To see how add a reference to the component in Visual Studio, read How to add reference to dll in Visual Studio project?






14. Where to put folder 'Styles' ?

You can put folder 'Styles', which can be downloaded with the component suite, into 'C:\Inetpub\wwwroot'.

You can also put it to any other location on your web server under the root folder.

Use web relative paths:
- If folder was placed in 'C:\Inetpub\wwwroot':
TextMenu1.StyleFolder = "/Styles/Style1"

- If folder was placed in 'C:\Inetpub\wwwroot\MyPath':
TextMenu1.StyleFolder = "/MyPath/Styles/Style1"

- If folder was placed in the same folder with your aspx file:
TextMenu1.StyleFolder = "Styles/Style1"

Also see How to set path for my page?
Also see How to run examples?







15. How to run examples? I am new to web programming.

Please check this page.


TIP: How to add reference to dll in Visual Studio project?
TIP: How to add TextMenu to the Visual Studio Toolbox?
Note: You don't need to create VS project to run examples.






17. How to add links to menu items ?

Menu items have two properties that help you open new pages on click:
· Url - sets the page to be opened
· UrlTarget - the target frame to open the page

Url can be any URL of a page (relative or absolute), just like the href of a link.

UrlTarget can be:
- the name of an existing frame or iframe in the page
- _blank to open in a new browser window
- _top to open in the top document of the current window
- _self to open instead of the current page

Url can also contain JavaScript commands that can be executed on click. Take a look at JavaScript Links tutorial




19. What browsers are supported?

Text Menu has been tested and works the same under Internet Explorer, Netscape Navigator, Mozilla FireFox, Safari and Opera.


Note: Text Menu might also work correctly under other browsers, but it has not been tested yet.



21. Does Text Menu work with ASP classic too, or only with ASP.NET?

Unfortunatelly this component does not work with ASP classic, only with ASP.NET.



22. How to make the menu transparent?

Take a look at the Transparent Text Menu Example



23. Is working perfectly on my development server, but it doesn't work on the production server.

On the server,

1. Open IIS console and go into properties of your website.
2. Switch to "Home Directory" tab.
3. Click on "Configuration" button under "Application Settings".
4. In the new window go into "Mappings" tab.
5. Copy (into notepad for example) all values for .aspx extension.
6. Click "Add" button to add a new entry.
7. "Executable" field is the same as the path for .aspx extension
(example: c:\windows\microsoft.net\framework\v2.0.50727\aspnet_isapi.dll).
8. "Extension" field must be ".axd".
9. Verbs are limited to "GET,HEAD,POST,DEBUG".
10. Uncheck "Verify that file exists" (important that it is unchecked).

Click OK on all open dialogs. 
This should now reference web resource files correctly.





24. Does Text Menu work inside User Control or Master Page?

Yes, Text Menu works inside User Control or Master Page.
Download ready working examples with source code.




"I try out other tools from time to time but always end up seeing if I can do what I need with the obout suite because you make the best ones!"

Daniel C. Hall