]> git.saurik.com Git - wxWidgets.git/blob - include/wx/msw/private.h
added GetHbrush() and GetHbrushOf()
[wxWidgets.git] / include / wx / msw / private.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: private.h
3 // Purpose: Private declarations: as this header is only included by
4 // wxWindows itself, it may contain identifiers which don't start
5 // with "wx".
6 // Author: Julian Smart
7 // Modified by:
8 // Created: 01/02/97
9 // RCS-ID: $Id$
10 // Copyright: (c) Julian Smart
11 // Licence: wxWindows licence
12 /////////////////////////////////////////////////////////////////////////////
13
14 #ifndef _WX_PRIVATE_H_
15 #define _WX_PRIVATE_H_
16
17 #include "wx/msw/wrapwin.h"
18
19 #if defined (__WXWINCE__)
20 #include <wingdi.h> // RGB, COLORREF
21 #define ERRFALSE(x)
22 #include <winuser.h> // Global Namespaces ::GetKeyState, ::GetWindowRect
23 #include "wx/msw/winundef.h"
24 #endif
25
26
27 #ifdef __WXMICROWIN__
28 // Extra prototypes and symbols not defined by MicroWindows
29 #include "wx/msw/microwin.h"
30 #endif
31
32 // Include fixes for MSLU:
33 #include "wx/msw/mslu.h"
34
35 #include "wx/log.h"
36
37 class WXDLLEXPORT wxFont;
38 class WXDLLEXPORT wxWindow;
39
40 // ---------------------------------------------------------------------------
41 // private constants
42 // ---------------------------------------------------------------------------
43
44 // Conversion
45 static const double METRIC_CONVERSION_CONSTANT = 0.0393700787;
46
47 // Scaling factors for various unit conversions
48 static const double mm2inches = (METRIC_CONVERSION_CONSTANT);
49 static const double inches2mm = (1/METRIC_CONVERSION_CONSTANT);
50
51 static const double mm2twips = (METRIC_CONVERSION_CONSTANT*1440);
52 static const double twips2mm = (1/(METRIC_CONVERSION_CONSTANT*1440));
53
54 static const double mm2pt = (METRIC_CONVERSION_CONSTANT*72);
55 static const double pt2mm = (1/(METRIC_CONVERSION_CONSTANT*72));
56
57 // ---------------------------------------------------------------------------
58 // standard icons from the resources
59 // ---------------------------------------------------------------------------
60
61 #if wxUSE_GUI
62
63 WXDLLEXPORT_DATA(extern HICON) wxSTD_FRAME_ICON;
64 WXDLLEXPORT_DATA(extern HICON) wxSTD_MDIPARENTFRAME_ICON;
65 WXDLLEXPORT_DATA(extern HICON) wxSTD_MDICHILDFRAME_ICON;
66 WXDLLEXPORT_DATA(extern HICON) wxDEFAULT_FRAME_ICON;
67 WXDLLEXPORT_DATA(extern HICON) wxDEFAULT_MDIPARENTFRAME_ICON;
68 WXDLLEXPORT_DATA(extern HICON) wxDEFAULT_MDICHILDFRAME_ICON;
69 WXDLLEXPORT_DATA(extern HFONT) wxSTATUS_LINE_FONT;
70
71 #endif // wxUSE_GUI
72
73 // ---------------------------------------------------------------------------
74 // define things missing from some compilers' headers
75 // ---------------------------------------------------------------------------
76
77 #if defined(__WXWINCE__) || (defined(__GNUWIN32__) && !wxUSE_NORLANDER_HEADERS)
78 #ifndef ZeroMemory
79 inline void ZeroMemory(void *buf, size_t len) { memset(buf, 0, len); }
80 #endif
81 #endif // old mingw32
82
83 // this defines a CASTWNDPROC macro which casts a pointer to the type of a
84 // window proc
85 #if defined(STRICT) || defined(__GNUC__)
86 typedef WNDPROC WndProcCast;
87 #else
88 typedef FARPROC WndProcCast;
89 #endif
90
91
92 #define CASTWNDPROC (WndProcCast)
93
94
95
96 // ---------------------------------------------------------------------------
97 // some stuff for old Windows versions (FIXME: what does it do here??)
98 // ---------------------------------------------------------------------------
99
100 #if !defined(APIENTRY) // NT defines APIENTRY, 3.x not
101 #define APIENTRY FAR PASCAL
102 #endif
103
104 #ifdef __WIN32__
105 #define _EXPORT
106 #else
107 #define _EXPORT _export
108 #endif
109
110 #ifndef __WIN32__
111 typedef signed short int SHORT;
112 #endif
113
114 #if !defined(__WIN32__) // 3.x uses FARPROC for dialogs
115 #ifndef STRICT
116 #define DLGPROC FARPROC
117 #endif
118 #endif
119
120 #if wxUSE_PENWIN
121 WXDLLEXPORT void wxRegisterPenWin();
122 WXDLLEXPORT void wxCleanUpPenWin();
123 WXDLLEXPORT void wxEnablePenAppHooks (bool hook);
124 #endif // wxUSE_PENWIN
125
126 #if wxUSE_ITSY_BITSY
127 #define IBS_HORZCAPTION 0x4000L
128 #define IBS_VERTCAPTION 0x8000L
129
130 UINT WINAPI ibGetCaptionSize( HWND hWnd ) ;
131 UINT WINAPI ibSetCaptionSize( HWND hWnd, UINT nSize ) ;
132 LRESULT WINAPI ibDefWindowProc( HWND hWnd, UINT uiMsg, WPARAM wParam, LPARAM lParam ) ;
133 VOID WINAPI ibAdjustWindowRect( HWND hWnd, LPRECT lprc ) ;
134 #endif // wxUSE_ITSY_BITSY
135
136 #if wxUSE_CTL3D
137 #include "wx/msw/ctl3d/ctl3d.h"
138 #endif // wxUSE_CTL3D
139
140 /*
141 * Decide what window classes we're going to use
142 * for this combination of CTl3D/FAFA settings
143 */
144
145 #define STATIC_CLASS wxT("STATIC")
146 #define STATIC_FLAGS (SS_LEFT|WS_CHILD|WS_VISIBLE)
147 #define CHECK_CLASS wxT("BUTTON")
148 #define CHECK_FLAGS (BS_AUTOCHECKBOX|WS_TABSTOP|WS_CHILD)
149 #define CHECK_IS_FAFA FALSE
150 #define RADIO_CLASS wxT("BUTTON")
151 #define RADIO_FLAGS (BS_AUTORADIOBUTTON|WS_CHILD|WS_VISIBLE)
152 #define RADIO_SIZE 20
153 #define RADIO_IS_FAFA FALSE
154 #define PURE_WINDOWS
155 #define GROUP_CLASS wxT("BUTTON")
156 #define GROUP_FLAGS (BS_GROUPBOX|WS_CHILD|WS_VISIBLE)
157
158 /*
159 #define BITCHECK_FLAGS (FB_BITMAP|FC_BUTTONDRAW|FC_DEFAULT|WS_VISIBLE)
160 #define BITRADIO_FLAGS (FC_BUTTONDRAW|FB_BITMAP|FC_RADIO|WS_CHILD|WS_VISIBLE)
161 */
162
163 // ---------------------------------------------------------------------------
164 // misc macros
165 // ---------------------------------------------------------------------------
166
167 #define MEANING_CHARACTER '0'
168 #define DEFAULT_ITEM_WIDTH 100
169 #define DEFAULT_ITEM_HEIGHT 80
170
171 // Scale font to get edit control height
172 //#define EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy) (3*(cy)/2)
173 #define EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy) (cy+8)
174
175 // Generic subclass proc, for panel item moving/sizing and intercept
176 // EDIT control VK_RETURN messages
177 extern LONG APIENTRY _EXPORT
178 wxSubclassedGenericControlProc(WXHWND hWnd, WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
179
180 // ---------------------------------------------------------------------------
181 // useful macros and functions
182 // ---------------------------------------------------------------------------
183
184 // a wrapper macro for ZeroMemory()
185 #if defined(__WIN32__) && !defined(__WXMICROWIN__)
186 #define wxZeroMemory(obj) ::ZeroMemory(&obj, sizeof(obj))
187 #else
188 #define wxZeroMemory(obj) memset((void*) & obj, 0, sizeof(obj))
189 #endif
190
191 #if wxUSE_GUI
192
193 #include <wx/gdicmn.h>
194 #include <wx/colour.h>
195
196 // make conversion from wxColour and COLORREF a bit less painful
197 inline COLORREF wxColourToRGB(const wxColour& c)
198 {
199 return RGB(c.Red(), c.Green(), c.Blue());
200 }
201
202 inline COLORREF wxColourToPalRGB(const wxColour& c)
203 {
204 return PALETTERGB(c.Red(), c.Green(), c.Blue());
205 }
206
207 inline wxColour wxRGBToColour(COLORREF rgb)
208 {
209 return wxColour(GetRValue(rgb), GetGValue(rgb), GetBValue(rgb));
210 }
211
212 inline void wxRGBToColour(wxColour& c, COLORREF rgb)
213 {
214 c.Set(GetRValue(rgb), GetGValue(rgb), GetBValue(rgb));
215 }
216
217 // get the standard colour map for some standard colours - see comment in this
218 // function to understand why is it needed and when should it be used
219 //
220 // it returns a wxCOLORMAP (can't use COLORMAP itself here as comctl32.dll
221 // might be not included/available) array of size wxSTD_COLOUR_MAX
222 //
223 // NB: if you change these colours, update wxBITMAP_STD_COLOURS in the
224 // resources as well: it must have the same number of pixels!
225 enum wxSTD_COLOUR
226 {
227 wxSTD_COL_BTNTEXT,
228 wxSTD_COL_BTNSHADOW,
229 wxSTD_COL_BTNFACE,
230 wxSTD_COL_BTNHIGHLIGHT,
231 wxSTD_COL_MAX,
232 };
233
234 struct WXDLLEXPORT wxCOLORMAP
235 {
236 COLORREF from, to;
237 };
238
239 // this function is implemented in src/msw/window.cpp
240 extern wxCOLORMAP *wxGetStdColourMap();
241
242 // copy Windows RECT to our wxRect
243 inline void wxCopyRECTToRect(const RECT& r, wxRect& rect)
244 {
245 rect.y = r.top;
246 rect.x = r.left;
247 rect.width = r.right - r.left;
248 rect.height = r.bottom - r.top;
249 }
250
251 // translations between HIMETRIC units (which OLE likes) and pixels (which are
252 // liked by all the others) - implemented in msw/utilsexc.cpp
253 extern void HIMETRICToPixel(LONG *x, LONG *y);
254 extern void PixelToHIMETRIC(LONG *x, LONG *y);
255
256 // Windows convention of the mask is opposed to the wxWindows one, so we need
257 // to invert the mask each time we pass one/get one to/from Windows
258 extern HBITMAP wxInvertMask(HBITMAP hbmpMask, int w = 0, int h = 0);
259
260 // Creates an icon or cursor depending from a bitmap
261 //
262 // The bitmap must be valid and it should have a mask. If it doesn't, a default
263 // mask is created using light grey as the transparent colour.
264 extern HICON wxBitmapToHICON(const wxBitmap& bmp);
265
266 // Same requirments as above apply and the bitmap must also have the correct
267 // size.
268 extern
269 HCURSOR wxBitmapToHCURSOR(const wxBitmap& bmp, int hotSpotX, int hotSpotY);
270
271 // get (x, y) from DWORD - notice that HI/LOWORD can *not* be used because they
272 // will fail on system with multiple monitors where the coords may be negative
273 //
274 // these macros are standard now (Win98) but some older headers don't have them
275 #ifndef GET_X_LPARAM
276 #define GET_X_LPARAM(lp) ((int)(short)LOWORD(lp))
277 #define GET_Y_LPARAM(lp) ((int)(short)HIWORD(lp))
278 #endif // GET_X_LPARAM
279
280 // get the current state of SHIFT/CTRL keys
281 inline bool wxIsShiftDown()
282 {
283 // return (::GetKeyState(VK_SHIFT) & 0x100) != 0;
284 // Returns different negative values on WinME and WinNT,
285 // so simply test for negative value.
286 return ::GetKeyState(VK_SHIFT) < 0;
287 }
288
289 inline bool wxIsCtrlDown()
290 {
291 // return (::GetKeyState(VK_CONTROL) & 0x100) != 0;
292 // Returns different negative values on WinME and WinNT,
293 // so simply test for negative value.
294 return ::GetKeyState(VK_CONTROL) < 0;
295 }
296
297 // wrapper around GetWindowRect() and GetClientRect() APIs doing error checking
298 // for Win32
299 inline RECT wxGetWindowRect(HWND hwnd)
300 {
301 RECT rect;
302 #ifdef __WIN16__
303 ::GetWindowRect(hwnd, &rect);
304 #else // Win32
305 if ( !::GetWindowRect(hwnd, &rect) )
306 {
307 wxLogLastError(_T("GetWindowRect"));
308 }
309 #endif // Win16/32
310
311 return rect;
312 }
313
314 inline RECT wxGetClientRect(HWND hwnd)
315 {
316 RECT rect;
317 #ifdef __WIN16__
318 ::GetClientRect(hwnd, &rect);
319 #else // Win32
320 if ( !::GetClientRect(hwnd, &rect) )
321 {
322 wxLogLastError(_T("GetClientRect"));
323 }
324 #endif // Win16/32
325
326 return rect;
327 }
328
329 // ---------------------------------------------------------------------------
330 // small helper classes
331 // ---------------------------------------------------------------------------
332
333 // a template to make initializing Windows styructs less painful: it zeroes all
334 // the struct fields and also sets cbSize member to the correct value (and so
335 // can be only used with structures which have this member...)
336 template <class T>
337 struct WinStruct : public T
338 {
339 WinStruct()
340 {
341 ::ZeroMemory(this, sizeof(T));
342 cbSize = sizeof(T);
343 }
344 };
345
346
347 // create an instance of this class and use it as the HDC for screen, will
348 // automatically release the DC going out of scope
349 class ScreenHDC
350 {
351 public:
352 ScreenHDC() { m_hdc = ::GetDC(NULL); }
353 ~ScreenHDC() { ::ReleaseDC(NULL, m_hdc); }
354
355 operator HDC() const { return m_hdc; }
356
357 private:
358 HDC m_hdc;
359
360 DECLARE_NO_COPY_CLASS(ScreenHDC)
361 };
362
363 // the same as ScreenHDC but for memory DCs: creates the HDC compatible with
364 // the given one (screen by default) in ctor and destroys it in dtor
365 class MemoryHDC
366 {
367 public:
368 MemoryHDC(HDC hdc = 0) { m_hdc = ::CreateCompatibleDC(hdc); }
369 ~MemoryHDC() { ::DeleteDC(m_hdc); }
370
371 operator HDC() const { return m_hdc; }
372
373 private:
374 HDC m_hdc;
375
376 DECLARE_NO_COPY_CLASS(MemoryHDC)
377 };
378
379 // a class which selects a GDI object into a DC in its ctor and deselects in
380 // dtor
381 class SelectInHDC
382 {
383 public:
384 SelectInHDC(HDC hdc, HGDIOBJ hgdiobj) : m_hdc(hdc)
385 { m_hgdiobj = ::SelectObject(hdc, hgdiobj); }
386
387 ~SelectInHDC() { ::SelectObject(m_hdc, m_hgdiobj); }
388
389 // return true if the object was successfully selected
390 operator bool() const { return m_hgdiobj != 0; }
391
392 private:
393 HDC m_hdc;
394 HGDIOBJ m_hgdiobj;
395
396 DECLARE_NO_COPY_CLASS(SelectInHDC)
397 };
398
399 #ifndef __WXWINCE__
400 // when working with global pointers (which is unfortunately still necessary
401 // sometimes, e.g. for clipboard) it is important to unlock them exactly as
402 // many times as we lock them which just asks for using a "smart lock" class
403 class GlobalPtr
404 {
405 public:
406 GlobalPtr(HGLOBAL hGlobal) : m_hGlobal(hGlobal)
407 {
408 m_ptr = ::GlobalLock(hGlobal);
409 if ( !m_ptr )
410 {
411 wxLogLastError(_T("GlobalLock"));
412 }
413 }
414
415 ~GlobalPtr()
416 {
417 if ( !::GlobalUnlock(m_hGlobal) )
418 {
419 #ifdef __WXDEBUG__
420 // this might happen simply because the block became unlocked
421 DWORD dwLastError = ::GetLastError();
422 if ( dwLastError != NO_ERROR )
423 {
424 wxLogApiError(_T("GlobalUnlock"), dwLastError);
425 }
426 #endif // __WXDEBUG__
427 }
428 }
429
430 operator void *() const { return m_ptr; }
431
432 private:
433 HGLOBAL m_hGlobal;
434 void *m_ptr;
435
436 DECLARE_NO_COPY_CLASS(GlobalPtr)
437 };
438 #endif
439
440 // ---------------------------------------------------------------------------
441 // macros to make casting between WXFOO and FOO a bit easier: the GetFoo()
442 // returns Foo cast to the Windows type for oruselves, while GetFooOf() takes
443 // an argument which should be a pointer or reference to the object of the
444 // corresponding class (this depends on the macro)
445 // ---------------------------------------------------------------------------
446
447 #define GetHwnd() ((HWND)GetHWND())
448 #define GetHwndOf(win) ((HWND)((win)->GetHWND()))
449 // old name
450 #define GetWinHwnd GetHwndOf
451
452 #define GetHdc() ((HDC)GetHDC())
453 #define GetHdcOf(dc) ((HDC)(dc).GetHDC())
454
455 #define GetHbitmap() ((HBITMAP)GetHBITMAP())
456 #define GetHbitmapOf(bmp) ((HBITMAP)(bmp).GetHBITMAP())
457
458 #define GetHicon() ((HICON)GetHICON())
459 #define GetHiconOf(icon) ((HICON)(icon).GetHICON())
460
461 #define GetHaccel() ((HACCEL)GetHACCEL())
462 #define GetHaccelOf(table) ((HACCEL)((table).GetHACCEL()))
463
464 #define GetHbrush() ((HPEN)GetResourceHandle())
465 #define GetHbrushOf(brush) ((HPEN)(brush).GetResourceHandle())
466
467 #define GetHmenu() ((HMENU)GetHMenu())
468 #define GetHmenuOf(menu) ((HMENU)menu->GetHMenu())
469
470 #define GetHcursor() ((HCURSOR)GetHCURSOR())
471 #define GetHcursorOf(cursor) ((HCURSOR)(cursor).GetHCURSOR())
472
473 #define GetHfont() ((HFONT)GetHFONT())
474 #define GetHfontOf(font) ((HFONT)(font).GetHFONT())
475
476 #define GetHpalette() ((HPALETTE)GetHPALETTE())
477 #define GetHpaletteOf(pal) ((HPALETTE)(pal).GetHPALETTE())
478
479 #define GetHpen() ((HPEN)GetResourceHandle())
480 #define GetHpenOf(pen) ((HPEN)(pen).GetResourceHandle())
481
482 #define GetHrgn() ((HRGN)GetHRGN())
483 #define GetHrgnOf(rgn) ((HRGN)(rgn).GetHRGN())
484
485 #endif // wxUSE_GUI
486
487 // ---------------------------------------------------------------------------
488 // global data
489 // ---------------------------------------------------------------------------
490
491 WXDLLIMPEXP_DATA_BASE(extern HINSTANCE) wxhInstance;
492
493 // ---------------------------------------------------------------------------
494 // global functions
495 // ---------------------------------------------------------------------------
496
497 extern "C"
498 {
499 WXDLLIMPEXP_BASE HINSTANCE wxGetInstance();
500 }
501
502 WXDLLIMPEXP_BASE void wxSetInstance(HINSTANCE hInst);
503
504 #if wxUSE_GUI
505
506 // cursor stuff
507 extern HCURSOR wxGetCurrentBusyCursor(); // from msw/utils.cpp
508 extern const wxCursor *wxGetGlobalCursor(); // from msw/cursor.cpp
509
510 WXDLLEXPORT void wxGetCharSize(WXHWND wnd, int *x, int *y, const wxFont *the_font);
511 WXDLLEXPORT void wxFillLogFont(LOGFONT *logFont, const wxFont *font);
512 WXDLLEXPORT wxFont wxCreateFontFromLogFont(const LOGFONT *logFont);
513 WXDLLEXPORT wxFontEncoding wxGetFontEncFromCharSet(int charset);
514
515 WXDLLEXPORT void wxSliderEvent(WXHWND control, WXWORD wParam, WXWORD pos);
516 WXDLLEXPORT void wxScrollBarEvent(WXHWND hbar, WXWORD wParam, WXWORD pos);
517
518 // Find maximum size of window/rectangle
519 WXDLLEXPORT extern void wxFindMaxSize(WXHWND hwnd, RECT *rect);
520
521 // Safely get the window text (i.e. without using fixed size buffer)
522 WXDLLEXPORT extern wxString wxGetWindowText(WXHWND hWnd);
523
524 // get the window class name
525 WXDLLEXPORT extern wxString wxGetWindowClass(WXHWND hWnd);
526
527 // get the window id (should be unsigned, hence this is not wxWindowID which
528 // is, for mainly historical reasons, signed)
529 WXDLLEXPORT extern WXWORD wxGetWindowId(WXHWND hWnd);
530
531 // check if hWnd's WNDPROC is wndProc. Return true if yes, false if they are
532 // different
533 WXDLLEXPORT extern bool wxCheckWindowWndProc(WXHWND hWnd, WXFARPROC wndProc);
534
535 // Does this window style specify any border?
536 inline bool wxStyleHasBorder(long style)
537 {
538 return (style & (wxSIMPLE_BORDER | wxRAISED_BORDER |
539 wxSUNKEN_BORDER | wxDOUBLE_BORDER)) != 0;
540 }
541
542 // ----------------------------------------------------------------------------
543 // functions mapping HWND to wxWindow
544 // ----------------------------------------------------------------------------
545
546 // this function simply checks whether the given hWnd corresponds to a wxWindow
547 // and returns either that window if it does or NULL otherwise
548 WXDLLEXPORT extern wxWindow* wxFindWinFromHandle(WXHWND hWnd);
549
550 // find the window for HWND which is part of some wxWindow, i.e. unlike
551 // wxFindWinFromHandle() above it will also work for "sub controls" of a
552 // wxWindow.
553 //
554 // returns the wxWindow corresponding to the given HWND or NULL.
555 WXDLLEXPORT extern wxWindow *wxGetWindowFromHWND(WXHWND hwnd);
556
557 // Get the size of an icon
558 WXDLLEXPORT extern wxSize wxGetHiconSize(HICON hicon);
559
560 // Lines are drawn differently for WinCE and regular WIN32
561 WXDLLEXPORT void wxDrawLine(HDC hdc, int x1, int y1, int x2, int y2);
562
563 // LocalAlloc should be used on WinCE
564 #ifdef __WXWINCE__
565 #include <winbase.h>
566
567 #if _WIN32_WCE <= 211
568 #define GlobalAlloc LocalAlloc
569 #define GlobalFree LocalFree
570 #define GlobalLock(mem) mem
571 #define GlobalUnlock(mem)
572 #define GlobalSize LocalSize
573 #define GPTR LPTR
574 #define GHND LPTR
575 #define GMEM_MOVEABLE 0
576 #define GMEM_SHARE 0
577 #endif
578
579 #if 0
580
581 HLOCAL
582 WINAPI
583 LocalAlloc (
584 UINT fuFlags,
585 UINT cbBytes
586 );
587
588 HLOCAL
589 WINAPI
590 LocalFree (
591 HLOCAL hMem
592 );
593
594 #ifndef LMEM_FIXED
595 #define LMEM_FIXED 0x0000
596 #define LMEM_MOVEABLE 0x0002
597 #define LMEM_NOCOMPACT 0x0010 /**** Used for Moveable Memory ***/
598 #define LMEM_NODISCARD 0x0020 /**** Ignored *****/
599 #define LMEM_ZEROINIT 0x0040
600 #define LMEM_MODIFY 0x0080 /*** Used only in LocalReAlloc() **/
601 #define LMEM_DISCARDABLE 0x0F00 /**** Ignored ****/
602 #define LMEM_VALID_FLAGS 0x0F72
603 #define LMEM_INVALID_HANDLE 0x8000
604
605 #define LHND (LMEM_MOVEABLE | LMEM_ZEROINIT)
606 #define LPTR (LMEM_FIXED | LMEM_ZEROINIT)
607 #endif
608
609 #endif
610 // 0
611
612 #endif
613 // __WXWINCE__
614 #endif // wxUSE_GUI
615
616 #endif
617 // _WX_PRIVATE_H_