AutomationElement.IsOffscreenProperty 欄位

定義

識別 IsOffscreen 屬性,指出是否在畫面上顯示使用者介面 (UI) 專案。Identifies the IsOffscreen property, which indicates whether the user interface (UI) item is visible on the screen.

public: static initonly System::Windows::Automation::AutomationProperty ^ IsOffscreenProperty;
public static readonly System.Windows.Automation.AutomationProperty IsOffscreenProperty;
 staticval mutable IsOffscreenProperty : System.Windows.Automation.AutomationProperty
Public Shared ReadOnly IsOffscreenProperty As AutomationProperty 

欄位值

AutomationProperty

範例

下列範例會抓取屬性的目前值。The following example retrieves the current value of the property. 如果元素未提供預設值,則會傳回預設值。The default value is returned if the element does not provide one.

bool isControlOffscreen = (bool)
   autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty);
Dim isControlOffscreen As Boolean = _
    CBool(autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty))

下列範例會抓取屬性目前的值,但指定如果專案本身未提供屬性的值, NotSupported 則會傳回而不是預設值。The following example retrieves the current value of the property, but specifies that if the element itself does not provide a value for the property, NotSupported is to be returned instead of a default value.

bool isControlOffscreen1;
object isOffscreenNoDefault =
    autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty, true);
if (isOffscreenNoDefault == AutomationElement.NotSupported)
{
    // TODO Handle the case where you do not wish to proceed using the default value.
}
else
{
    isControlOffscreen1 = (bool)isOffscreenNoDefault;
}
Dim isControlOffscreen1 As Boolean
Dim isOffscreenNoDefault As Object = autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty, True)
If isOffscreenNoDefault Is AutomationElement.NotSupported Then
    ' TODO Handle the case where you do not wish to proceed using the default value.
Else
    isControlOffscreen1 = CBool(isOffscreenNoDefault)
End If

備註

消費者介面自動化用戶端應用程式會使用此識別碼。This identifier is used by UI Automation client applications. 消費者介面自動化提供者應該在中使用對等的識別碼 AutomationElementIdentifiersUI Automation providers should use the equivalent identifier in AutomationElementIdentifiers.

這個屬性也可以從 Current 或屬性中抓取 CachedThis property can also be retrieved from the Current or Cached properties.

傳回值的類型為 Boolean ,而預設值為 falseThe return value is of type Boolean, and the default value is false.

如需此屬性的詳細資訊 true ,請參閱 IsOffscreenFor more information about when this property is true, see IsOffscreen.

適用於