home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / com / activexcontrol / basectl / include / util.h < prev    next >
C/C++ Source or Header  |  1997-10-05  |  6KB  |  146 lines
  1. //=--------------------------------------------------------------------------=
  2. // Util.H
  3. //=--------------------------------------------------------------------------=
  4. // Copyright 1995-1997 Microsoft Corporation.  All Rights Reserved.
  5. //
  6. // THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF 
  7. // ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
  8. // THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A 
  9. // PARTICULAR PURPOSE.
  10. //=--------------------------------------------------------------------------=
  11. //
  12. // contains utilities that we will find useful.
  13. //
  14. #ifndef _UTIL_H_
  15.  
  16. #include "Globals.H"
  17.  
  18.  
  19. //=--------------------------------------------------------------------------=
  20. // Misc Helper Routines
  21. //=--------------------------------------------------------------------------=
  22. //
  23. HWND      GetParkingWindow(void);
  24. HINSTANCE GetResourceHandle(void);
  25.  
  26. //=--------------------------------------------------------------------------=
  27. // miscellaneous [useful] numerical constants
  28. //=--------------------------------------------------------------------------=
  29. // the length of a guid once printed out with -'s, leading and trailing bracket,
  30. // plus 1 for NULL
  31. //
  32. #define GUID_STR_LEN    40
  33.  
  34.  
  35. //=--------------------------------------------------------------------------=
  36. // allocates a temporary buffer that will disappear when it goes out of scope
  37. // NOTE: be careful of that -- make sure you use the string in the same or
  38. // nested scope in which you created this buffer. people should not use this
  39. // class directly.  use the macro(s) below.
  40. //
  41. class TempBuffer {
  42.   public:
  43.     TempBuffer(ULONG cBytes) {
  44.         m_pBuf = (cBytes <= 120) ? &m_szTmpBuf : HeapAlloc(g_hHeap, 0, cBytes);
  45.         m_fHeapAlloc = (cBytes > 120);
  46.     }
  47.     ~TempBuffer() {
  48.         if (m_pBuf && m_fHeapAlloc) HeapFree(g_hHeap, 0, m_pBuf);
  49.     }
  50.     void *GetBuffer() {
  51.         return m_pBuf;
  52.     }
  53.  
  54.   private:
  55.     void *m_pBuf;
  56.     // we'll use this temp buffer for small cases.
  57.     //
  58.     char  m_szTmpBuf[120];
  59.     unsigned m_fHeapAlloc:1;
  60. };
  61.  
  62. //=--------------------------------------------------------------------------=
  63. // string helpers.
  64. //
  65. // given and ANSI String, copy it into a wide buffer.
  66. // be careful about scoping when using this macro!
  67. //
  68. // how to use the below two macros:
  69. //
  70. //  ...
  71. //  LPSTR pszA;
  72. //  pszA = MyGetAnsiStringRoutine();
  73. //  MAKE_WIDEPTR_FROMANSI(pwsz, pszA);
  74. //  MyUseWideStringRoutine(pwsz);
  75. //  ...
  76. //
  77. // similarily for MAKE_ANSIPTR_FROMWIDE.  note that the first param does not
  78. // have to be declared, and no clean up must be done.
  79. //
  80. #define MAKE_WIDEPTR_FROMANSI(ptrname, ansistr) \
  81.     long __l##ptrname = (lstrlen(ansistr) + 1) * sizeof(WCHAR); \
  82.     TempBuffer __TempBuffer##ptrname(__l##ptrname); \
  83.     MultiByteToWideChar(CP_ACP, 0, ansistr, -1, (LPWSTR)__TempBuffer##ptrname.GetBuffer(), __l##ptrname); \
  84.     LPWSTR ptrname = (LPWSTR)__TempBuffer##ptrname.GetBuffer()
  85.  
  86. //
  87. // Note: allocate lstrlenW(widestr) * 2 because its possible for a UNICODE 
  88. // character to map to 2 ansi characters this is a quick guarantee that enough
  89. // space will be allocated.
  90. //
  91. #define MAKE_ANSIPTR_FROMWIDE(ptrname, widestr) \
  92.     long __l##ptrname = (lstrlenW(widestr) + 1) * 2 * sizeof(char); \
  93.     TempBuffer __TempBuffer##ptrname(__l##ptrname); \
  94.     WideCharToMultiByte(CP_ACP, 0, widestr, -1, (LPSTR)__TempBuffer##ptrname.GetBuffer(), __l##ptrname, NULL, NULL); \
  95.     LPSTR ptrname = (LPSTR)__TempBuffer##ptrname.GetBuffer()
  96.  
  97. #define STR_BSTR   0
  98. #define STR_OLESTR 1
  99. #define BSTRFROMANSI(x)    (BSTR)MakeWideStrFromAnsi((LPSTR)(x), STR_BSTR)
  100. #define OLESTRFROMANSI(x)  (LPOLESTR)MakeWideStrFromAnsi((LPSTR)(x), STR_OLESTR)
  101. #define BSTRFROMRESID(x)   (BSTR)MakeWideStrFromResourceId(x, STR_BSTR)
  102. #define OLESTRFROMRESID(x) (LPOLESTR)MakeWideStrFromResourceId(x, STR_OLESTR)
  103. #define COPYOLESTR(x)      (LPOLESTR)MakeWideStrFromWide(x, STR_OLESTR)
  104. #define COPYBSTR(x)        (BSTR)MakeWideStrFromWide(x, STR_BSTR)
  105.  
  106. LPWSTR MakeWideStrFromAnsi(LPSTR, BYTE bType);
  107. LPWSTR MakeWideStrFromResourceId(WORD, BYTE bType);
  108. LPWSTR MakeWideStrFromWide(LPWSTR, BYTE bType);
  109.  
  110.  
  111. // takes a GUID, and a pointer to a buffer, and places the string form of the
  112. // GUID in said buffer.
  113. //
  114. int StringFromGuidA(REFIID, LPSTR);
  115.  
  116.  
  117. //=--------------------------------------------------------------------------=
  118. // registry helpers.
  119. //
  120. // takes some information about an Automation Object, and places all the
  121. // relevant information about it in the registry.
  122. //
  123. BOOL RegSetMultipleValues(HKEY hkey, ...);
  124. BOOL RegisterUnknownObject(LPCSTR pszObjectName, REFCLSID riidObject);
  125. BOOL RegisterAutomationObject(LPCSTR pszLibName, LPCSTR pszObjectName, long lVersion, REFCLSID riidLibrary, REFCLSID riidObject);
  126. BOOL RegisterControlObject(LPCSTR pszLibName, LPCSTR pszObjectName, long lVersion, REFCLSID riidLibrary, REFCLSID riidObject, DWORD dwMiscStatus, WORD wToolboxBitmapId);
  127. BOOL UnregisterUnknownObject(REFCLSID riidObject);
  128. BOOL UnregisterAutomationObject(LPCSTR pszLibName, LPCSTR pszObjectName, long lVersion, REFCLSID riidObject);
  129. #define UnregisterControlObject UnregisterAutomationObject
  130. BOOL UnregisterTypeLibrary(REFCLSID riidLibrary);
  131.  
  132. // deletes a key in the registr and all of it's subkeys
  133. //
  134. BOOL DeleteKeyAndSubKeys(HKEY hk, LPSTR pszSubKey);
  135.  
  136.  
  137. //=--------------------------------------------------------------------------=
  138. // conversion helpers.
  139. //
  140. void        HiMetricToPixel(const SIZEL *pSizeInHiMetric, SIZEL *pSizeinPixels);
  141. void        PixelToHiMetric(const SIZEL *pSizeInPixels, SIZEL *pSizeInHiMetric);
  142.  
  143.  
  144. #define _UTIL_H_
  145. #endif // _UTIL_H_
  146.