wpfXamlEditor

UNDER CONSTRUCTION

Overview

XamlEditor is a Xaml editor for an APL variable or for a file on disk. This user command is able to show the Xaml in color with folding, print it, reorganize it so it is more readable according to some settings set by the user. It is inspired by the work of Robby Ingebretsen of Kaxaml (http://www.Kaxaml.com). It is particularly valuable for APLers that like to keep their Xaml in the workspace. With XamlEditor they have a tool to maintain it without effort.

Usage

Once installed the user command can be invoke by typing ]XamlEditor (casing is not important, no argument). The following start-up screen will appear:

InitialView.png
Here is a short description for each buttons:

Button

Explanation

Button

Explanation

Exec32.png

Execute the Xaml and Show the Result in a Separate Window

SelectAll24.png

Select All the Xaml

Scrubber24.png

Scrub the Xaml According to Settings

Delete24.png

Delete the Selected Text

OpenObject24.png

Open a Dialog Box to Select a Xaml Variable in the WS

ClearClipboard24.png

Clear the Clipboard

SaveObject24.png

Open a Dialog Box to Save the Xaml as a Variable in the WS

Undo24.png

Undo Last Operation

Open24.png

Open a Dialog Box to Select a File on Disk

Redo24.png

Redo Previous Operation

Save24.png

Open a Dialog Box to Save the Xaml to a File

Print32.png

Print All the Xaml

Cut24.png

Cut the Selected Text to The Clipboard

PrintPreview32.png

Print Preview All the Xaml

Copy24.png

Copy the Selected Text to the Clipboard

Comments24.png

Make Selected Text a Comment

Paste24.png

Paste the Text From the clipboard

Settings24.png

Choose the Settings when Scrubbing

Installation

  1. Download the file wpfXamlEditor.1.0.zip. It contains the Dyalog user command file wpfXamlEditor.dyalog and a dll named ICSharpCode.AvalonEdit.dll

  2. Copy the file wpfXamlEditor.dyalog to your user command directory (for advice how to organize your User Commands see UserCommands/WhereShouldTheyGo).

  3. Copy the file ICSharpCode.AvalonEdit.dll to the same directory as your dyalog.exe file (as shown by doing +2 ⎕NQ'.' 'GetEnvironment' 'Dyalog')(you may need administrator privileges for doing that). That dll is free of charge and was written by Daniel Grunwald. It can be downloaded from CodeProject or from AvalonEdit but is included in the zip file for commodity.

Detailed Explanations

Exec32.png

Execute the Xaml and Show the Result in a Separate Window

