Hinzufügen von benutzerdefinierten Schaltflächen mit UI-Werkzeugen

Klicken Sie im Startmenü von Windows auf Alle Programme

Microsoft Visual Studio

Microsoft Visual Studio.

Erstellen Sie ein Visual C#-Projekt:

Klicken Sie in der Visual Studio-Entwicklungsumgebung im Menü Datei auf Neu Projekt.
Erweitern Sie die linke Werkzeugleiste Visual C#-Vorlagen, und klicken Sie auf InventorETO.
Klicken Sie in der Liste der Vorlagen auf Inventor ETO-Zusatzmodul.
Geben Sie einen Namen für das Projekt ein.
Klicken Sie auf OK, um das Projekt zu erstellen.

Erstellen Sie ein Projekt:

Mehrere Quelldateien, die automatisch generiert werden, werden zum jeweils richtigen Zeitpunkt an Inventor und Inventor ETO angehängt. Erstellen Sie das Projekt, und stellen Sie sicher, dass die Erstellung erfolgreich abgeschlossen wird. Im Rahmen des Erstellungsprozesses registriert es sich selbst bei Inventor. Hilfe bei der Registrierung des Zusatzmoduls finden Sie in der Readme-Datei, die das Visual C#-Projekt generiert.

Führen Sie Inventor aus:

Öffnen Sie ein Inventor-Projekt und eine Baugruppe.
In der Multifunktionsleiste werden auf der Registerkarte mit dem Namen des Zusatzmoduls drei Schaltflächen angezeigt: Rendern, Exportierenund Importieren.
Schließen Sie Inventor, ohne zu speichern.

Definieren Sie eine benutzerdefinierte Schaltfläche:

Erweitern Sie im Zusatzmodul Visual Studio den Organisationsordner "UI", und öffnen Sie die Datei "UserInterfaceComponents.cs". Diese Datei definiert die Klasse UserInterfaceComponents, die die Erstellung von Multifunktionsleiste und Schaltflächen steuert.
Fügen Sie dieser Klasse ein ButtonDefinitionWrapper-Objekt hinzu, um die benutzerdefinierte Schaltfläche hinzuzufügen.
Fügen Sie unterhalb des Konstruktors für die Klasse die neue Schaltfläche zu den vorhandenen Schaltflächendefinitionen hinzu.

Um vorhandene Schaltflächen zu entfernen, löschen Sie die entsprechenden Definitionen oder kommentieren Sie sie aus. Fügen Sie die folgende Zeile unter den anderen Schaltflächendefinitionen hinzu:

 internal ButtonDefinitionWrapper MyButton { get; privateset; }

Erstellen Sie ein Schaltflächenexemplar:

Fügen Sie in der Methode "CreateButtonDefinitions" die folgende Zeile hinzu:
```
 MyButton = CreateButtonDefinition(buttons, addInSite, "MyButton" , CommandTypesEnum .kNonShapeEditCmdType);
```
Ein Exemplar einer Schaltfläche mit dem Namen "MyButton" wird angezeigt. Die Klassifizierung lautet "kNonShapeEditCmdType". Wählen Sie die entsprechende Klassifizierung je nach vorgesehenem Verwendungszweck.

Die Methode CreateButtonDefinition ruft einen Konstruktor in der Klasse ButtonDefinitionWrapper auf, um die Schaltfläche zu erstellen. Der Konstruktor registriert die Ressourcen, die zum Anzeigen der Schaltfläche erforderlich sind.
Um die vorhandenen Schaltflächen aus der Ansicht zu entfernen, entfernen Sie die Instanziierung der anderen Schaltflächen.

Fügen Sie benutzerdefinierte Schaltfläche zur Multifunktionsleiste hinzu:

Suchen Sie in der Datei UserInterfaceComponents.cs nach der Methode CreateAssemblyRibbonTab. Diese Methode fügt jede Komponente zur Multifunktionsleiste des Zusatzmoduls zum Anzeigen hinzu. Die Schaltflächen werden am Ende dieser Methode zur Multifunktionsleiste hinzugefügt. Fügen Sie die neue Schaltfläche durch Hinzufügen der folgenden Zeile hinzu:
Fügen Sie die neue Schaltfläche durch Hinzufügen der folgenden Zeile hinzu:
```
 controls.AddButton(MyButton.Target, true );
```
Schaltflächen werden in der Multifunktionsleiste von links nach rechts hinzugefügt. Überlegen Sie daher, an welcher Stelle Ihre Schaltflächen angezeigt werden sollen.

