Process.MainWindowTitle Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.