Verwaltet zentral die Frame-Klassen: Instanziert Frame-Klassen zu Frame-Objekten und liefert die Referenzen auf diese zurück. Mehr ...

Zusammengehörigkeiten von OKW.FrameObjectDictionary:

Öffentliche Methoden
	FrameObjectDictionary ()
	Konstuktor der Klasse. Es wird die Methode FrameObjectDictionary.Init() aufgerufen. Mehr ...

object	GetParentObjectByName (string fpsParentObject)
	Die Methode liefert das Frame-Object des gegebenen Fensterobjektes zurück. Mehr ...

object	GetChildObjectByName (string fps_ParentObject, string fps_ChildObject)
	Die Methode liefert das Objekt des gegebenen Kindobjekttests zurück. Mehr ...

void	Init ()
	Methode initialisiert diese Klasse. Mehr ...

List< Type >	GetListOfOKWGuiClasses ()
	Methode erstellt eine Liste alle OKWGUI-Rahmenklassen (frame class), die in der aktuell ausgeführten Assambly definiert sind. Mehr ...

void	Scanfields (Type fpType, object fpsWindowAsObject, string fpsWindowName)

Öffentliche Attribute
Dictionary< string, object >	__FrameObjectDictionary = new Dictionary<string, object>()
	Zentrale Liste, genauer Dictionary/Hash der aktuell benutzten Frame-Objekte. Mehr ...

Private Methoden
void	AddFrameInstancesToDictionary (List< Type > fpListOfOKWGuiTypes)

string	GetFunktionlanameFromObjekt (object fpObject)
	List dasAttribute Funktionalname das übergeben Objektes aus. Mehr ...

object	CreateInstanceByType (Type fpParentType)
	Die Methode erzeugt eine Instanz der Rahmenklasse (frame class) mit dem in 'fps_ParentClassName' gegebenen Namen. Mehr ...

object	__CreateInstanceByObjectName (string fps_ParentObject, string fps_ChildObject)
	Erzeugt eine Instanz des OKW-Frame-Objekts. Mehr ...

object	GetChildObjectByName (object fpo_ParentObject, string fps_ChildName)
	Holt sich einen öffentlichen Feld Wert über den Namen. Mehr ...

Private Attribute
LogMessenger	LM = null

Ausführliche Beschreibung

Verwaltet zentral die Frame-Klassen: Instanziert Frame-Klassen zu Frame-Objekten und liefert die Referenzen auf diese zurück.

Noch zu erledigen:

TODO: ZH Dokumentaion erweitern.

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Definiert in Zeile 65 der Datei FrameObjectDictionary.cs.

Beschreibung der Konstruktoren und Destruktoren

OKW.FrameObjectDictionary.FrameObjectDictionary ( )

