]> git.saurik.com Git - wxWidgets.git/blob - src/msw/ole/uuid.cpp
A lot of documentation revision. Updated doctest code in propgrid sample to reflect...
[wxWidgets.git] / src / msw / ole / uuid.cpp
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/ole/uuid.cpp
3 // Purpose: implements Uuid class, see uuid.h for details
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created: 12.09.96
7 // RCS-ID: $Id$
8 // Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
11
12 // ============================================================================
13 // Declarations
14 // ============================================================================
15
16 // For compilers that support precompilation, includes "wx.h".
17 #include "wx/wxprec.h"
18
19 #if defined(__BORLANDC__)
20 #pragma hdrstop
21 #endif
22
23 #if wxUSE_OLE && ( wxUSE_DRAG_AND_DROP || (defined(__WXDEBUG__) && wxUSE_DATAOBJ) )
24
25 #ifndef WX_PRECOMP
26 #include "wx/msw/wrapwin.h"
27 #endif
28
29 #include <rpc.h> // UUID related functions
30
31 #include "wx/msw/ole/uuid.h"
32
33
34
35 // ============================================================================
36 // Implementation
37 // ============================================================================
38
39 // length of UUID in C format
40 #define UUID_CSTRLEN 100 // real length is 66
41
42 // copy ctor
43 Uuid::Uuid(const Uuid& uuid)
44 {
45 // bitwise copy Ok for UUIDs
46 m_uuid = uuid.m_uuid;
47
48 // force the string to be allocated by RPC
49 // (we free it later with RpcStringFree)
50 #ifdef _UNICODE
51 UuidToString(&m_uuid, (unsigned short **)&m_pszUuid);
52 #else
53 UuidToString(&m_uuid, &m_pszUuid);
54 #endif
55
56 // allocate new buffer
57 m_pszCForm = new wxChar[UUID_CSTRLEN];
58 // and fill it
59 memcpy(m_pszCForm, uuid.m_pszCForm, UUID_CSTRLEN*sizeof(wxChar));
60 }
61
62 // assignment operator
63 Uuid& Uuid::operator=(const Uuid& uuid)
64 {
65 m_uuid = uuid.m_uuid;
66
67 // force the string to be allocated by RPC
68 // (we free it later with RpcStringFree)
69 #ifdef _UNICODE
70 UuidToString(&m_uuid, (unsigned short **)&m_pszUuid);
71 #else
72 UuidToString(&m_uuid, &m_pszUuid);
73 #endif
74
75 // allocate new buffer if not done yet
76 if ( !m_pszCForm )
77 m_pszCForm = new wxChar[UUID_CSTRLEN];
78
79 // and fill it
80 memcpy(m_pszCForm, uuid.m_pszCForm, UUID_CSTRLEN*sizeof(wxChar));
81
82 return *this;
83 }
84
85 bool Uuid::operator==(const Uuid& uuid) const
86 {
87 // IsEqualGUID() returns BOOL and not bool so use an explicit comparison to
88 // avoid MSVC warnings about int->bool conversion
89 return IsEqualGUID(m_uuid, uuid.m_uuid) == TRUE;
90 }
91
92 // dtor
93 Uuid::~Uuid()
94 {
95 // this string must be allocated by RPC!
96 // (otherwise you get a debug breakpoint deep inside RPC DLL)
97 if ( m_pszUuid )
98 #ifdef _UNICODE
99 RpcStringFree((unsigned short **)&m_pszUuid);
100 #else
101 RpcStringFree(&m_pszUuid);
102 #endif
103
104 // perhaps we should just use a static buffer and not bother
105 // with new and delete?
106 if ( m_pszCForm )
107 delete [] m_pszCForm;
108 }
109
110 // update string representation of new UUID
111 void Uuid::Set(const UUID &uuid)
112 {
113 m_uuid = uuid;
114
115 // get string representation
116 #ifdef _UNICODE
117 UuidToString(&m_uuid, (unsigned short **)&m_pszUuid);
118 #else
119 UuidToString(&m_uuid, &m_pszUuid);
120 #endif
121
122 // cache UUID in C format
123 UuidToCForm();
124 }
125
126 // create a new UUID
127 void Uuid::Create()
128 {
129 UUID uuid;
130
131 // can't fail
132 UuidCreate(&uuid);
133
134 Set(uuid);
135 }
136
137 // set the value
138 bool Uuid::Set(const wxChar *pc)
139 {
140 // get UUID from string
141 #ifdef _UNICODE
142 if ( UuidFromString((unsigned short *)pc, &m_uuid) != RPC_S_OK)
143 #else
144 if ( UuidFromString((wxUChar *)pc, &m_uuid) != RPC_S_OK)
145 #endif
146 // failed: probably invalid string
147 return false;
148
149 // transform it back to string to normalize it
150 #ifdef _UNICODE
151 UuidToString(&m_uuid, (unsigned short **)&m_pszUuid);
152 #else
153 UuidToString(&m_uuid, &m_pszUuid);
154 #endif
155
156 // update m_pszCForm
157 UuidToCForm();
158
159 return true;
160 }
161
162 // stores m_uuid in m_pszCForm in a format required by
163 // DEFINE_GUID macro: i.e. something like
164 // 0x7D8A2281L,0x4C61,0x11D0,0xBA,0xBD,0x00,0x00,0xC0,0x18,0xBA,0x27
165 // m_pszUuid is of the form (no, it's not quite the same UUID :-)
166 // 6aadc650-67b0-11d0-bac8-0000c018ba27
167 void Uuid::UuidToCForm()
168 {
169 if ( m_pszCForm == NULL )
170 m_pszCForm = new wxChar[UUID_CSTRLEN];
171
172 wsprintf(m_pszCForm, wxT("0x%8.8X,0x%4.4X,0x%4.4X,0x%2.2X,0x2.2%X,0x2.2%X,0x2.2%X,0x2.2%X,0x2.2%X,0x2.2%X,0x2.2%X"),
173 m_uuid.Data1, m_uuid.Data2, m_uuid.Data3,
174 m_uuid.Data4[0], m_uuid.Data4[1], m_uuid.Data4[2], m_uuid.Data4[3],
175 m_uuid.Data4[4], m_uuid.Data4[5], m_uuid.Data4[6], m_uuid.Data4[7]);
176 }
177
178 #endif
179 // wxUSE_DRAG_AND_DROP