The Panel Object

Synopsis

Description

The top level object which serves as the application main window.

• The Panel object is created automatically and cannot be destroyed.
• It is always called gsharp_1.
• Although each of the Panel's children are optional, if they are created they will appear in the following order: Menubar, Toolbar, Canvas, Toolbar, Command.
• The Panel's components can be managed using the object displayoption
• If used, the Panel's Toolbars need to be registered with Gsharp like so:

  create Toolbar gsharp_1.TopToolbar
   ( XuNguiCreateFunction = "GuiSetCommandToolbarId",
     XuNguiDestroyFunction = "GuiDestroyCommandToolbar"
   );
  create Toolbar gsharp_1.BottomToolbar
   ( XuNguiCreateFunction = "GuiSetObjectToolbarId",
     XuNguiDestroyFunction = "GuiDestroyObjectToolbar"
   );

• Any number of dialogs can be created
  

Inherited Resources

• All objects: XuNdestroyable, XuNimmutable, XuNname and XuNuserData
• GUI objects: XuNguiCreateFunction, XuNguiDestroyFunction, XuNguiHeight, XuNguiPosition, XuNguiSensitive and XuNguiWidth

New Resources

• The title of the Gsharp main window

• XuNguiCallback specifies the name of the function to call when the application exits. The callback reason is  XuCR_EXIT.
• If XuNguiCallbackData is specified then the value is passed to the callback function in the second argument.
• For more details - see Callback Functions

Example Code

  set gsharp_1
   ( XuNguiTitle = "My Application",
     XuNguiPosition = (0,0),
     XuNguiWidth = 200,
     XuNguiHeight = 400
   );
  create Menubar gsharp_1.MenuBar;
  create Menu gsharp_1.MenuBar.FileMenu
   ( XuNguiLabel = "File"
   );
  create Button gsharp_1.MenuBar.FileMenu.Open;

  create Toolbar gsharp_1.TopToolbar
   ( XuNguiCreateFunction = "GuiSetCommandToolbarId",
     XuNguiDestroyFunction = "GuiDestroyCommandToolbar"
   );
  create Icon gsharp_1.TopToolbar.Open
   ( XuNguiPixmap = "print.xpm"
   );

  create Canvas gsharp_1.ScrolledCanvas;

  create Toolbar gsharp_1.BottomToolbar
   ( XuNguiCreateFunction = "GuiSetObjectToolbarId",
     XuNguiDestroyFunction = "GuiDestroyObjectToolbar"
   );
  create Icon gsharp_1.BottomToolbar.Open
   ( XuNguiPixmap = "open.xpm"
   );

  create Command gsharp_1.command;

Return to Gsharp Applications Reference Manual