Changeset 352 for trunk/src

Timestamp:

Nov 27, 2009, 1:15:54 AM (16 years ago)

Author:

Dmitry A. Kuminov

Message:

gui/kernel: Added QWidget::internalFrameWinId() and effectiveFrameWinId() non-portable OS/2-specific functions for easy access to the frame window of top-level widgets which may sometimes be necessary for tighter integration with the platform.

Location:

trunk/src/gui/kernel

Files:

• qwidget.cpp (modified) (1 diff)
• qwidget.h (modified) (1 diff)

trunk/src/gui/kernel/qwidget.cpp

@@ -10360 +10360 @@
 }
 #elif defined (Q_WS_PM)
+
+/*!
+    \fn WId QWidget::internalFrameWinId() const
+    \internal
+    Returns the frame window system identifier of the widget, or 0 if the widget
+    is not created yet or if it is not a top-level window and therefore does not
+    have a system frame.
+
+    \warning This function is not portable and exists only on OS/2.
+*/
+WId QWidget::internalFrameWinId() const
+{
+    Q_D(const QWidget);
+    return d->frameWinId();
+}
+
+/*!
+    Returns the effective frame window system identifier of the widget, i.e. the
+    native parent's frame window system identifier.
+
+    If the widget is native, this function returns the native frame window for
+    this widget (the same value as internalFrameWinId() returns). Otherwise, the
+    frame window ID of the first native parent widget, i.e., the top-level
+    widget that contains this widget, is returned.
+
+    \note We recommend that you do not store this value as it is likely to
+    change at run-time.
+
+    \sa nativeParentWidget()
+
+    \warning This function is not portable and exists only on OS/2.
+*/
+WId QWidget::effectiveFrameWinId() const
+{
+    Q_D(const QWidget);
+    return d->effectiveFrameWinId();
+}
+
 /*!
     Returns the window system handle of the widget, for low-level

trunk/src/gui/kernel/qwidget.h

@@ -584 +584 @@
     void releaseDC(HDC) const;
 #elif defined(Q_WS_PM)
+    WId internalFrameWinId() const;
+    WId effectiveFrameWinId() const;
     HPS getPS() const;
     void releasePS(HPS) const;