Application Application Application Application Class

定義

Windows メッセージを処理するために、アプリケーションを開始および停止するメソッドや、アプリケーションの情報を取得するためのプロパティなど、アプリケーションを管理するための static メソッドおよびプロパティを提供します。Provides static methods and properties to manage an application, such as methods to start and stop an application, to process Windows messages, and properties to get information about an application. このクラスは継承できません。This class cannot be inherited.

public ref class Application sealed
public sealed class Application
type Application = class
Public NotInheritable Class Application
継承
ApplicationApplicationApplicationApplication

次のコード例は、フォームのリスト ボックス内の番号を一覧表示します。The following code example lists numbers in a list box on a form. クリックするたびにbutton1アプリケーションの一覧に別の番号を追加します。Each time you click button1, the application adds another number to the list.

Mainメソッド呼び出しRunフォームを作成すると、アプリケーションを起動するlistBox1button1します。The Main method calls Run to start the application, which creates the form, listBox1 and button1. ユーザーがクリックするとbutton1button1_Clickメソッドが表示されます、MessageBoxします。When the user clicks button1, the button1_Click method displays a MessageBox. ユーザーがクリックした場合No上、 MessageBoxbutton1_Clickメソッドの一覧に数値を追加します。If the user clicks No on the MessageBox, the button1_Click method adds a number to the list. ユーザーがクリックした場合Yes、アプリケーション呼び出しExitをキューに残りのすべてのメッセージを処理し、終了します。If the user clicks Yes, the application calls Exit to process all remaining messages in the queue and then to quit.

注意

呼び出しExit部分信頼では失敗します。The call to Exit will fail in partial trust.

public ref class Form1: public System::Windows::Forms::Form
{
private:
   Button^ button1;
   ListBox^ listBox1;

public:
   Form1()
   {
      button1 = gcnew Button;
      button1->Left = 200;
      button1->Text =  "Exit";
      button1->Click += gcnew EventHandler( this, &Form1::button1_Click );
      listBox1 = gcnew ListBox;
      this->Controls->Add( button1 );
      this->Controls->Add( listBox1 );
   }

private:
   void Form1::button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      int count = 1;
      
      // Check to see whether the user wants to exit 
      // the application. If not, add a number to the list box.
      while ( MessageBox::Show(  "Exit application?",  "", MessageBoxButtons::YesNo ) == ::DialogResult::No )
      {
         listBox1->Items->Add( count );
         count += 1;
      }

      
      // The user wants to exit the application. 
      // Close everything down.
      Application::Exit();
   }

};

int main()
{
   
   // Starts the application.
   Application::Run( gcnew Form1 );
}

public class Form1 : Form
{
    [STAThread]
    public static void Main()
    {
        // Start the application.
        Application.Run(new Form1());
    }

    private Button button1;
    private ListBox listBox1;

    public Form1()
    {
        button1 = new Button();
        button1.Left = 200;
        button1.Text = "Exit";
        button1.Click += new EventHandler(button1_Click);

        listBox1 = new ListBox();
        this.Controls.Add(button1);
        this.Controls.Add(listBox1);
    }

    private void button1_Click(object sender, System.EventArgs e)
    {
        int count = 1;
        // Check to see whether the user wants to exit the application.
        // If not, add a number to the list box.
        while (MessageBox.Show("Exit application?", "", 
            MessageBoxButtons.YesNo)==DialogResult.No)
        {
            listBox1.Items.Add(count);
            count += 1;
        }

        // The user wants to exit the application. 
        // Close everything down.
        Application.Exit();
    }
}
Public Class Form1 
    Inherits Form

    <STAThread()> _
     Shared Sub Main()
        ' Start the application.
        Application.Run(New Form1)
    End Sub

    Private WithEvents button1 As Button
    Private WithEvents listBox1 As ListBox

    Public Sub New()
        button1 = New Button
        button1.Left = 200
        button1.Text = "Exit"

        listBox1 = New ListBox
        Me.Controls.Add(button1)
        Me.Controls.Add(listBox1)
    End Sub

    Private Sub button1_Click(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles button1.Click
        Dim count As Integer = 1
        ' Check to see whether the user wants to exit the application.
        ' If not, add a number to the list box.
        While (MessageBox.Show("Exit application?", "", _
            MessageBoxButtons.YesNo) = DialogResult.No)

            listBox1.Items.Add(count)
            count += 1

        End While

        ' The user wants to exit the application. 
        ' Close everything down.
        Application.Exit()
    End Sub

End Class

注釈

Applicationクラスのアプリケーションとスレッドを開始および停止して、次のように、Windows メッセージを処理するメソッドがあります。The Application class has methods to start and stop applications and threads, and to process Windows messages, as follows:

  • Run 現在のスレッドで、アプリケーション メッセージ ループを開始し、必要に応じて、フォームを表示します。Run starts an application message loop on the current thread and, optionally, makes a form visible.

  • Exit またはExitThreadメッセージ ループを停止します。Exit or ExitThread stops a message loop.

  • DoEvents ループになっているプログラムは、メッセージを処理します。DoEvents processes messages while your program is in a loop.

  • AddMessageFilter Windows メッセージを監視するアプリケーション メッセージ ポンプにメッセージ フィルターを追加します。AddMessageFilter adds a message filter to the application message pump to monitor Windows messages.

  • IMessageFilter により、イベントの発生を停止またはイベント ハンドラーを呼び出す前に特別な操作を実行できます。IMessageFilter lets you stop an event from being raised or perform special operations before invoking an event handler.

このクラスはCurrentCultureCurrentInputLanguageカルチャの現在のスレッドの情報を取得または設定するプロパティ。This class has CurrentCulture and CurrentInputLanguage properties to get or set culture information for the current thread.

このクラスのインスタンスを作成することはできません。You cannot create an instance of this class.

プロパティ

AllowQuit AllowQuit AllowQuit AllowQuit

呼び出し元がこのアプリケーションを終了できるかどうかを示す値を取得します。Gets a value indicating whether the caller can quit this application.

CommonAppDataPath CommonAppDataPath CommonAppDataPath CommonAppDataPath

すべてのユーザーが共有するアプリケーション データのパスを取得します。Gets the path for the application data that is shared among all users.

CommonAppDataRegistry CommonAppDataRegistry CommonAppDataRegistry CommonAppDataRegistry

すべてのユーザーが共有するアプリケーション データのレジストリ キーを取得します。Gets the registry key for the application data that is shared among all users.

CompanyName CompanyName CompanyName CompanyName

アプリケーションに関連付けられている会社名を取得します。Gets the company name associated with the application.

CurrentCulture CurrentCulture CurrentCulture CurrentCulture

現在のスレッドのカルチャ情報を取得または設定します。Gets or sets the culture information for the current thread.

CurrentInputLanguage CurrentInputLanguage CurrentInputLanguage CurrentInputLanguage

現在のスレッドの現在の入力言語を取得または設定します。Gets or sets the current input language for the current thread.

ExecutablePath ExecutablePath ExecutablePath ExecutablePath

アプリケーションを開始した実行可能ファイルのパスを、ファイル名を含めて取得します。Gets the path for the executable file that started the application, including the executable name.

HighDpiMode HighDpiMode HighDpiMode HighDpiMode
LocalUserAppDataPath LocalUserAppDataPath LocalUserAppDataPath LocalUserAppDataPath

ローカルで非ローミング ユーザーのアプリケーション データのパスを取得します。Gets the path for the application data of a local, non-roaming user.

MessageLoop MessageLoop MessageLoop MessageLoop

このスレッドにメッセージ ループが存在するかどうかを示す値を取得します。Gets a value indicating whether a message loop exists on this thread.

OpenForms OpenForms OpenForms OpenForms

アプリケーションが所有している、開かれたフォームのコレクションを取得します。Gets a collection of open forms owned by the application.

ProductName ProductName ProductName ProductName

このアプリケーションに関連付けられている製品名を取得します。Gets the product name associated with this application.

ProductVersion ProductVersion ProductVersion ProductVersion

このアプリケーションに関連付けられている製品のバージョンを取得します。Gets the product version associated with this application.

RenderWithVisualStyles RenderWithVisualStyles RenderWithVisualStyles RenderWithVisualStyles

現在のアプリケーションが visual スタイルを使用してコントロールを描画しているかどうかを示す値を取得します。Gets a value specifying whether the current application is drawing controls with visual styles.

SafeTopLevelCaptionFormat SafeTopLevelCaptionFormat SafeTopLevelCaptionFormat SafeTopLevelCaptionFormat

警告見出しと共に表示された場合にトップレベル ウィンドウのキャプションに適用する書式指定文字列を取得または設定します。Gets or sets the format string to apply to top-level window captions when they are displayed with a warning banner.

StartupPath StartupPath StartupPath StartupPath

アプリケーションを開始した実行可能ファイルの、ファイル名を含まないパスを取得します。Gets the path for the executable file that started the application, not including the executable name.

UserAppDataPath UserAppDataPath UserAppDataPath UserAppDataPath

ユーザーのアプリケーション データのパスを取得します。Gets the path for the application data of a user.

UserAppDataRegistry UserAppDataRegistry UserAppDataRegistry UserAppDataRegistry

ユーザーのアプリケーション データのレジストリ キーを取得します。Gets the registry key for the application data of a user.

UseWaitCursor UseWaitCursor UseWaitCursor UseWaitCursor

アプリケーションの開いているフォームすべてに待機カーソルを使用するかどうかについて、取得または設定します。Gets or sets whether the wait cursor is used for all open forms of the application.

VisualStyleState VisualStyleState VisualStyleState VisualStyleState

アプリケーション ウィンドウに visual スタイルをどのように適用するかを指定する値を取得します。Gets a value that specifies how visual styles are applied to application windows.

メソッド

AddMessageFilter(IMessageFilter) AddMessageFilter(IMessageFilter) AddMessageFilter(IMessageFilter) AddMessageFilter(IMessageFilter)

メッセージ フィルターを追加して、ルーティング先にルーティングされる Windows メッセージを監視します。Adds a message filter to monitor Windows messages as they are routed to their destinations.

DoEvents() DoEvents() DoEvents() DoEvents()

メッセージ キューに現在ある Windows メッセージをすべて処理します。Processes all Windows messages currently in the message queue.

EnableVisualStyles() EnableVisualStyles() EnableVisualStyles() EnableVisualStyles()

アプリケーションで visual スタイルを有効にします。Enables visual styles for the application.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Exit() Exit() Exit() Exit()

終了する必要があるすべてのメッセージ ポンプを通知し、メッセージが処理されると、すべてのアプリケーション ウィンドウを閉じます。Informs all message pumps that they must terminate, and then closes all application windows after the messages have been processed.

Exit(CancelEventArgs) Exit(CancelEventArgs) Exit(CancelEventArgs) Exit(CancelEventArgs)

終了する必要があるすべてのメッセージ ポンプを通知し、メッセージが処理されると、すべてのアプリケーション ウィンドウを閉じます。Informs all message pumps that they must terminate, and then closes all application windows after the messages have been processed.

ExitThread() ExitThread() ExitThread() ExitThread()

現在のスレッドのメッセージ ループを終了し、スレッドのウィンドウをすべて閉じます。Exits the message loop on the current thread and closes all windows on the thread.

FilterMessage(Message) FilterMessage(Message) FilterMessage(Message) FilterMessage(Message)

ウィンドウ メッセージに対してフィルターを実行し、変更したメッセージのコピーを返します。Runs any filters against a window message, and returns a copy of the modified message.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OleRequired() OleRequired() OleRequired() OleRequired()

現在のスレッドで OLE を初期化します。Initializes OLE on the current thread.

OnThreadException(Exception) OnThreadException(Exception) OnThreadException(Exception) OnThreadException(Exception)

ThreadException イベントを発生させます。Raises the ThreadException event.

RaiseIdle(EventArgs) RaiseIdle(EventArgs) RaiseIdle(EventArgs) RaiseIdle(EventArgs)

ホストされているシナリオで Idle イベントを発生させます。Raises the Idle event in hosted scenarios.

RegisterMessageLoop(Application+MessageLoopCallback) RegisterMessageLoop(Application+MessageLoopCallback) RegisterMessageLoop(Application+MessageLoopCallback) RegisterMessageLoop(Application+MessageLoopCallback)

メッセージ ループがホストされている環境で実行されているかどうかをチェックするためのコールバックを登録します。Registers a callback for checking whether the message loop is running in hosted environments.

RemoveMessageFilter(IMessageFilter) RemoveMessageFilter(IMessageFilter) RemoveMessageFilter(IMessageFilter) RemoveMessageFilter(IMessageFilter)

アプリケーションのメッセージ ポンプからメッセージ フィルターを削除します。Removes a message filter from the message pump of the application.

Restart() Restart() Restart() Restart()

アプリケーションをシャット ダウンし、直後に新しいインストールを開始します。Shuts down the application and starts a new instance immediately.

Run() Run() Run() Run()

現在のスレッドで標準のアプリケーション メッセージ ループの実行を、フォームなしで開始します。Begins running a standard application message loop on the current thread, without a form.

Run(ApplicationContext) Run(ApplicationContext) Run(ApplicationContext) Run(ApplicationContext)

ApplicationContext を使用して、現在のスレッドで標準のアプリケーション メッセージ ループの実行を開始します。Begins running a standard application message loop on the current thread, with an ApplicationContext.

Run(Form) Run(Form) Run(Form) Run(Form)

現在のスレッドで標準のアプリケーション メッセージ ループの実行を開始し、指定したフォームを表示します。Begins running a standard application message loop on the current thread, and makes the specified form visible.

SetCompatibleTextRenderingDefault(Boolean) SetCompatibleTextRenderingDefault(Boolean) SetCompatibleTextRenderingDefault(Boolean) SetCompatibleTextRenderingDefault(Boolean)

特定のコントロールで定義された UseCompatibleTextRendering プロパティにアプリケーション全体で有効な既定値を設定します。Sets the application-wide default for the UseCompatibleTextRendering property defined on certain controls.

SetHighDpiMode(HighDpiMode) SetHighDpiMode(HighDpiMode) SetHighDpiMode(HighDpiMode) SetHighDpiMode(HighDpiMode)
SetSuspendState(PowerState, Boolean, Boolean) SetSuspendState(PowerState, Boolean, Boolean) SetSuspendState(PowerState, Boolean, Boolean) SetSuspendState(PowerState, Boolean, Boolean)

システムを中断または休止状態にするか、システムが中断または休止状態になるよう要求します。Suspends or hibernates the system, or requests that the system be suspended or hibernated.

SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode) SetUnhandledExceptionMode(UnhandledExceptionMode)

未処理の例外への対応方法をアプリケーションに指示します。Instructs the application how to respond to unhandled exceptions.

SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

未処理の例外に応答する方法をアプリケーションに指示し、オプションでスレッド固有の動作を適用します。Instructs the application how to respond to unhandled exceptions, optionally applying thread-specific behavior.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
UnregisterMessageLoop() UnregisterMessageLoop() UnregisterMessageLoop() UnregisterMessageLoop()

RegisterMessageLoop(Application+MessageLoopCallback) によって行われたメッセージ ループ コールバックを登録解除します。Unregisters the message loop callback made with RegisterMessageLoop(Application+MessageLoopCallback).

イベント

ApplicationExit ApplicationExit ApplicationExit ApplicationExit

アプリケーションをシャットダウンしようとすると発生します。Occurs when the application is about to shut down.

EnterThreadModal EnterThreadModal EnterThreadModal EnterThreadModal

アプリケーションがモーダル状態に入ろうとすると発生します。Occurs when the application is about to enter a modal state.

Idle Idle Idle Idle

アプリケーションが処理を完了し、アイドル状態に入ろうとすると発生します。Occurs when the application finishes processing and is about to enter the idle state.

LeaveThreadModal LeaveThreadModal LeaveThreadModal LeaveThreadModal

アプリケーションがモーダル状態を終了するときに発生します。Occurs when the application is about to leave a modal state.

ThreadException ThreadException ThreadException ThreadException

トラップされないスレッドの例外がスローされると、発生します。Occurs when an untrapped thread exception is thrown.

ThreadExit ThreadExit ThreadExit ThreadExit

スレッドをシャットダウンしようとすると発生します。Occurs when a thread is about to shut down. アプリケーションのメイン スレッドをシャットダウンしようとするとこのイベントが発生し、続いて ApplicationExit イベントが発生します。When the main thread for an application is about to be shut down, this event is raised first, followed by an ApplicationExit event.

適用対象