X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/048bd5039e8a444b097796d37d23df948ce718c9..2d956b58023a4955313a1c1531bc70a0deb0b831:/docs/univ/readme.txt diff --git a/docs/univ/readme.txt b/docs/univ/readme.txt index ada0d1ac24..13a6765469 100644 --- a/docs/univ/readme.txt +++ b/docs/univ/readme.txt @@ -1,10 +1,10 @@ - wxUniversal README - ================== + wxUniversal README + ================== Welcome to wxUniversal! Acknowledgements: wxUniversal wouldn't have been written without the -generuous support of SciTech Software. Many thanks to Kendall Benett and +generous support of SciTech Software. Many thanks to Kendall Bennett and Tom Ryan! 0. Introduction @@ -13,29 +13,29 @@ Tom Ryan! wxUniversal is a port of wxWindows which implements the various GUI controls by drawing them itself (using low level wxWindows classes). Please see - http://www.wxwindows.org/wxuniv.htm + http://www.wxwindows.org/wxuniv.htm for more details about it. The advantage of wxUniversal is that you have precise control over the -controls appearance (it is not always possible to change all aspects of the +controls' appearance (it is not always possible to change all aspects of the native controls) and the theme support: the same program may be changed to -look completely differently without changing a single line of its code but +look completely differently without changing a single line of its code but just changing the theme. Another advantage is that it makes writing ports of wxWindows for other platforms (such as OS/2, BeOS or QNX) much simpler, so it is of special -interest to the people interested in porting wxWindows to another platform. +interest to people interested in porting wxWindows to another platform. - However, wxUniversal doesn't have the 100% native look and feel unlike the + However, wxUniversal doesn't have a 100% native look and feel unlike the other wxWindows ports - this is the price to pay for the extra flexibility. -1. Requirments and supported platforms --------------------------------------- +1. Requirements and supported platforms +--------------------------------------- wxUniversal is used together with another wxWindows port which provides the -"low level classes" mentioned above. Currently it can be built either with -wxMSW or wxGTK. In any case, you should download the sources for the +"low level classes" mentioned above. Currently it can be built with wxMSW, +wxGTK or wxX11. In any case, you should download the sources for the appropriate toolkit in addition to wxUniversal - in fact, you should download them first and then unpack wxUniversal in the same directory. @@ -47,7 +47,7 @@ toolkit. a) Using Visual C++ 6.0 - Simply open the src/wxUniv.dsw file in MSDEV and build it. + Simply open the src/wxUniv.dsw file in DevStudio and build it. b) Cygwin @@ -55,18 +55,39 @@ b) Cygwin c) Other compilers - Unfortunately we don't have the makefiles for any other compilers yet. + Unfortunately we don't have makefiles for any other compilers yet. Please contact us if you would like to help us with creating one for the compiler you use. +Note that you can use the wxUniversal classes, wxMSW and MicroWindows (from +Century Software) to build a different variant of wxUniversal than that +documented here. Please see docs/univ/readme.txt for further information. + 3. Installing under Unix ------------------------ -Please refer to the installation instructions for wxGTK. The only change for -wxUniversal is that you must add "--enable-univ" switch to the configure -command line. +Please refer to the installation instructions for wxGTK or wxX11. The only +change for wxUniversal is that you must add "--enable-universal" switch to +the configure command line and for wxX11 even this is unnecessary, i.e. it +is enabled by default. + +4. Running wxUniv programs +-------------------------- + +wxUniv programs all honour the standard option "--theme" which allows to +specify the theme to be used by name. Currently there are the following +themes: + +a) win32 -- Windows 95 look and feel +b) metal -- based on win32 but with gradient backgrounds +c) gtk -- GTK+ 1.x standard look and feel -4. Documentation and support +Thus, to launch a program using gtk theme you may do "./program --theme=gtk". + +It is also possible to change the default theme for all wxUniv applications +at once by setting the environment variable WXTHEME to the theme name. + +5. Documentation and support ---------------------------- Please note that wxUniversal is not as mature as the other wxWindows ports @@ -87,12 +108,11 @@ itself, namely: * WWW page: http://www.wxwindows.org/ - Hope you will find wxUniversal useful! - - Vadim Zeitlin + Hope you find wxUniversal useful! + Vadim Zeitlin -This file is accurate for the version 2.3.2 of wxUniversal. It was last -modified on Dec 11, 2001. +This file is accurate for the version 2.3.3 of wxUniversal. It was last +modified on Apr 15, 2002.