VirtualBox

source: vbox/trunk/src/VBox/Debugger/VBoxDbgBase.h@ 60045

Last change on this file since 60045 was 56296, checked in by vboxsync, 10 years ago

Debugger: Updated (C) year.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 4.6 KB
Line 
1/* $Id: VBoxDbgBase.h 56296 2015-06-09 14:30:56Z vboxsync $ */
2/** @file
3 * VBox Debugger GUI - Base classes.
4 */
5
6/*
7 * Copyright (C) 2006-2015 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 */
17
18
19#ifndef ___Debugger_VBoxDbgBase_h
20#define ___Debugger_VBoxDbgBase_h
21
22
23#include <VBox/vmm/stam.h>
24#include <VBox/vmm/vmapi.h>
25#include <VBox/dbg.h>
26#include <iprt/thread.h>
27#include <QString>
28#include <QWidget>
29
30class VBoxDbgGui;
31
32
33/**
34 * VBox Debugger GUI Base Class.
35 *
36 * The purpose of this class is to hide the VM handle, abstract VM
37 * operations, and finally to make sure the GUI won't crash when
38 * the VM dies.
39 */
40class VBoxDbgBase
41{
42public:
43 /**
44 * Construct the object.
45 *
46 * @param pDbgGui Pointer to the debugger gui object.
47 */
48 VBoxDbgBase(VBoxDbgGui *a_pDbgGui);
49
50 /**
51 * Destructor.
52 */
53 virtual ~VBoxDbgBase();
54
55
56 /**
57 * Checks if the VM is OK for normal operations.
58 * @returns true if ok, false if not.
59 */
60 bool isVMOk() const
61 {
62 return m_pUVM != NULL;
63 }
64
65 /**
66 * Checks if the current thread is the GUI thread or not.
67 * @return true/false accordingly.
68 */
69 bool isGUIThread() const
70 {
71 return m_hGUIThread == RTThreadNativeSelf();
72 }
73
74 /** @name Operations
75 * @{ */
76 /**
77 * Wrapper for STAMR3Reset().
78 */
79 int stamReset(const QString &rPat);
80 /**
81 * Wrapper for STAMR3Enum().
82 */
83 int stamEnum(const QString &rPat, PFNSTAMR3ENUM pfnEnum, void *pvUser);
84 /**
85 * Wrapper for DBGCCreate().
86 */
87 int dbgcCreate(PDBGCBACK pBack, unsigned fFlags);
88 /** @} */
89
90
91protected:
92 /** @name Signals
93 * @{ */
94 /**
95 * Called when the VM is being destroyed.
96 */
97 virtual void sigDestroying();
98 /**
99 * Called when the VM has been terminated.
100 */
101 virtual void sigTerminated();
102 /** @} */
103
104
105private:
106 /** @callback_method_impl{FNVMATSTATE} */
107 static DECLCALLBACK(void) atStateChange(PUVM pUVM, VMSTATE enmState, VMSTATE enmOldState, void *pvUser);
108
109private:
110 /** Pointer to the debugger GUI object. */
111 VBoxDbgGui *m_pDbgGui;
112 /** The user mode VM handle. */
113 PUVM volatile m_pUVM;
114 /** The handle of the GUI thread. */
115 RTNATIVETHREAD m_hGUIThread;
116};
117
118
119/**
120 * VBox Debugger GUI Base Window Class.
121 *
122 * This is just a combination of QWidget and VBoxDbgBase with some additional
123 * functionality for window management. This class is not intended for control
124 * widgets, only normal top-level windows.
125 */
126class VBoxDbgBaseWindow : public QWidget, public VBoxDbgBase
127{
128public:
129 /**
130 * Construct the object.
131 *
132 * @param pDbgGui Pointer to the debugger gui object.
133 */
134 VBoxDbgBaseWindow(VBoxDbgGui *a_pDbgGui, QWidget *a_pParent);
135
136 /**
137 * Destructor.
138 */
139 virtual ~VBoxDbgBaseWindow();
140
141 /**
142 * Shows the window and gives it focus.
143 */
144 void vShow();
145
146 /**
147 * Repositions the window, taking the frame decoration into account.
148 *
149 * @param a_x The new x coordinate.
150 * @param a_y The new x coordinate.
151 * @param a_cx The total width.
152 * @param a_cy The total height.
153 * @param a_fResize Whether to resize it as well.
154 */
155 void vReposition(int a_x, int a_y, unsigned a_cx, unsigned a_cy, bool a_fResize);
156
157protected:
158 /**
159 * For polishing the window size (X11 mess).
160 *
161 * @returns true / false.
162 * @param a_pEvt The event.
163 */
164 virtual bool event(QEvent *a_pEvt);
165
166 /**
167 * Internal worker for polishing the size and position (X11 hacks).
168 */
169 void vPolishSizeAndPos();
170
171 /**
172 * Internal worker that guesses the border sizes.
173 */
174 QSize vGuessBorderSizes();
175
176
177private:
178 /** Whether we've done the size polishing in showEvent or not. */
179 bool m_fPolished;
180 /** The desired x coordinate. */
181 int m_x;
182 /** The desired y coordinate. */
183 int m_y;
184 /** The desired width. */
185 unsigned m_cx;
186 /** The desired height. */
187 unsigned m_cy;
188
189 /** Best effort x border size (for X11). */
190 static unsigned m_cxBorder;
191 /** Best effort y border size (for X11). */
192 static unsigned m_cyBorder;
193};
194
195#endif
196
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette