Process.MainWindowTitle Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.Process.dll

Zdroj:

Process.Unix.cs

Získá popis hlavního okna procesu.

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

public string MainWindowTitle { get; }

member this.MainWindowTitle : string

Public ReadOnly Property MainWindowTitle As String

Hodnota vlastnosti

String

Název hlavního okna procesu

Výjimky

InvalidOperationException

Vlastnost MainWindowTitle není definována, protože proces byl ukončen.

NotSupportedException

Pokoušíte se získat přístup MainWindowTitle k vlastnosti pro proces, který je spuštěn na vzdáleném počítači. Tato vlastnost je k dispozici pouze pro procesy spuštěné v místním počítači.

Příklady

Následující příklad spustí instanci Poznámkového bloku a načte popis hlavního okna procesu.

#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

Poznámky

K procesu je přidruženo hlavní okno pouze v případě, že má proces grafické rozhraní. Pokud přidružený proces nemá hlavní okno (takže MainWindowHandle je to nula) nebo pokud systém nemůže určit, že existuje hlavní okno (například na některých unixových platformách), MainWindowTitle je prázdný řetězec ("").

Pokud jste právě zahájili proces a chcete použít jeho název hlavního okna, zvažte použití WaitForInputIdle metody, která umožní dokončení procesu, a ujistěte se, že byl vytvořen popisovač hlavního okna. V opačném případě systém vyvolá výjimku.

Poznámka

Hlavní okno je okno, které má aktuálně fokus. Všimněte si, že toto nemusí být primární okno procesu. Musíte použít metodu Refresh k aktualizaci objektu Process , abyste získali nejaktuálnější popisovač hlavního okna, pokud se změnil.