Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v20 R7
Get action info

Get action info 


 

Get action info ( Aktion {; Ziel} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Aktion  String in Standardaktion Name oder Vorlage mit Parameter, wenn erforderlich
Ziel  Lange Ganzzahl in Ziel der Aktion zum Erhalten der Information: Hauptformular oder aktuelles Formular
Funktionsergebnis  Objekt in Objekt mit Aktionsstatus als Boolean Eigenschaften: istAktiviert, istSichtbar, istMarkiert, istGemischt, istUnbekannterStatus

Die Funktion Get action info gibt je nach dem aktuellen Kontext der Anwendung verschiedene Informationen über die definierte Aktion in Ziel zurück; dazu gehören auch Verfügbarkeit und Status.

In Aktion übergeben Sie den Namen der Standardaktion zum Prüfen zurück. Das kann ein String oder eine Konstante aus dem Thema Standardaktion sein. Es kann sich um einen String oder eine Konstante aus dem Standardaktion-Thema handeln. Einige Aktionen akzeptieren ein Zielelement und Parameter. In diesem Fall müssen Sie das angeforderte Muster verwenden, zum Beispiel "gotoPage?value=2" oder paragraph/backgroundPositionV?value=top. 

Die verfügbaren 4D Aktionen sind im Abschnitt Standardaktionen des 4D Design Reference Handbuchs aufgeführt.

Hinweis: Einige Aktionen akzeptieren Parameter. In diesem Fall müssen Sie folgende Vorgabe verwenden: actionName?ParameterName=ParameterValue. Beispiel: "gotoPage?value=2"

In Ziel können Sie - wenn verfügbar - das Formular zum Ausführen von Aktion übergeben. Sie können eine der folgenden Konstanten unter dem Thema Standardaktion verwenden:

Konstante Typ Wert Kommentar
ak current form Lange Ganzzahl 1 Aktuelles Formular ist das Formular, wo die Aktion aufgerufen wurde. Das kann das Hauptformular oder ein Palettenfenster vor dem Hauptformular des aktuellen Prozesses sein. 
ak main form Lange Ganzzahl 2 Hauptformular ist das vorderste Dokument oder Dialogfenster des Prozesses, ohne Paletten- oder PopUp-Fenster.

Hinweis: Ist Ziel nicht angegeben, wird standardmäßig der Kontext ak current form verwendet.

Die Funktion Get action info gibt Information als Objekt mit folgenden Eigenschaften zurück:

EigenschaftTypBeschreibung
AktiviertBooleanwahr, wenn die Aktion auslösbar ist, sonst falsch
StatusStringWert kann ein String sein:
"markiert"die Aktion ist markiert, d.h. die Eigenschaft ist gesetzt. Beispiel: Der ausgewählte Text ist fett, die Standardaktion ak font bold der Eigenschaft "Status" enthält "checked"
"unchecked"Die Aktion ist nicht markiert, d.h. die Eigenschaft ist nicht gesetzt. Beispiel: Der gewählte Text ist nicht fett, die Standardaktion ak font bold der Eigenschaft "status" enthält "unchecked".
"mixed"Die Aktion ist gemischt, d.h. die Eigenschaft ist teilweise gesetzt. Beispiel: Ein Teil des gewählten Textes ist "fett", die Standardaktion ak font bold der Eigenschaft "status" enthält "mixed".
TitelTextAktueller lokalisierter Name der Aktion. Beispiel: "Undo", "Paste" für die englische Version
SichtbarBooleanwahr, wenn die Aktion im Formular sichtbar ist
WertStringAktueller Wert des Parameters Aktion (wenn vorhanden). Ist beispielsweise die Standardaktion "fontSize?value=10pt", enthält die Eigenschaft Wert "10pt"

Lässt sich kein Status der Aktion bestimmen (z.B. weil sie für kein Objekt oder Menübefehl zutrifft), gibt die Funktion ein Nullobjekt zurück (undefiniert). 

Abfragen, ob die Aktion Kopieren verfügbar ist (z.B. ob Daten ausgewählt sind):

 C_OBJECT($actionInfo)
 C_BOOLEAN($isEnabled)
 $actionInfo:=Get action info(ak copy)
 If(OB Is defined($actionInfo)) //Aktion ist im Prozess definiert
    If(OB Get($actionInfo;"enabled"))
       ... //die Aktion Kopieren ist verfügbar
    End if
 End if



Siehe auch 

INVOKE ACTION
SET LIST ITEM PARAMETER

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Programmiersprache
Nummer: 1442

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D v16 R3
Geändert: 4D v16 R4

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v20 R7)