EvtAttachState

Änderung im Zustand des GroupTile -Objekts

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aMode: int Ereignis-Modus _WinModeAttachQuery Zustandsänderung durchführen? _WinModeAttachChanged Zustandsänderung durchgeführt.
aStateOld: int Vorhergehender Zustand _WinStateAttachNormal GroupTile -Objekt wird normal dargestellt. _WinStateAttachMaximized GroupTile -Objekt wird maximiert dargestellt. _WinStateAttachClosed GroupTile -Objekt ist geschlossen.
aStateNew: int neuer Zustand _WinStateAttachNormal GroupTile -Objekt soll normal dargestellt. _WinStateAttachMaximized GroupTile -Objekt soll maximiert dargestellt. _WinStateAttachClosed GroupTile -Objekt soll geschlossen werden.
aReason: int Grund für die Änderung des Zustands _WinReasonUserCaption Titelleiste _WinReasonUserTab -Taste _WinReasonInternProcedure prozedural _WinReasonInternIndirect indirekt
Resultat: logic Zustandsänderung durchführen?
Siehe: Liste , Objekte , Ereignisbefehle

Das Ereignis wird aufgerufen, wenn eine Zustandsänderung erfolgen soll, also das GroupTile -Objekt geschlossen, maximiert oder wiederhergestellt werden soll.

Dabei wird das Ereignis zunächst mit der Konstante _WinModeAttachQuery in aMode aufgerufen. Durch den Rückgabewert von true wird die Zustandsänderung zugelassen, durch einen Rückgabewert von false wird sie verhindert.

Wurde die Zustandsänderung zugelassen, wird das Ereignis nochmals mit der Konstante _WinModeAttachChanged aufgerufen, um zu benachrichtigen, das die Zustandsänderung durchgeführt wurde.

Definition des Funktionskopfes:

sub EvtAttachState
(
  aEvt                 : event;    // Ereignis
  aMode                : int;      // Ereignis-Modus
  aStateOld            : int;      // Bisheriger Attach-State
  aStateNew            : int;      // Neuer Attach-State
  aReason              : int;      // Grund für die Änderung
)
: logic;                           // Zustandsänderung durchführen?
{
  return(true);
}

aEvt

Die Funktion hat einen Übergabeparameter vom Typ event. In aEvt wird unter anderem der Deskriptor des auslösenden Objekts, d. h. das Objekt, in dem die Ereignisfunktion eingetragen wurde, übergeben.

aMode

Der hier übergebene Wert kann mit den folgenden Konstanten verglichen werden:

_WinModeAttachQuery: Nachfrage, ob Zustandsänderung durchgeführt werden darf.
_WinModeAttachChanged: Erfolgte Zustandsveränderung.

aStateOld / aStateNew

In diesen Parametern wird übergeben, in welchem Zustand das GroupTile -Objekt sich befindet und welchen Zustand es annehmen soll. Der Übergabewert kann mit folgenden Konstanten verglichen werden:

_WinStateAttachNormal: GroupTile -Objekt wird normal dargestellt.
_WinStateAttachMaximized: GroupTile -Objekt wird maximiert dargestellt.
_WinStateAttachClosed: GroupTile -Objekt ist geschlossen.

aReason

In diesem Parameter wird der Grund der Zustandsänderung übergeben. Er kann mit folgenden Konstanten verglichen werden:

_WinReasonUserCaption: Benutzerinteraktion mit der Titelleiste
_WinReasonUserTab: Benutzernavigation durch die -Taste
_WinReasonInternProcedure: prozedural ausgelöst (zum Beispiel durch Setzen einer Eigenschaft)
_WinReasonInternIndirect: indirekt durch die Zustandsveränderung eines anderen GroupTile -Objekts ausgelöst

Resultat

Der Rückgabewert entscheidet, um die Zustandsänderung durchgeführt wird (true) oder nicht (false). Wird in aMode _WinModeAttachChanged übergeben, ist der Rückgabewert ohne Bedeutung.

EvtAttachState​

EvtAttachState