MarkAfflictedSection

| ALPHA-VISION® DCS

## MarkAfflictedSection

### Syntax

`MarkAfflictedSection(class, affliction_type, context_figure, cur_file);`

### Wirkung

Der Mauszeiger wird in den angegebenen Cursor umgewandelt. Der Bediener kann nun in eine Abteilung im rechten Fenster der BDCRUN-Applikation klicken.
Daraufhin wird für diese Abteilung ein Flag für den entsprechenden `affliction_type` gesetzt. Entsprechende Projektierung vorausgesetzt wird das Kontextmenü umgeschaltet und - über die Abfrage des `affliction_type` (im Refresh-Skript der Abteilung) - die Farb- bzw. Füllmusterumschaltung der Abteilung realisiert. Bei der Benutzung einer Bitmap kann diese semi-transparent angezeigt werden, wenn vor dem Aufruf der Bitmap eine semi-transparente Farbe angewählt wird.
Wenn der Bediener nicht auf einen Raum klickt, dann passiert nichts.
Eine solche Abteilungsmarkierung und das zugehörige Kontextmenü können später wieder angewählt werden, indem der Bediener den Vorgang wiederholt, d.h nochmals den entsprechenden Button drückt und mit dem geänderten Cursor in die gewünschte Abteilung klickt.

### Argumente

class (String)
  Die benutzerdefinierte Datenobjektklasse die die Schadensdaten verwaltet. Beim Anklicken wird eine Instanz dieser Klasse angelegt. Eine solche Klasse muß folgende Eingenschaften enthalten:
  ContextFigure (String)
    Der Name der Figur für das Kontextmenü des Schadens. Dieser Wert wird aus dem entsprechenden Argument des InsertPlotSymbol-Jobs entnommen.
  Display (String)
    Der Name des Bildes, in dem das Plotsymbol plaziert wurde.
  SectionPolyName (String)
    Der Name des angewählten Abteilungspolygons. Dieser Wert wird intern gehandhabt.
  DamageType
    Dieser Wert wird aus dem `affliction_type` Argument des MarkAfflictedSection-Jobs entnommen.
  Section (String)
    Die Bezeichnung der Sektion in welcher der Schaden aufgetreten ist. Dieser Wert wird aus der entsprechenden Eigenschaft des Raumpolygons entnommen.
  Created (Zeit)
    Diese Zeit wird beim Einfügen des Symbols automatisch gesetzt.
  Das Datenobjekt des aktuell selektierten Schadens kann über `BDC.ActDamage` angesprochen werden.
affliction_type (String)
  Die Schadensart in der betroffenen Abteilung. Es gibt folgende drei Typenkennungen:
  Smoke - verrauchter Bereich
  Inundation - überschwemmter Bereich
  Contamination - kontaminierter Bereich
  Dieser Text wird im Eintrag `DamageType` des Schadens-Datenobjekts gespeichert und dient zum Zeichnen der Abteilung nach einem Bildwechsel.
context_figure (String)
  Die Figur (nur der Name, nicht die Datei) für das Kontextmenü. Dieser Text wird in der Eingenschaft `ContextFigure` des Schadens-Datenobjekts gespeichert und dient zur Umschaltung der Figur für das Kontextmenü.
cur_file (String)
  Der Dateiname des anzuzeigenden Cursors relativ zum Projektverzeichnis. Die Datei muß sich im Projektverzeichis oder einem Unterverzeichnis davon befinden. Animierte Cursor sind ebenfalls möglich.

### Beispiel

Icon (Button) in der Iconleiste: (Aktion)

    //Der Cursor befindet sich im Unterverzeichnis Cursors
    MarkAfflictedSection("AfflictedArea", "Smoke", "AfflictedAreaContext", "Cursors\Smoke.cur");

    Plazierte Figur für das Kontextmenü: (Refresh)
    SetVal(Figure, BDC.ActDamage.ContextFigure);

    Grafikobjekte innerhalb der Kontextmenü-Figur: z.B. Anzeige des Schadenstyps in einem Text: (Refresh)
    SetVal(Text, BDC.ActDamage.DamageType);