Process.MainWindowTitle Tulajdonság

Definíció

Névtér:

System.Diagnostics

Szerelvények:

netstandard.dll, System.Diagnostics.Process.dll

Forrás:

Process.Unix.cs

Lekéri a folyamat főablakának feliratát.

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

public string MainWindowTitle { get; }

member this.MainWindowTitle : string

Public ReadOnly Property MainWindowTitle As String

Tulajdonság értéke

String

A folyamat főablakának címe.

Kivételek

InvalidOperationException

A MainWindowTitle tulajdonság nincs definiálva, mert a folyamat kilépett.

NotSupportedException

Egy távoli számítógépen futó folyamat tulajdonságához próbál hozzáférni MainWindowTitle . Ez a tulajdonság csak a helyi számítógépen futó folyamatokhoz érhető el.

Példák

Az alábbi példa elindítja a Jegyzettömb egy példányát, és lekéri a folyamat fő ablakának feliratát.

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

Megjegyzések

Egy folyamathoz csak akkor van főablak társítva, ha a folyamat grafikus felülettel rendelkezik. Ha a társított folyamat nem rendelkezik főablakkal (tehát MainWindowHandle nulla), vagy ha a rendszer nem tudja megállapítani, hogy van-e főablak (például egyes Unix-platformok esetében), MainWindowTitle akkor üres sztring ("").

Ha éppen most indított el egy folyamatot, és a főablak címét szeretné használni, fontolja meg a WaitForInputIdle metódus használatát a folyamat elindításának engedélyezéséhez, biztosítva a fő ablakfogópont létrehozását. Ellenkező esetben a rendszer kivételt jelez.

Note

A főablak az az ablak, amely jelenleg a fókuszban van; vegye figyelembe, hogy lehet, hogy nem ez a folyamat elsődleges ablaka. A módszerrel frissítenie kell Refresh az Process objektumot, hogy a legfrissebb főablak-leírót kapja, ha az megváltozott.