wxPython/wxPython/tools/XRCed/README.txt

   1 ********************************************************************************
   2
   3                                   XRCed README
   4
   5 ********************************************************************************
   6
   7 Installation on UNIX
   8 --------------------
   9
  10 XRCed requires wxGTK and wxPython greater or equal to 2.3.3, and Python 2.2
  11 (it may work with earlier version, but was not tested).
  12
  13 Of course wxGTK's XRC library (libwxxrc) and it's python module must
  14 be installed.
  15
  16 Installation on Windows
  17 -----------------------
  18
  19 Works with wxPython 2.3.2 for Python 2.2.
  20
  21 Short manual
  22 ------------
  23
  24 XRCed's idea is very straightforward: it is a visual tool for editing an XML
  25 file conforming to XRC format. Every operation performed in XRCed has direct
  26 correspondence to XML structure. So it is not really a usual point-and-click
  27 GUI builder, but don't let that scare you.
  28
  29 To start xrced, change to the directory where you installed it and run
  30 "python2.2 xrced.py".
  31
  32 On UNIX you can edit wrapper script "xrced.sh" to point to your installation
  33 directory.
  34
  35 To create an object, first you should select some object in the tree (or the
  36 root item if it's empty) then press the right mouse button and select an
  37 appropriate command. The pulldown menu is context-dependent on the selected
  38 object.
  39
  40 XRCed tries to guess if new object should be added as a next sibling or a
  41 child of current object, depending on the possibility of the object to have
  42 child objects and expanded state (if tree item is collapsed, new object will
  43 be sibling). You can change this behavior to create siblings by pressing and
  44 holding the Shift and Control keys before clicking the mouse.
  45
  46 Pressed Control key while pressing right button makes next item a sibling of
  47 selected item regardless of its expanded state.
  48
  49 Pressed Shift key changes the place for inserting new child to be before
  50 selected child, not after as by default.
  51
  52 Panel on the right contains object properties. Properties which are optional
  53 should be "checked" first. This panel can be made separate by unchecking
  54 "Embed Panel" in View menu.
  55
  56 All properties can be edited as text, and some are supplied with special
  57 editing controls.
  58
  59 The names of the properties are exactly as in XRC file, and it's usually not
  60 hard to guess what they do. XML ID is the name of the window, and must be
  61 present for top-level windows (though this is not enforced by XRCed).
  62
  63 To display the preview window double-click a top-level object (you should
  64 assign an XMLID to it first), press "Test" toolbar button or select command
  65 from View menu, or press F5. After that, if you select a child object, it
  66 becomes highlighted, and if you change it, preview is updated when you select
  67 another item or press Ctrl-R (refresh). To turn off automatic update, toggle
  68 "View->Auto-refresh" or toolbar auto-refresh button (to the right of the
  69 refresh button).
  70
  71 --------------------------------------------------------------------------------
  72
  73 Copyright 2001 Roman Rolinsky <rolinsky@mema.ucl.ac.be>