Voraussetzungen:

• Komponente "GuiXT Controls" ist aktiv
• In Ihrem .NET Projekt haben Sie eine Referenz auf guinet.dll aufgenommen

Es genügt für die Verwendung der folgenden Funktionen, in Ihrer .NET Klasse das GuiXT-Objekt mit

Private guixt As New guinet.guixt

private guinet.guixt guixt = new guinet.guixt();

anzulegen.

Wenn var den Inhalt "xxx" hat, wird die GuiXT Scriptvariable V[xxx] gelesen und der Inhalt nach r gestellt.

Beispiel:

Dim menu_icon_path As String
menu_icon_path = guixt.GetVariable("menu_icon_path")

string menu_icon_path;
menu_icon_path = guixt.GetVariable("menu_icon_path");

Wenn var den Inhalt "xxx" hat, wird die GuiXT Scriptvariable V[xxx] auf den Inhalt von value gesetzt.

Beispiel:

guixt.SetVariable("menu_icon_path", "C:\guixt\menu\icons")

guixt.SetVariable("menu_icon_path", @"C:\guixt\menu\icons");

Wenn var den Inhalt "xxx" hat, wird die GuiXT Langtextvariable text[xxx] gelesen und der Inhalt nach r gestellt.

Beispiel:

' Menü lesen
Dim menu As String
menu = Split(guixt.GetText("menu"), vbCrLf)

// Menü lesen
string[] menu = guixt.GetText("menu").Split(
    new string[]{"\r\n"}, StringSplitOptions.None);

Wenn var den Inhalt "xxx" hat, wird die GuiXT Langtextvariable text[xxx] auf den Inhalt von value gesetzt.

Beispiel:

Dim lines() As String
...
guixt.settext("menu_layout", String.Join(vbCrLf, lines))

string[] lines;
...
guixt.SetText("menu_layout", String.Join("\r\n", lines));

Native-Schnittstelle zu einem aktuell im SAP GUI Fenster angezeigten Control. Als id ist folgendes möglich:

"grid"    GridView Control
"tree"    TreeView Control
"textedit" TextEdit Control
"htmlviewer" HTML Viewer Control
"toolbar" "Toolbar Control
"splitter" Splitter Control
"picture" Picture Control
"*" Beliebiger Typ

Falls mehrere Controls des gleichen Typs existieren, können Sie über den zweiten Parameter das n-te Control dieses Types abrufen.

Beispiel:

Imports GRIDVIEWLIB
Imports SAPTOOLBARLib
...
Dim gridview As GridView = guixt.GetControl("grid")
Dim tb1 As ISAPToolBar = guixt.GetControl("toolbar", 1)
Dim tb2 As ISAPToolBar = guixt.GetControl("toolbar", 2)

using GRIDVIEWLIB;
using SAPTOOLBARLib;
...
GridView gridview = (GridView)guixt.GetControl("grid");
ISAPToolBar tb1 = (ISAPToolBar)guixt.GetControl("toolbar", 1);
ISAPToolBar tb2 = (ISAPToolBar)guixt.GetControl("toolbar", 2);

Der native Zugriff auf die Controls ist nur in Ausnahmefällen sinnvoll. Falls möglich, sollte SAP GUI Scripting stattdessen genutzt werden. Weitere Details finden Sie in "Tips, Tricks and Samples" -> "Native Control Interface"
 

GuiXT ersetzt im angegebenen String alle &-Ausdrücke nach GuiXT-Logik durch die entsprechenden Werte und stellt das Resultat nach r.

Beispiel:

Dim matnr As String
matnr = guixt.Value("&F[Material]")

string matnr;
matnr = guixt.Value("&F[Material]");

Der angegebene String s wird exakt so interpretiert wie für die input= Option der Image-Anweisung beschrieben.

Beispiel:

guixt.input("U[VBELN]:" & ListView.selectedItem)
guixt.input("OK:/nVA03,process=va03_enter.txt")

guixt.Input("U[VBELN]:" + ListView.SelectedItem);
guixt.Input("OK:/nVA03,process=va03_enter.txt");

Entspricht der GuiXT Anweisung Process.