Konstuktor der Klasse. Es wird die Methode FrameObjectDictionary.Init() aufgerufen.

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Definiert in Zeile 106 der Datei FrameObjectDictionary.cs.

         {
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.FrameObjectDictionary");
 
             this.Init();
 
             Logger.Instance.LogFunctionEndDebug();
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

Dokumentation der Elementfunktionen

object OKW.FrameObjectDictionary.__CreateInstanceByObjectName	(	string	fps_ParentObject,
		string	fps_ChildObject
	)

private

Erzeugt eine Instanz des OKW-Frame-Objekts.

Rückgabe: Die Instanz des OKW-Frame_Objekts.

Parameter

fps_ParentName	Name des Eltern Fensters.
fps_ChildName	Name des Kind-Objektes im Fenster-Objekt fps_ParentName.

Autor: Zoltan Hrabovszki

Datum: 2014-10-10 FIXME: Prüfen, ob diese Methoden namentlich ok sind. Wird das Eltern Obejkt angelegt?

Definiert in Zeile 519 der Datei FrameObjectDictionary.cs.

         {
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.CreateInstanceByObjectName", "fps_ParentObject", fps_ParentObject, "fps_ChildObject", fps_ChildObject);
 
             object myParentObject = null;
             object myChildObject = null;
             bool bOK = false;
 
             try {
                 // PerentObject holen und ggf. als instanz anlegen
                 myParentObject = this.GetParentObjectByName(fps_ParentObject);
 
                 // Kindobjekt aufrufen...
                 // aber nur wenn Paretobjekt gefunden worden ist.
                 if (myParentObject != null) {
                     // FIXME: was ist wenn das myChildObject = null ist??Checken
                     myChildObject = this.GetChildObjectByName(myParentObject, fps_ChildObject);
                 } else {
                     // LANGUAGE: Log Schreiben..
                     throw new OKWFrameObjectParentNotFoundException("Frame Objekt des Fensters");
                 }
 
                 bOK = true;
             } finally {
                 if (bOK) {
                     // Wir sind ohne Exception durchgekommen und wir nehmen an,
                     // dass lvo_Obj != null
                     // -> wir geben den Namen des Objektes zurück...
                     Logger.Instance.LogFunctionEndDebug(myChildObject.GetType().FullName);
                 } else {
                     // Irgend etwas ist faul wir rufen nur LogFunctionEndDebug auf...
                     Logger.Instance.LogFunctionEndDebug();
                 }
             }
             
             return myChildObject;
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

void OKW.FrameObjectDictionary.AddFrameInstancesToDictionary ( List< Type > fpListOfOKWGuiTypes )

private

Rückgabe: Liefert die Instanz der Klasse.

Parameter

fps_ParentClassName	Name der Klasse
fps_ParentClassName	Name of the class

Autor: Zoltan Hrabovszki

Datum: 2015.01.28

Definiert in Zeile 341 der Datei FrameObjectDictionary.cs.

         {
             object lvTypeInstanceAsObject = null;
 
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.AddFrameInstancesToDictionary");
 
             try {
                 // Für jede Klasse...
                 foreach (Type lvOKWGuiClass in fpListOfOKWGuiTypes) {
                     lvTypeInstanceAsObject = CreateInstanceByType(lvOKWGuiClass);
                     
                     // Funktionalenname der Klasse aus dem Attribute OKWGUI auslesen.
                     string lvFunktionalname = this.GetFunktionlanameFromObjekt(lvTypeInstanceAsObject);
                     
                     // Wenn Attribute vorhanden (!=null) und nicht Leer dann ins Dictionary einfügen.
                     if (!string.IsNullOrEmpty(lvFunktionalname)) {
                         string lvsKey = lvFunktionalname;
                         System.Console.WriteLine("\n Window Frame: >>" + lvsKey + "<<");
                         System.Console.WriteLine("     Technisches Objekt: >>" + lvTypeInstanceAsObject.GetType().FullName + "<<");
 
                         this.__FrameObjectDictionary.Add(lvFunktionalname, lvTypeInstanceAsObject);
                         
                         Logger.Instance.LogPrintDebug(this.LM.GetMessage("CreateInstanceByObjectName", "InstanceWasCreated", lvTypeInstanceAsObject.GetType().FullName));
                         
                         //nun Rekursive die Kinder (=Felder) des Frames durgehen und ins einlesen.
                         Scanfields(lvOKWGuiClass, lvTypeInstanceAsObject, lvFunktionalname);
                     }
                 }
             } finally {
                 Logger.Instance.LogFunctionEndDebug();
             }
             
             return;
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

object OKW.FrameObjectDictionary.CreateInstanceByType ( Type fpParentType )

private

Die Methode erzeugt eine Instanz der Rahmenklasse (frame class) mit dem in 'fps_ParentClassName' gegebenen Namen.

Zu beachten: WICHTIG: Die Klasse muss zwingend so heißen, wie angegeben. Hier wird kein 'Frame Präfix' ergänzt.

Rückgabe: Liefert die Instanz der Klasse.

Parameter

fps_ParentClassName Name der Klasse

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Definiert in Zeile 465 der Datei FrameObjectDictionary.cs.

         {
             object lvo_Obj = null;
             bool bOK = false;
 
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.CreateInstanceByObjectName", "fpParentClass", fpParentType.FullName);
 
             try {
                 lvo_Obj = Activator.CreateInstance(fpParentType, null);
                 
                 Logger.Instance.LogPrintDebug(this.LM.GetMessage("CreateInstanceByObjectName", "InstanceWasCreated", lvo_Obj.GetType().FullName));
                 bOK = true;
             } catch (TargetInvocationException e) {
                 // EXCEPTION: Pürfen was hier genau passiert. Exception weitergeben
                 throw new OKWFrameObjectParentNotFoundException(this.LM.GetMessage("CreateInstanceByObjectName", "InstanceWasCreated", fpParentType.FullName), e);
             } finally {
                 if (bOK) {
                     // Wir sind ohne Exception durchgekommen und wir nehmen an,
                     // dass lvo_Obj != null
                     // -> wir geben den Namen des Objektes zurück...
                     Logger.Instance.LogFunctionEndDebug(lvo_Obj.GetType().FullName);
                 } else {
                     // Irgend etwas ist faul wir rufen nur LogFunctionEndDebug auf...
                     Logger.Instance.LogFunctionEndDebug();
                 }
             }
             
             return lvo_Obj;
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

object OKW.FrameObjectDictionary.GetChildObjectByName	(	string	fps_ParentObject,
		string	fps_ChildObject
	)

Die Methode liefert das Objekt des gegebenen Kindobjekttests zurück.

Siehe auch: Für das Fensterobjekt existiert eine zweite Ausprägung dieser Methode. FrameObjectDictionary.GetObjectByName(string,string)

Parameter

fps_ParentObject	Name des Fenster-Objektes = Elternobjekt.
fps_ChildObject	Name des Kindobjektes-Objektes.

Rückgabe: Frame-Objekt-Referenz auf das Kindobjekt.

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Noch zu erledigen:: TODO: Exception/Try/Except/Finaly einbauen

Definiert in Zeile 209 der Datei FrameObjectDictionary.cs.

         {
             object lvo_Return = null;
             string lvs_ObjectName = fps_ParentObject + "." + fps_ChildObject;
 
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.GetChildObjectByName", "fps_ParentObject", fps_ParentObject, "fps_ChildObject", fps_ChildObject);
 
             // Gibt es den Schlüssel im Dictinary?
             Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetChildObjectByName", "M1", fps_ChildObject, fps_ParentObject));
 
             if (this.__FrameObjectDictionary.ContainsKey(lvs_ObjectName)) {
                 // Ja, das Objekt existiert.
                 Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetChildObjectByName", "M2"));
                 // Hole refarenc auf des Objekt im Dictionary
                 lvo_Return = this.__FrameObjectDictionary[lvs_ObjectName];
             } else {
                 // Nein -> Frame zum Funtionalen Name wurde nicht gefunden -> Exception OKWFrameObjectChildNotFoundException auslösen...
                 // \todo TODO: Fehlermeldung einbauen...
                 Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetChildObjectByName", "M3"));
 
                 string lvsMessage = this.LM.GetMessage("GetChildObjectByName", "OKWFrameObjectChildNotFoundException", lvs_ObjectName );
                 throw new OKWFrameObjectChildNotFoundException(lvsMessage);
             }
 
             Logger.Instance.LogFunctionEndDebug();
             return lvo_Return;
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

object OKW.FrameObjectDictionary.GetChildObjectByName	(	object	fpo_ParentObject,
		string	fps_ChildName
	)

private

Holt sich einen öffentlichen Feld Wert über den Namen.

Parameter

srcObj	object to inspect
fieldName	Name of the field to retrieve the value from

Rückgabe: Eigenschaftswert

Autor: Zoltan Hrabovszki

Datum: 2014-10-10

Definiert in Zeile 576 der Datei FrameObjectDictionary.cs.

         {
             object lvo_Return = null;
 
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.GetChildObjectByName", "fpo_ParentObject", fpo_ParentObject.ToString(), "fps_ChildName", fps_ChildName);
 
             try {
                 FieldInfo fieldInfoObj = fpo_ParentObject.GetType().GetField(fps_ChildName);
 
                 // Existiert es das Kindobjekt >>{0:}<< im Objekt >>{1:}<<?
                 Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetChildObjectByName", "M1", fps_ChildName, fpo_ParentObject.GetType().Name));
                 if (fieldInfoObj == null) {
                     // Nein -> Exception auslösen und alles beenden!
                     Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetChildObjectByName", "M3"));
                     throw new OKWFrameObjectChildNotFoundException(this.LM.GetMessage("GetChildObjectByName", "ChildIsNotDefined_Exception", fps_ChildName, fpo_ParentObject.GetType().Name));
                 } else {
                     // Ja, das Objekt existiert.
                     Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetChildObjectByName", "M2"));
 
                     // Get the value from property.
                     lvo_Return = fpo_ParentObject.GetType().InvokeMember(
                         fieldInfoObj.Name,
                         BindingFlags.GetField,
                         null,
                         fpo_ParentObject,
                         null);
                 }
             } finally {
                 Logger.Instance.LogFunctionEndDebug();
             }
 
             return lvo_Return;
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

string OKW.FrameObjectDictionary.GetFunktionlanameFromObjekt ( object fpObject )

private

List dasAttribute Funktionalname das übergeben Objektes aus.

Parameter

fpObject

Rückgabe: Wert aus Funtionalname

Definiert in Zeile 421 der Datei FrameObjectDictionary.cs.

         {
             string lvsReturn = "";
 
             Attribute[] attrs = System.Attribute.GetCustomAttributes(fpObject.GetType());  // Reflection.
 
             // Displaying output.
             foreach (System.Attribute attr in attrs) {
                 if (attr is OKWGUIAttribute) {
                     OKWGUIAttribute a = (OKWGUIAttribute)attr;
                     lvsReturn = a.FunctionalName;
                 }
             }
             
             return lvsReturn;
         }

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

List<Type> OKW.FrameObjectDictionary.GetListOfOKWGuiClasses ( )

Methode erstellt eine Liste alle OKWGUI-Rahmenklassen (frame class), die in der aktuell ausgeführten Assambly definiert sind.

Zu beachten

WICHTIG: Es werden Klasse in die Liste uafgenommen, die

dem Namepsace OKW.Frames zugeordent sind
und mit dem Attribut OKWGUIAttribute geschmückt ist.

Rückgabe: Liefert die Liste der Klasse, die der Namespace OKW.Frames und mit dem Attribute OKWGUI vershen sind.

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Definiert in Zeile 295 der Datei FrameObjectDictionary.cs.

         {
             string @namespace = "OKW.Frames";
             var lvLsReturn = new List<Type>();
 
             Type[] myTypes;
                                     
             Assembly[] appAssemblies = AppDomain.CurrentDomain.GetAssemblies();
 
             for (int i = 0; i < appAssemblies.Length; i++) {
                 Logger.Instance.LogPrint("-------------------------------------------------------------------------------------------");
                 Logger.Instance.LogPrint(string.Format("Assambly {0}: {1}\n", i, appAssemblies[i].FullName));
                 Logger.Instance.LogPrint("-------------------------------------------------------------------------------------------");
                 
                 Assembly myAssembly = appAssemblies[i];
                 myTypes = myAssembly.GetTypes();
        
                 var q = from t in myTypes
                                 where t.IsClass && t.Namespace == @namespace
                                 select t;
             
                 foreach (Type t in q) {
                     if (t.GetCustomAttributes(typeof(OKWGUIAttribute), true).Length > 0) {
                         lvLsReturn.Add(t);
                     }
                 }
             }
             return lvLsReturn;
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

object OKW.FrameObjectDictionary.GetParentObjectByName ( string fpsParentObject )

Die Methode liefert das Frame-Object des gegebenen Fensterobjektes zurück.

Dabei kann das Objekt bereits erzeugt (instanziert) sein, in diesem Fall wird der Bezug aus der Dictionary OKW_FrameObjectDictionary.cv_FrameObjectDictionary geholt oder das Objekt wurde noch nicht erzeugt, dann wird eine Instanz angelegt und ein Bezug auf das Objekt gespeichert.

Siehe auch: Für das Kindobjekt existiert eine zweite Ausprägung dieser Methode: FrameObjectDictionary.GetObjectByName(string,string)

Parameter

fpsParentObject Fachlicher Name des Fenster Objektes = Elternobjekt.

Rückgabe: Frame-Objekt-Referenz auf das Fenstre-Objekt.

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Definiert in Zeile 154 der Datei FrameObjectDictionary.cs.

         {
             object lvo_Return = null;
 
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.GetParentObjectByName", "fpsFunctionalnameOfWindow", fpsParentObject);
             try {
                 // Gibt es den Schlüssel im Dictinary? - D.h. Gibt es schon eine Instanz des Objektes im Speicher?
                 Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetParentObjectByName", "M1", fpsParentObject));
                 if (this.__FrameObjectDictionary.ContainsKey(fpsParentObject))
                 {
                     // Ja, das Objekt existiert.
                     Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetParentObjectByName", "M2"));
                     lvo_Return = this.__FrameObjectDictionary[fpsParentObject];
                 } else {
                     // Nein -> Frame zum Funtionalen NAme wurde nicht gefunden -> Exception auslösen...
                     // \todo TODO: Fehlermeldung einbauen...
                     Logger.Instance.LogPrintDebug(this.LM.GetMessage("GetParentObjectByName", "M3"));
 
                     string lvsMessage = this.LM.GetMessage("GetParentObjectByName", "OKWFrameObjectParentNotFoundException", fpsParentObject);
                     throw new OKWFrameObjectParentNotFoundException(lvsMessage);
                 }
             } finally {
                 Logger.Instance.LogFunctionEndDebug();
             }
             
             return lvo_Return;
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

void OKW.FrameObjectDictionary.Init ( )

Methode initialisiert diese Klasse.

Es wird

LogMessender-Instanz erzeugt.
das FrameObjektDictionary wird gelöscht.
Es werden die Frame-Objekte geladen

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Definiert in Zeile 254 der Datei FrameObjectDictionary.cs.

         {
             Logger.Instance.LogFunctionStartDebug("FrameObjectDictionary.Init");
 
             
             try {
                 this.LM = new LogMessenger("FrameObjectDictionary");
 
                 Logger.Instance.LogPrint(this.LM.GetMessage("Init", "InitClear", this.GetType().Name));
                 this.__FrameObjectDictionary.Clear();
                 
                 List<Type> lvOKWGuiClasses = GetListOfOKWGuiClasses();
                 
                 this.AddFrameInstancesToDictionary(lvOKWGuiClasses);
             } finally {
                 Logger.Instance.LogFunctionEndDebug();
             }
         }

Hier ist ein Graph, der zeigt, was diese Funktion aufruft:

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

Dokumentation der Datenelemente

Dictionary<string, object> OKW.FrameObjectDictionary.__FrameObjectDictionary = new Dictionary<string, object>()

Zentrale Liste, genauer Dictionary/Hash der aktuell benutzten Frame-Objekte.

Der Zugriff erfolgt über die Methoden:

FrameObjectDictionary.GetObjectByName(string)
FrameObjectDictionary.GetObjectByName(string,string)
FrameObjectDictionary.Init()

Zu beachten: Feld ist Public

Autor: Zoltan Hrabovszki

Datum: 2014.10.10

Noch zu erledigen:: TODO: Bedingte Kompilierung einfügen für "Test" Feld muss Public sein, wenn unittets durchgeführt werden soll.

Definiert in Zeile 87 der Datei FrameObjectDictionary.cs.

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

OKW/FrameObjectDictionary.cs

Öffentliche Methoden

Öffentliche Attribute

Private Methoden

Private Attribute

Ausführliche Beschreibung

Beschreibung der Konstruktoren und Destruktoren

Dokumentation der Elementfunktionen

Dokumentation der Datenelemente