Process.MainWindowTitle Свойство

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.Process.dll

Сборка:

System.dll

Сборка:

netstandard.dll

Получает заголовок главного окна процесса.

public:
 property System::String ^ MainWindowTitle { System::String ^ get(); };

public string MainWindowTitle { get; }

member this.MainWindowTitle : string

Public ReadOnly Property MainWindowTitle As String

Значение свойства

String

Заголовок главного окна процесса.

Исключения

InvalidOperationException

Свойство MainWindowTitle не определено, так как процесс завершился.

NotSupportedException

Вы пытаетесь получить доступ к свойству MainWindowTitle процесса, запущенного на удаленном компьютере. Это свойство доступно только для процессов, запущенных на локальном компьютере.

Примеры

В следующем примере запускается экземпляр Блокнота и извлекается заголовок главного окна процесса.

#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

Комментарии

Процесс связан с ним главным окном только в том случае, если процесс имеет графический интерфейс. Если связанный процесс не имеет главного окна (поэтому MainWindowHandle он равен нулю), или если система не может определить, что на некоторых платформах Unix есть главное окно (например, на некоторых платформах Unix), MainWindowTitle является пустой строкой ("").

Если вы только что запустили процесс и хотите использовать его заголовок главного окна, рассмотрите возможность использования WaitForInputIdle метода, чтобы завершить процесс, гарантируя создание дескриптора главного окна. В противном случае система создает исключение.

Примечание

Главное окно — это окно, которое в настоящее время имеет фокус; Обратите внимание, что это может быть не основное окно для процесса. Метод необходимо использовать Refresh для обновления Process объекта, чтобы получить самый актуальный дескриптор главного окна, если он изменился.