Process.MainWindowTitle Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.Process.dll

Zdroj:

Process.Unix.cs

Získá titulek hlavního okna procesu.

public:
 property System::String ^ MainWindowTitle { System::String ^ get(); };

public string MainWindowTitle { get; }

member this.MainWindowTitle : string

Public ReadOnly Property MainWindowTitle As String

Hodnota vlastnosti

String

Název hlavního okna procesu.

Výjimky

InvalidOperationException

Vlastnost není definována MainWindowTitle , protože proces byl ukončen.

NotSupportedException

Pokoušíte se získat přístup k MainWindowTitle vlastnosti procesu, který běží na vzdáleném počítači. Tato vlastnost je k dispozici pouze pro procesy spuštěné v místním počítači.

Příklady

Následující příklad spustí instanci Poznámkového bloku a načte titulek hlavního okna procesu.

using System;
using System.Diagnostics;

class MainWindowTitleClass
{
    public static void Main()
    {
        try
        {
            // Create an instance of process component.
            using (Process myProcess = new Process())
            {
                // Create an instance of 'myProcessStartInfo'.
                ProcessStartInfo myProcessStartInfo = new ProcessStartInfo();
                myProcessStartInfo.FileName = "notepad";
                myProcess.StartInfo = myProcessStartInfo;
                // Start process.
                myProcess.Start();
                // Allow the process to finish starting.
                myProcess.WaitForInputIdle();
                Console.Write("Main window Title : " + myProcess.MainWindowTitle);

                myProcess.CloseMainWindow();
            }
        }
        catch (Exception e)
        {
            Console.Write($" Message : {e.Message}");
        }
    }
}

open System.Diagnostics

try
    // Create an instance of process component.
    use myProcess = new Process()
    // Create an instance of 'myProcessStartInfo'.
    let myProcessStartInfo = ProcessStartInfo()
    myProcessStartInfo.FileName <- "notepad"
    myProcess.StartInfo <- myProcessStartInfo
    // Start process.
    myProcess.Start() |> ignore
    // Allow the process to finish starting.
    myProcess.WaitForInputIdle() |> ignore
    printfn $"Main window Title : {myProcess.MainWindowTitle}"

    myProcess.CloseMainWindow() |> ignore
with e ->
    printfn $" Message : {e.Message}"

Imports System.Diagnostics

Class MainWindowTitleClass
    Public Shared Sub Main()
        Try
            ' Create an instance of process component.
            Using myProcess As New Process()
                ' Create an instance of 'myProcessStartInfo'.
                Dim myProcessStartInfo As New ProcessStartInfo()
                myProcessStartInfo.FileName = "notepad"
                myProcess.StartInfo = myProcessStartInfo
                ' Start process.
                myProcess.Start()
                ' Allow the process to finish starting.
                myProcess.WaitForInputIdle()
                Console.Write("Main window Title : " + myProcess.MainWindowTitle)

                myProcess.CloseMainWindow()
            End Using
        Catch e As Exception
            Console.Write($" Message : {e.Message}")
        End Try
    End Sub
End Class

Poznámky

Proces má přidružené hlavní okno pouze v případě, že má proces grafické rozhraní. Pokud přidružený proces nemá hlavní okno (tedy nula MainWindowHandle ), nebo pokud systém nedokáže určit, že existuje hlavní okno (například na některých platformách Unixu), MainWindowTitle je prázdný řetězec ("").

Pokud jste právě spustili proces a chcete použít jeho hlavní název okna, zvažte použití WaitForInputIdle metody, která umožní dokončení procesu zahájení, a ujistěte se, že byl vytvořen hlavní popisovač okna. V opačném případě systém vyvolá výjimku.

Note

Hlavní okno je okno, které má aktuálně fokus; všimněte si, že to nemusí být primární okno procesu. K aktualizaci objektu Refresh musíte použít metodu Process , abyste získali nejaktuálnější hlavní popisovač okna, pokud se změnil.