Qt 4.8
Public Functions | Protected Functions | Private Functions | Properties | Static Private Attributes | Friends | List of all members
QAxWidget Class Reference

The QAxWidget class is a QWidget that wraps an ActiveX control. More...

#include <qaxwidget.h>

Inheritance diagram for QAxWidget:
QWidget QAxBase QObject QPaintDevice

Public Functions

const char * className () const
 
void clear ()
 Shuts down the ActiveX control. More...
 
virtual QAxAggregatedcreateAggregate ()
 Reimplement this function when you want to implement additional COM interfaces for the client site of the ActiveX control, or when you want to provide alternative implementations of COM interfaces. More...
 
bool doVerb (const QString &verb)
 Requests the ActiveX control to perform the action verb. More...
 
const QMetaObjectmetaObject () const
 
QSize minimumSizeHint () const
 Reimplemented Function More...
 
 QAxWidget (QWidget *parent=0, Qt::WindowFlags f=0)
 Creates an empty QAxWidget widget and propagates parent and f to the QWidget constructor. More...
 
 QAxWidget (const QString &c, QWidget *parent=0, Qt::WindowFlags f=0)
 Creates an QAxWidget widget and initializes the ActiveX control c. More...
 
 QAxWidget (IUnknown *iface, QWidget *parent=0, Qt::WindowFlags f=0)
 Creates a QAxWidget that wraps the COM object referenced by iface. More...
 
QObjectqObject () const
 
int qt_metacall (QMetaObject::Call, int, void **)
 
void * qt_metacast (const char *)
 
QSize sizeHint () const
 Reimplemented Function More...
 
 ~QAxWidget ()
 Shuts down the ActiveX control and destroys the QAxWidget widget, cleaning up all allocated resources. More...
 
- Public Functions inherited from QWidget
bool acceptDrops () const
 
QString accessibleDescription () const
 
QString accessibleName () const
 
QList< QAction * > actions () const
 Returns the (possibly empty) list of this widget's actions. More...
 
void activateWindow ()
 Sets the top-level widget containing this widget to be the active window. More...
 
void addAction (QAction *action)
 Appends the action action to this widget's list of actions. More...
 
void addActions (QList< QAction *> actions)
 Appends the actions actions to this widget's list of actions. More...
 
void adjustSize ()
 Adjusts the size of the widget to fit its contents. More...
 
bool autoFillBackground () const
 
QPalette::ColorRole backgroundRole () const
 Returns the background role of the widget. More...
 
QSize baseSize () const
 
QWidgetchildAt (int x, int y) const
 Returns the visible child widget at the position ({x}, {y}) in the widget's coordinate system. More...
 
QWidgetchildAt (const QPoint &p) const
 Returns the visible child widget at point p in the widget's own coordinate system. More...
 
QRect childrenRect () const
 
QRegion childrenRegion () const
 
void clearFocus ()
 Takes keyboard input focus from the widget. More...
 
void clearMask ()
 Removes any mask set by setMask(). More...
 
QMargins contentsMargins () const
 The contentsMargins function returns the widget's contents margins. More...
 
QRect contentsRect () const
 Returns the area inside the widget's margins. More...
 
Qt::ContextMenuPolicy contextMenuPolicy () const
 
void createWinId ()
 
QCursor cursor () const
 
int devType () const
 
WId effectiveWinId () const
 Returns the effective window system identifier of the widget, i. More...
 
void ensurePolished () const
 Ensures that the widget has been polished by QStyle (i.e., has a proper font and palette). More...
 
Qt::FocusPolicy focusPolicy () const
 
QWidgetfocusProxy () const
 Returns the focus proxy, or 0 if there is no focus proxy. More...
 
QWidgetfocusWidget () const
 Returns the last child of this widget that setFocus had been called on. More...
 
const QFontfont () const
 
QFontInfo fontInfo () const
 Returns the font info for the widget's current font. More...
 
QFontMetrics fontMetrics () const
 Returns the font metrics for the widget's current font. More...
 
QPalette::ColorRole foregroundRole () const
 Returns the foreground role. More...
 
QRect frameGeometry () const
 
QSize frameSize () const
 
const QRectgeometry () const
 
void getContentsMargins (int *left, int *top, int *right, int *bottom) const
 Returns the widget's contents margins for left, top, right, and bottom. More...
 
HDC getDC () const
 Returns the window system handle of the widget, for low-level access. More...
 
void grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags())
 Subscribes the widget to a given gesture with specific flags. More...
 
void grabKeyboard ()
 Grabs the keyboard input. More...
 
void grabMouse ()
 Grabs the mouse input. More...
 
void grabMouse (const QCursor &)
 
int grabShortcut (const QKeySequence &key, Qt::ShortcutContext context=Qt::WindowShortcut)
 Adds a shortcut to Qt's shortcut system that watches for the given key sequence in the given context. More...
 
QGraphicsEffectgraphicsEffect () const
 The graphicsEffect function returns a pointer to the widget's graphics effect. More...
 
QGraphicsProxyWidgetgraphicsProxyWidget () const
 Returns the proxy widget for the corresponding embedded widget in a graphics view; otherwise returns 0. More...
 
bool hasFocus () const
 
bool hasMouseTracking () const
 
int height () const
 
virtual int heightForWidth (int) const
 Returns the preferred height for this widget, given the width w. More...
 
QInputContextinputContext ()
 This function returns the QInputContext for this widget. More...
 
Qt::InputMethodHints inputMethodHints () const
 
virtual QVariant inputMethodQuery (Qt::InputMethodQuery) const
 This method is only relevant for input widgets. More...
 
void insertAction (QAction *before, QAction *action)
 Inserts the action action to this widget's list of actions, before the action before. More...
 
void insertActions (QAction *before, QList< QAction *> actions)
 Inserts the actions actions to this widget's list of actions, before the action before. More...
 
WId internalWinId () const
 Returns the window system identifier of the widget, or 0 if the widget is not created yet. More...
 
bool isActiveWindow () const
 
bool isAncestorOf (const QWidget *child) const
 Returns true if this widget is a parent, (or grandparent and so on to any level), of the given child, and both widgets are within the same window; otherwise returns false. More...
 
bool isEnabled () const
 
bool isEnabledTo (QWidget *) const
 Returns true if this widget would become enabled if ancestor is enabled; otherwise returns false. More...
 
bool isEnabledToTLW () const
 This function is deprecated. More...
 
bool isFullScreen () const
 
bool isHidden () const
 Returns true if the widget is hidden, otherwise returns false. More...
 
bool isLeftToRight () const
 
bool isMaximized () const
 
bool isMinimized () const
 
bool isModal () const
 
bool isRightToLeft () const
 
bool isTopLevel () const
 Use isWindow() instead. More...
 
bool isVisible () const
 
bool isVisibleTo (QWidget *) const
 Returns true if this widget would become visible if ancestor is shown; otherwise returns false. More...
 
bool isWindow () const
 Returns true if the widget is an independent window, otherwise returns false. More...
 
bool isWindowModified () const
 
