CX_PRESENTATION_MANAGER
169434
Klassenhierarchie
- CX_CLASS
- CX_SYSTEM_MANAGER
- CX_PRESENTATION_MANAGER
- CX_SYSTEM_MANAGER
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.
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 |
|
Resultat ist ein Vektor aus Objekten der Klasse CX_BITMAP_PATH. Modul prsntmgr.mod benutzt diese Methode, um das Mapping mittels ListView zu visualisieren |
|
Bis Dll-Version 227914 |
INT | Liefert den zuletzt mit SetROCursorIndex gesetzten Index für die Auswahl eines Cursors für den Lese-Modus (readonly) | |
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. | |
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. | |
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 |
Datenfeld | Typ | Standartwert | Kurzbeschreibung |
---|---|---|---|
bmpIndex | INTEGER | -1 |