QML學習筆記(1)-- Window對象

今天學習的內容是Window對象,閱讀過程有任何相關問題,請留言~

更多QML筆記請點擊:開始QML學習之路

目錄

window屬性

Window附加屬性描述

信號描述

方法描述


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。


 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章