Process.MainWindowTitle Proprietà

Definizione

Ottiene la didascalia della finestra principale del processo.

public:
 property System::String ^ MainWindowTitle { System::String ^ get(); };
public string MainWindowTitle { get; }
member this.MainWindowTitle : string
Public ReadOnly Property MainWindowTitle As String

Valore della proprietà

Titolo della finestra principale del processo.

Eccezioni

La MainWindowTitle proprietà non è definita perché il processo è stato chiuso.

Si sta tentando di accedere alla MainWindowTitle proprietà per un processo in esecuzione in un computer remoto. Questa proprietà è disponibile solo per i processi in esecuzione nel computer locale.

Esempio

Nell'esempio seguente viene avviata un'istanza del Blocco note e viene recuperata la didascalia della finestra principale del processo.

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

Commenti

A un processo è associata una finestra principale solo se il processo ha un'interfaccia grafica. Se il processo associato non ha una finestra principale (in modo che MainWindowHandle sia zero) o se il sistema non è in grado di determinare che è presente una finestra principale (ad esempio, potrebbe essere il caso in alcune piattaforme Unix), MainWindowTitle è una stringa vuota ("").

Se è stato appena avviato un processo e si vuole usare il titolo della finestra principale, è consigliabile usare il WaitForInputIdle metodo per consentire al processo di completare l'avvio, assicurandosi che l'handle della finestra principale sia stato creato. In caso contrario, il sistema genera un'eccezione.

Note

La finestra principale è la finestra che attualmente ha lo stato attivo; Si noti che questo potrebbe non essere la finestra principale per il processo. È necessario utilizzare il Refresh metodo per aggiornare l'oggetto per ottenere l'handle Process della finestra principale più aggiornato se è stato modificato.

Si applica a