C
VncItem QML Type
Item for creating a VNC®-compatible server. More...
Import Statement: | import QtVncServer |
Properties
- connectionActive : bool
- connectionEnabled : bool
- grabMode : enumeration
- password : string
- remoteInputEnabled : bool
- vncPort : int
Detailed Description
VncItem is a Qt Quick Item which will share its children over the RFB® protocol. It can be the top-level item in the scene for sharing the full window, or any rectangular part of it. Resizing the item will also resize the frames shared with clients.
As soon as the VncItem is initialized, it will accept connections.
Property Documentation
connectionActive : bool |
This read-only property reflects whether there is currently one or more clients connected to the server.
connectionEnabled : bool |
This property decides whether the server accepts new connections. Set this to false
to reject new connections. It is true
by default.
grabMode : enumeration |
This property specifies the visual content that is transmitted to the client. It must be set before a client connects: changes to this property is ignored while clients are connected.
Constant | Description |
---|---|
VncItem.GrabItemRectangle | The client will show the part of the window that is covered by the item's geometry. This includes popup windows and overlapping siblings. This mode is the default. |
VncItem.GrabItemIsolated | The client will show just the content of the item and the item's children within the geometry of the item. Popups and overlapping sibling are excluded. This means that combo boxes and menus will not work properly from the client. This mode will usually give better performance. |
VncItem.GrabWindow | The client will show the entire contents of the item's window, regardless of the geometry of the item. This is useful when sharing an ApplicationWindow, for example, since the menu bar and tool bars will be outside the item's geometry. |
password : string |
When set, this property enables DEC Authentication on the server and remote clients will have to provide a matching password to connect.
Note: DEC authentication is considered weak protection, and the connection itself is not encrypted. This protects mainly against accidental intrusion, but not against targeted attacks.
Note: This depends on the availability of LibTomCrypt, otherwise it will have no effect.
remoteInputEnabled : bool |
This property decides whether input from remote clients is processed. If set to false
then clients will only be able to see the contents of the VncItem, but not actually interact with it. The default is true
.
vncPort : int |
This property decides the port on which the VncItem listens to new connections. The default value is 5900.
Available under certain Qt licenses.
Find out more.