Lade...
 

CX_PRESENTATION_MANAGER

CX_PRESENTATION_MANAGER

169434

Klassenhierarchie
Beschreibung:

Der Presentationmanager kümmert sich um die native Darstellung von ClassiX. Hierzu gehört, dass Bitmaps und Cursor ausgetauscht werden können und Positionierungen von Fenstern gespeichert werden. Zudem kann über den Presenationmanager ein anwendungsglobaler Fenstertitelsuffix/-Präfix gesetzt werden.

Icons / Bitmaps

Grundlage für das Austauschen der Bitmaps ist der BmpIndex, welcher festlegt, welcher Satz an Bitmaps benutzt wird. Die Sätze werden über CX_BITMAP, CX_BITMAP2 etc. definiert.

Für Widgets mit Icons wird in der Definition im InstantView-Code der Name eines .bmp oder .png Files angegeben.
Diese Filenamen im InstantView-Code können auf unterschiedliche Sets anderer Filenamen gemappt werden. ClassiX kennt dann unterschiedliche Sets von Images für die Oberfläche. Mit dem Presentationmanager wird das aktuell anzuwendende Set ausgewählt.

Wichtig: das Mapping bildet einen Filenamen auf anderen, keinen vollständigen Pfad.

Diese Feature ist optional!

Die Zuordnung (Name im IV-Code) → { IconFile1, IconFIle2, . . . } wird mit Excel beschrieben.
Daraus kann das Mapping-File imageMap.json erzeugt werden (siehe prsntmgr.mod und Methode CX_BITMAP_PATH::Save).

Pfade
Image Version Umgebungsvariable mit durchsuchtem Pfad
1 CX_BITMAP
2 CX_BITMAP2
3 CX_BITMAP3

Die Regel für Fallback trifft zu, wenn das Mapping-Feature nicht aktiv ist oder wenn da, wo es erwartet wurde, kein Image-File gefunden wurde:

  • Im IV-Code steht ein vollständiger Pfad: CX_ROOTDIR substituieren und dort suchen
  • Standard-Annahme %CX_ROOTDIR%\Bmp;%CX_ROOTDIR%\Bmp\%CX_PROJECT_NAME% verfolgen

Cursor

Die Cursor für laufende Lese/Schreibtransaktion sind über den Presentation-Manager konfigurierbar und können durch eigene Cursor-Dateien ausgetauscht werden (per LoadCursorFromFile). Die Original-Cursor lassen sich per RestoreROCursor/RestoreRWCursor wiederherstellen.

Positionen der Fenster

Wenn das Feature aktiv ist, wird die aktuelle Position eines Fenster beim Close in die Registry geschrieben. Beim nächsten Open erscheint an genau dieser Position.
Das Feature ist nur für die „konventionelle“ Windowoberfläche mit Zinc implementiert.

Methodenverzeichnis (MDI)
Funktion Parameter Rückgabe Kurzbeschreibung
DeleteStoredWindowPositions     Setzt die gespeicherten Fenster-Positionen zurück
GetBmpIndex   INT Liefert den zuletzt mit SetBmpIndex gesetzten Index zur Auswahl des Icon-Sets
GetBmpMapFromStorage   
VECTOR<CX_BITMAP_PATH>
 Resultat ist ein Vektor aus Objekten der Klasse CX_BITMAP_PATH.
Modul prsntmgr.mod benutzt diese Methode, um das Mapping mittels ListView zu visualisieren
GetROCursorIndex
Bis Dll-Version 227914		   INT Liefert den zuletzt mit SetROCursorIndex gesetzten Index für die Auswahl eines Cursors für den Lese-Modus (readonly)
GetRWCursorIndex
Bis Dll-Version 227914		   INT Liefert den zuletzt mit SetROCursorIndex gesetzten Index für die Auswahl eines Cursors für den Update-Modus
GetSaveUpdatedWindowPosition   INT  
GetUseStoredWindowPositionOnOpen   INT  
GetWindowPrefix
185561		   ML_STRING  
GetWindowSuffix
185561		   ML_STRING  
IsBmpMapping   INT Liefert TRUE wenn imageMap.json existiert, dann ist das Image-Mapping aktiv. Gibt es kein File imageMap.json ist das Ergebnis FALSE.
LoadCursorFromFile STRING, INT   Lädt temporär einen (Lade-)Cursor aus einer .cur- oder .ani-Datei.
Der zweite Parameter legt fest, welcher Cursor geladen wird: 0 → ReadOnly-Cursor, 1 → Update-Cursor.
Die Methode existiert, damit man ein neues Cursor-Design ausprobieren kann.
RestoreROCursor
227914		     Nachdem ein ReadOnly-Cursor per LoadCursorFromFile gesetzt wurde, kann per RestoreROCursor der Original-Cursor wiederhergestellt werden.
RestoreRWCursor
227914		     Nachdem ein Update-Cursor per LoadCursorFromFile gesetzt wurde, kann per RestoreRWCursor der Original-Cursor wiederhergestellt werden.
SetBmpIndex INT   Festlegen, welches Image-Set von jetzt an benutzt wird. Der Wert wird in der Registry gespeichert, gilt also auch beim nächsten Start des ClassiX-Systems.
SetROCursorIndex
Bis Dll-Version 227914		 INT   Festlegen, welcher Cursor für Read-only Transaktionen benutzt wird. Der Wert wird in der Registry gespeichert, gilt also auch beim nächsten Start des ClassiX-Systems.
SetRWCursorIndex
Bis Dll-Version 227914		 INT    
SetSaveUpdatedWindowPosition INT    
SetUseStoredWindowPositionOnOpen INT    
SetWindowPrefix
185561		 ML_STRING   Setzt den globalen Fensterpräfix
SetWindowSuffix
185561		 ML_STRING   Setzt den globalen Fenstersuffix
Datenverzeichnis (DDI)
Datenfeld Typ Standartwert Kurzbeschreibung
bmpIndex INTEGER -1