QLayoutlayout () const
 Returns the layout manager that is installed on this widget, or 0 if no layout manager is installed. More...
 
Qt::LayoutDirection layoutDirection () const
 
QLocale locale () const
 
Qt::HANDLE macCGHandle () const
 Returns the CoreGraphics handle of the widget. More...
 
Qt::HANDLE macQDHandle () const
 Returns the QuickDraw handle of the widget. More...
 
QPoint mapFrom (QWidget *, const QPoint &) const
 Translates the widget coordinate pos from the coordinate system of parent to this widget's coordinate system. More...
 
QPoint mapFromGlobal (const QPoint &) const
 Translates the global screen coordinate pos to widget coordinates. More...
 
QPoint mapFromParent (const QPoint &) const
 Translates the parent widget coordinate pos to widget coordinates. More...
 
QPoint mapTo (QWidget *, const QPoint &) const
 Translates the widget coordinate pos to the coordinate system of parent. More...
 
QPoint mapToGlobal (const QPoint &) const
 Translates the widget coordinate pos to global screen coordinates. More...
 
QPoint mapToParent (const QPoint &) const
 Translates the widget coordinate pos to a coordinate in the parent widget. More...
 
QRegion mask () const
 Returns the mask currently set on a widget. More...
 
int maximumHeight () const
 
QSize maximumSize () const
 
int maximumWidth () const
 
int minimumHeight () const
 
QSize minimumSize () const
 
int minimumWidth () const
 
void move (int x, int y)
 This corresponds to move(QPoint(x, y)). More...
 
void move (const QPoint &)
 
QWidgetnativeParentWidget () const
 Returns the native parent for this widget, i. More...
 
QWidgetnextInFocusChain () const
 Returns the next widget in this widget's focus chain. More...
 
QRect normalGeometry () const
 
void overrideWindowFlags (Qt::WindowFlags type)
 Sets the window flags for the widget to flags, without telling the window system. More...
 
void overrideWindowState (Qt::WindowStates state)
 
QPaintEnginepaintEngine () const
 Returns the widget's paint engine. More...
 
const QPalettepalette () const
 
QWidgetparentWidget () const
 Returns the parent of this widget, or 0 if it does not have any parent widget. More...
 
QPoint pos () const
 
QWidgetpreviousInFocusChain () const
 The previousInFocusChain function returns the previous widget in this widget's focus chain. More...
 
 QWidget (QWidget *parent=0, Qt::WindowFlags f=0)
 Constructs a widget which is a child of parent, with widget flags set to f. More...
 
QRect rect () const
 
void releaseDC (HDC) const
 Releases the HDC hdc acquired by a previous call to getDC(). More...
 
void releaseKeyboard ()
 Releases the keyboard grab. More...
 
void releaseMouse ()
 Releases the mouse grab. More...
 
void releaseShortcut (int id)
 Removes the shortcut with the given id from Qt's shortcut system. More...
 
void removeAction (QAction *action)
 Removes the action action from this widget's list of actions. More...
 
void render (QPaintDevice *target, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren))
 Renders the sourceRegion of this widget into the target using renderFlags to determine how to render. More...
 
void render (QPainter *painter, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren))
 Renders the widget into the painter's QPainter::device(). More...
 
void repaint (int x, int y, int w, int h)
 This version repaints a rectangle (x, y, w, h) inside the widget. More...
 
void repaint (const QRect &)
 This version repaints a rectangle rect inside the widget. More...
 
void repaint (const QRegion &)
 This version repaints a region rgn inside the widget. More...
 
void resize (int w, int h)
 This corresponds to resize(QSize(w, h)). More...
 
void resize (const QSize &)
 
bool restoreGeometry (const QByteArray &geometry)
 Restores the geometry and state top-level widgets stored in the byte array geometry. More...
 
QByteArray saveGeometry () const
 Saves the current geometry and state for top-level widgets. More...
 
void scroll (int dx, int dy)
 Scrolls the widget including its children dx pixels to the right and dy downward. More...
 
void scroll (int dx, int dy, const QRect &)
 This version only scrolls r and does not move the children of the widget. More...
 
void setAcceptDrops (bool on)
 
void setAccessibleDescription (const QString &description)
 
void setAccessibleName (const QString &name)
 
void setAttribute (Qt::WidgetAttribute, bool on=true)
 Sets the attribute attribute on this widget if on is true; otherwise clears the attribute. More...
 
void setAutoFillBackground (bool enabled)
 
void setBackgroundRole (QPalette::ColorRole)
 Sets the background role of the widget to role. More...
 
void setBaseSize (const QSize &)
 
void setBaseSize (int basew, int baseh)
 This corresponds to setBaseSize(QSize(basew, baseh)). More...
 
void setContentsMargins (int left, int top, int right, int bottom)
 Sets the margins around the contents of the widget to have the sizes left, top, right, and bottom. More...
 
void setContentsMargins (const QMargins &margins)
 The setContentsMargins function sets the margins around the widget's contents. More...
 
void setContextMenuPolicy (Qt::ContextMenuPolicy policy)
 
void setCursor (const QCursor &)
 
void setFixedHeight (int h)
 Sets both the minimum and maximum heights of the widget to h without changing the widths. More...
 
void setFixedSize (const QSize &)
 Sets both the minimum and maximum sizes of the widget to s, thereby preventing it from ever growing or shrinking. More...
 
void setFixedSize (int w, int h)
 Sets the width of the widget to w and the height to h. More...
 
void setFixedWidth (int w)
 Sets both the minimum and maximum width of the widget to w without changing the heights. More...
 
void setFocus (Qt::FocusReason reason)
 Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More...
 
void setFocusPolicy (Qt::FocusPolicy policy)
 
void setFocusProxy (QWidget *)
 Sets the widget's focus proxy to widget w. More...
 
void setFont (const QFont &)
 Use the single-argument overload instead. More...
 
void setForegroundRole (QPalette::ColorRole)
 Sets the foreground role of the widget to role. More...
 
void setGeometry (int x, int y, int w, int h)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This corresponds to setGeometry(QRect(x, y, w, h)). More...
 
void setGeometry (const QRect &)
 
void setGraphicsEffect (QGraphicsEffect *effect)
 The setGraphicsEffect function is for setting the widget's graphics effect. More...
 
void setInputContext (QInputContext *)
 This function sets the input context context on this widget. More...
 
void setInputMethodHints (Qt::InputMethodHints hints)
 
void setLayout (QLayout *)
 Sets the layout manager for this widget to layout. More...
 
void setLayoutDirection (Qt::LayoutDirection direction)
 
void setLocale (const QLocale &locale)
 
void setMask (const QBitmap &)
 Causes only the pixels of the widget for which bitmap has a corresponding 1 bit to be visible. More...
 
void setMask (const QRegion &)
 Causes only the parts of the widget which overlap region to be visible. More...
 
void setMaximumHeight (int maxh)
 
void setMaximumSize (const QSize &)
 
void setMaximumSize (int maxw, int maxh)
 This function corresponds to setMaximumSize(QSize(maxw, maxh)). More...
 
void setMaximumWidth (int maxw)
 
void setMinimumHeight (int minh)
 
void setMinimumSize (const QSize &)
 
void setMinimumSize (int minw, int minh)
 This function corresponds to setMinimumSize(QSize(minw, minh)). More...
 
void setMinimumWidth (int minw)
 
void setMouseTracking (bool enable)
 
void setPalette (const QPalette &)
 Use the single-argument overload instead. More...
 
void setParent (QWidget *parent)
 Sets the parent of the widget to parent, and resets the window flags. More...
 
void setParent (QWidget *parent, Qt::WindowFlags f)
 This function also takes widget flags, f as an argument. More...
 
void setShortcutAutoRepeat (int id, bool enable=true)
 If enable is true, auto repeat of the shortcut with the given id is enabled; otherwise it is disabled. More...
 
void setShortcutEnabled (int id, bool enable=true)
 If enable is true, the shortcut with the given id is enabled; otherwise the shortcut is disabled. More...
 
void setSizeIncrement (const QSize &)
 
void setSizeIncrement (int w, int h)
 Sets the x (width) size increment to w and the y (height) size increment to h. More...
 
void setSizePolicy (QSizePolicy)
 
void setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)
 Sets the size policy of the widget to horizontal and vertical, with standard stretch and no height-for-width. More...
 
void setStatusTip (const QString &)
 
void setStyle (QStyle *)
 Sets the widget's GUI style to style. More...
 
void setToolTip (const QString &)
 
void setUpdatesEnabled (bool enable)
 
void setupUi (QWidget *widget)
 Sets up the user interface for the specified widget. More...
 
void setWhatsThis (const QString &)
 
void setWindowFilePath (const QString &filePath)
 
void setWindowFlags (Qt::WindowFlags type)
 
void setWindowIcon (const QIcon &icon)
 
void setWindowIconText (const QString &)
 
void setWindowModality (Qt::WindowModality windowModality)
 
void setWindowOpacity (qreal level)
 
void setWindowRole (const QString &)
 Sets the window's role to role. More...
 
void setWindowState (Qt::WindowStates state)
 Sets the window state to windowState. More...
 
void setWindowSurface (QWindowSurface *surface)
 Sets the window surface to be the surface specified. More...
 
QSize size () const
 
QSize sizeIncrement () const
 
QSizePolicy sizePolicy () const
 
void stackUnder (QWidget *)
 Places the widget under w in the parent widget's stack. More...
 
QString statusTip () const
 
QStylestyle () const
 
QString styleSheet () const
 
bool testAttribute (Qt::WidgetAttribute) const
 Returns true if attribute attribute is set on this widget; otherwise returns false. More...
 
QString toolTip () const
 
QWidgettopLevelWidget () const
 
bool underMouse () const
 Returns true if the widget is under the mouse cursor; otherwise returns false. More...
 
void ungrabGesture (Qt::GestureType type)
 Unsubscribes the widget from a given gesture type. More...
 
void unsetCursor ()
 
void unsetLayoutDirection ()
 
void unsetLocale ()
 
void update (int x, int y, int w, int h)
 This version updates a rectangle (x, y, w, h) inside the widget. More...
 
void update (const QRect &)
 This version updates a rectangle rect inside the widget. More...
 
void update (const QRegion &)
 This version repaints a region rgn inside the widget. More...
 
void updateGeometry ()
 Notifies the layout system that this widget has changed and may need to change geometry. More...
 
bool updatesEnabled () const
 
QRegion visibleRegion () const
 Returns the unobscured region where paint events can occur. More...
 
QString whatsThis () const
 
int width () const
 
QWidgetwindow () const
 Returns the window for this widget, i.e. More...
 
QString windowFilePath () const
 
