Gewusst wie: Verwenden von Smartphone-Menüs
Aktualisiert: November 2007
.NET Compact Framework erzwingt die folgenden Menübeschränkungen, um die Kompatibilität mit der Smartphone-Benutzeroberfläche sicherzustellen:
Es können nur zwei Menüelemente der obersten Ebene vorhanden sein.
Nur das zweite Menüelement der obersten Ebene (auf der rechten Seite des Formulars) darf über Untermenüs verfügen.
Beachten Sie, dass diese Beschränkungen von .NET Compact Framework nicht zur Entwurfszeit erzwungen werden, sondern dass zur Laufzeit eine NotSupportedException-Ausnahme ausgelöst wird, wenn der Code die Beschränkungen nicht einhält.
Menüelemente der obersten Ebene können zur Laufzeit nicht gelöscht werden. Sie können jedoch die Enabled-Eigenschaft eines MenuItem auf eine leere Zeichenfolge ("") festlegen, damit ein Menüelement nicht sichtbar ist.
Visual Studio fügt dem Formular beim Erstellen von Smartphone- und Pocket PC-Anwendungen automatisch eine MainMenu-Komponente hinzu. Untergeordneten Formularen wird diese Komponente jedoch nicht hinzugefügt. Mit der MainMenu-Komponente werden die Smartphone-Bildschirmtasten ausgeführt, deren Funktionsweise jedoch nur dann programmiert werden kann, wenn Sie die MainMenu-Komponente aus dem Formular entfernen. Weitere Informationen über das Programmieren von Bildschirmtasten finden Sie unter dem Thema zur Verwendung der Smartphone-Rücktaste und -Bildschirmtasten.
Um eine Methode einer Menüauswahl zuzuordnen, geben Sie Code für das Click-Ereignis für ein MenuItem an.
Beispiel
In diesem Beispiel wird ein Menüsystem für ein Szenario definiert, in dem Maps ausgewählt werden:
Auf der linken Seite befindet sich das Menüelement Map Help, dessen Ereignisbehandlungscode ein Meldungsfeld aufruft.
Auf der rechten Seite befindet sich das Menüelement Maps, das über zwei untergeordnete Elemente verfügt: My Maps und Add and Remove. Diese untergeordneten Elemente verfügen ihrerseits über fünf bzw. zwei untergeordnete Elemente.
Imports System
Imports System.Windows.Forms
Public Class Form1
Inherits System.Windows.Forms.Form
Friend WithEvents MainMenu1 As System.Windows.Forms.MainMenu
Private WithEvents mi1 As New MenuItem
Private mi2 As New MenuItem
Private miChildA As New MenuItem
Private miChildB As New MenuItem
Private WithEvents miGrandChildA1 As New MenuItem
Private WithEvents miGrandChildA2 As New MenuItem
Private WithEvents miGrandChildA3 As New MenuItem
Private WithEvents miGrandChildA4 As New MenuItem
Private WithEvents miGrandChildA5 As New MenuItem
Private WithEvents miGrandChildB1 As New MenuItem
Private WithEvents miGrandChildB2 As New MenuItem
Public Sub New()
MyBase.New()
InitializeComponent()
'Define and add menu items.
MainMenu1.MenuItems.Add(mi1)
MainMenu1.MenuItems.Add(mi2)
mi2.MenuItems.Add(miChildA)
mi2.MenuItems.Add(miChildB)
miChildA.MenuItems.Add(miGrandChildA1)
miChildA.MenuItems.Add(miGrandChildA2)
miChildA.MenuItems.Add(miGrandChildA3)
miChildA.MenuItems.Add(miGrandChildA4)
miChildA.MenuItems.Add(miGrandChildA5)
miChildB.MenuItems.Add(miGrandChildB1)
miChildB.MenuItems.Add(miGrandChildB2)
mi1.Text = "Map Help"
mi2.Text = "Maps"
miChildA.Text = "My Maps"
miChildB.Text = "Add and remove"
miGrandChildA1.Text = "Manhattan"
miGrandChildA2.Text = "Bronx"
miGrandChildA3.Text = "Brooklyn"
miGrandChildA4.Text = "Queens"
miGrandChildA5.Text = "Staten Island"
miGrandChildB1.Text = "Add map"
miGrandChildB2.Text = "Delete map"
End Sub
Public Shared Sub Main()
Application.Run(New Form1)
End Sub
'Form overrides dispose to clean up the component list.
Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
MyBase.Dispose(disposing)
End Sub
Private Sub InitializeComponent()
Me.MainMenu1 = New System.Windows.Forms.MainMenu()
Me.Menu = Me.MainMenu1
Me.Text = "Form1"
End Sub
' The following subroutine handles the
' Click event for the mi1 MenuItem.
Private Sub mi1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles mi1.Click
MessageBox.Show("This is just a test.")
End Sub
End Class
using System;
using System.Windows.Forms;
namespace SmartphoneMenus
{
public class Form1 : System.Windows.Forms.Form
{
private System.Windows.Forms.MainMenu mainMenu1;
private MenuItem mi1 = new MenuItem();
private MenuItem mi2 = new MenuItem();
private MenuItem miChildA = new MenuItem();
private MenuItem miChildB = new MenuItem();
private MenuItem miGrandChildA1 = new MenuItem();
private MenuItem miGrandChildA2 = new MenuItem();
private MenuItem miGrandChildA3 = new MenuItem();
private MenuItem miGrandChildA4 = new MenuItem();
private MenuItem miGrandChildA5 = new MenuItem();
private MenuItem miGrandChildB1 = new MenuItem();
private MenuItem miGrandChildB2 = new MenuItem();
public Form1()
{
InitializeComponent();
mainMenu1.MenuItems.Add(mi1);
mainMenu1.MenuItems.Add(mi2);
mi2.MenuItems.Add(miChildA);
mi2.MenuItems.Add(miChildB);
miChildA.MenuItems.Add(miGrandChildA1);
miChildA.MenuItems.Add(miGrandChildA2);
miChildA.MenuItems.Add(miGrandChildA3);
miChildA.MenuItems.Add(miGrandChildA4);
miChildA.MenuItems.Add(miGrandChildA5);
miChildB.MenuItems.Add(miGrandChildB1);
miChildB.MenuItems.Add(miGrandChildB2);
// Event handler for the top left menu.
mi1.Click +=new EventHandler(mi1_Click);
// Event handlers for grandchild menu items. This code is commented out
// because this example does not define their event handling methods.
// miGrandChildA1.Click +=new EventHandler(miGrandChildA1_Click);
// miGrandChildB1.Click +=new EventHandler(miGrandChildB1_Click);
// miGrandChildB2.Click +=new EventHandler(miGrandChildB2_Click);
mi1.Text = "Map Help";
mi2.Text = "Maps";
miChildA.Text = "My Maps";
miChildB.Text = "Add and remove";
miGrandChildA1.Text = "Manhattan";
miGrandChildA2.Text = "Bronx";
miGrandChildA3.Text = "Brooklyn";
miGrandChildA4.Text = "Queens";
miGrandChildA5.Text = "Staten Island";
miGrandChildB1.Text = "Add map";
miGrandChildB2.Text = "Remove map";
}
protected override void Dispose( bool disposing )
{
base.Dispose( disposing );
}
private void InitializeComponent()
{
this.mainMenu1 = new System.Windows.Forms.MainMenu();
this.Menu = this.mainMenu1;
this.Text = "Form1";
}
static void Main()
{
Application.Run(new Form1());
}
// The following method handles the
// Click event for the mi1 MenuItem.
private void mi1_Click(object sender, EventArgs e)
{
MessageBox.Show("This is just a test.");
}
}
}
Kompilieren des Codes
Für dieses Beispiel sind Verweise auf die folgenden Namespaces erforderlich: