September 2007
Beginner
448 pages
10h 2m
English
To add a menu to a web part, override the Verbs property to add WebPartVerb objects to the web part's WebPartVerbCollection. Web part menus can respond to events with server-side code, client-side code, or both. The following example adds two menu items to a web part:
The Save Settings item runs server-side code to save the web part properties.
The Help item runs JavaScript to display a help page in a new window.
public override WebPartVerbCollection Verbs
{
get
{
// Create a list to hold the verbs.
ArrayList verbSet = new ArrayList( );
// Add the built-in verbs to the list.
verbSet.AddRange(base.Verbs);
// Create a custom server-side verb.
WebPartVerb vSave = new WebPartVerb("vSave",
new WebPartEventHandler(vSave_Click));
vSave.Description = "Saves web part properties.";
vSave.Text = "Save Settings";
// Add it to the list of verbs.
verbSet.Add(vSave);
// Create a custom client-side verb.
WebPartVerb vHelp = new WebPartVerb("vHelp",
"javascript:window.open('page1.aspx','_help',
'height=200,width=200');");
vHelp.Description = "Show Help in new window.";
vHelp.Text = "Help";
// Add it to the list of verbs.
verbSet.Add(vHelp);
// Return the new list.
return new WebPartVerbCollection(verbSet);
}
}
protected void vSave_Click(object sender, WebPartEventArgs e)
{
this.SetPersonalizationDirty( );
}Figure 11-14 shows the web part menu in action.

Figure 11-14. Adding a menu item to ...