Process.MainWindowTitle Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Der Hauptfenstertitel des Prozesses.
Ausnahmen
Die MainWindowTitle Eigenschaft ist nicht definiert, da der Prozess beendet wurde.
Sie versuchen, auf die Eigenschaft für einen Prozess zuzugreifen, der MainWindowTitle 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 des Editor gestartet und die Beschriftung des Hauptfensters des Prozesses abgerufen.
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
Hinweise
Einem Prozess ist ein Hauptfenster nur zugeordnet, wenn der Prozess über eine grafische Benutzeroberfläche verfügt. Wenn der zugeordnete Prozess nicht über ein Hauptfenster verfügt (d. h. null MainWindowHandle ), oder wenn das System nicht bestimmen kann, dass ein Hauptfenster vorhanden ist (z. B. auf einigen Unix-Plattformen MainWindowTitle ), ist eine leere Zeichenfolge ("").
Wenn Sie gerade einen Prozess gestartet haben und den Hauptfenstertitel verwenden möchten, sollten Sie die WaitForInputIdle Methode verwenden, damit der Prozess gestartet werden kann, und stellen Sie sicher, dass das Hauptfensterhandle erstellt wurde. Andernfalls löst das System eine Ausnahme aus.
Note
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 das aktuelle Hauptfensterhandle abzurufen, wenn es geändert wurde.