src/msw/utils.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        msw/utils.cpp
   3 // Purpose:     Various utilities
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     04/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart and Markus Holzem
   9 // Licence:     wxWindows license
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21 // #pragma implementation "utils.h"   // Note: this is done in utilscmn.cpp now.
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #ifndef WX_PRECOMP
  32     #include "wx/utils.h"
  33     #include "wx/app.h"
  34     #include "wx/intl.h"
  35     #include "wx/log.h"
  36 #if wxUSE_GUI
  37     #include "wx/cursor.h"
  38 #endif
  39 #endif  //WX_PRECOMP
  40
  41 #include "wx/msw/private.h"     // includes <windows.h>
  42
  43 #ifdef __GNUWIN32_OLD__
  44     // apparently we need to include winsock.h to get WSADATA and other stuff
  45     // used in wxGetFullHostName() with the old mingw32 versions
  46     #include <winsock.h>
  47 #endif
  48
  49 #include "wx/timer.h"
  50
  51 #if !defined(__GNUWIN32__) && !defined(__WXWINE__) && !defined(__SALFORDC__) && !defined(__WXMICROWIN__)
  52     #include <direct.h>
  53
  54     #ifndef __MWERKS__
  55         #include <dos.h>
  56     #endif
  57 #endif  //GNUWIN32
  58
  59 #if defined(__CYGWIN__) && !defined(__TWIN32__)
  60     #include <sys/unistd.h>
  61     #include <sys/stat.h>
  62     #include <sys/cygwin.h> // for cygwin_conv_to_full_win32_path()
  63 #endif  //GNUWIN32
  64
  65 #ifdef __BORLANDC__ // Please someone tell me which version of Borland needs
  66                     // this (3.1 I believe) and how to test for it.
  67                     // If this works for Borland 4.0 as well, then no worries.
  68     #include <dir.h>
  69 #endif
  70
  71 // VZ: there is some code using NetXXX() functions to get the full user name:
  72 //     I don't think it's a good idea because they don't work under Win95 and
  73 //     seem to return the same as wxGetUserId() under NT. If you really want
  74 //     to use them, just #define USE_NET_API
  75 #undef USE_NET_API
  76
  77 #ifdef USE_NET_API
  78     #include <lm.h>
  79 #endif // USE_NET_API
  80
  81 #if defined(__WIN32__) && !defined(__WXWINE__) && !defined(__WXMICROWIN__)
  82     #include <io.h>
  83
  84     #ifndef __GNUWIN32__
  85         #include <shellapi.h>
  86     #endif
  87 #endif
  88
  89 #ifndef __WATCOMC__
  90     #if !(defined(_MSC_VER) && (_MSC_VER > 800))
  91         #include <errno.h>
  92     #endif
  93 #endif
  94
  95 //// BEGIN for console support: VC++ only
  96 #ifdef __VISUALC__
  97
  98 #include "wx/msw/msvcrt.h"
  99
 100 #include <fcntl.h>
 101
 102 #include "wx/ioswrap.h"
 103
 104 /* Need to undef new if including crtdbg.h */
 105 #  ifdef new
 106 #  undef new
 107 #  endif
 108
 109 #ifndef __WIN16__
 110 #  include <crtdbg.h>
 111 #endif
 112
 113 #  if defined(__WXDEBUG__) && wxUSE_GLOBAL_MEMORY_OPERATORS && wxUSE_DEBUG_NEW_ALWAYS
 114 #  define new new(__TFILE__,__LINE__)
 115 #  endif
 116
 117 #endif
 118   // __VISUALC__
 119 /// END for console support
 120
 121 // ----------------------------------------------------------------------------
 122 // constants
 123 // ----------------------------------------------------------------------------
 124
 125 // In the WIN.INI file
 126 static const wxChar WX_SECTION[] = wxT("wxWindows");
 127 static const wxChar eUSERNAME[]  = wxT("UserName");
 128
 129 // these are only used under Win16
 130 #if !defined(__WIN32__) && !defined(__WXMICROWIN__)
 131 static const wxChar eHOSTNAME[]  = wxT("HostName");
 132 static const wxChar eUSERID[]    = wxT("UserId");
 133 #endif // !Win32
 134
 135 #ifndef __WXMICROWIN__
 136
 137 // ============================================================================
 138 // implementation
 139 // ============================================================================
 140
 141 // ----------------------------------------------------------------------------
 142 // get host name and related
 143 // ----------------------------------------------------------------------------
 144
 145 // Get hostname only (without domain name)
 146 bool wxGetHostName(wxChar *buf, int maxSize)
 147 {
 148 #if defined(__WIN32__) && !defined(__TWIN32__) && !defined(__WXMICROWIN__)
 149     DWORD nSize = maxSize;
 150     if ( !::GetComputerName(buf, &nSize) )
 151     {
 152         wxLogLastError(wxT("GetComputerName"));
 153
 154         return FALSE;
 155     }
 156
 157     return TRUE;
 158 #else
 159     wxChar *sysname;
 160     const wxChar *default_host = wxT("noname");
 161
 162     if ((sysname = wxGetenv(wxT("SYSTEM_NAME"))) == NULL) {
 163         GetProfileString(WX_SECTION, eHOSTNAME, default_host, buf, maxSize - 1);
 164     } else
 165         wxStrncpy(buf, sysname, maxSize - 1);
 166     buf[maxSize] = wxT('\0');
 167     return *buf ? TRUE : FALSE;
 168 #endif
 169 }
 170
 171 // get full hostname (with domain name if possible)
 172 bool wxGetFullHostName(wxChar *buf, int maxSize)
 173 {
 174 #if defined(__WIN32__) && !defined(__TWIN32__) && !defined(__WXMICROWIN__) && ! (defined(__GNUWIN32__) && !defined(__MINGW32__))
 175     // TODO should use GetComputerNameEx() when available
 176
 177     // the idea is that if someone had set wxUSE_SOCKETS to 0 the code
 178     // shouldn't use winsock.dll (a.k.a. ws2_32.dll) at all so only use this
 179     // code if we link with it anyhow
 180 #if wxUSE_SOCKETS
 181     WSADATA wsa;
 182     if ( WSAStartup(MAKEWORD(1, 1), &wsa) == 0 )
 183     {
 184         wxString host;
 185         char bufA[256];
 186         if ( gethostname(bufA, WXSIZEOF(bufA)) == 0 )
 187         {
 188             // gethostname() won't usually include the DNS domain name, for
 189             // this we need to work a bit more
 190             if ( !strchr(bufA, '.') )
 191             {
 192                 struct hostent *pHostEnt =  gethostbyname(bufA);
 193
 194                 if ( pHostEnt )
 195                 {
 196                     // Windows will use DNS internally now
 197                     pHostEnt = gethostbyaddr(pHostEnt->h_addr, 4, AF_INET);
 198                 }
 199
 200                 if ( pHostEnt )
 201                 {
 202                     host = pHostEnt->h_name;
 203                 }
 204             }
 205         }
 206
 207         WSACleanup();
 208
 209         if ( !host.empty() )
 210         {
 211             wxStrncpy(buf, host, maxSize);
 212
 213             return TRUE;
 214         }
 215     }
 216 #endif // wxUSE_SOCKETS
 217
 218 #endif // Win32
 219
 220     return wxGetHostName(buf, maxSize);
 221 }
 222
 223 // Get user ID e.g. jacs
 224 bool wxGetUserId(wxChar *buf, int maxSize)
 225 {
 226 #if defined(__WIN32__) && !defined(__win32s__) && !defined(__TWIN32__) && !defined(__WXMICROWIN__)
 227     DWORD nSize = maxSize;
 228     if ( ::GetUserName(buf, &nSize) == 0 )
 229     {
 230         // actually, it does happen on Win9x if the user didn't log on
 231         DWORD res = ::GetEnvironmentVariable(wxT("username"), buf, maxSize);
 232         if ( res == 0 )
 233         {
 234             // not found
 235             return FALSE;
 236         }
 237     }
 238
 239     return TRUE;
 240 #else   // Win16 or Win32s
 241     wxChar *user;
 242     const wxChar *default_id = wxT("anonymous");
 243
 244     // Can't assume we have NIS (PC-NFS) or some other ID daemon
 245     // So we ...
 246     if (  (user = wxGetenv(wxT("USER"))) == NULL &&
 247             (user = wxGetenv(wxT("LOGNAME"))) == NULL )
 248     {
 249         // Use wxWindows configuration data (comming soon)
 250         GetProfileString(WX_SECTION, eUSERID, default_id, buf, maxSize - 1);
 251     }
 252     else
 253     {
 254         wxStrncpy(buf, user, maxSize - 1);
 255     }
 256
 257     return *buf ? TRUE : FALSE;
 258 #endif
 259 }
 260
 261 // Get user name e.g. Julian Smart
 262 bool wxGetUserName(wxChar *buf, int maxSize)
 263 {
 264 #if wxUSE_PENWINDOWS && !defined(__WATCOMC__) && !defined(__GNUWIN32__)
 265     extern HANDLE g_hPenWin; // PenWindows Running?
 266     if (g_hPenWin)
 267     {
 268         // PenWindows Does have a user concept!
 269         // Get the current owner of the recognizer
 270         GetPrivateProfileString("Current", "User", default_name, wxBuffer, maxSize - 1, "PENWIN.INI");
 271         strncpy(buf, wxBuffer, maxSize - 1);
 272     }
 273     else
 274 #endif
 275     {
 276 #ifdef USE_NET_API
 277         CHAR szUserName[256];
 278         if ( !wxGetUserId(szUserName, WXSIZEOF(szUserName)) )
 279             return FALSE;
 280
 281         // TODO how to get the domain name?
 282         CHAR *szDomain = "";
 283
 284         // the code is based on the MSDN example (also see KB article Q119670)
 285         WCHAR wszUserName[256];          // Unicode user name
 286         WCHAR wszDomain[256];
 287         LPBYTE ComputerName;
 288
 289         USER_INFO_2 *ui2;         // User structure
 290
 291         // Convert ANSI user name and domain to Unicode
 292         MultiByteToWideChar( CP_ACP, 0, szUserName, strlen(szUserName)+1,
 293                 wszUserName, WXSIZEOF(wszUserName) );
 294         MultiByteToWideChar( CP_ACP, 0, szDomain, strlen(szDomain)+1,
 295                 wszDomain, WXSIZEOF(wszDomain) );
 296
 297         // Get the computer name of a DC for the domain.
 298         if ( NetGetDCName( NULL, wszDomain, &ComputerName ) != NERR_Success )
 299         {
 300             wxLogError(wxT("Can not find domain controller"));
 301
 302             goto error;
 303         }
 304
 305         // Look up the user on the DC
 306         NET_API_STATUS status = NetUserGetInfo( (LPWSTR)ComputerName,
 307                 (LPWSTR)&wszUserName,
 308                 2, // level - we want USER_INFO_2
 309                 (LPBYTE *) &ui2 );
 310         switch ( status )
 311         {
 312             case NERR_Success:
 313                 // ok
 314                 break;
 315
 316             case NERR_InvalidComputer:
 317                 wxLogError(wxT("Invalid domain controller name."));
 318
 319                 goto error;
 320
 321             case NERR_UserNotFound:
 322                 wxLogError(wxT("Invalid user name '%s'."), szUserName);
 323
 324                 goto error;
 325
 326             default:
 327                 wxLogSysError(wxT("Can't get information about user"));
 328
 329                 goto error;
 330         }
 331
 332         // Convert the Unicode full name to ANSI
 333         WideCharToMultiByte( CP_ACP, 0, ui2->usri2_full_name, -1,
 334                 buf, maxSize, NULL, NULL );
 335
 336         return TRUE;
 337
 338 error:
 339         wxLogError(wxT("Couldn't look up full user name."));
 340
 341         return FALSE;
 342 #else  // !USE_NET_API
 343         // Could use NIS, MS-Mail or other site specific programs
 344         // Use wxWindows configuration data
 345         bool ok = GetProfileString(WX_SECTION, eUSERNAME, wxT(""), buf, maxSize - 1) != 0;
 346         if ( !ok )
 347         {
 348             ok = wxGetUserId(buf, maxSize);
 349         }
 350
 351         if ( !ok )
 352         {
 353             wxStrncpy(buf, wxT("Unknown User"), maxSize);
 354         }
 355 #endif // Win32/16
 356     }
 357
 358     return TRUE;
 359 }
 360
 361 const wxChar* wxGetHomeDir(wxString *pstr)
 362 {
 363   wxString& strDir = *pstr;
 364
 365   #if defined(__UNIX__) && !defined(__TWIN32__)
 366     const wxChar *szHome = wxGetenv("HOME");
 367     if ( szHome == NULL ) {
 368       // we're homeless...
 369       wxLogWarning(_("can't find user's HOME, using current directory."));
 370       strDir = wxT(".");
 371     }
 372     else
 373        strDir = szHome;
 374
 375     // add a trailing slash if needed
 376     if ( strDir.Last() != wxT('/') )
 377       strDir << wxT('/');
 378
 379     #ifdef __CYGWIN__
 380       // Cygwin returns unix type path but that does not work well
 381       static wxChar windowsPath[MAX_PATH];
 382       cygwin_conv_to_full_win32_path(strDir, windowsPath);
 383       strDir = windowsPath;
 384     #endif
 385   #else   // Windows
 386     #ifdef  __WIN32__
 387       strDir.clear();
 388
 389       // If we have a valid HOME directory, as is used on many machines that
 390       // have unix utilities on them, we should use that.
 391       const wxChar *szHome = wxGetenv(wxT("HOME"));
 392
 393       if ( szHome != NULL )
 394       {
 395         strDir = szHome;
 396       }
 397       else // no HOME, try HOMEDRIVE/PATH
 398       {
 399           szHome = wxGetenv(wxT("HOMEDRIVE"));
 400           if ( szHome != NULL )
 401             strDir << szHome;
 402           szHome = wxGetenv(wxT("HOMEPATH"));
 403
 404           if ( szHome != NULL )
 405           {
 406             strDir << szHome;
 407
 408             // the idea is that under NT these variables have default values
 409             // of "%systemdrive%:" and "\\". As we don't want to create our
 410             // config files in the root directory of the system drive, we will
 411             // create it in our program's dir. However, if the user took care
 412             // to set HOMEPATH to something other than "\\", we suppose that he
 413             // knows what he is doing and use the supplied value.
 414             if ( wxStrcmp(szHome, wxT("\\")) == 0 )
 415               strDir.clear();
 416           }
 417       }
 418
 419       if ( strDir.empty() )
 420       {
 421           // If we have a valid USERPROFILE directory, as is the case in
 422           // Windows NT, 2000 and XP, we should use that as our home directory.
 423           szHome = wxGetenv(wxT("USERPROFILE"));
 424
 425           if ( szHome != NULL )
 426             strDir = szHome;
 427       }
 428
 429       if ( !strDir.empty() )
 430       {
 431           return strDir.c_str();
 432       }
 433       //else: fall back to the prograrm directory
 434     #else   // Win16
 435       // Win16 has no idea about home, so use the executable directory instead
 436     #endif  // WIN16/32
 437
 438     // 260 was taken from windef.h
 439     #ifndef MAX_PATH
 440       #define MAX_PATH  260
 441     #endif
 442
 443     wxString strPath;
 444     ::GetModuleFileName(::GetModuleHandle(NULL),
 445                         strPath.GetWriteBuf(MAX_PATH), MAX_PATH);
 446     strPath.UngetWriteBuf();
 447
 448     // extract the dir name
 449     wxSplitPath(strPath, &strDir, NULL, NULL);
 450
 451   #endif  // UNIX/Win
 452
 453   return strDir.c_str();
 454 }
 455
 456 wxChar *wxGetUserHome(const wxString& WXUNUSED(user))
 457 {
 458     // VZ: the old code here never worked for user != "" anyhow! Moreover, it
 459     //     returned sometimes a malloc()'d pointer, sometimes a pointer to a
 460     //     static buffer and sometimes I don't even know what.
 461     static wxString s_home;
 462
 463     return (wxChar *)wxGetHomeDir(&s_home);
 464 }
 465
 466 bool wxDirExists(const wxString& dir)
 467 {
 468 #ifdef __WXMICROWIN__
 469     return wxPathExist(dir);
 470 #elif defined(__WIN32__)
 471     DWORD attribs = GetFileAttributes(dir);
 472     return ((attribs != (DWORD)-1) && (attribs & FILE_ATTRIBUTE_DIRECTORY));
 473 #else // Win16
 474     #ifdef __BORLANDC__
 475         struct ffblk fileInfo;
 476     #else
 477         struct find_t fileInfo;
 478     #endif
 479     // In Borland findfirst has a different argument
 480     // ordering from _dos_findfirst. But _dos_findfirst
 481     // _should_ be ok in both MS and Borland... why not?
 482     #ifdef __BORLANDC__
 483         return (findfirst(dir, &fileInfo, _A_SUBDIR) == 0 &&
 484                (fileInfo.ff_attrib & _A_SUBDIR) != 0);
 485     #else
 486         return (_dos_findfirst(dir, _A_SUBDIR, &fileInfo) == 0) &&
 487                ((fileInfo.attrib & _A_SUBDIR) != 0);
 488     #endif
 489 #endif // Win32/16
 490 }
 491
 492 bool wxGetDiskSpace(const wxString& path, wxLongLong *pTotal, wxLongLong *pFree)
 493 {
 494     if ( path.empty() )
 495         return FALSE;
 496
 497 // old w32api don't have ULARGE_INTEGER
 498 #if defined(__WIN32__) && \
 499     (!defined(__GNUWIN32__) || wxCHECK_W32API_VERSION( 0, 3 ))
 500     // GetDiskFreeSpaceEx() is not available under original Win95, check for
 501     // it
 502     typedef BOOL (WINAPI *GetDiskFreeSpaceEx_t)(LPCTSTR,
 503                                                 PULARGE_INTEGER,
 504                                                 PULARGE_INTEGER,
 505                                                 PULARGE_INTEGER);
 506
 507     GetDiskFreeSpaceEx_t
 508         pGetDiskFreeSpaceEx = (GetDiskFreeSpaceEx_t)::GetProcAddress
 509                               (
 510                                 ::GetModuleHandle(_T("kernel32.dll")),
 511 #if wxUSE_UNICODE
 512                                 "GetDiskFreeSpaceExW"
 513 #else
 514                                 "GetDiskFreeSpaceExA"
 515 #endif
 516                               );
 517
 518     if ( pGetDiskFreeSpaceEx )
 519     {
 520         ULARGE_INTEGER bytesFree, bytesTotal;
 521
 522         // may pass the path as is, GetDiskFreeSpaceEx() is smart enough
 523         if ( !pGetDiskFreeSpaceEx(path,
 524                                   &bytesFree,
 525                                   &bytesTotal,
 526                                   NULL) )
 527         {
 528             wxLogLastError(_T("GetDiskFreeSpaceEx"));
 529
 530             return FALSE;
 531         }
 532
 533         // ULARGE_INTEGER is a union of a 64 bit value and a struct containing
 534         // two 32 bit fields which may be or may be not named - try to make it
 535         // compile in all cases
 536 #if defined(__BORLANDC__) && !defined(_ANONYMOUS_STRUCT)
 537         #define UL(ul) ul.u
 538 #else // anon union
 539         #define UL(ul) ul
 540 #endif
 541         if ( pTotal )
 542         {
 543             *pTotal = wxLongLong(UL(bytesTotal).HighPart, UL(bytesTotal).LowPart);
 544         }
 545
 546         if ( pFree )
 547         {
 548             *pFree = wxLongLong(UL(bytesFree).HighPart, UL(bytesFree).LowPart);
 549         }
 550     }
 551     else
 552 #endif // Win32
 553     {
 554         // there's a problem with drives larger than 2GB, GetDiskFreeSpaceEx()
 555         // should be used instead - but if it's not available, fall back on
 556         // GetDiskFreeSpace() nevertheless...
 557
 558         DWORD lSectorsPerCluster,
 559               lBytesPerSector,
 560               lNumberOfFreeClusters,
 561               lTotalNumberOfClusters;
 562
 563         // FIXME: this is wrong, we should extract the root drive from path
 564         //        instead, but this is the job for wxFileName...
 565         if ( !::GetDiskFreeSpace(path,
 566                                  &lSectorsPerCluster,
 567                                  &lBytesPerSector,
 568                                  &lNumberOfFreeClusters,
 569                                  &lTotalNumberOfClusters) )
 570         {
 571             wxLogLastError(_T("GetDiskFreeSpace"));
 572
 573             return FALSE;
 574         }
 575
 576         wxLongLong lBytesPerCluster = lSectorsPerCluster;
 577         lBytesPerCluster *= lBytesPerSector;
 578
 579         if ( pTotal )
 580         {
 581             *pTotal = lBytesPerCluster;
 582             *pTotal *= lTotalNumberOfClusters;
 583         }
 584
 585         if ( pFree )
 586         {
 587             *pFree = lBytesPerCluster;
 588             *pFree *= lNumberOfFreeClusters;
 589         }
 590     }
 591
 592     return TRUE;
 593 }
 594
 595 // ----------------------------------------------------------------------------
 596 // env vars
 597 // ----------------------------------------------------------------------------
 598
 599 bool wxGetEnv(const wxString& var, wxString *value)
 600 {
 601 #ifdef __WIN16__
 602     const wxChar* ret = wxGetenv(var);
 603     if (ret)
 604     {
 605         *value = ret;
 606         return TRUE;
 607     }
 608     else
 609         return FALSE;
 610 #else
 611     // first get the size of the buffer
 612     DWORD dwRet = ::GetEnvironmentVariable(var, NULL, 0);
 613     if ( !dwRet )
 614     {
 615         // this means that there is no such variable
 616         return FALSE;
 617     }
 618
 619     if ( value )
 620     {
 621         (void)::GetEnvironmentVariable(var, value->GetWriteBuf(dwRet), dwRet);
 622         value->UngetWriteBuf();
 623     }
 624
 625     return TRUE;
 626 #endif
 627 }
 628
 629 bool wxSetEnv(const wxString& var, const wxChar *value)
 630 {
 631     // some compilers have putenv() or _putenv() or _wputenv() but it's better
 632     // to always use Win32 function directly instead of dealing with them
 633 #if defined(__WIN32__)
 634     if ( !::SetEnvironmentVariable(var, value) )
 635     {
 636         wxLogLastError(_T("SetEnvironmentVariable"));
 637
 638         return FALSE;
 639     }
 640
 641     return TRUE;
 642 #else // no way to set env vars
 643     return FALSE;
 644 #endif
 645 }
 646
 647 // ----------------------------------------------------------------------------
 648 // process management
 649 // ----------------------------------------------------------------------------
 650
 651 #ifdef __WIN32__
 652
 653 // structure used to pass parameters from wxKill() to wxEnumFindByPidProc()
 654 struct wxFindByPidParams
 655 {
 656     wxFindByPidParams() { hwnd = 0; pid = 0; }
 657
 658     // the HWND used to return the result
 659     HWND hwnd;
 660
 661     // the PID we're looking from
 662     DWORD pid;
 663 };
 664
 665 // wxKill helper: EnumWindows() callback which is used to find the first (top
 666 // level) window belonging to the given process
 667 BOOL CALLBACK wxEnumFindByPidProc(HWND hwnd, LPARAM lParam)
 668 {
 669     DWORD pid;
 670     (void)::GetWindowThreadProcessId(hwnd, &pid);
 671
 672     wxFindByPidParams *params = (wxFindByPidParams *)lParam;
 673     if ( pid == params->pid )
 674     {
 675         // remember the window we found
 676         params->hwnd = hwnd;
 677
 678         // return FALSE to stop the enumeration
 679         return FALSE;
 680     }
 681
 682     // continue enumeration
 683     return TRUE;
 684 }
 685
 686 #endif // __WIN32__
 687
 688 int wxKill(long pid, wxSignal sig, wxKillError *krc)
 689 {
 690 #ifdef __WIN32__
 691     // get the process handle to operate on
 692     HANDLE hProcess = ::OpenProcess(SYNCHRONIZE |
 693                                     PROCESS_TERMINATE |
 694                                     PROCESS_QUERY_INFORMATION,
 695                                     FALSE, // not inheritable
 696                                     (DWORD)pid);
 697     if ( hProcess == NULL )
 698     {
 699         if ( krc )
 700         {
 701             if ( ::GetLastError() == ERROR_ACCESS_DENIED )
 702             {
 703                 *krc = wxKILL_ACCESS_DENIED;
 704             }
 705             else
 706             {
 707                 *krc = wxKILL_NO_PROCESS;
 708             }
 709         }
 710
 711         return -1;
 712     }
 713
 714     bool ok = TRUE;
 715     switch ( sig )
 716     {
 717         case wxSIGKILL:
 718             // kill the process forcefully returning -1 as error code
 719             if ( !::TerminateProcess(hProcess, (UINT)-1) )
 720             {
 721                 wxLogSysError(_("Failed to kill process %d"), pid);
 722
 723                 if ( krc )
 724                 {
 725                     // this is not supposed to happen if we could open the
 726                     // process
 727                     *krc = wxKILL_ERROR;
 728                 }
 729
 730                 ok = FALSE;
 731             }
 732             break;
 733
 734         case wxSIGNONE:
 735             // do nothing, we just want to test for process existence
 736             break;
 737
 738         default:
 739             // any other signal means "terminate"
 740             {
 741                 wxFindByPidParams params;
 742                 params.pid = (DWORD)pid;
 743
 744                 // EnumWindows() has nice semantics: it returns 0 if it found
 745                 // something or if an error occured and non zero if it
 746                 // enumerated all the window
 747                 if ( !::EnumWindows(wxEnumFindByPidProc, (LPARAM)&params) )
 748                 {
 749                     // did we find any window?
 750                     if ( params.hwnd )
 751                     {
 752                         // tell the app to close
 753                         //
 754                         // NB: this is the harshest way, the app won't have
 755                         //     opportunity to save any files, for example, but
 756                         //     this is probably what we want here. If not we
 757                         //     can also use SendMesageTimeout(WM_CLOSE)
 758                         if ( !::PostMessage(params.hwnd, WM_QUIT, 0, 0) )
 759                         {
 760                             wxLogLastError(_T("PostMessage(WM_QUIT)"));
 761                         }
 762                     }
 763                     else // it was an error then
 764                     {
 765                         wxLogLastError(_T("EnumWindows"));
 766
 767                         ok = FALSE;
 768                     }
 769                 }
 770                 else // no windows for this PID
 771                 {
 772                     if ( krc )
 773                     {
 774                         *krc = wxKILL_ERROR;
 775                     }
 776
 777                     ok = FALSE;
 778                 }
 779             }
 780     }
 781
 782     // the return code
 783     DWORD rc;
 784
 785     if ( ok )
 786     {
 787         // as we wait for a short time, we can use just WaitForSingleObject()
 788         // and not MsgWaitForMultipleObjects()
 789         switch ( ::WaitForSingleObject(hProcess, 500 /* msec */) )
 790         {
 791             case WAIT_OBJECT_0:
 792                 // process terminated
 793                 if ( !::GetExitCodeProcess(hProcess, &rc) )
 794                 {
 795                     wxLogLastError(_T("GetExitCodeProcess"));
 796                 }
 797                 break;
 798
 799             default:
 800                 wxFAIL_MSG( _T("unexpected WaitForSingleObject() return") );
 801                 // fall through
 802
 803             case WAIT_FAILED:
 804                 wxLogLastError(_T("WaitForSingleObject"));
 805                 // fall through
 806
 807             case WAIT_TIMEOUT:
 808                 if ( krc )
 809                 {
 810                     *krc = wxKILL_ERROR;
 811                 }
 812
 813                 rc = STILL_ACTIVE;
 814                 break;
 815         }
 816     }
 817     else // !ok
 818     {
 819         // just to suppress the warnings about uninitialized variable
 820         rc = 0;
 821     }
 822
 823     ::CloseHandle(hProcess);
 824
 825     // the return code is the same as from Unix kill(): 0 if killed
 826     // successfully or -1 on error
 827     if ( sig == wxSIGNONE )
 828     {
 829         if ( ok && rc == STILL_ACTIVE )
 830         {
 831             // there is such process => success
 832             return 0;
 833         }
 834     }
 835     else // not SIGNONE
 836     {
 837         if ( ok && rc != STILL_ACTIVE )
 838         {
 839             // killed => success
 840             return 0;
 841         }
 842     }
 843 #else // Win16
 844     wxFAIL_MSG( _T("not implemented") );
 845 #endif // Win32/Win16
 846
 847     // error
 848     return -1;
 849 }
 850
 851 // Execute a program in an Interactive Shell
 852 bool wxShell(const wxString& command)
 853 {
 854     wxChar *shell = wxGetenv(wxT("COMSPEC"));
 855     if ( !shell )
 856         shell = (wxChar*) wxT("\\COMMAND.COM");
 857
 858     wxString cmd;
 859     if ( !command )
 860     {
 861         // just the shell
 862         cmd = shell;
 863     }
 864     else
 865     {
 866         // pass the command to execute to the command processor
 867         cmd.Printf(wxT("%s /c %s"), shell, command.c_str());
 868     }
 869
 870     return wxExecute(cmd, TRUE /* sync */) != 0;
 871 }
 872
 873 // Shutdown or reboot the PC
 874 bool wxShutdown(wxShutdownFlags wFlags)
 875 {
 876 #ifdef __WIN32__
 877     bool bOK = TRUE;
 878
 879     if ( wxGetOsVersion(NULL, NULL) == wxWINDOWS_NT ) // if is NT or 2K
 880     {
 881         // Get a token for this process.
 882         HANDLE hToken;
 883         bOK = ::OpenProcessToken(GetCurrentProcess(),
 884                                  TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY,
 885                                  &hToken) != 0;
 886         if ( bOK )
 887         {
 888             TOKEN_PRIVILEGES tkp;
 889
 890             // Get the LUID for the shutdown privilege.
 891             ::LookupPrivilegeValue(NULL, SE_SHUTDOWN_NAME,
 892                                    &tkp.Privileges[0].Luid);
 893
 894             tkp.PrivilegeCount = 1;  // one privilege to set
 895             tkp.Privileges[0].Attributes = SE_PRIVILEGE_ENABLED;
 896
 897             // Get the shutdown privilege for this process.
 898             ::AdjustTokenPrivileges(hToken, FALSE, &tkp, 0,
 899                                     (PTOKEN_PRIVILEGES)NULL, 0);
 900
 901             // Cannot test the return value of AdjustTokenPrivileges.
 902             bOK = ::GetLastError() == ERROR_SUCCESS;
 903         }
 904     }
 905
 906     if ( bOK )
 907     {
 908         UINT flags = EWX_SHUTDOWN | EWX_FORCE;
 909         switch ( wFlags )
 910         {
 911             case wxSHUTDOWN_POWEROFF:
 912                 flags |= EWX_POWEROFF;
 913                 break;
 914
 915             case wxSHUTDOWN_REBOOT:
 916                 flags |= EWX_REBOOT;
 917                 break;
 918
 919             default:
 920                 wxFAIL_MSG( _T("unknown wxShutdown() flag") );
 921                 return FALSE;
 922         }
 923
 924         bOK = ::ExitWindowsEx(EWX_SHUTDOWN | EWX_FORCE | EWX_REBOOT, 0) != 0;
 925     }
 926
 927     return bOK;
 928 #else // Win16
 929     return FALSE;
 930 #endif // Win32/16
 931 }
 932
 933 // ----------------------------------------------------------------------------
 934 // misc
 935 // ----------------------------------------------------------------------------
 936
 937 // Get free memory in bytes, or -1 if cannot determine amount (e.g. on UNIX)
 938 long wxGetFreeMemory()
 939 {
 940 #if defined(__WIN32__) && !defined(__BORLANDC__) && !defined(__TWIN32__)
 941     MEMORYSTATUS memStatus;
 942     memStatus.dwLength = sizeof(MEMORYSTATUS);
 943     GlobalMemoryStatus(&memStatus);
 944     return memStatus.dwAvailPhys;
 945 #else
 946     return (long)GetFreeSpace(0);
 947 #endif
 948 }
 949
 950 unsigned long wxGetProcessId()
 951 {
 952 #ifdef __WIN32__
 953     return ::GetCurrentProcessId();
 954 #else
 955     return 0;
 956 #endif
 957 }
 958
 959 // Emit a beeeeeep
 960 void wxBell()
 961 {
 962     ::MessageBeep((UINT)-1);        // default sound
 963 }
 964
 965 wxString wxGetOsDescription()
 966 {
 967 #ifdef __WIN32__
 968     wxString str;
 969
 970     OSVERSIONINFO info;
 971     wxZeroMemory(info);
 972
 973     info.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);
 974     if ( ::GetVersionEx(&info) )
 975     {
 976         switch ( info.dwPlatformId )
 977         {
 978             case VER_PLATFORM_WIN32s:
 979                 str = _("Win32s on Windows 3.1");
 980                 break;
 981
 982             case VER_PLATFORM_WIN32_WINDOWS:
 983                 str.Printf(_("Windows 9%c"),
 984                            info.dwMinorVersion == 0 ? _T('5') : _T('8'));
 985                 if ( !wxIsEmpty(info.szCSDVersion) )
 986                 {
 987                     str << _T(" (") << info.szCSDVersion << _T(')');
 988                 }
 989                 break;
 990
 991             case VER_PLATFORM_WIN32_NT:
 992                 str.Printf(_T("Windows NT %lu.%lu (build %lu"),
 993                            info.dwMajorVersion,
 994                            info.dwMinorVersion,
 995                            info.dwBuildNumber);
 996                 if ( !wxIsEmpty(info.szCSDVersion) )
 997                 {
 998                     str << _T(", ") << info.szCSDVersion;
 999                 }
1000                 str << _T(')');
1001                 break;
1002         }
1003     }
1004     else
1005     {
1006         wxFAIL_MSG( _T("GetVersionEx() failed") ); // should never happen
1007     }
1008
1009     return str;
1010 #else // Win16
1011     return _("Windows 3.1");
1012 #endif // Win32/16
1013 }
1014
1015 int wxGetOsVersion(int *majorVsn, int *minorVsn)
1016 {
1017 #if defined(__WIN32__) && !defined(__SC__)
1018     static int ver = -1, major = -1, minor = -1;
1019
1020     if ( ver == -1 )
1021     {
1022         OSVERSIONINFO info;
1023         wxZeroMemory(info);
1024
1025         ver = wxWINDOWS;
1026         info.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);
1027         if ( ::GetVersionEx(&info) )
1028         {
1029             major = info.dwMajorVersion;
1030             minor = info.dwMinorVersion;
1031
1032             switch ( info.dwPlatformId )
1033             {
1034                 case VER_PLATFORM_WIN32s:
1035                     ver = wxWIN32S;
1036                     break;
1037
1038                 case VER_PLATFORM_WIN32_WINDOWS:
1039                     ver = wxWIN95;
1040                     break;
1041
1042                 case VER_PLATFORM_WIN32_NT:
1043                     ver = wxWINDOWS_NT;
1044                     break;
1045             }
1046         }
1047     }
1048
1049     if (majorVsn && major != -1)
1050         *majorVsn = major;
1051     if (minorVsn && minor != -1)
1052         *minorVsn = minor;
1053
1054     return ver;
1055 #else // Win16
1056     int retValue = wxWINDOWS;
1057     #ifdef __WINDOWS_386__
1058         retValue = wxWIN386;
1059     #else
1060         #if !defined(__WATCOMC__) && !defined(GNUWIN32) && wxUSE_PENWINDOWS
1061             extern HANDLE g_hPenWin;
1062             retValue = g_hPenWin ? wxPENWINDOWS : wxWINDOWS;
1063         #endif
1064     #endif
1065
1066     if (majorVsn)
1067         *majorVsn = 3;
1068     if (minorVsn)
1069         *minorVsn = 1;
1070
1071     return retValue;
1072 #endif
1073 }
1074
1075 // ----------------------------------------------------------------------------
1076 // sleep functions
1077 // ----------------------------------------------------------------------------
1078
1079 #if wxUSE_GUI
1080
1081 #if wxUSE_TIMER
1082
1083 // Sleep for nSecs seconds. Attempt a Windows implementation using timers.
1084 static bool gs_inTimer = FALSE;
1085
1086 class wxSleepTimer : public wxTimer
1087 {
1088 public:
1089     virtual void Notify()
1090     {
1091         gs_inTimer = FALSE;
1092         Stop();
1093     }
1094 };
1095
1096 static wxTimer *wxTheSleepTimer = NULL;
1097
1098 void wxUsleep(unsigned long milliseconds)
1099 {
1100 #ifdef __WIN32__
1101     ::Sleep(milliseconds);
1102 #else // !Win32
1103     if (gs_inTimer)
1104         return;
1105
1106     wxTheSleepTimer = new wxSleepTimer;
1107     gs_inTimer = TRUE;
1108     wxTheSleepTimer->Start(milliseconds);
1109     while (gs_inTimer)
1110     {
1111         if (wxTheApp->Pending())
1112             wxTheApp->Dispatch();
1113     }
1114     delete wxTheSleepTimer;
1115     wxTheSleepTimer = NULL;
1116 #endif // Win32/!Win32
1117 }
1118
1119 void wxSleep(int nSecs)
1120 {
1121     if (gs_inTimer)
1122         return;
1123
1124     wxTheSleepTimer = new wxSleepTimer;
1125     gs_inTimer = TRUE;
1126     wxTheSleepTimer->Start(nSecs*1000);
1127     while (gs_inTimer)
1128     {
1129         if (wxTheApp->Pending())
1130             wxTheApp->Dispatch();
1131     }
1132     delete wxTheSleepTimer;
1133     wxTheSleepTimer = NULL;
1134 }
1135
1136 // Consume all events until no more left
1137 void wxFlushEvents()
1138 {
1139 //  wxYield();
1140 }
1141
1142 #endif // wxUSE_TIMER
1143
1144 #elif defined(__WIN32__) // wxUSE_GUI
1145
1146 void wxUsleep(unsigned long milliseconds)
1147 {
1148     ::Sleep(milliseconds);
1149 }
1150
1151 void wxSleep(int nSecs)
1152 {
1153     wxUsleep(1000*nSecs);
1154 }
1155
1156 #endif // wxUSE_GUI/!wxUSE_GUI
1157 #endif // __WXMICROWIN__
1158
1159 // ----------------------------------------------------------------------------
1160 // deprecated (in favour of wxLog) log functions
1161 // ----------------------------------------------------------------------------
1162
1163 #if WXWIN_COMPATIBILITY_2_2
1164
1165 // Output a debug mess., in a system dependent fashion.
1166 #ifndef __WXMICROWIN__
1167 void wxDebugMsg(const wxChar *fmt ...)
1168 {
1169   va_list ap;
1170   static wxChar buffer[512];
1171
1172   if (!wxTheApp->GetWantDebugOutput())
1173     return;
1174
1175   va_start(ap, fmt);
1176
1177   wvsprintf(buffer,fmt,ap);
1178   OutputDebugString((LPCTSTR)buffer);
1179
1180   va_end(ap);
1181 }
1182
1183 // Non-fatal error: pop up message box and (possibly) continue
1184 void wxError(const wxString& msg, const wxString& title)
1185 {
1186   wxSprintf(wxBuffer, wxT("%s\nContinue?"), WXSTRINGCAST msg);
1187   if (MessageBox(NULL, (LPCTSTR)wxBuffer, (LPCTSTR)WXSTRINGCAST title,
1188              MB_ICONSTOP | MB_YESNO) == IDNO)
1189     wxExit();
1190 }
1191
1192 // Fatal error: pop up message box and abort
1193 void wxFatalError(const wxString& msg, const wxString& title)
1194 {
1195   wxSprintf(wxBuffer, wxT("%s: %s"), WXSTRINGCAST title, WXSTRINGCAST msg);
1196   FatalAppExit(0, (LPCTSTR)wxBuffer);
1197 }
1198 #endif // __WXMICROWIN__
1199
1200 #endif // WXWIN_COMPATIBILITY_2_2
1201
1202 #if wxUSE_GUI
1203
1204 // ----------------------------------------------------------------------------
1205 // functions to work with .INI files
1206 // ----------------------------------------------------------------------------
1207
1208 // Reading and writing resources (eg WIN.INI, .Xdefaults)
1209 #if wxUSE_RESOURCES
1210 bool wxWriteResource(const wxString& section, const wxString& entry, const wxString& value, const wxString& file)
1211 {
1212   if (file != wxT(""))
1213 // Don't know what the correct cast should be, but it doesn't
1214 // compile in BC++/16-bit without this cast.
1215 #if !defined(__WIN32__)
1216     return (WritePrivateProfileString((const char*) section, (const char*) entry, (const char*) value, (const char*) file) != 0);
1217 #else
1218     return (WritePrivateProfileString((LPCTSTR)WXSTRINGCAST section, (LPCTSTR)WXSTRINGCAST entry, (LPCTSTR)value, (LPCTSTR)WXSTRINGCAST file) != 0);
1219 #endif
1220   else
1221     return (WriteProfileString((LPCTSTR)WXSTRINGCAST section, (LPCTSTR)WXSTRINGCAST entry, (LPCTSTR)WXSTRINGCAST value) != 0);
1222 }
1223
1224 bool wxWriteResource(const wxString& section, const wxString& entry, float value, const wxString& file)
1225 {
1226     wxString buf;
1227     buf.Printf(wxT("%.4f"), value);
1228
1229     return wxWriteResource(section, entry, buf, file);
1230 }
1231
1232 bool wxWriteResource(const wxString& section, const wxString& entry, long value, const wxString& file)
1233 {
1234     wxString buf;
1235     buf.Printf(wxT("%ld"), value);
1236
1237     return wxWriteResource(section, entry, buf, file);
1238 }
1239
1240 bool wxWriteResource(const wxString& section, const wxString& entry, int value, const wxString& file)
1241 {
1242     wxString buf;
1243     buf.Printf(wxT("%d"), value);
1244
1245     return wxWriteResource(section, entry, buf, file);
1246 }
1247
1248 bool wxGetResource(const wxString& section, const wxString& entry, wxChar **value, const wxString& file)
1249 {
1250     static const wxChar defunkt[] = wxT("$$default");
1251     if (file != wxT(""))
1252     {
1253         int n = GetPrivateProfileString((LPCTSTR)WXSTRINGCAST section, (LPCTSTR)WXSTRINGCAST entry, (LPCTSTR)defunkt,
1254                 (LPTSTR)wxBuffer, 1000, (LPCTSTR)WXSTRINGCAST file);
1255         if (n == 0 || wxStrcmp(wxBuffer, defunkt) == 0)
1256             return FALSE;
1257     }
1258     else
1259     {
1260         int n = GetProfileString((LPCTSTR)WXSTRINGCAST section, (LPCTSTR)WXSTRINGCAST entry, (LPCTSTR)defunkt,
1261                 (LPTSTR)wxBuffer, 1000);
1262         if (n == 0 || wxStrcmp(wxBuffer, defunkt) == 0)
1263             return FALSE;
1264     }
1265     if (*value) delete[] (*value);
1266     *value = copystring(wxBuffer);
1267     return TRUE;
1268 }
1269
1270 bool wxGetResource(const wxString& section, const wxString& entry, float *value, const wxString& file)
1271 {
1272     wxChar *s = NULL;
1273     bool succ = wxGetResource(section, entry, (wxChar **)&s, file);
1274     if (succ)
1275     {
1276         *value = (float)wxStrtod(s, NULL);
1277         delete[] s;
1278         return TRUE;
1279     }
1280     else return FALSE;
1281 }
1282
1283 bool wxGetResource(const wxString& section, const wxString& entry, long *value, const wxString& file)
1284 {
1285     wxChar *s = NULL;
1286     bool succ = wxGetResource(section, entry, (wxChar **)&s, file);
1287     if (succ)
1288     {
1289         *value = wxStrtol(s, NULL, 10);
1290         delete[] s;
1291         return TRUE;
1292     }
1293     else return FALSE;
1294 }
1295
1296 bool wxGetResource(const wxString& section, const wxString& entry, int *value, const wxString& file)
1297 {
1298     wxChar *s = NULL;
1299     bool succ = wxGetResource(section, entry, (wxChar **)&s, file);
1300     if (succ)
1301     {
1302         *value = (int)wxStrtol(s, NULL, 10);
1303         delete[] s;
1304         return TRUE;
1305     }
1306     else return FALSE;
1307 }
1308 #endif // wxUSE_RESOURCES
1309
1310 // ---------------------------------------------------------------------------
1311 // helper functions for showing a "busy" cursor
1312 // ---------------------------------------------------------------------------
1313
1314 static HCURSOR gs_wxBusyCursor = 0;     // new, busy cursor
1315 static HCURSOR gs_wxBusyCursorOld = 0;  // old cursor
1316 static int gs_wxBusyCursorCount = 0;
1317
1318 extern HCURSOR wxGetCurrentBusyCursor()
1319 {
1320     return gs_wxBusyCursor;
1321 }
1322
1323 // Set the cursor to the busy cursor for all windows
1324 void wxBeginBusyCursor(wxCursor *cursor)
1325 {
1326     if ( gs_wxBusyCursorCount++ == 0 )
1327     {
1328         gs_wxBusyCursor = (HCURSOR)cursor->GetHCURSOR();
1329 #ifndef __WXMICROWIN__
1330         gs_wxBusyCursorOld = ::SetCursor(gs_wxBusyCursor);
1331 #endif
1332     }
1333     //else: nothing to do, already set
1334 }
1335
1336 // Restore cursor to normal
1337 void wxEndBusyCursor()
1338 {
1339     wxCHECK_RET( gs_wxBusyCursorCount > 0,
1340                  wxT("no matching wxBeginBusyCursor() for wxEndBusyCursor()") );
1341
1342     if ( --gs_wxBusyCursorCount == 0 )
1343     {
1344 #ifndef __WXMICROWIN__
1345         ::SetCursor(gs_wxBusyCursorOld);
1346 #endif
1347         gs_wxBusyCursorOld = 0;
1348     }
1349 }
1350
1351 // TRUE if we're between the above two calls
1352 bool wxIsBusy()
1353 {
1354   return gs_wxBusyCursorCount > 0;
1355 }
1356
1357 // Check whether this window wants to process messages, e.g. Stop button
1358 // in long calculations.
1359 bool wxCheckForInterrupt(wxWindow *wnd)
1360 {
1361     wxCHECK( wnd, FALSE );
1362
1363     MSG msg;
1364     while ( ::PeekMessage(&msg, GetHwndOf(wnd), 0, 0, PM_REMOVE) )
1365     {
1366         ::TranslateMessage(&msg);
1367         ::DispatchMessage(&msg);
1368     }
1369
1370     return TRUE;
1371 }
1372
1373 // MSW only: get user-defined resource from the .res file.
1374 // Returns NULL or newly-allocated memory, so use delete[] to clean up.
1375
1376 #ifndef __WXMICROWIN__
1377 wxChar *wxLoadUserResource(const wxString& resourceName, const wxString& resourceType)
1378 {
1379     HRSRC hResource = ::FindResource(wxGetInstance(), resourceName, resourceType);
1380     if ( hResource == 0 )
1381         return NULL;
1382
1383     HGLOBAL hData = ::LoadResource(wxGetInstance(), hResource);
1384     if ( hData == 0 )
1385         return NULL;
1386
1387     wxChar *theText = (wxChar *)::LockResource(hData);
1388     if ( !theText )
1389         return NULL;
1390
1391     // Not all compilers put a zero at the end of the resource (e.g. BC++ doesn't).
1392     // so we need to find the length of the resource.
1393     int len = ::SizeofResource(wxGetInstance(), hResource);
1394     wxChar  *s = new wxChar[len+1];
1395     wxStrncpy(s,theText,len);
1396     s[len]=0;
1397
1398     // wxChar *s = copystring(theText);
1399
1400     // Obsolete in WIN32
1401 #ifndef __WIN32__
1402     UnlockResource(hData);
1403 #endif
1404
1405     // No need??
1406     //  GlobalFree(hData);
1407
1408     return s;
1409 }
1410 #endif // __WXMICROWIN__
1411
1412 // ----------------------------------------------------------------------------
1413 // get display info
1414 // ----------------------------------------------------------------------------
1415
1416 // See also the wxGetMousePosition in window.cpp
1417 // Deprecated: use wxPoint wxGetMousePosition() instead
1418 void wxGetMousePosition( int* x, int* y )
1419 {
1420     POINT pt;
1421     GetCursorPos( & pt );
1422     if ( x ) *x = pt.x;
1423     if ( y ) *y = pt.y;
1424 };
1425
1426 // Return TRUE if we have a colour display
1427 bool wxColourDisplay()
1428 {
1429 #ifdef __WXMICROWIN__
1430     // MICROWIN_TODO
1431     return TRUE;
1432 #else
1433     // this function is called from wxDC ctor so it is called a *lot* of times
1434     // hence we optimize it a bit but doign the check only once
1435     //
1436     // this should be MT safe as only the GUI thread (holding the GUI mutex)
1437     // can call us
1438     static int s_isColour = -1;
1439
1440     if ( s_isColour == -1 )
1441     {
1442         ScreenHDC dc;
1443         int noCols = ::GetDeviceCaps(dc, NUMCOLORS);
1444
1445         s_isColour = (noCols == -1) || (noCols > 2);
1446     }
1447
1448     return s_isColour != 0;
1449 #endif
1450 }
1451
1452 // Returns depth of screen
1453 int wxDisplayDepth()
1454 {
1455     ScreenHDC dc;
1456     return GetDeviceCaps(dc, PLANES) * GetDeviceCaps(dc, BITSPIXEL);
1457 }
1458
1459 // Get size of display
1460 void wxDisplaySize(int *width, int *height)
1461 {
1462 #ifdef __WXMICROWIN__
1463     RECT rect;
1464     HWND hWnd = GetDesktopWindow();
1465     ::GetWindowRect(hWnd, & rect);
1466
1467     if ( width )
1468         *width = rect.right - rect.left;
1469     if ( height )
1470         *height = rect.bottom - rect.top;
1471 #else // !__WXMICROWIN__
1472     ScreenHDC dc;
1473
1474     if ( width )
1475         *width = ::GetDeviceCaps(dc, HORZRES);
1476     if ( height )
1477         *height = ::GetDeviceCaps(dc, VERTRES);
1478 #endif // __WXMICROWIN__/!__WXMICROWIN__
1479 }
1480
1481 void wxDisplaySizeMM(int *width, int *height)
1482 {
1483 #ifdef __WXMICROWIN__
1484     // MICROWIN_TODO
1485     if ( width )
1486         *width = 0;
1487     if ( height )
1488         *height = 0;
1489 #else
1490     ScreenHDC dc;
1491
1492     if ( width )
1493         *width = ::GetDeviceCaps(dc, HORZSIZE);
1494     if ( height )
1495         *height = ::GetDeviceCaps(dc, VERTSIZE);
1496 #endif
1497 }
1498
1499 void wxClientDisplayRect(int *x, int *y, int *width, int *height)
1500 {
1501 #if defined(__WIN16__) || defined(__WXMICROWIN__)
1502     *x = 0; *y = 0;
1503     wxDisplaySize(width, height);
1504 #else
1505     // Determine the desktop dimensions minus the taskbar and any other
1506     // special decorations...
1507     RECT r;
1508
1509     SystemParametersInfo(SPI_GETWORKAREA, 0, &r, 0);
1510     if (x)      *x = r.left;
1511     if (y)      *y = r.top;
1512     if (width)  *width = r.right - r.left;
1513     if (height) *height = r.bottom - r.top;
1514 #endif
1515 }
1516
1517 // ---------------------------------------------------------------------------
1518 // window information functions
1519 // ---------------------------------------------------------------------------
1520
1521 wxString WXDLLEXPORT wxGetWindowText(WXHWND hWnd)
1522 {
1523     wxString str;
1524
1525     if ( hWnd )
1526     {
1527         int len = GetWindowTextLength((HWND)hWnd) + 1;
1528         ::GetWindowText((HWND)hWnd, str.GetWriteBuf(len), len);
1529         str.UngetWriteBuf();
1530     }
1531
1532     return str;
1533 }
1534
1535 wxString WXDLLEXPORT wxGetWindowClass(WXHWND hWnd)
1536 {
1537     wxString str;
1538
1539     // MICROWIN_TODO
1540 #ifndef __WXMICROWIN__
1541     if ( hWnd )
1542     {
1543         int len = 256; // some starting value
1544
1545         for ( ;; )
1546         {
1547             int count = ::GetClassName((HWND)hWnd, str.GetWriteBuf(len), len);
1548
1549             str.UngetWriteBuf();
1550             if ( count == len )
1551             {
1552                 // the class name might have been truncated, retry with larger
1553                 // buffer
1554                 len *= 2;
1555             }
1556             else
1557             {
1558                 break;
1559             }
1560         }
1561     }
1562 #endif // !__WXMICROWIN__
1563
1564     return str;
1565 }
1566
1567 WXWORD WXDLLEXPORT wxGetWindowId(WXHWND hWnd)
1568 {
1569 #ifndef __WIN32__
1570     return (WXWORD)GetWindowWord((HWND)hWnd, GWW_ID);
1571 #else // Win32
1572     return (WXWORD)GetWindowLong((HWND)hWnd, GWL_ID);
1573 #endif // Win16/32
1574 }
1575
1576 // ----------------------------------------------------------------------------
1577 // Metafile helpers
1578 // ----------------------------------------------------------------------------
1579
1580 extern void PixelToHIMETRIC(LONG *x, LONG *y)
1581 {
1582     ScreenHDC hdcRef;
1583
1584     int iWidthMM = GetDeviceCaps(hdcRef, HORZSIZE),
1585         iHeightMM = GetDeviceCaps(hdcRef, VERTSIZE),
1586         iWidthPels = GetDeviceCaps(hdcRef, HORZRES),
1587         iHeightPels = GetDeviceCaps(hdcRef, VERTRES);
1588
1589     *x *= (iWidthMM * 100);
1590     *x /= iWidthPels;
1591     *y *= (iHeightMM * 100);
1592     *y /= iHeightPels;
1593 }
1594
1595 extern void HIMETRICToPixel(LONG *x, LONG *y)
1596 {
1597     ScreenHDC hdcRef;
1598
1599     int iWidthMM = GetDeviceCaps(hdcRef, HORZSIZE),
1600         iHeightMM = GetDeviceCaps(hdcRef, VERTSIZE),
1601         iWidthPels = GetDeviceCaps(hdcRef, HORZRES),
1602         iHeightPels = GetDeviceCaps(hdcRef, VERTRES);
1603
1604     *x *= iWidthPels;
1605     *x /= (iWidthMM * 100);
1606     *y *= iHeightPels;
1607     *y /= (iHeightMM * 100);
1608 }
1609
1610 #endif // wxUSE_GUI
1611
1612 #ifdef __WXMICROWIN__
1613 int wxGetOsVersion(int *majorVsn, int *minorVsn)
1614 {
1615     // MICROWIN_TODO
1616     if (majorVsn) *majorVsn = 0;
1617     if (minorVsn) *minorVsn = 0;
1618     return wxUNIX;
1619 }
1620 #endif // __WXMICROWIN__
1621
1622 // ----------------------------------------------------------------------------
1623 // Win32 codepage conversion functions
1624 // ----------------------------------------------------------------------------
1625
1626 #if defined(__WIN32__) && !defined(__WXMICROWIN__)
1627
1628 // wxGetNativeFontEncoding() doesn't exist neither in wxBase nor in wxUniv
1629 #if wxUSE_GUI && !defined(__WXUNIVERSAL__)
1630
1631 #include "wx/fontmap.h"
1632
1633 // VZ: the new version of wxCharsetToCodepage() is more politically correct
1634 //     and should work on other Windows versions as well but the old version is
1635 //     still needed for !wxUSE_FONTMAP || !wxUSE_GUI case
1636
1637 extern long wxEncodingToCodepage(wxFontEncoding encoding)
1638 {
1639     // translate encoding into the Windows CHARSET
1640     wxNativeEncodingInfo natveEncInfo;
1641     if ( !wxGetNativeFontEncoding(encoding, &natveEncInfo) )
1642         return -1;
1643
1644     // translate CHARSET to code page
1645     CHARSETINFO csetInfo;
1646     if ( !::TranslateCharsetInfo((DWORD *)(DWORD)natveEncInfo.charset,
1647                                  &csetInfo,
1648                                  TCI_SRCCHARSET) )
1649     {
1650         wxLogLastError(_T("TranslateCharsetInfo(TCI_SRCCHARSET)"));
1651
1652         return -1;
1653     }
1654
1655     return csetInfo.ciACP;
1656 }
1657
1658 #if wxUSE_FONTMAP
1659
1660 extern long wxCharsetToCodepage(const wxChar *name)
1661 {
1662     // first get the font encoding for this charset
1663     if ( !name )
1664         return -1;
1665
1666     wxFontEncoding enc = wxFontMapper::Get()->CharsetToEncoding(name, FALSE);
1667     if ( enc == wxFONTENCODING_SYSTEM )
1668         return -1;
1669
1670     // the use the helper function
1671     return wxEncodingToCodepage(enc);
1672 }
1673
1674 #endif // wxUSE_FONTMAP
1675
1676 #endif // wxUSE_GUI
1677
1678 // include old wxCharsetToCodepage() by OK if needed
1679 #if !wxUSE_GUI || !wxUSE_FONTMAP
1680
1681 #include "wx/msw/registry.h"
1682
1683 // this should work if Internet Exploiter is installed
1684 extern long wxCharsetToCodepage(const wxChar *name)
1685 {
1686     if (!name)
1687         return GetACP();
1688
1689     long CP=-1;
1690
1691     wxString cn(name);
1692     do {
1693         wxString path(wxT("MIME\\Database\\Charset\\"));
1694         path += cn;
1695         wxRegKey key(wxRegKey::HKCR, path);
1696
1697         if (!key.Exists()) break;
1698
1699         // two cases: either there's an AliasForCharset string,
1700         // or there are Codepage and InternetEncoding dwords.
1701         // The InternetEncoding gives us the actual encoding,
1702         // the Codepage just says which Windows character set to
1703         // use when displaying the data.
1704         if (key.HasValue(wxT("InternetEncoding")) &&
1705             key.QueryValue(wxT("InternetEncoding"), &CP)) break;
1706
1707         // no encoding, see if it's an alias
1708         if (!key.HasValue(wxT("AliasForCharset")) ||
1709             !key.QueryValue(wxT("AliasForCharset"), cn)) break;
1710     } while (1);
1711
1712     return CP;
1713 }
1714
1715 #endif // !wxUSE_GUI || !wxUSE_FONTMAP
1716
1717 #endif // Win32
1718