Changeset 52510 in vbox

Timestamp:

Aug 28, 2014 11:46:54 AM (10 years ago)

Author:

vboxsync

Message:

FE/Qt: Mac OS X: Runtime UI: UICocoaApplication coding-style update, doxygen.

Location:

trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin

Files:

• UICocoaApplication.h (modified) (4 diffs)
• UICocoaApplication.mm (modified) (3 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UICocoaApplication.h

@@ -4 +4 @@
 
 /*
- * Copyright (C) 2009-2010 Oracle Corporation
+ * Copyright (C) 2009-2014 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -43 +43 @@
 typedef void (*PfnNativeNotificationCallbackForQWidget)(const QString &strNativeNotificationName, QWidget *pWidget);
 
-/* C++ singleton for our private NSApplication object */
+/* C++ singleton for our private NSApplication object. */
 class UICocoaApplication
 {
 public:
 
+    /** Returns singleton access instance. */
     static UICocoaApplication* instance();
-    void hide();
+
+    /** Destructor. */
     ~UICocoaApplication();
 
+    /** Hides the application. */
+    void hide();
+
+    /** Register native @a pfnCallback of the @a pvUser taking event @a fMask into account. */
     void registerForNativeEvents(uint32_t fMask, PFNVBOXCACALLBACK pfnCallback, void *pvUser);
+    /** Unregister native @a pfnCallback of the @a pvUser taking event @a fMask into account. */
     void unregisterForNativeEvents(uint32_t fMask, PFNVBOXCACALLBACK pfnCallback, void *pvUser);
 
@@ -59 +66 @@
     /** Unregister passed @a pWidget from native notification @a strNativeNotificationName. */
     void unregisterFromNotificationOfWindow(const QString &strNativeNotificationName, QWidget *pWidget);
+
     /** Redirects native notification @a pstrNativeNotificationName for window @a pWindow to registered listener. */
     void nativeNotificationProxyForWidget(NativeNSStringRef pstrNativeNotificationName, NativeNSWindowRef pWindow);
@@ -64 +72 @@
 private:
 
+    /** Constructor. */
     UICocoaApplication();
+
+    /** Holds the singleton access instance. */
     static UICocoaApplication *m_pInstance;
+
+    /** Holds the private NSApplication instance. */
     NativeUICocoaApplicationPrivateRef m_pNative;
+    /** Holds the private NSAutoreleasePool instance. */
     NativeNSAutoreleasePoolRef m_pPool;
 

trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UICocoaApplication.mm

@@ -5 +5 @@
 
 /*
- * Copyright (C) 2009-2010 Oracle Corporation
+ * Copyright (C) 2009-2014 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -208 +208 @@
 }
 
-void UICocoaApplication::hide()
-{
-    [m_pNative hide:m_pNative];
-}
-
 UICocoaApplication::UICocoaApplication()
 {
@@ -230 +225 @@
 }
 
+void UICocoaApplication::hide()
+{
+    [m_pNative hide:m_pNative];
+}
+
 void UICocoaApplication::registerForNativeEvents(uint32_t fMask, PFNVBOXCACALLBACK pfnCallback, void *pvUser)
 {