WML Dateiformat

Zweck

Generiert variable UIL-Compilerkomponenten.

Beschreibung

Die Widget-Metasprache ( WML ) wird verwendet, um veränderbare Komponenten des Compilers für die Benutzeroberflächensprache (UIL) zu generieren, abhängig vom Widget-Set. Mit können Sie dem AIXwindows -Widget-Set WML neue UIL-Unterstützung hinzufügen oder Unterstützung für ein völlig neues Widget-Set hinzufügen.

Dateiformat

WML Die Dateien sind ASCII-Dateien und können mit jedem Standard-Texteditor bearbeitet werden. Sie sind im Verzeichnis WML tools/wml zu finden und haben die Endung .wml. Das Motif AIXwindows -Widget-Set wird in der motif.wml Datei beschrieben. Dies ist auch die WML Standarddatei bei Verwendung der WML Funktion.

Wenn Sie eine WML Datei erstellen, um neue Widgets hinzuzufügen oder Widget-Eigenschaften zu ändern, können Sie eine Kopie der motif.wml Datei erstellen und diese ändern. Wenn Sie eine neue Widgetgruppe zur Verwendung mit UIL erstellen, erstellen Sie eine völlig neue Datei. In beiden Fällen ist die motif.wml Datei ein gutes Beispiel für WML die Syntax und kann Ihnen helfen, sich mit der Sprache vertraut zu machen, bevor Sie versuchen, Ihre eigene WML Datei zu schreiben.

WML Dateien haben eine grundlegende Syntax, die in ihrer Struktur der von UIL ähnelt. WML Die Syntax besteht aus den folgenden Elementen:

• Kommentare
• Datentypdefinitionen
• Zeichensatzdefinitionen
• Aufzählungsgruppendefinitionen
• Kontrolllistendefinitionen
• Klassendefinitionen
• Untergeordnete Definitionen
• Ressourcendefinitionen

Sie können Leerzeichen, Tabulatoren oder Zeilenvorschubzeichen an beliebiger Stelle in der Syntax verwenden, solange sie keine Schlüsselwörter oder Zeichenfolgen trennen. Kommentare enden mit einem Zeilenvorschubzeichen. Die Reihenfolge der Elemente in der Syntax ist nicht wichtig.

Die gezeigten Syntaxbeispiele für die Metasprache des Widgets verwenden die folgenden zusätzlichen Konventionen:

Kommentar

Sie können Kommentare in die WML Datei einfügen. Kommentare haben die folgende Syntax:

[AnyElement]!AnyComment

Kommentare beginnen mit einem! (Ausrufezeichen) und bis zum Ende der Zeile. Ein Kommentar kann in einer Zeile allein beginnen oder einem beliebigen Teil eines anderen Elements folgen. Ein Kommentar ändert nicht die Bedeutung eines anderen Elements. Beispiel:

!This is a comment
!   that spans two lines.
DataType   !This is a comment that follows code.

Datentypdefinitionen

Datentypdefinitionen registriert alle Ressourcendatentypen, die in der Datei verwendet werden. Sie müssen alle in Ihrer WML Datei verwendeten Datentypen registrieren. Datentypdefinitionen haben die folgende Syntax:

DataType AnyDatatype [{InternalLiteral = InternalName | DocName = "Zeichenfolge"; [...]}]; [...]

Eine Datentypdefinition beginnt mit dem Schlüsselwort DataType . Im Anschluss an das Schlüsselwort DataType folgt eine Liste der Datentypen, die wie folgt geändert werden können:

DataType OddNumber {DocName="OddNumber";};
         NewString;

Zeichensatzdefinitionen

Zeichensatzdefinitionen registrieren Sie den AIXwindows Toolkit-Namen und weitere Informationen für die in UIL verwendeten Zeichensatznamen. Zeichensatzdefinitionen haben folgende Syntax:

AnyCharacterSetCharacterSet { [ FontListElementTag | XmStringCharsetName ] = " String "; [ Alias = " String "... ; | Direction = [ LeftToRight | RightToLeft ] ; | ParseDirection = [ LeftToRight | RightToLeft ] ; | CharacterSize = [ OneByte | TwoByte ] ; ] [... ] }; [... ]

Eine Zeichensatzdefinition beginnt mit dem Schlüsselwort CharacterSet . Nach dem Schlüsselwort CharacterSet folgt eine Liste mit Zeichensätzen, die wie folgt geändert werden können:

Es folgt ein Beispiel für die Syntax der Zeichensatzdefinition:

CharacterSet
   iso_latin1
                 { XmStringCharsetName = "ISO8859-1";
                                  Alias = "ISOLatin1"; } ;
   iso_hebrew_lr
                 { XmStringCharsetName = "ISO8859-8";
                                  Alias = "iso_latin8_lr";
                                  Direction = RightToLeft;
                                  ParseDirection = LeftToRight; } ;
   ksc_korean
                 { XmStringCharsetName = "KSC5601.1987-0";
                                  CharacterSize = TwoByte; };

Aufzählungsgruppendefinitionen

Aufzählungsgruppendefinitionen Registrieren Sie die benannten Konstanten, die im AIXwindows Toolkit verwendet werden, um bestimmte Ressourcenwerte anzugeben. Aufzählungsgruppendefinitionen haben die folgende Syntax:

EnumerationSet ResourceName : ResourceType { Aufzählungswertname ; [...] };

Eine Aufzählungsgruppendefinition beginnt mit dem Schlüsselwort EnumerationSet . Für jede definierte Aufzählungsgruppe werden Name und Typ der Ressource aufgelistet. Der Ressourcenname ist der Ressourcenname von AIXwindows Toolkit, wobei das Präfix XmN am Anfang entfernt und der Anfangsbuchstabe in Großbuchstaben geschrieben wird. Der Name der AIXwindows Toolkit-Ressource XmNrowColumnType würde beispielsweise lauten RowColumnType. Der Ressourcentyp ist der Datentyp für die Ressource; für die meisten Ressourcen ist dies der Datentyp für ganze Zahlen. Nach dem Ressourcennamen und -typ folgt eine Liste mit Aufzählungswertnamen, die als Einstellungen für die Ressource verwendet werden können. Diese Namen sind mit denen im AIXwindows Toolkit identisch.

Es folgt ein Beispiel für die Syntax der Aufzählungssatzdefinition:

EnumerationSet
   RowColumnType: integer
        { XmWORK_AREA; XmMENU_BAR; XmMENU_POPUP;
          XmMENU_PULLDOWN; XmMENU_OPTION; };

Kontrolllistendefinitionen

Steuerlistendefinitionen weist Gruppen von Steuerelementen einen Namen zu. Sie können diese Kontrolllisten später in Klassendefinitionen verwenden, um die Struktur Ihrer WML Datei zu vereinfachen. Steuerlistendefinitionen haben folgende Syntax:

AnyControlListControlList [ { AnyControl; [...] } ];

Eine Steuerlistendefinition beginnt mit dem Schlüsselwort ControlList . Nach dem Schlüsselwort ControlList folgt eine beliebige Anzahl von Steuerlistendefinitionen. Steuerlistendefinitionen bestehen aus einem Steuerlistennamen, gefolgt von der Gruppe von Steuerelementen, die sie darstellen. Beispiel:

ControlList
        Buttons {PushButton;
                RadioButton;
                CascadeButton;
                NewCascadebutton; } ;

Jedes in der Steuerliste angegebene Steuerelement muss als Klasse in der Datei definiert sein.

Klassendefinitionen

Klassendefinitionen beschreiben eine bestimmte Widgetklasse. In dieser Beschreibung ist die Position in der Klassenhierarchie, in der Komfortfunktion des Toolkits, in Ressourcen und Steuerelementen enthalten. Es sollte eine Klassendefinition für jedes Widget oder Gadget in der Widgetgruppe geben, die Sie in UIL unterstützen möchten. Klassendefinitionen haben folgende Syntax:

