AutomationElement.IsOffscreenProperty フィールド

定義

名前空間:
System.Windows.Automation
アセンブリ:
UIAutomationClient.dll

IsOffscreen プロパティを識別します。これは、ユーザー インターフェイス (UI) 項目が画面上に表示されるかどうかを示します。

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

例

次の例では、プロパティの現在の値を取得します。 要素に既定値が指定されていない場合は、既定値が返されます。

bool isControlOffscreen = (bool)
   autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty);

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

次の例では、プロパティの現在の値を取得しますが、要素自体がプロパティの値を提供しない場合は、既定値ではなく NotSupported を返すように指定します。

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

注釈

この識別子は、クライアント アプリケーションUI オートメーション使用されます。 UI オートメーションプロバイダーは、AutomationElementIdentifiers で同等の識別子を使用する必要があります。

このプロパティは、 Current または Cached プロパティから取得することもできます。

戻り値は Boolean型であり、既定値は false。

このプロパティが trueされるタイミングの詳細については、「 IsOffscreen」を参照してください。

適用対象

こちらもご覧ください