Window.ShowActivated Window.ShowActivated Window.ShowActivated Window.ShowActivated Property

定義

ウィンドウをアクティブ状態で初期表示するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether a window is activated when first shown.

public:
 property bool ShowActivated { bool get(); void set(bool value); };
public bool ShowActivated { get; set; }
member this.ShowActivated : bool with get, set
Public Property ShowActivated As Boolean

プロパティ値

ウィンドウを初期表示するときにアクティブ化する場合は true。それ以外の場合は falsetrue if a window is activated when first shown; otherwise, false. 既定値は、true です。The default is true.

次の例は、マークアップを使用して、アクティブ化せずにウィンドウを開くように構成する方法を示しています。The following example shows how to use markup to configure a window to be opened without being activated.

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="WindowShowActivatedSnippets.AWindow"
    ShowActivated="False">
using System.Windows;

namespace WindowShowActivatedSnippets
{
    public partial class AWindow : Window
    {
        public AWindow()
        {
            InitializeComponent();
        }
    }
}

Imports System.Windows

Namespace WindowShowActivatedSnippets
    Partial Public Class AWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub
    End Class
End Namespace

次の例は、コードを使用して、ウィンドウをアクティブ化せずに開くように構成する方法を示しています。The following example shows how to use code to configure a window to be opened without it being activated.

AWindow window = new AWindow();
window.ShowActivated = false;
window.Show();
Dim window As New AWindow()
window.ShowActivated = False
window.Show()

注釈

ShowActivatedプロパティがにfalse設定されたウィンドウを開くと、ウィンドウはアクティブ化されActivatedず、ユーザーが手動でウィンドウを選択してアクティブにするまで、そのイベントは発生しません。When a window with its ShowActivated property set to false is opened, the window is not activated and its Activated event is not raised until a user manually activates the window by selecting it. ウィンドウが選択されると、正常にアクティブ化され、非アクティブになります。After the window is selected, it activates and deactivates normally.

ShowActivatedウィンドウが開いたときにアクティブにならないようにするには、をfalse呼び出しShowて、ウィンドウを表示する前にプロパティをShowActivatedfalse設定する必要があります。ウィンドウを表示した後にを設定しても効果はありません。To prevent a window from being activated when it opens, the ShowActivated property must be set to false before the window is shown (by calling Show); setting ShowActivated to false after a window is shown has no effect.

ShowActivated呼びfalse 出すShowDialogことによって、モーダルで開かれたウィンドウでをに設定しても、実際の影響はありません。Setting ShowActivated to false on a window that is opened modally, by calling ShowDialog, has no real impact. モーダルウィンドウはアクティブ化されませんが、モーダルウィンドウを使用すると、ユーザーは開いている他のアプリケーションウィンドウをアクティブにできなくなります。Although the modal window will not be activated, the modal window will prevent the user from activating any other open application windows.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field ShowActivatedProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone

適用対象