Erstellen Sie einen Handler für die Schaltfläche "OnExecute":

Öffnen Sie die Datei IntentModel.cs aus dem Stammordner des Projekts.
Fügen Sie eine Methode zur Steuerung von Klicks auf die neue Schaltfläche hinzu. Das folgende Snippet generiert bei jedem Klick ein Meldungsfeld, um zu zeigen, wann die Methode OnExecute aufgerufen wird.
```
 void MyButton_OnExecute( object sender, ButtonDefinitionWrapper . ExecuteEventArgs e)
 {
// TODO Implement OnExecute Method
MessageBox .Show( "MyButton's OnExecute Method" );
}
```
Beim Entfernen der vorhandenen Schaltflächen können Sie die jeweiligen OnExecute-Handler entfernen.

Registrieren Sie den OnExecute-Handler:

Registrieren Sie im Konstruktor für die Klasse IntentModel den Ereignis-Handler bei der Benutzeroberfläche durch Hinzufügen der folgenden Zeile:
```
 gui.MyButton.OnExecute += new EventHandler < ButtonDefinitionWrapper. ExecuteEventArgs >(MyButton_OnExecute);
```

Erstellen Sie das Projekt:

Erstellen Sie das Projekt, und bereinigen Sie alle Fehler.
Öffnen Sie ein Inventor-Projekt, und wählen Sie eine Baugruppe aus. Die Multifunktionsleiste des Zusatzmoduls enthält die benutzerdefinierte Schaltfläche. Klicken Sie auf die Schaltfläche, um das im Methoden-Handler OnExecute erstellte Meldungsfeld anzuzeigen.
Schließen Sie Inventor, ohne zu speichern.

Fügen Sie Text zur Schaltfläche hinzu:

Um ein benutzerdefiniertes Symbol und Hilfetext zur Schaltfläche hinzuzufügen, bearbeiten Sie das Design Resources.resx im Organisationsordner Resources für das Projekt.
Diese Datei definiert für jede Schaltfläche einen Satz von Zeichenfolgen und Bildern.
Um die für eine Schaltfläche erforderlichen Zeichenfolgen hinzuzufügen, folgen Sie dem Modell der anderen Schaltflächen. Als Präfix der einzelnen Ressourcennamen verwenden Sie dieselbe Zeichenfolge wie zum Erstellen des Exemplars einer Schaltfläche.
Die Zeichenfolge <name>_DisplayName definiert den Namen, der unter dem Symbol für die benutzerdefinierte Schaltfläche angezeigt wird.

<name>_DescriptionText definiert den pause-over-Text der benutzerdefinierten Schaltfläche.

<name>_ToolTip entspricht der DescriptionText-Zeichenfolge.

Fügen Sie ein benutzerdefiniertes Symbol hinzu:

Wählen Sie in der Datei resources.resx über das Dropdown-Menü, das derzeit Zeichenfolgen anzeigt, den Eintrag Bilder.

Diese Ansicht definiert die Symbole für die einzelnen Schaltflächen. Geben Sie Ihren Bildern den Namen <name>_LargeIcon und <name>_StandardIcon, um sicherzustellen, dass die ButtonDefinitionWrapper-Klasse diese hinzufügt. Große Symbole in der Größe 32 x 32 Pixel und Standardsymbole in der Größe 16 x 16 Pixel.

Verwenden Sie als Beispiel den Symbolsatz Render, und benennen Sie die Symbole in MyButton_LargeIcon und MyButton_StandardIcon um, oder verwenden Sie beliebige Bilder.

Erstellen Sie die Lösung:

Speichern Sie die Ressourcendatei, und erstellen Sie die Lösung.
Öffnen Sie Ihr Inventor-Projekt und die Baugruppe erneut. Die Multifunktionsleiste des Zusatzmoduls enthält ein Symbol mit der benutzerdefinierten Schaltfläche. Der neue Anzeigetext ersetzt den Namen der Schaltfläche.
Wenn eine der Ressourcen nicht geladen wird, prüfen Sie, ob Sie für jede Ressource das Präfix verwendet haben, mit dem das Exemplar einer Schaltfläche erstellt wurde.