Klasse ClassName : MetaClass | Widget | Gerät [{[ SuperClass = Klassenname; | ParentClass = Elternklassenbezeichnung; | InternalLiteral = Interner Name; | Alias = Alias; | ConvenienceFunction = Komfortfunktion; | WidgetClass = WidgetClass ; | DocName = "Zeichenfolge"; | DialogClass = Wahr | Falsch; | Ressourcen { AnyResourceName [{ Standard = NeuerStandardwert; | Ausschließen = Wahr | Falsch; [...]} ]; [...]};| Steuerelemente { Beliebiger Steuerungsname; [...]}; Kinder { Beliebiger Kindername; [...]}; [...] ]}];

Klassendefinitionen beginnen mit dem Schlüsselwort Klasse . Für jede definierte Klasse werden der Name der Klasse und die Angabe, ob die Klasse eine Metaklasse, ein Widget oder ein Gadget ist, aufgelistet. Jede Klassendefinition kann wie folgt geändert werden:

Es folgt ein Beispiel für die Verwendung des vorherigen Datentyps und der Steuerlistendefinitionen:

Class
   TopLevelWidget : MetaClass
        {
        Resources
                {
                XtbNfirstResource;
                XtbNsecondResource;
                };
        };

   NewWidget : Widget
        {
        SuperClass = TopLevelWidget;
        ConvenienceFunction =
                XtbCreateNewWidget;
        Resources
        {
        XtbNnewResource;
        XtbNfirstResource
                {Default="XtbNEW_VALUE";};
        XtbNsecondResource
                {Exclude=True;};
        };
        Controls
        {
        NewWidget;
        Buttons;
        };
        };

Untergeordnete Definitionen

Untergeordnete Definitionen registrieren die Klassen automatisch erstellter untergeordneter Elemente. Automatisch erstellte untergeordnete Elemente werden an anderer Stelle in einer UIL-Datei referenziert, wenn das Schlüsselwort Untergeordnete Elemente in einer Klassendefinition verwendet wird. Untergeordnete Definitionen haben die folgende Syntax:

Kind ChildName : Klassenname; [...]

ChildName ist der Name des automatisch erstellten untergeordneten Elements und ClassName ist der Name der Klasse dieses untergeordneten Elements.

Ressourcendefinitionen

Ressourcendefinitionen beschreiben eine bestimmte Ressource. In dieser Beschreibung sind Typ und Standardwert enthalten. Jede neue Ressourcenreferenz in einer Klassendefinition sollte eine Ressourcendefinition haben. Ressourcendefinitionen haben die folgende Syntax:

Ressource ResourceName : Argument | Reason | Integritätsbedingung | SubResource [{[ Type = Typ ; | ResourceLiteral = ResourceLiteral ; | InternalLiteral = InternalName ; | Alias = Alias ; | Related = Related , | Default = Default , | DocName = Dokumentname , | [...]}] [...]

Ressourcendefinitionen beginnen mit dem Schlüsselwort Ressource . Für jede Ressourcendefinition wird der Name der Ressource und die Angabe, ob die Ressource ein Argument, eine Ursache, eine Integritätsbedingung oder eine untergeordnete Ressource ist, aufgelistet.

Eine Ressourcendefinition kann wie folgt geändert werden:

Es folgt ein Beispiel für die Verwendung von Datentypen, Steuerlisten und Klassendefinitionen:

Resource
   XtbNfirstResource : Argument
        { Type = OddNumber;
          Default = "XtbOLD_VALUE";};
   XtbNsecondResource : Argument
        { Type = NewString;
          Default = "XtbNEW_STRING";};
   XtbNnewResource : Argument
        { Type = OddNumber;
          Default = "XtbODD_NUMBER";};