Qt::WindowFlags windowFlags () const
 Window flags are a combination of a type (e. More...
 
QIcon windowIcon () const
 
QString windowIconText () const
 
Qt::WindowModality windowModality () const
 
qreal windowOpacity () const
 
QString windowRole () const
 Returns the window's role, or an empty string. More...
 
Qt::WindowStates windowState () const
 Returns the current window state. More...
 
QWindowSurfacewindowSurface () const
 Returns the QWindowSurface this widget will be drawn into. More...
 
QString windowTitle () const
 
Qt::WindowType windowType () const
 Returns the window type of this widget. More...
 
WId winId () const
 Returns the window system identifier of the widget. More...
 
int x () const
 
const QX11Infox11Info () const
 Returns information about the configuration of the X display used to display the widget. More...
 
Qt::HANDLE x11PictureHandle () const
 Returns the X11 Picture handle of the widget for XRender support. More...
 
int y () const
 
 ~QWidget ()
 Destroys the widget. More...
 
- Public Functions inherited from QObject
bool blockSignals (bool b)
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
 
const QObjectListchildren () const
 Returns a list of child objects. More...
 
bool connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
 
bool disconnect (const QObject *receiver, const char *member=0)
 
void dumpObjectInfo ()
 Dumps information about signal connections, etc. More...
 
void dumpObjectTree ()
 Dumps a tree of children to the debug output. More...
 
QList< QByteArraydynamicPropertyNames () const
 Returns the names of all properties that were dynamically added to the object using setProperty(). More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Filters events if this object has been installed as an event filter for the watched object. More...
 
template<typename T >
findChild (const QString &aName=QString()) const
 Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
 
template<typename T >
QList< T > findChildren (const QString &aName=QString()) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
 
template<typename T >
QList< T > findChildren (const QRegExp &re) const
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
 
void installEventFilter (QObject *)
 Installs an event filter filterObj on this object. More...
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false. More...
 
void killTimer (int id)
 Kills the timer with timer identifier, id. More...
 
void moveToThread (QThread *thread)
 Changes the thread affinity for this object and its children. More...
 
QString objectName () const
 
QObjectparent () const
 Returns a pointer to the parent object. More...
 
QVariant property (const char *name) const
 Returns the value of the object's name property. More...
 
Q_INVOKABLE QObject (QObject *parent=0)
 Constructs an object with parent object parent. More...
 
void removeEventFilter (QObject *)
 Removes an event filter object obj from this object. More...
 
void setObjectName (const QString &name)
 
void setParent (QObject *)
 Makes the object a child of parent. More...
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value. More...
 
void setUserData (uint id, QObjectUserData *data)
 
bool signalsBlocked () const
 Returns true if signals are blocked; otherwise returns false. More...
 
int startTimer (int interval)
 Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (uint id) const
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects. More...
 
- Public Functions inherited from QPaintDevice
int colorCount () const
 
int depth () const
 
int height () const
 
int heightMM () const
 
int logicalDpiX () const
 
int logicalDpiY () const
 
QT_DEPRECATED int numColors () const
 
bool paintingActive () const
 
int physicalDpiX () const
 
int physicalDpiY () const
 
int width () const
 
int widthMM () const
 
virtual ~QPaintDevice ()
 
- Public Functions inherited from QAxBase
QVariant asVariant () const
 Returns a QVariant that wraps the COM object. More...
 
QString control () const
 the name of the COM object wrapped by this QAxBase object. More...
 
void disableClassInfo ()
 Disables the class info generation for this ActiveX container. More...
 
void disableEventSink ()
 Disables the event sink implementation for this ActiveX container. More...
 
void disableMetaObject ()
 Disables the meta object generation for this ActiveX container. More...
 
QVariant dynamicCall (const char *name, const QVariant &v1=QVariant(), const QVariant &v2=QVariant(), const QVariant &v3=QVariant(), const QVariant &v4=QVariant(), const QVariant &v5=QVariant(), const QVariant &v6=QVariant(), const QVariant &v7=QVariant(), const QVariant &v8=QVariant())
 Calls the COM object's method function, passing the parameters var1, var1, var2, var3, var4, var5, var6, var7 and var8, and returns the value returned by the method, or an invalid QVariant if the method does not return a value or when the function call failed. More...
 
QVariant dynamicCall (const char *name, QList< QVariant > &vars)
 Calls the COM object's method function, passing the parameters in vars, and returns the value returned by the method. More...
 
QString generateDocumentation ()
 Returns a rich text string with documentation for the wrapped COM object. More...
 
bool isNull () const
 Returns true if there is no COM object loaded by this wrapper; otherwise return false. More...
 
PropertyBag propertyBag () const
 Returns a name:value map of all the properties exposed by the COM object. More...
 
virtual bool propertyWritable (const char *) const
 Returns true if the property prop is writable; otherwise returns false. More...
 
 QAxBase (IUnknown *iface=0)
 Creates a QAxBase object that wraps the COM object iface. More...
 
long queryInterface (const QUuid &, void **) const
 Requests the interface uuid from the COM object and sets the value of iface to the provided interface, or to 0 if the requested interface could not be provided. More...
 
QAxObjectquerySubObject (const char *name, const QVariant &v1=QVariant(), const QVariant &v2=QVariant(), const QVariant &v3=QVariant(), const QVariant &v4=QVariant(), const QVariant &v5=QVariant(), const QVariant &v6=QVariant(), const QVariant &v7=QVariant(), const QVariant &v8=QVariant())
 Returns a pointer to a QAxObject wrapping the COM object provided by the method or property name, passing passing the parameters var1, var1, var2, var3, var4, var5, var6, var7 and var8. More...
 
QAxObjectquerySubObject (const char *name, QList< QVariant > &vars)
 The QVariant objects in vars are updated when the method has out-parameters. More...
 
bool setControl (const QString &)
 
void setPropertyBag (const PropertyBag &)
 Sets the properties of the COM object to the corresponding values in bag. More...
 
virtual void setPropertyWritable (const char *, bool)
 Sets the property prop to writable if ok is true, otherwise sets prop to be read-only. More...
 
QStringList verbs () const
 Returns the list of verbs that the COM object can execute. More...
 
virtual ~QAxBase ()
 Shuts down the COM object and destroys the QAxBase object. More...
 

Protected Functions

void changeEvent (QEvent *e)
 Reimplemented Function More...
 
void connectNotify (const char *signal)
 Reimplemented Function More...
 
virtual bool createHostWindow (bool)
 Creates the client site for the ActiveX control, and returns true if the control could be embedded successfully, otherwise returns false. More...
 
bool createHostWindow (bool, const QByteArray &)
 Creates the client site for the ActiveX control, and returns true if the control could be embedded successfully, otherwise returns false. More...
 
bool initialize (IUnknown **)
 Calls QAxBase::initialize(ptr), and embeds the control in this widget by calling createHostWindow(false) if successful. More...
 
void resizeEvent (QResizeEvent *)
 Reimplemented Function More...
 
virtual bool translateKeyEvent (int message, int keycode) const
 Reimplement this function to pass certain key events to the ActiveX control. More...
 
- Protected Functions inherited from QWidget
virtual void actionEvent (QActionEvent *)
 This event handler is called with the given event whenever the widget's actions are changed. More...
 
virtual void closeEvent (QCloseEvent *)
 This event handler is called with the given event when Qt receives a window close request for a top-level widget from the window system. More...
 
virtual void contextMenuEvent (QContextMenuEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive widget context menu events. More...
 
void create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true)
 Creates a new widget window if window is 0, otherwise sets the widget's window to window. More...
 
void destroy (bool destroyWindow=true, bool destroySubWindows=true)
 Frees up window system resources. More...
 
virtual void dragEnterEvent (QDragEnterEvent *)
 This event handler is called when a drag is in progress and the mouse enters this widget. More...
 
virtual void dragLeaveEvent (QDragLeaveEvent *)
 This event handler is called when a drag is in progress and the mouse leaves this widget. More...
 
virtual void dragMoveEvent (QDragMoveEvent *)
 This event handler is called if a drag is in progress, and when any of the following conditions occur: the cursor enters this widget, the cursor moves within this widget, or a modifier key is pressed on the keyboard while this widget has the focus. More...
 
virtual void dropEvent (QDropEvent *)
 This event handler is called when the drag is dropped on this widget. More...
 
virtual void enabledChange (bool)
 
virtual void enterEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive widget enter events which are passed in the event parameter. More...
 
bool event (QEvent *)
 This is the main event handler; it handles event event. More...
 
virtual void focusInEvent (QFocusEvent *)
 This event handler can be reimplemented in a subclass to receive keyboard focus events (focus received) for the widget. More...
 
bool focusNextChild ()
 Finds a new widget to give the keyboard focus to, as appropriate for Tab, and returns true if it can find a new widget, or false if it can't. More...
 
virtual bool focusNextPrevChild (bool next)
 Finds a new widget to give the keyboard focus to, as appropriate for Tab and Shift+Tab, and returns true if it can find a new widget, or false if it can't. More...
 
virtual void focusOutEvent (QFocusEvent *)
 This event handler can be reimplemented in a subclass to receive keyboard focus events (focus lost) for the widget. More...
 
bool focusPreviousChild ()
 Finds a new widget to give the keyboard focus to, as appropriate for Shift+Tab, and returns true if it can find a new widget, or false if it can't. More...
 
virtual void fontChange (const QFont &)
 
virtual void hideEvent (QHideEvent *)
 This event handler can be reimplemented in a subclass to receive widget hide events. More...
 
virtual void inputMethodEvent (QInputMethodEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive Input Method composition events. More...
 
virtual void keyPressEvent (QKeyEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive key press events for the widget. More...
 
virtual void keyReleaseEvent (QKeyEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive key release events for the widget. More...
 
virtual void languageChange ()
 
virtual void leaveEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive widget leave events which are passed in the event parameter. More...
 
virtual bool macEvent (EventHandlerCallRef, EventRef)
 This special event handler can be reimplemented in a subclass to receive native Macintosh events. More...
 
int metric (PaintDeviceMetric) const
 Internal implementation of the virtual QPaintDevice::metric() function. More...
 
virtual void mouseDoubleClickEvent (QMouseEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive mouse double click events for the widget. More...
 
virtual void mouseMoveEvent (QMouseEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive mouse move events for the widget. More...
 
virtual void mousePressEvent (QMouseEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive mouse press events for the widget. More...
 
virtual void mouseReleaseEvent (QMouseEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive mouse release events for the widget. More...
 
virtual void moveEvent (QMoveEvent *)
 This event handler can be reimplemented in a subclass to receive widget move events which are passed in the event parameter. More...
 
virtual void paintEvent (QPaintEvent *)
 This event handler can be reimplemented in a subclass to receive paint events passed in event. More...
 
virtual void paletteChange (const QPalette &)
 
 QWidget (QWidgetPrivate &d, QWidget *parent, Qt::WindowFlags f)
 
virtual bool qwsEvent (QWSEvent *)
 This special event handler can be reimplemented in a subclass to receive native Qt for Embedded Linux events which are passed in the event parameter. More...
 
void resetInputContext ()
 This function can be called on the widget that currently has focus to reset the input method operating on it. More...
 
virtual void showEvent (QShowEvent *)
 This event handler can be reimplemented in a subclass to receive widget show events which are passed in the event parameter. More...
 
virtual void styleChange (QStyle &)
 
virtual void tabletEvent (QTabletEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive tablet events for the widget. More...
 
virtual void wheelEvent (QWheelEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive wheel events for the widget. More...
 
virtual void windowActivationChange (bool)
 
virtual bool winEvent (MSG *message, long *result)
 This special event handler can be reimplemented in a subclass to receive native Windows events which are passed in the message parameter. More...
 
virtual bool x11Event (XEvent *)
 This special event handler can be reimplemented in a subclass to receive native X11 events passed in the event parameter. More...
 
- Protected Functions inherited from QObject
virtual void childEvent (QChildEvent *)
 This event handler can be reimplemented in a subclass to receive child events. More...
 
virtual void customEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive custom events. More...
 
virtual void disconnectNotify (const char *signal)
 This virtual function is called when something has been disconnected from signal in this object. More...
 
 QObject (QObjectPrivate &dd, QObject *parent=0)
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal. More...
 
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *)
 This event handler can be reimplemented in a subclass to receive timer events for the object. More...
 
- Protected Functions inherited from QPaintDevice
 QPaintDevice ()
 
- Protected Functions inherited from QAxBase
void connectNotify ()
 Connects to all event interfaces of the object. More...
 
long indexOfVerb (const QString &verb) const
 
bool initializeActive (IUnknown **ptr)
 Connects to an active instance running on the current machine, and returns the IUnknown interface to the running object in ptr. More...
 
void initializeFrom (QAxBase *that)
 Used by subclasses generated with dumpcpp to implement cast-operators. More...
 
bool initializeFromFile (IUnknown **ptr)
 Creates the COM object handling the filename in the control property, and returns the IUnknown interface to the object in ptr. More...
 
bool initializeLicensed (IUnknown **ptr)
 Creates an instance of a licensed control, and returns the IUnknown interface to the object in ptr. More...
 
bool initializeRemote (IUnknown **ptr)
 Creates the instance on a remote server, and returns the IUnknown interface to the object in ptr. More...
 
void internalRelease ()
 Used by subclasses generated with dumpcpp to balance reference count. More...
 

Private Functions

const QMetaObjectparentMetaObject () const
 

Properties

QAxClientSitecontainer
 

Static Private Attributes

static QMetaObject staticMetaObject
 

Friends

class QAxClientSite
 

Additional Inherited Members

- Public Types inherited from QWidget
enum  RenderFlag { DrawWindowBackground = 0x1, DrawChildren = 0x2, IgnoreMask = 0x4 }
 This enum describes how to render the widget when calling QWidget::render(). More...
 
- Public Types inherited from QPaintDevice
enum  PaintDeviceMetric {
  PdmWidth = 1, PdmHeight, PdmWidthMM, PdmHeightMM,
  PdmNumColors, PdmDepth, PdmDpiX, PdmDpiY,
  PdmPhysicalDpiX, PdmPhysicalDpiY
}
 
- Public Types inherited from QAxBase
typedef QMap< QString, QVariantPropertyBag
 A QMap<QString,QVariant> that can store properties as name:value pairs. More...
 
- Public Slots inherited from QWidget
bool close ()
 Closes this widget. More...
 
void hide ()
 Hides the widget. More...
 
void lower ()
 Lowers the widget to the bottom of the parent widget's stack. More...
 
void raise ()
 Raises this widget to the top of the parent widget's stack. More...
 
void repaint ()
 Repaints the widget directly by calling paintEvent() immediately, unless updates are disabled or the widget is hidden. More...
 
void setDisabled (bool)
 Disables widget input events if disable is true; otherwise enables input events. More...
 
void setEnabled (bool)
 
void setFocus ()
 Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More...
 
void setHidden (bool hidden)
 Convenience function, equivalent to setVisible(!hidden). More...
 
QT_MOC_COMPAT void setShown (bool shown)
 Use setVisible(shown) instead. More...
 
void setStyleSheet (const QString &styleSheet)
 
virtual void setVisible (bool visible)
 
void setWindowModified (bool)
 
void setWindowTitle (const QString &)
 
void show ()
 Shows the widget and its child widgets. More...
 
void showFullScreen ()
 Shows the widget in full-screen mode. More...
 
void showMaximized ()
 Shows the widget maximized. More...
 
void showMinimized ()
 Shows the widget minimized, as an icon. More...
 
void showNormal ()
 Restores the widget after it has been maximized or minimized. More...
 
void update ()
 Updates the widget unless updates are disabled or the widget is hidden. More...
 
- Public Slots inherited from QObject
void deleteLater ()
 Schedules this object for deletion. More...
 
- Signals inherited from QWidget
void customContextMenuRequested (const QPoint &pos)
 This signal is emitted when the widget's contextMenuPolicy is Qt::CustomContextMenu, and the user has requested a context menu on the widget. More...
 
- Signals inherited from QObject
void destroyed (QObject *=0)
 This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
 
- Signals inherited from QAxBase
void exception (int, const QString &, const QString &, const QString &)
 This signal is emitted when the COM object throws an exception while called using the OLE automation interface IDispatch. More...
 
void propertyChanged (const QString &)
 If the COM object supports property notification, this signal gets emitted when the property called name is changed. More...
 
void signal (const QString &, int, void *)
 This generic signal gets emitted when the COM object issues the event name. More...
 
- Static Public Functions inherited from QWidget
static QWidgetfind (WId)
 Returns a pointer to the widget with window identifer/handle id. More...
 
static QWidgetkeyboardGrabber ()
 Returns the widget that is currently grabbing the keyboard input. More...
 
static QWidgetmouseGrabber ()
 Returns the widget that is currently grabbing the mouse input. More...
 
static void setTabOrder (QWidget *, QWidget *)
 Puts the second widget after the first widget in the focus order. More...
 
- Static Public Functions inherited from QObject
static bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
 
static bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 Disconnects signal in object sender from method in object receiver. More...
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static uint registerUserData ()
 
static QString tr (const char *sourceText, const char *comment=0, int n=-1)
 
static QString trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
 
- Static Public Functions inherited from QPaintDevice
static QWSDisplayqwsDisplay ()
 
- Static Public Variables inherited from QObject
static const QMetaObject staticMetaObject
 This variable stores the meta-object for the class. More...
 
- Protected Slots inherited from QWidget
void updateMicroFocus ()
 Updates the widget's micro focus. More...
 
- Protected Variables inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Protected Variables inherited from QPaintDevice
ushort painters
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

The QAxWidget class is a QWidget that wraps an ActiveX control.

Attention
Module: QAxContainer

A QAxWidget can be instantiated as an empty object, with the name of the ActiveX control it should wrap, or with an existing interface pointer to the ActiveX control. The ActiveX control's properties, methods and events which only use QAxBase supported data types, become available as Qt properties, slots and signals. The base class QAxBase provides an API to access the ActiveX directly through the IUnknown pointer.

QAxWidget is a QWidget and can mostly be used as such, e.g. it can be organized in a widget hierarchy and layouts or act as an event filter. Standard widget properties, e.g. enabled are supported, but it depends on the ActiveX control to implement support for ambient properties like e.g. palette or font. QAxWidget tries to provide the necessary hints.

However, you cannot reimplement Qt-specific event handlers like mousePressEvent or keyPressEvent and expect them to be called reliably. The embedded control covers the QAxWidget completely, and usually handles the user interface itself. Use control-specific APIs (i.e. listen to the signals of the control), or use standard COM techniques like window procedure subclassing.

QAxWidget also inherits most of its ActiveX-related functionality from QAxBase, notably dynamicCall() and querySubObject().

Warning
You can subclass QAxWidget, but you cannot use the Q_OBJECT macro in the subclass (the generated moc-file will not compile), so you cannot add further signals, slots or properties. This limitation is due to the metaobject information generated in runtime. To work around this problem, aggregate the QAxWidget as a member of the QObject subclass.
See also
QAxBase, QAxObject, QAxScript, {ActiveQt Framework}

Definition at line 60 of file qaxwidget.h.

Constructors and Destructors

◆ QAxWidget() [1/3]

QAxWidget::QAxWidget ( QWidget parent = 0,
Qt::WindowFlags  f = 0 
)

Creates an empty QAxWidget widget and propagates parent and f to the QWidget constructor.

To initialize a control, call setControl().

Definition at line 1891 of file qaxwidget.cpp.

Referenced by qObject().

1892 : QWidget(parent, f), container(0)
1893 {
1894 }
QWidget(QWidget *parent=0, Qt::WindowFlags f=0)
Constructs a widget which is a child of parent, with widget flags set to f.
Definition: qwidget.cpp:1189
QAxClientSite * container
Definition: qaxwidget.h:95

◆ QAxWidget() [2/3]

QAxWidget::QAxWidget ( const QString c,
QWidget parent = 0,
Qt::WindowFlags  f = 0 
)

Creates an QAxWidget widget and initializes the ActiveX control c.

parent and f are propagated to the QWidget contructor.

See also
setControl()

Definition at line 1902 of file qaxwidget.cpp.

1903 : QWidget(parent, f), container(0)
1904 {
1905  setControl(c);
1906 }
QWidget(QWidget *parent=0, Qt::WindowFlags f=0)
Constructs a widget which is a child of parent, with widget flags set to f.
Definition: qwidget.cpp:1189
bool setControl(const QString &)
Definition: qaxbase.cpp:975
QAxClientSite * container
Definition: qaxwidget.h:95

◆ QAxWidget() [3/3]

QAxWidget::QAxWidget ( IUnknown *  iface,
QWidget parent = 0,
Qt::WindowFlags  f = 0 
)

Creates a QAxWidget that wraps the COM object referenced by iface.

parent and f are propagated to the QWidget contructor.

Definition at line 1912 of file qaxwidget.cpp.

1913 : QWidget(parent, f), QAxBase(iface), container(0)
1914 {
1915 }
QWidget(QWidget *parent=0, Qt::WindowFlags f=0)
Constructs a widget which is a child of parent, with widget flags set to f.
Definition: qwidget.cpp:1189
QAxClientSite * container
Definition: qaxwidget.h:95
QAxBase(IUnknown *iface=0)
Creates a QAxBase object that wraps the COM object iface.
Definition: qaxbase.cpp:850

◆ ~QAxWidget()

QAxWidget::~QAxWidget ( )

Shuts down the ActiveX control and destroys the QAxWidget widget, cleaning up all allocated resources.

See also
clear()

Definition at line 1923 of file qaxwidget.cpp.

Referenced by qObject().

1924 {
1925  if (container)
1926  container->reset(this);
1927  clear();
1928 }
void reset(QWidget *p)
Definition: qaxwidget.cpp:173
void clear()
Shuts down the ActiveX control.
Definition: qaxwidget.cpp:2030
QAxClientSite * container
Definition: qaxwidget.h:95

Functions

◆ changeEvent()

void QAxWidget::changeEvent ( QEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 2164 of file qaxwidget.cpp.

Referenced by qObject().

2165 {
2166  if (isNull() || !container)
2167  return;
2168 
2169  switch (e->type()) {
2170  case QEvent::EnabledChange:
2171  container->emitAmbientPropertyChange(DISPID_AMBIENT_UIDEAD);
2172  break;
2173  case QEvent::FontChange:
2174  container->emitAmbientPropertyChange(DISPID_AMBIENT_FONT);
2175  break;
2176  case QEvent::PaletteChange:
2177  container->emitAmbientPropertyChange(DISPID_AMBIENT_BACKCOLOR);
2178  container->emitAmbientPropertyChange(DISPID_AMBIENT_FORECOLOR);
2179  break;
2182  break;
2183  default:
2184  break;
2185  }
2186 }
void emitAmbientPropertyChange(DISPID dispid)
Definition: qaxwidget.cpp:904
bool isNull() const
Returns true if there is no COM object loaded by this wrapper; otherwise return false.
Definition: qaxbase.cpp:4412
QAxClientSite * container
Definition: qaxwidget.h:95
Type type() const
Returns the event type.
Definition: qcoreevent.h:303
void windowActivationChange()
Definition: qaxwidget.cpp:1605

◆ className()

const char * QAxWidget::className ( ) const
virtual
Warning
This function is not part of the public interface.

Implements QAxBase.

Definition at line 2117 of file qaxwidget.cpp.

Referenced by qObject().

2118 {
2119  return "QAxWidget";
2120 }

◆ clear()

void QAxWidget::clear ( )
virtual

Shuts down the ActiveX control.

Reimplemented Function

Reimplemented from QAxBase.

Definition at line 2030 of file qaxwidget.cpp.

Referenced by qObject(), and ~QAxWidget().

2031 {
2032  if (isNull())
2033  return;
2034  if (!control().isEmpty()) {
2035 #if !defined(Q_OS_WINCE)
2036  ATOM filter_ref = FindAtom(qaxatom);
2037  if (filter_ref)
2038  DeleteAtom(filter_ref);
2039  filter_ref = FindAtom(qaxatom);
2040  if (!filter_ref) {
2041 #else
2042  if (!filter_ref && !--filter_ref) {
2043 #endif
2045  previous_filter = 0;
2046  }
2047  }
2048 
2049  if (container)
2050  container->deactivate();
2051 
2052  QAxBase::clear();
2054 
2055  if (container) {
2056  container->releaseAll();
2057  container->Release();
2058  }
2059  container = 0;
2060 }
bool isNull() const
Returns true if there is no COM object loaded by this wrapper; otherwise return false.
Definition: qaxbase.cpp:4412
QString control() const
the name of the COM object wrapped by this QAxBase object.
Definition: qaxbase.cpp:1029
static QAbstractEventDispatcher * instance(QThread *thread=0)
Returns a pointer to the event dispatcher object for the specified thread.
unsigned long WINAPI Release()
Definition: qaxwidget.cpp:780
#define ATOM(x)
Definition: qt_x11_p.h:723
static bool isEmpty(const char *str)
static QAbstractEventDispatcher::EventFilter previous_filter
Definition: qaxwidget.cpp:460
static int filter_ref
Definition: qaxwidget.cpp:465
EventFilter setEventFilter(EventFilter filter)
Replaces the event filter function for this QAbstractEventDispatcher with filter and returns the repl...
QAxClientSite * container
Definition: qaxwidget.h:95
virtual void clear()
Disconnects and destroys the COM object.
Definition: qaxbase.cpp:1095
void releaseAll()
Definition: qaxwidget.cpp:749
void deactivate()
Definition: qaxwidget.cpp:767
void setFocusPolicy(Qt::FocusPolicy policy)
Definition: qwidget.cpp:7631

◆ connectNotify()

void QAxWidget::connectNotify ( const char *  signal)
protectedvirtual

Reimplemented Function

Reimplemented from QObject.

Definition at line 2200 of file qaxwidget.cpp.

2201 {
2203 }
void connectNotify()
Connects to all event interfaces of the object.
Definition: qaxbase.cpp:3282

◆ createAggregate()

QAxAggregated * QAxWidget::createAggregate ( )
virtual

Reimplement this function when you want to implement additional COM interfaces for the client site of the ActiveX control, or when you want to provide alternative implementations of COM interfaces.

Return a new object of a QAxAggregated subclass.

The default implementation returns the null pointer.

Definition at line 2017 of file qaxwidget.cpp.

Referenced by QAxClientSite::QAxClientSite(), and qObject().

2018 {
2019  return 0;
2020 }

◆ createHostWindow() [1/2]

bool QAxWidget::createHostWindow ( bool  initialized)
protectedvirtual

Creates the client site for the ActiveX control, and returns true if the control could be embedded successfully, otherwise returns false.

If initialized is true the control has already been initialized.

This function is called by initialize(). If you reimplement initialize to customize the actual control instantiation, call this function in your reimplementation to have the control embedded by the default client side. Creates the client site for the ActiveX control, and returns true if the control could be embedded successfully, otherwise returns false.

Definition at line 1962 of file qaxwidget.cpp.

Referenced by initialize(), and qObject().

1963 {
1964  return createHostWindow(initialized, QByteArray());
1965 }
The QByteArray class provides an array of bytes.
Definition: qbytearray.h:135
virtual bool createHostWindow(bool)
Creates the client site for the ActiveX control, and returns true if the control could be embedded su...
Definition: qaxwidget.cpp:1962

◆ createHostWindow() [2/2]

bool QAxWidget::createHostWindow ( bool  initialized,
const QByteArray data 
)
protected

Creates the client site for the ActiveX control, and returns true if the control could be embedded successfully, otherwise returns false.

Since
4.4

If initialized is false the control will be initialized using the data. The control will be initialized through either IPersistStreamInit or IPersistStorage interface.

If the control needs to be initialized using custom data, call this function in your reimplementation of initialize(). This function is not called by the default implementation of initialize().

Definition at line 1983 of file qaxwidget.cpp.

1984 {
1985 #ifdef QT3_SUPPORT
1986  QApplication::sendPostedEvents(0, QEvent::ChildInserted);
1987 #endif
1988 
1989  container = new QAxClientSite(this);
1990  container->activateObject(initialized, data);
1991 
1992 #if !defined(Q_OS_WINCE)
1993  ATOM filter_ref = FindAtom(qaxatom);
1994 #endif
1995  if (!filter_ref)
1997 #if !defined(Q_OS_WINCE)
1998  AddAtom(qaxatom);
1999 #else
2000  ++filter_ref;
2001 #endif
2002 
2003  if (parentWidget())
2005 
2006  return true;
2007 }
friend class QAxClientSite
Definition: qaxwidget.h:94
QWidget * parentWidget() const
Returns the parent of this widget, or 0 if it does not have any parent widget.
Definition: qwidget.h:1035
bool activateObject(bool initialized, const QByteArray &data)
Definition: qaxwidget.cpp:557
static void postEvent(QObject *receiver, QEvent *event)
Adds the event event, with the object receiver as the receiver of the event, to an event queue and re...
static QAbstractEventDispatcher * instance(QThread *thread=0)
Returns a pointer to the event dispatcher object for the specified thread.
#define ATOM(x)
Definition: qt_x11_p.h:723
static QAbstractEventDispatcher::EventFilter previous_filter
Definition: qaxwidget.cpp:460
static void sendPostedEvents()
bool axc_FilterProc(void *m)
Definition: qaxwidget.cpp:471
static int filter_ref
Definition: qaxwidget.cpp:465
EventFilter setEventFilter(EventFilter filter)
Replaces the event filter function for this QAbstractEventDispatcher with filter and returns the repl...
QAxClientSite * container
Definition: qaxwidget.h:95
The QEvent class is the base class of all event classes.
Definition: qcoreevent.h:56

◆ doVerb()

bool QAxWidget::doVerb ( const QString verb)

Requests the ActiveX control to perform the action verb.

Since
4.1

The possible verbs are returned by verbs().

The function returns true if the object could perform the action, otherwise returns false.

Definition at line 2073 of file qaxwidget.cpp.

Referenced by qObject().

2074 {
2075  if (!verbs().contains(verb))
2076  return false;
2077 
2078  HRESULT hres = container->doVerb(indexOfVerb(verb));
2079 
2080  return hres == S_OK;
2081 }
QStringList verbs() const
Returns the list of verbs that the COM object can execute.
Definition: qaxbase.cpp:1137
HRESULT doVerb(LONG index)
Definition: qaxwidget.cpp:186
long HRESULT
long indexOfVerb(const QString &verb) const
Definition: qaxbase.cpp:1172
QAxClientSite * container
Definition: qaxwidget.h:95

◆ initialize()

bool QAxWidget::initialize ( IUnknown **  ptr)
protectedvirtual

Calls QAxBase::initialize(ptr), and embeds the control in this widget by calling createHostWindow(false) if successful.

Since
4.2

To initialize the control before it is activated, reimplement this function and add your initialization code before you call createHostWindow(true).

Reimplemented from QAxBase.

Definition at line 1943 of file qaxwidget.cpp.

Referenced by qObject().

1944 {
1945  if (!QAxBase::initialize(ptr))
1946  return false;
1947 
1948  return createHostWindow(false); // assume that control is not initialized
1949 }
const T * ptr(const T &t)
virtual bool initialize(IUnknown **ptr)
This virtual function is called by setControl() and creates the requested COM object.
Definition: qaxbase.cpp:1199
virtual bool createHostWindow(bool)
Creates the client site for the ActiveX control, and returns true if the control could be embedded su...
Definition: qaxwidget.cpp:1962

◆ metaObject()

const QMetaObject * QAxWidget::metaObject ( ) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from QAxBase.

Definition at line 2091 of file qaxwidget.cpp.

2092 {
2093  return QAxBase::metaObject();
2094 }
virtual const QMetaObject * metaObject() const
The metaobject is generated on the fly from the information provided by the IDispatch and ITypeInfo i...
Definition: qaxbase.cpp:3245

◆ minimumSizeHint()

QSize QAxWidget::minimumSizeHint ( ) const
virtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 2150 of file qaxwidget.cpp.

Referenced by qObject().

2151 {
2152  if (container) {
2154  if (sh.isValid())
2155  return sh;
2156  }
2157 
2158  return QWidget::minimumSizeHint();
2159 }
virtual QSize minimumSizeHint() const
QSize minimumSizeHint() const
Definition: qaxwidget.cpp:1590
bool isValid() const
Returns true if both the width and height is equal to or greater than 0; otherwise returns false...
Definition: qsize.h:123
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
QAxClientSite * container
Definition: qaxwidget.h:95

◆ parentMetaObject()

const QMetaObject * QAxWidget::parentMetaObject ( ) const
privatevirtual
Warning
This function is not part of the public interface.

Implements QAxBase.

Definition at line 2099 of file qaxwidget.cpp.

2100 {
2101  return &QWidget::staticMetaObject;
2102 }
static const QMetaObject staticMetaObject
This variable stores the meta-object for the class.
Definition: qobject.h:128

◆ qObject()

QObject * QAxWidget::qObject ( ) const
inlinevirtual
Warning
This function is not part of the public interface.

Implements QAxBase.

Definition at line 66 of file qaxwidget.h.

66 { return (QWidget*)this; }
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150

◆ qt_metacall()

int QAxWidget::qt_metacall ( QMetaObject::Call  call,
int  id,
void **  v 
)
virtual
Warning
This function is not part of the public interface.

Reimplemented from QAxBase.

Definition at line 2125 of file qaxwidget.cpp.

2126 {
2127  id = QWidget::qt_metacall(call, id, v);
2128  if (id < 0)
2129  return id;
2130  return QAxBase::qt_metacall(call, id, v);
2131 }
virtual int qt_metacall(QMetaObject::Call, int, void **)
Definition: qaxbase.cpp:3705

◆ qt_metacast()

void * QAxWidget::qt_metacast ( const char *  cname)
Warning
This function is not part of the public interface.

Definition at line 2107 of file qaxwidget.cpp.

Referenced by qobject_cast< QAxWidget * >().

2108 {
2109  if (!qstrcmp(cname, "QAxWidget")) return (void*)this;
2110  if (!qstrcmp(cname, "QAxBase")) return (QAxBase*)this;
2111  return QWidget::qt_metacast(cname);
2112 }
int qstrcmp(const QByteArray &str1, const char *str2)
Definition: qbytearray.cpp:336
The QAxBase class is an abstract class that provides an API to initialize and access a COM object...
Definition: qaxbase.h:66

◆ resizeEvent()

void QAxWidget::resizeEvent ( QResizeEvent )
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 2191 of file qaxwidget.cpp.

Referenced by qObject().

2192 {
2193  if (container)
2194  container->resize(size());
2195 }
QSize size() const
QAxClientSite * container
Definition: qaxwidget.h:95
void resize(QSize sz)
Definition: qaxwidget.cpp:365

◆ sizeHint()

QSize QAxWidget::sizeHint ( ) const
virtual

Reimplemented Function

Reimplemented from QWidget.

Definition at line 2136 of file qaxwidget.cpp.

Referenced by qObject().

2137 {
2138  if (container) {
2139  QSize sh = container->sizeHint();
2140  if (sh.isValid())
2141  return sh;
2142  }
2143 
2144  return QWidget::sizeHint();
2145 }
QSize sizeHint() const
Definition: qaxwidget.cpp:363
virtual QSize sizeHint() const
bool isValid() const
Returns true if both the width and height is equal to or greater than 0; otherwise returns false...
Definition: qsize.h:123
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
QAxClientSite * container
Definition: qaxwidget.h:95

◆ translateKeyEvent()

bool QAxWidget::translateKeyEvent ( int  message,
int  keycode 
) const
protectedvirtual

Reimplement this function to pass certain key events to the ActiveX control.

message is the Window message identifier specifying the message type (ie. WM_KEYDOWN), and keycode is the virtual keycode (ie. VK_TAB).

If the function returns true the key event is passed on to the ActiveX control, which then either processes the event or passes the event on to Qt.

If the function returns false the processing of the key event is ignored by ActiveQt, ie. the ActiveX control might handle it or not.

The default implementation returns true for the following cases:

WM_SYSKEYDOWN WM_SYSKEYUP WM_KEYDOWN
All keycodes VK_MENU VK_TAB, VK_DELETE and all non-arrow-keys in combination with VK_SHIFT, VK_CONTROL or VK_MENU

This table is the result of experimenting with popular ActiveX controls, ie. Internet Explorer and Microsoft Office applications, but for some controls it might require modification.

Definition at line 2238 of file qaxwidget.cpp.

Referenced by qObject().

2239 {
2240  bool translate = false;
2241 
2242  switch (message) {
2243  case WM_SYSKEYDOWN:
2244  translate = true;
2245  break;
2246  case WM_KEYDOWN:
2247  translate = keycode == VK_TAB
2248  || keycode == VK_DELETE;
2249  if (!translate) {
2250  int state = 0;
2251  if (GetKeyState(VK_SHIFT) < 0)
2252  state |= 0x01;
2253  if (GetKeyState(VK_CONTROL) < 0)
2254  state |= 0x02;
2255  if (GetKeyState(VK_MENU) < 0)
2256  state |= 0x04;
2257  if (state) {
2258  state = keycode < VK_LEFT || keycode > VK_DOWN;
2259  }
2260  translate = state;
2261  }
2262  break;
2263  case WM_SYSKEYUP:
2264  translate = keycode == VK_MENU;
2265  break;
2266  }
2267 
2268  return translate;
2269 }
int keycode

Friends and Related Functions

◆ QAxClientSite

friend class QAxClientSite
friend

Definition at line 94 of file qaxwidget.h.

Referenced by createHostWindow().

Properties

◆ container

QAxClientSite* QAxWidget::container
private

◆ staticMetaObject

QMetaObject QAxWidget::staticMetaObject
staticprivate

Definition at line 98 of file qaxwidget.h.


The documentation for this class was generated from the following files: