Process.MainWindowTitle Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Quelle:

Process.Unix.cs

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

InvalidOperationException

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

NotSupportedException

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 instance von Editor gestartet und die Untertitel des Standard Fensters 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

Einem Prozess ist nur ein Standard Fenster zugeordnet, wenn der Prozess über eine grafische Schnittstelle verfügt. Wenn der zugeordnete Prozess kein Standard Fenster hat (also MainWindowHandle null), oder wenn das System nicht feststellen kann, dass ein Standard Fenster vorhanden ist (wie es auf einigen Unix-Plattformen der Fall sein kann), MainWindowTitle ist eine leere Zeichenfolge ("").

Wenn Sie gerade einen Prozess gestartet haben und den Titel des Standard Fensters verwenden möchten, sollten Sie die WaitForInputIdle -Methode verwenden, damit der Prozess gestartet werden kann, um sicherzustellen, dass das Standard Fensterhandle erstellt wurde. Andernfalls löst das System eine Ausnahme aus.

Hinweis

Das Standard Fensters 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 neuesten Stand Standard Fensterhandle zu erhalten, wenn es sich geändert hat.