WebPart.CreateWebPartMenu-Methode
Nach dem Microsoft ASP.NET Load -Ereignis aufgerufen und zu ändern oder zu überschreiben, klicken Sie im Menü Standardeinstellung verwendet.
Namespace: Microsoft.SharePoint.WebPartPages
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Overridable Sub CreateWebPartMenu
'Usage
Dim instance As WebPart
instance.CreateWebPartMenu()
public virtual void CreateWebPartMenu()
Hinweise
Die CreateWebPartMenu -Methode wird aufgerufen, nachdem das geerbte System.Web.UI.Control.Load -Ereignis eingetreten ist, um das Webpart zum Festlegen der Eigenschaft WebPartMenu zu benachrichtigen.
Beispiele
Das folgende Codebeispiel zeigt eine überschriebene CreateWebPartMenu -Methode, die ein übergeordnetes Menüelement und zwei Menüelemente im Webpartmenü Standard hinzufügt. Es wird davon ausgegangen, dass diese Methode Teil einer WebPart -Klasse, die enthält zwei benutzerdefinierte booleschen Eigenschaften, ParentItemIsVisible und EnableItem1 ist, können Sie steuern, wenn diese Menüelemente im sichtbar und aktiviert sind. Ein Ereignishandler mit dem Namen EventHandlerForItem1 sollte auch erstellt werden.
Public Overrides Sub CreateWebPartMenu()
' Declare variables for menu items.
Dim ParentItem As MenuItem
Dim Item1 As MenuItem
Dim Item2 As MenuItem
' Create three menu items:
' One parent item, and two submenu items.
' Create the parent item.
ParentItem = New MenuItem("ParentItem", "", "ParentItemID")
' Create a submenu item with a server event on click.
Item1 = New MenuItem("Item1", "Item1ID", New EventHandler(AddressOf EventHandlerForItem1))
' Create a submenu item with a client event on click.
Item2 = New MenuItem("Item2", "javascript:alert('Item2 was clicked.');", "Item2ID")
' Add the submenu items to the parent item.
ParentItem.MenuItems.Add(Item1)
ParentItem.MenuItems.Add(Item2)
' Add the parent item after the "Modify Shared/Personal Web Part"
' command in the default menu.
' Retrieve the index of the "Modify Shared/Personal Web Part" command.
Dim EditIndex As Integer = Me.WebPartMenu.MenuItems.IndexOf(Me.WebPartMenu.MenuItems.ItemFromID("MSOMenu_Edit"))
' Insert the parent item after the "Modify Shared/Personal Web Part" command.
Me.WebPartMenu.MenuItems.Insert(EditIndex + 1, ParentItem)
' Add a separator above the parent item.
ParentItem.BeginSection = True
' Check the "ParentItemIsVisible" custom Boolean property to decide whether to display the parent menu.
If Me.ParentItemIsVisible = True Then
ParentItem.Visible = True
Else
ParentItem.Visible = False
End If
' Check the "EnableItem1" custom Boolean property to decide which menu item to enable.
' within the parent item.
If Me.EnableItem1 = True Then
Item1.Enabled = True
Item2.Enabled = False
Else
Item1.Enabled = False
Item2.Enabled = True
End If
End Sub
public override void CreateWebPartMenu()
{
// Declare variables for menu items.
MenuItem ParentItem;
MenuItem Item1;
MenuItem Item2;
// Create three menu items:
// One parent item, and two submenu items.
// Create the parent item.
ParentItem = new MenuItem("ParentItem", "", "ParentItemID");
// Create a submenu item with a server event on click.
Item1 = new MenuItem("Item1", "Item1ID", new EventHandler(EventHandlerForItem1));
// Create a submenu item with a client event on click.
Item2 = new MenuItem("Item2", "javascript:alert('Item2 was clicked.');", "Item2ID");
// Add the submenu items to the parent item.
ParentItem.MenuItems.Add(Item1);
ParentItem.MenuItems.Add(Item2);
// Add the parent item after the "Modify Shared/Personal Web Part"
// command in the default menu.
// Retrieve the index of the "Modify Shared/Personal Web Part" command.
int EditIndex = this.WebPartMenu.MenuItems.IndexOf(this.WebPartMenu.MenuItems.ItemFromID("MSOMenu_Edit"));
// Insert the parent item after the "Modify Shared/Personal Web Part" command.
this.WebPartMenu.MenuItems.Insert(EditIndex + 1, ParentItem);
// Add a separator above the parent item.
ParentItem.BeginSection = true;
// Check the "ParentItemIsVisible" custom Boolean property to decide whether to display the parent menu.
if (this.ParentItemIsVisible == true)
{
ParentItem.Visible = true;
}
else
{
ParentItem.Visible = false;
}
// Check the "EnableItem1" custom Boolean property to decide which menu item to enable.
// within the parent item.
if (this.EnableItem1 == true)
{
Item1.Enabled=true;
Item2.Enabled=false;
}
else
{
Item1.Enabled=false;
Item2.Enabled=true;
}
}