MUI Royale 1.7 Easy GUI Creation For You Kings and Queens of MUI Andreas Falkenhahn i Table of Contents 1 General information::::::::::::::::::::::::::::: 1 1.1 Introduction :::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.2 Terms and conditions ::::::::::::::::::::::::::::::::::::::::::: 1 1.3 Requirements::::::::::::::::::::::::::::::::::::::::::::::::::: 2 1.4 Support for palette screens:::::::::::::::::::::::::::::::::::::: 2 2 About MUI Royale:::::::::::::::::::::::::::::: 5 2.1 History ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 5 2.2 Future:::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 5 2.3 Frequently asked questions:::::::::::::::::::::::::::::::::::::: 5 2.4 Credits ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 5 3 Fundamental MUI concepts :::::::::::::::::::: 7 3.1 Application tree :::::::::::::::::::::::::::::::::::::::::::::::: 7 3.2 Class hierarchy ::::::::::::::::::::::::::::::::::::::::::::::::: 8 3.3 Automatic layout engine :::::::::::::::::::::::::::::::::::::::: 8 3.4 Group objects :::::::::::::::::::::::::::::::::::::::::::::::::: 9 3.5 Object handling ::::::::::::::::::::::::::::::::::::::::::::::: 11 3.6 Notifications::::::::::::::::::::::::::::::::::::::::::::::::::: 12 3.7 Applicability :::::::::::::::::::::::::::::::::::::::::::::::::: 13 3.8 Cycle chain:::::::::::::::::::::::::::::::::::::::::::::::::::: 13 3.9 Text formatting codes ::::::::::::::::::::::::::::::::::::::::: 14 3.10 Implementing online help ::::::::::::::::::::::::::::::::::::: 15 3.11 Context menus ::::::::::::::::::::::::::::::::::::::::::::::: 16 3.12 Drag'n'drop :::::::::::::::::::::::::::::::::::::::::::::::::: 17 3.13 Character encoding::::::::::::::::::::::::::::::::::::::::::: 17 3.14 Hollywood bridge::::::::::::::::::::::::::::::::::::::::::::: 18 3.15 Style guide ::::::::::::::::::::::::::::::::::::::::::::::::::: 22 4 Tutorial ::::::::::::::::::::::::::::::::::::::::: 25 4.1 Tutorial ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 25 5 Function reference ::::::::::::::::::::::::::::: 35 5.1 mui.CreateGUI :::::::::::::::::::::::::::::::::::::::::::::::: 35 5.2 mui.CreateObject ::::::::::::::::::::::::::::::::::::::::::::: 36 5.3 mui.DoMethod :::::::::::::::::::::::::::::::::::::::::::::::: 37 5.4 mui.FreeGUI :::::::::::::::::::::::::::::::::::::::::::::::::: 38 5.5 mui.FreeImage::::::::::::::::::::::::::::::::::::::::::::::::: 38 5.6 mui.FreeObject :::::::::::::::::::::::::::::::::::::::::::::::: 39 5.7 mui.Get ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 39 5.8 mui.HaveObject ::::::::::::::::::::::::::::::::::::::::::::::: 40 ii MUI Royale manual 5.9 mui.IsVersion4::::::::::::::::::::::::::::::::::::::::::::::::: 40 5.10 mui.Notify ::::::::::::::::::::::::::::::::::::::::::::::::::: 41 5.11 mui.Request:::::::::::::::::::::::::::::::::::::::::::::::::: 41 5.12 mui.Set :::::::::::::::::::::::::::::::::::::::::::::::::::::: 43 6 Application class ::::::::::::::::::::::::::::::: 45 6.1 Overview :::::::::::::::::::::::::::::::::::::::::::::::::::::: 45 6.2 Application.AboutMUI :::::::::::::::::::::::::::::::::::::::: 45 6.3 Application.AboutMUIRoyale ::::::::::::::::::::::::::::::::: 45 6.4 Application.AddWindow::::::::::::::::::::::::::::::::::::::: 45 6.5 Application.Base :::::::::::::::::::::::::::::::::::::::::::::: 46 6.6 Application.ConfigChange ::::::::::::::::::::::::::::::::::::: 46 6.7 Application.DoubleStart ::::::::::::::::::::::::::::::::::::::: 47 6.8 Application.DropObject ::::::::::::::::::::::::::::::::::::::: 47 6.9 Application.HelpFile::::::::::::::::::::::::::::::::::::::::::: 47 6.10 Application.Icon:::::::::::::::::::::::::::::::::::::::::::::: 48 6.11 Application.Iconified ::::::::::::::::::::::::::::::::::::::::: 48 6.12 Application.Load ::::::::::::::::::::::::::::::::::::::::::::: 49 6.13 Application.Menustrip :::::::::::::::::::::::::::::::::::::::: 50 6.14 Application.OpenConfigWindow :::::::::::::::::::::::::::::: 50 6.15 Application.RemoveWindow :::::::::::::::::::::::::::::::::: 51 6.16 Application.Save ::::::::::::::::::::::::::::::::::::::::::::: 51 6.17 Application.SingleTask ::::::::::::::::::::::::::::::::::::::: 52 6.18 Application.Sleep::::::::::::::::::::::::::::::::::::::::::::: 52 6.19 Application.WindowList :::::::::::::::::::::::::::::::::::::: 53 7 Area class ::::::::::::::::::::::::::::::::::::::: 55 7.1 Overview :::::::::::::::::::::::::::::::::::::::::::::::::::::: 55 7.2 Area.Background :::::::::::::::::::::::::::::::::::::::::::::: 55 7.3 Area.BackgroundBrush :::::::::::::::::::::::::::::::::::::::: 56 7.4 Area.BackgroundImage :::::::::::::::::::::::::::::::::::::::: 57 7.5 Area.BackgroundRGB ::::::::::::::::::::::::::::::::::::::::: 57 7.6 Area.BottomEdge ::::::::::::::::::::::::::::::::::::::::::::: 58 7.7 Area.ContextMenu :::::::::::::::::::::::::::::::::::::::::::: 58 7.8 Area.ContextMenuTrigger ::::::::::::::::::::::::::::::::::::: 59 7.9 Area.ControlChar ::::::::::::::::::::::::::::::::::::::::::::: 59 7.10 Area.CycleChain ::::::::::::::::::::::::::::::::::::::::::::: 59 7.11 Area.Disabled :::::::::::::::::::::::::::::::::::::::::::::::: 60 7.12 Area.FixHeight ::::::::::::::::::::::::::::::::::::::::::::::: 60 7.13 Area.FixHeightTxt ::::::::::::::::::::::::::::::::::::::::::: 60 7.14 Area.FixWidth ::::::::::::::::::::::::::::::::::::::::::::::: 61 7.15 Area.FixWidthTxt ::::::::::::::::::::::::::::::::::::::::::: 61 7.16 Area.Font :::::::::::::::::::::::::::::::::::::::::::::::::::: 61 7.17 Area.Frame :::::::::::::::::::::::::::::::::::::::::::::::::: 62 7.18 Area.FramePhantomHoriz :::::::::::::::::::::::::::::::::::: 63 7.19 Area.FrameTitle:::::::::::::::::::::::::::::::::::::::::::::: 63 7.20 Area.Height :::::::::::::::::::::::::::::::::::::::::::::::::: 64 iii 7.21 Area.Hide :::::::::::::::::::::::::::::::::::::::::::::::::::: 64 7.22 Area.HorizWeight :::::::::::::::::::::::::::::::::::::::::::: 64 7.23 Area.InnerBottom :::::::::::::::::::::::::::::::::::::::::::: 65 7.24 Area.InnerLeft ::::::::::::::::::::::::::::::::::::::::::::::: 65 7.25 Area.InnerRight :::::::::::::::::::::::::::::::::::::::::::::: 65 7.26 Area.InnerTop:::::::::::::::::::::::::::::::::::::::::::::::: 66 7.27 Area.InputMode:::::::::::::::::::::::::::::::::::::::::::::: 66 7.28 Area.LeftEdge:::::::::::::::::::::::::::::::::::::::::::::::: 66 7.29 Area.MaxHeight:::::::::::::::::::::::::::::::::::::::::::::: 67 7.30 Area.MaxWidth :::::::::::::::::::::::::::::::::::::::::::::: 67 7.31 Area.Pressed ::::::::::::::::::::::::::::::::::::::::::::::::: 67 7.32 Area.RightEdge :::::::::::::::::::::::::::::::::::::::::::::: 68 7.33 Area.Selected::::::::::::::::::::::::::::::::::::::::::::::::: 68 7.34 Area.ShortHelp::::::::::::::::::::::::::::::::::::::::::::::: 69 7.35 Area.ShowSelState ::::::::::::::::::::::::::::::::::::::::::: 69 7.36 Area.TopEdge :::::::::::::::::::::::::::::::::::::::::::::::: 70 7.37 Area.VertWeight ::::::::::::::::::::::::::::::::::::::::::::: 70 7.38 Area.Weight:::::::::::::::::::::::::::::::::::::::::::::::::: 70 7.39 Area.Width :::::::::::::::::::::::::::::::::::::::::::::::::: 71 8 Busy class::::::::::::::::::::::::::::::::::::::: 73 8.1 Overview :::::::::::::::::::::::::::::::::::::::::::::::::::::: 73 8.2 Busy.Move :::::::::::::::::::::::::::::::::::::::::::::::::::: 73 8.3 Busy.Speed :::::::::::::::::::::::::::::::::::::::::::::::::::: 73 9 Button class :::::::::::::::::::::::::::::::::::: 75 9.1 Overview :::::::::::::::::::::::::::::::::::::::::::::::::::::: 75 9.2 Button.HiChar :::::::::::::::::::::::::::::::::::::::::::::::: 75 9.3 Button.Label :::::::::::::::::::::::::::::::::::::::::::::::::: 75 9.4 Button.NoAutoKey:::::::::::::::::::::::::::::::::::::::::::: 76 9.5 Button.Pressed :::::::::::::::::::::::::::::::::::::::::::::::: 76 9.6 Button.Selected ::::::::::::::::::::::::::::::::::::::::::::::: 76 9.7 Button.Toggle ::::::::::::::::::::::::::::::::::::::::::::::::: 77 10 Checkmark class :::::::::::::::::::::::::::::: 79 10.1 Overview::::::::::::::::::::::::::::::::::::::::::::::::::::: 79 10.2 Checkmark.Selected :::::::::::::::::::::::::::::::::::::::::: 79 11 Coloradjust class :::::::::::::::::::::::::::::: 81 11.1 Overview::::::::::::::::::::::::::::::::::::::::::::::::::::: 81 11.2 Coloradjust.RGB ::::::::::::::::::::::::::::::::::::::::::::: 81 12 Colorfield class :::::::::::::::::::::::::::::::: 83 12.1 Overview::::::::::::::::::::::::::::::::::::::::::::::::::::: 83 12.2 Colorfield.RGB ::::::::::::::::::::::::::::::::::::::::::::::: 83 iv MUI Royale manual 13 Cycle class::::::::::::::::::::::::::::::::::::: 85 13.1 Overview::::::::::::::::::::::::::::::::::::::::::::::::::::: 85 13.2 Cycle.Active ::::::::::::::::::::::::::::::::::::::::::::::::: 85 14 Dirlist class:::::::::::::::::::::::::::::::::::: 87 14.1 Overview::::::::::::::::::::::::::::::::::::::::::::::::::::: 87 14.2 Dirlist.AcceptPattern::::::::::::::::::::::::::::::::::::::::: 88 14.3 Dirlist.Directory:::::::::::::::::::::::::::::::::::::::::::::: 88 14.4 Dirlist.DrawersOnly :::::::::::::::::::::::::::::::::::::::::: 89 14.5 Dirlist.FilesOnly:::::::::::::::::::::::::::::::::::::::::::::: 89 14.6 Dirlist.FilterDrawers ::::::::::::::::::::::::::::::::::::::::: 89 14.7 Dirlist.MultiSelDirs::::::::::::::::::::::::::::::::::::::::::: 90 14.8 Dirlist.NumBytes::::::::::::::::::::::::::::::::::::::::::::: 90 14.9 Dirlist.NumDrawers :::::::::::::::::::::::::::::::::::::::::: 90 14.10 Dirlist.NumFiles :::::::::::::::::::::::::::::::::::::::::::: 91 14.11 Dirlist.Path ::::::::::::::::::::::::::::::::::::::::::::::::: 91 14.12 Dirlist.RejectIcons:::::::::::::::::::::::::::::::::::::::::::