The Xaml will be parsed and show in a separate window. If the root element of the Xaml is not a window it will be made the content of a new window. The x:Class attribute will be removed if present. All the events will be removed before parsing the Xaml by the function ScrubAndFix. It does not rely on a prefix to removed the events. ( Show ScrubAndFix )

   ∇ rootObj←ScrubAndFix xamlString;err;reader;stringReader;writer;⎕USING
     ⍝ Function to remove the Class and Events elements of Xaml and fix the resulting Xaml.
     ⍝ This function is most usefull when experimenting with Xaml taken directly from the Web but is slower than FixXaml.
     ⍝ Inspired from the code of XAMLPAD2009.
     ⍝ XamlString = Vector of Characters representing a XAML string
     ⍝ rootObj    = WPF Root Element Object if no error
     ⍝            = ⎕NULL (explanation of error) if error
     
      :Trap 0
     
          ⎕USING←'System.IO' 'System.Windows.Markup,WPF/PresentationFramework.dll' 'System.Xaml,System.Xaml.dll'
          stringReader←⎕NEW StringReader(⊂xamlString)
          reader←⎕NEW XamlXmlReader(stringReader XamlReader.GetWpfSchemaContext)
          writer←⎕NEW XamlObjectWriter(reader.SchemaContext)
     
          ⎕USING←0⍴⊂'' ⍝ Don't need it anymore
     
          :While reader.Read
     
              :If 'StartMember'≡⍕reader.NodeType
              :AndIf reader.Member.Name≡'Class'
                ⍝ Skip the x:Class attribute
                  {}reader.Read
                  {}reader.Read
     
              :ElseIf 'StartMember'≡⍕reader.NodeType
              :AndIf reader.Member.IsEvent
                ⍝ Skip the Event member
                  {}reader.Read
                  {}reader.Read
     
              :Else
                ⍝ Keep the other nodes
                  writer.WriteNode(reader)
     
              :End
     
          :EndWhile
     
        ⍝ The following line will return the root object
          rootObj←writer.Result
     
      :Else
         ⍝ Build the Error Message
          :If 90≠⎕EN
            ⍝ APL Error
              err←(1⊃⎕DM),': ',{(' '=1↑⍵)↓((1↓a,0)∨a←' '≠⍵)/⍵}(2⊃⎕DM),(⎕UCS 13)
     
          :Else
            ⍝ .Net Error
              :Trap 0
                ⍝ Show the value of ⎕EXCEPTION.Message if not ⎕NULL.
                  err←('EXCEPTION: ',⎕EXCEPTION.Message),(⎕UCS 13)
              :Else
                ⍝ Sometimes ⎕EXCEPTION is (NULL) and will bug here.
                  err←'Exception (NULL): Unknown error',(⎕UCS 13)
     
              :EndTrap
     
          :End
     
          rootObj←⎕NULL err
     
      :EndTrap


Scrubber24.png

Scrub the Xaml According to Settings



OpenObject24.png

Open a Dialog Box to Select a Xaml Variable in the WS

SaveObject24.png

Open a Dialog Box to Save the Xaml as a Variable in the WS

The dialog box contains a tree element where each branch is a namespace that has a character variable that responded positive to the following test: '><'≡¯2↑1⌽variableName~⎕UCS 32 10 13 9 (first and last character is '<>' after removing the space,LF,NL,HT characters)

Open24.png

Open a Dialog Box to Select a File on Disk

Save24.png

Open a Dialog Box to Save the Xaml to a File

A standard OpenFileDialog and SaveFileDialog are used to select and save the file.

Print32.png

Print All the Xaml

PrintPreview32.png

Print Preview All the Xaml

Will take the Xaml to a FlowDocument where it can be preview or print directly.

Comments24.png

Make Selected Text a Comment

The following rules applied to this button when clicked:

  1. If nothing is selected it will insert '<!--  -->' at the caret.

  2. If the selection is positive to the test: ' --><!-- '≡9↑¯4⌽selectedText, the comments are removed.

  3. Otherwise it will insert: '<!-- ',selectedText,' -->'


Settings24.png

Choose the Settings when Scrubbing

The settings for scrubbing are saved in a xml file named XED.Settings.xml. The file will be created automatically with default values the first time the user command runs. It will be located next to the wpfXamlEditor.dyalog file or in the AppData directory depending on the Windows version and security. The data of the file looks like this:

   1 <Settings>
   2   <EditorFont>APL385 Unicode</EditorFont>
   3   <EditorFontSize>14</EditorFontSize>
   4   <ReducePrecision>0</ReducePrecision>
   5   <Precision>10</Precision>
   6   <AttributeCounteTolerance>2</AttributeCounteTolerance>
   7   <ReorderAttributes>1</ReorderAttributes>
   8   <RemoveCommonDefaultValues>1</RemoveCommonDefaultValues>
   9   <ConvertTabsToSpaces>1</ConvertTabsToSpaces>
  10   <SpaceCount>2</SpaceCount>
  11 </Settings>


It is used to build the Settings window (button Settings24.png of the command bar).
Settings.png
Look at the individual tooltips on the Window for more information on each settings.

Version Information

Original author:

Pierre Gilbert

Responsible:

PierreGilbert

Email:

<apgil AT SPAMFREE videotron DOT ca>

CategoryDyalogWpfUtilities