今天學習的內容是Window對象,閱讀過程有任何相關問題,請留言~
更多QML筆記請點擊:開始QML學習之路
目錄
Window對象爲Qt Quick場景創建一個新的頂級窗口。它會自動設置用於QtQuick 2.x的窗口圖形類型。要使用這種類型,您需要導入模塊,並使用以下代碼行:
import QtQuick.Window 2.2
window屬性
1)active : bool
描述:窗口的活動狀態。
2)activeFocusItem : Item
描述:當前具有活動焦點的項,如果沒有具有活動焦點的項,則爲空。
3)color : color
描述:窗口的背景顏色。
4)[只讀]contentItem : Item
描述:場景中看不見的根項目。這裏爲只讀~注意!!
5)contentOrientation : Qt::ScreenOrientation
描述:這是給窗口管理器的一個提示,以防它需要顯示額外的內容,如彈出窗口、對話框、狀態欄或與窗口相關的類似內容。
推薦的方向是屏幕方向,但應用程序不必支持所有可能的方向,因此可以選擇忽略當前屏幕方向。
窗口和內容方向之間的差異決定了內容旋轉的大小。
6)[默認]data : list<Object>
描述:data屬性允許您在一個窗口中自由地混合可視的子窗口、資源窗口和其他窗口。
如果爲數據列表分配另一個窗口,嵌套窗口將成爲外部窗口的“臨時”窗口。
如果將一個項分配給數據列表,它就會成爲窗口內容的子元素,從而出現在窗口內。項的父項將是窗口的contentItem,它是該窗口內的項所有權樹的根。
如果您分配任何其他對象類型,則將其作爲資源添加。
通常沒有必要引用data屬性,因爲它是Window的默認屬性,因此所有子項都會自動分配給這個屬性。
7)flags : Qt::WindowFlags
描述:窗口的窗口標誌。
窗口標誌控制窗口在窗口系統中的外觀,它是對話框、彈出窗口還是普通窗口,以及它是否應該有標題欄等等。
如果請求的標誌無法實現,則從此屬性讀取的標誌可能與設置的標誌不同。
8)height : int
描述:定義窗口的高度大小。
9)width : int
描述:定義窗口的寬度大小。
10)x : int
描述:定義窗口的座標x。
11)y : int
描述:定義窗口的座標y。
12)title : string
描述:窗口系統中的窗口標題。
窗口標題可能出現在窗口裝飾的標題區域,這取決於窗口系統和窗口標誌。窗口系統也可以使用它來標識其他上下文中的窗口,比如在任務切換器中。
13)visible : bool
描述:窗口在屏幕上是否可見。
將可見設置爲false與將可見設置爲隱藏相同。
14)visibility : QWindow::Visibility
描述:窗口的屏幕佔用狀態。
可見性是指該窗口在窗口系統中顯示爲正常、最小化、最大化、全屏還是隱藏。
將可見性設置爲自動可見意味着給窗口一個默認可見狀態,根據平臺可能是全屏或窗口。然而,當讀取可視性屬性時,您總是會得到實際的狀態,而不會自動獲得可視性。
當一個窗口不可見時,它的可見性是隱藏的,而將可見性設置爲隱藏與將可見設置爲假是相同的。
15)screen : variant
描述:與窗口相關聯的屏幕。
如果在顯示窗口之前指定,將導致窗口顯示在該屏幕上,除非已經明確設置了窗口位置。屏幕數組。
注意:要確保在創建底層本機窗口時,窗口與所需的屏幕相關聯,請確保儘早設置該屬性,並且其值的設置不會被延遲。這在沒有窗口系統的嵌入式平臺上尤其重要,在這種平臺上,每個屏幕一次只允許有一個窗口。如果新屏幕和舊屏幕是同一個虛擬桌面的一部分,那麼在創建窗口後設置屏幕不會移動窗口。
16)opacity : real
描述:窗口的不透明度。
如果窗口系統支持窗口不透明度,這可以用來淡入淡出窗口,或使其半透明。
1.0或以上的值被視爲完全不透明,而0.0或以下的值被視爲完全透明。中間的值表示兩個極端之間不同程度的透明度。
默認值是1.0。
17)modality : Qt::WindowModality
描述:窗戶的形狀。
模態窗口阻止其他窗口接收輸入事件。可能的值是Qt.NonModal(默認值)、Qt.WindowModal和Qt.ApplicationModal。
18)minimumWidth : int
描述:定義窗口的最小寬的大小。
這是對窗口管理器的一個提示,以防止調整大小低於指定的寬度和高度。
19)minimumHeight : int
描述:定義窗口的最小高的大小。
這是對窗口管理器的一個提示,以防止調整大小低於指定的寬度和高度。
20)maximumWidth : int
描述:定義窗口的最大寬的大小。
這是對窗口管理器的一個提示,以防止調整大小超過指定的寬度和高度。
21)maximumHeight : int
描述:定義窗口的最大大小。
這是對窗口管理器的一個提示,以防止調整大小超過指定的寬度和高度。
Window附加屬性描述
1)Window.active : bool
描述:這個附加屬性告訴窗口是否處於活動狀態。“窗口附加”屬性可以附加到任何項。
舉個例子,改變標籤來顯示窗口的活動狀態:
import QtQuick 2.4
import QtQuick.Window 2.2
Text {
text: Window.active ? "active" : "inactive"
}
2)Window.activeFocusItem : Item
描述:這個附加屬性保存當前具有活動焦點的項,如果沒有具有活動焦點的項,則爲空。“窗口附加”屬性可以附加到任何項。
3)Window.contentItem : Item
描述:這個附加的屬性保存場景的不可見根項,如果根項不在窗口中,則爲空。“窗口附加”屬性可以附加到任何項。
4)Window.height : int
描述:這些附加的屬性保留了項目窗口的大小。“窗口附加”屬性可以附加到任何項。
5)Window.visibility : QWindow::Visibility
描述:這個附加屬性保持當前窗口在窗口系統中顯示爲正常、最小化、最大化、全屏或隱藏。“窗口附加”屬性可以附加到任何項。如果該項不在任何窗口中顯示,則該值將被隱藏。
6)Window.width : int
描述:這些附加的屬性保留了項目窗口的大小。“窗口附加”屬性可以附加到任何項。
7)Window.window : Window
描述:此附加屬性保存該項的窗口。“窗口附加”屬性可以附加到任何項。
信號描述
closing(CloseEvent close)
當用戶試圖關閉窗口時,會發出此信號。
這個信號包括一個閉合參數。關閉。accept屬性默認爲true,這樣就允許關閉窗口;但是您可以實現一個onClosing處理程序並設置close。如果需要在關閉窗口之前做一些其他的事情,accept = false。
相應的處理程序正在關閉。
方法描述
1)alert(int msec)
描述:使警報顯示毫秒。如果msec爲0(默認值),則會無限期地顯示警報,直到窗口再次激活爲止。
在警報狀態下,窗口表明它需要注意,例如通過閃爍或彈跳任務欄條目。
2)close()
描述:關閉窗口。
當調用此方法時,或者當用戶試圖通過標題欄按鈕關閉窗口時,將發出關閉信號。如果沒有處理程序,或者處理程序沒有撤銷關閉權限,窗口將隨後關閉。如果QGuiApplication::quitOnLastWindowClosed屬性爲真,並且沒有打開其他窗口,應用程序將退出。
3)hide()
描述:隱藏窗口。
相當於將可見設置爲false或將可見設置爲隱藏。
4)lower()
描述:降低開窗系統中的窗口。
請求將窗口降低以出現在其他窗口的下面。
5)raise()
描述:在窗口系統中升高窗口。
請求將該窗口提升到其他窗口的上方。
6)requestActivate()
描述:請求激活窗口,即接收鍵盤焦點。
在Qt 5.1中介紹了這種方法。
7)show()
描述:顯示窗口。
這相當於調用showFullScreen()、showMaximized()或showNormal(),這取決於平臺的窗口類型和標誌的默認行爲。
8)showFullScreen()
描述:將窗口顯示爲全屏。
相當於設置全屏可見性。
9)showMaximized()
描述:將窗口顯示爲最大化。
相當於將可見性設置爲最大化。
10)showMinimized()
描述:將窗口顯示爲最小化。
相當於將可見性設置爲最小化。
11)showNormal()
描述:正常顯示窗口,即既不最大化,最小化,也不全屏。
相當於將可見性設置爲window。