Process.MainWindowTitle Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Origine:

Process.Unix.cs

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à

String

Titolo della finestra principale del processo.

Eccezioni

InvalidOperationException

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

NotSupportedException

Si sta provando ad accedere alla proprietà MainWindowTitle 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 recuperato il didascalia della finestra principale del processo.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   try
   {
      
      // Create an instance of process component.
      Process^ myProcess = gcnew Process;
      
      // Create an instance of 'myProcessStartInfo'.
      ProcessStartInfo^ myProcessStartInfo = gcnew ProcessStartInfo;
      myProcessStartInfo->FileName = "notepad";
      myProcess->StartInfo = myProcessStartInfo;
      
      // Start process.
      myProcess->Start();
      
      // Allow the process to finish starting.
      myProcess->WaitForInputIdle();
      Console::Write( "Main window Title : {0}", myProcess->MainWindowTitle );
      myProcess->CloseMainWindow();
      myProcess->Close();
   }
   catch ( Exception^ e ) 
   {
      Console::Write( " Message : {0}", e->Message );
   }

}

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}");
        }
    }
}

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

Un processo ha una finestra principale associata solo se il processo ha un'interfaccia grafica. Se il processo associato non dispone di una finestra principale (in modo MainWindowHandle che sia zero) o se il sistema non può determinare che esiste 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 principale della finestra, è 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 genererà un'eccezione.

Nota

La finestra principale è la finestra che attualmente ha lo stato attivo; Si noti che potrebbe non essere la finestra primaria per il processo. È necessario usare il metodo per aggiornare l'oggetto RefreshProcess per ottenere la gestione della finestra principale più aggiornata se è stata modificata.