Process.MainWindowTitle Propiedad

Definición

Obtiene el título de la ventana principal del proceso.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

Valor de propiedad

String

Título de la ventana principal del proceso.The main window title of the process.

Excepciones

La propiedad MainWindowTitle no está definida porque el proceso ha terminado.The MainWindowTitle property is not defined because the process has exited.

Está intentando obtener acceso a la propiedad MainWindowTitle de un proceso que se ejecuta en un equipo remoto.You are trying to access the MainWindowTitle property for a process that is running on a remote computer. Esta propiedad está disponible únicamente para los procesos que se ejecutan en el equipo local.This property is available only for processes that are running on the local computer.

Ejemplos

En el ejemplo siguiente se inicia una instancia del Bloc de notas y se recupera el título de la ventana principal del proceso.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.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

Comentarios

Un proceso tiene asociada una ventana principal solo si el proceso tiene una interfaz gráfica.A process has a main window associated with it only if the process has a graphical interface. Si el proceso asociado no tiene una ventana principal (por lo que MainWindowHandle es cero), o si el sistema no puede determinar que hay una ventana principal (como puede ser el caso en algunas plataformas UNIX), MainWindowTitle es una cadena vacía ("").If the associated process does not have a main window (so that MainWindowHandle is zero), or if the system can't determine that there's a main window (such as may be the case on some Unix platforms), MainWindowTitle is an empty string ("").

Si acaba de iniciar un proceso y desea usar el título de la ventana principal, considere la posibilidad de usar el WaitForInputIdle método para permitir que el proceso termine de iniciarse, asegurándose de que se ha creado el identificador de la ventana principal.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. De lo contrario, el sistema produce una excepción.Otherwise, the system throws an exception.

Nota

La ventana principal es la ventana que tiene actualmente el foco. Tenga en cuenta que esto podría no ser la ventana principal del proceso.The main window is the window that currently has the focus; note that this might not be the primary window for the process. Debe utilizar el Refresh método para actualizar el Process objeto con el fin de obtener el identificador de ventana principal más actualizado si ha cambiado.You must use the Refresh method to refresh the Process object to get the most up to date main window handle if it has changed.

Se aplica a