Process.MainWindowTitle Eigenschaft

Definition

Ruft die Beschriftung des Hauptfensters des Prozesses ab.

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

Eigenschaftswert

String

Der Titel des Hauptfensters des Prozesses.

Ausnahmen

Die MainWindowTitle-Eigenschaft ist nicht definiert, da der Prozess beendet wurde.

Sie versuchen, auf die MainWindowTitle-Eigenschaft für einen Prozess zuzugreifen, der auf einem Remotecomputer ausgeführt wird. Diese Eigenschaft ist nur für Prozesse verfügbar, die auf dem lokalen Computer ausgeführt werden.

Beispiele

Im folgenden Beispiel wird eine Instanz von Editor gestartet und die Beschriftung des Hauptfensters des Prozesses abgerufen.

#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

Hinweise

Ein Prozess verfügt über ein Hauptfenster, das es nur zugeordnet ist, wenn der Prozess über eine grafische Schnittstelle verfügt. Wenn der zugeordnete Prozess kein Hauptfenster hat (so MainWindowHandle dass null ist), MainWindowTitle oder wenn das System nicht bestimmen kann, dass ein Hauptfenster vorhanden ist (z. B. bei einigen Unix-Plattformen), ist eine leere Zeichenfolge ("").

Wenn Sie gerade einen Prozess gestartet haben und den Hauptfenstertitel verwenden möchten, sollten Sie die Methode verwenden WaitForInputIdle , um den Startvorgang zu ermöglichen, um sicherzustellen, dass der Hauptfensterpunkt erstellt wurde. Andernfalls löst das System eine Ausnahme aus.

Hinweis

Das Hauptfenster ist das Fenster, das derzeit den Fokus hat; Beachten Sie, dass dies möglicherweise nicht das primäre Fenster für den Prozess ist. Sie müssen die Refresh Methode verwenden, um das Process Objekt zu aktualisieren, um den aktuellen Hauptfensterhandpunkt abzurufen, wenn es geändert wurde.

Gilt für