Aus dem ersten Parameter funcname wird der Scriptname "process_[funcname].txt" gebildet. Dieses Script wird durchgeführt, wobei die Parameter des Scripts durch die Werte von par1, par2,... besetzt werden. Der bei "Return" im Script gesetzte String wird zurückgegeben.

Der angegebene String s wird als Dateiname relativ zum GuiXT Scriptverzeichnis interpretiert.

• Der gesamte Dateiname, mit aktuellem Scriptverzeichnis, wird zurückgegeben.
• Ein absoluter Dateiname wie C:\guixt\scripts\..." bleibt unverändert.
• Bei Angabe einer Datei aus dem SAP MIME Repository "SAPMR:..." wird im GuiXT Cache eine lokale Kopie erstellt und der Cache-Dateiname zurückgegeben
• Bei Angabe einer http oder ftp Datei wie "http://..." oder "ftp://" wird im GuiXT Cache eine lokale Kopie erstellt und der Cache-Dateiname zurückgegeben.

Bei cache=True werden externe Dateien zunächst im GuiXT Cache gesucht.

Beispiele:

imgpath = guixt.FilePath("images\home.gif")
' imgpath ist jetzt z.B. "C:\guixt\scripts1\images\home.gif"

Dim url As String = "http://www.synactive.com/" & _
    "images/s10logo_blue.gif"
imgpath = guixt.FilePath(url)
' imgpath ist jetzt z.B.
'   "C:\Users\ADMINI~1\AppData\Local\Temp\
'    guixt\GuiXT Cache\http\
'    www.synactive.com\images\s10logo_blue.gif"

imgpath = guixt.FilePath(@"images\home.gif");
// imgpath ist jetzt z.B. "C:\guixt\scripts1\images\home.gif"

var url = "http://www.synactive.com/images/" +
          "s10logo_blue.gif";
imgpath = guixt.FilePath(url);
// imgpath ist jetzt z.B.
//   "C:\Users\ADMINI~1\AppData\Local\Temp\
//    guixt\GuiXT Cache\http\
//    www.synactive.com\images\s10logo_blue.gif"

Angabe zweier Objekte. Für jedes Event z.B. "Click" von Objekt obj1 wird die Funktion "OnClick" von Objekt2 aufgerufen. Die Parameterübergabe erfolgt gemäss der Event-Schnittstelle, d.h. Sie müssen die Funktionen zur Eventbehandlung mit den entsprechenden Parametern anlegen. Meist ist obj1 ein Control, z.B. ein Tree View oder ein List View, und obj2 ist ein mit .NET-Mitteln definiertes Objekt zur Behandlung der Events.

Tipp: Die ausgelösten Events und aktuellen Parameter können Sie mit der Trace-Funktion im GuiXT-Window anzeigen.

Beispiel:

' Ereignisse verarbeiten
Set e = New va03_list_events
Set e.ListView = lv
guixt.SetEventHandler(lv, e)

// Ereignisse verarbeiten
va03_list_events e = new va03_list_events();
e.ListView = lv;
guixt.SetEventHandler(lv, e);

Blendet eine interaktive Windows Form in das SAP GUI Window ein. Sie nutzen am besten das ActiveX-Objekt "Shell.Explorer" als Platzhalter im SAP GUI Fenster.

Beispiel:

Control (10,20) (18,80) progID="Shell.Explorer" _ 
	name="d1" initFlag="d1init"

if V[d1init]
  CallVB utilities.customer.preview "&V[d1]"
endif

Imports guinet
....

Public Sub preview(ByVal w As Object)

  ' neue Form erstellen
  Dim f As New Dialog1()

  ' in SAP GUI Fenster einbetten
  guixt.EmbedForm(f, w)

End Sub

using guinet;
....

public void preview(object w)
{
    // neue Form erstellen
    Dialog1 f = new Dialog1();

    // in SAP GUI Fenster einbetten
    guixt.EmbedForm(f, w);
}

Liefert ein Objekt der Klasse guinet.sapguisession, mit dem Sie komfortabel SAP GUI Scripting-Funktionen ausführen können. Details dazu in GUI Scripting in .NET

Beispiel:

guixt.GuiSession().Enter("/NFB01")

guixt.GuiSession().Enter("/NFB01");

Liefert ein Objekt der Klasse System.Windows.Forms.NativeWindow, das eine eindeutige Identifizierung des SAP Modus ermöglicht.