Process.MainWindowTitle Process.MainWindowTitle Process.MainWindowTitle Process.MainWindowTitle Property

Definizione

Ottiene la didascalia della finestra principale del processo.Gets the caption of the main window of the process.

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.The main window title of the process.

Eccezioni

La proprietà MainWindowTitle non è definita perché il processo è terminato.The MainWindowTitle property is not defined because the process has exited.

Si sta provando ad accedere alla proprietà MainWindowTitle per un processo in esecuzione in un computer remoto.You are trying to access the MainWindowTitle property for a process that is running on a remote computer. Questa proprietà è disponibile solo per i processi in esecuzione nel computer locale.This property is available only for processes that are running on the local computer.

La piattaforma è Windows 98 o Windows Millennium Edition (Windows Me); impostare UseShellExecute su false per accedere a questa proprietà in Windows 98 e Windows Me.The platform is Windows 98 or Windows Millennium Edition (Windows Me); set UseShellExecute to false to access this property on Windows 98 and Windows Me.

Esempi

Nell'esempio seguente viene avviata un'istanza del blocco note e viene recuperata la didascalia della finestra principale del processo.The following example starts an instance of Notepad and retrieves the caption of the main window of the process.

#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
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 'Main
End Class 'MainWindowTitleClass

Commenti

A un processo è associata una finestra principale solo se il processo dispone di un'interfaccia grafica.A process has a main window associated with it only if the process has a graphical interface. Se il processo associato non dispone di una finestra principale (in modo MainWindowHandle che sia zero) MainWindowTitle , è una stringa vuota ("").If the associated process does not have a main window (so that MainWindowHandle is zero), MainWindowTitle is an empty string (""). Se è stato appena avviato un processo e si vuole usare il titolo della finestra principale, provare a WaitForInputIdle usare il metodo per consentire il completamento dell'avvio del processo, assicurandosi che sia stato creato l'handle della finestra principale.If you have just started a process and want to use its main window title, consider using the WaitForInputIdle method to allow the process to finish starting, ensuring that the main window handle has been created. In caso contrario, il sistema genererà un'eccezione.Otherwise, the system throws an exception.

Nota

La finestra principale è la finestra che attualmente ha lo stato attivo; Si noti che questa operazione potrebbe non essere la finestra primaria per il processo.The main window is the window that currently has the focus; note that this might not be the primary window for the process. È necessario utilizzare il Refresh metodo per aggiornare l' Process oggetto per ottenere l'handle della finestra principale corrente se è stato modificato.You must use the Refresh method to refresh the Process object to get the current main window handle if it has changed.

Sicurezza

LinkDemand
per l'attendibilità totale per il chiamante immediato.for full trust for the immediate caller. Impossibile utilizzare questo membro in codice parzialmente attendibile.This member cannot be used by partially trusted code.

Si applica a