NewMailEx イベント (Outlook)Application.NewMailEx event (Outlook)

受信トレイに新しいアイテムを受信すると発生します。Occurs when a new item is received in the Inbox.


expression. NewMailEx( _EntryIDCollection_ )NewMailEx( _EntryIDCollection_ )

Application オブジェクトを表す変数。expression A variable that represents an Application object.


名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
EntryIDCollectionEntryIDCollection 必須Required StringString 受信トレイに受信したアイテムのエントリ ID を表す文字列です。A string representing an Entry ID of an item received in the Inbox.


このイベントは、Microsoft Outlook によって処理されたすべての受信アイテムに対して1回発生します。This event fires once for every received item that is processed by Microsoft Outlook. アイテムは、 MailItemMeetingItemSharingItem など、さまざまな種類のアイテムのいずれかにすることができます。The item can be one of several different item types, for example, MailItem, MeetingItem, or SharingItem. _Entryidscollection_文字列には、そのアイテムに対応するエントリ ID が含まれています。The EntryIDsCollection string contains the Entry ID that corresponds to that item. この動作は、 _Entryidcollection_に、前回のイベント発生後に受信トレイで受信したすべてのアイテムのコンマ区切りのエントリ id のリストが含まれていた場合に、以前のバージョンのイベントから変更されています。Note that this behavior has changed from earlier versions of the event when the EntryIDCollection contained a list of comma-delimited Entry IDs of all the items received in the Inbox since the last time the event was fired.

このイベントは Microsoft Visual Basic Scripting Edition (VBScript) では使用できません。This event is not available in Microsoft Visual Basic Scripting Edition (VBScript).

このイベントは、受信したメッセージに関する通知を提供する電子メールアカウント (Microsoft Exchange Server、POP3 アカウントなど) に対して発生します。This event fires for email accounts that provide notifications for received messages, such as Microsoft Exchange Server and POP3 accounts.

Newmailexイベントは、受信トレイに新しいメッセージが到着したとき、およびクライアントルールの処理が行われる前に発生します。The NewMailEx event fires when a new message arrives in the Inbox and before client rule processing occurs. _Entryidcollection_配列で返されたエントリ ID を使用して、 GetItemFromID メソッドを呼び出し、アイテムを処理することができます。You can use the Entry ID returned in the EntryIDCollection array to call the NameSpace.GetItemFromID method and process the item. このメソッドは、Outlook のパフォーマンスへの影響が最小限になるよう、注意して使用する必要があります。Use this method with caution to minimize the impact on Outlook performance. ただし、クライアント コンピューターの設定によっては、新しいメッセージが受信トレイに配信された後に、迷惑メールのフィルター処理や、クライアント ルールによって新しいメッセージを受信トレイから別のフォルダーへ移動する処理などが、非同期に実行される場合もあります。However, depending on the setup on the client computer, after a new message arrives in the Inbox, processes like spam filtering and client rules that move the new message from the Inbox to another folder can occur asynchronously. このため、このイベントの発生後に、受信トレイ内のアイテムが必ず 1 つ増えるとは限りません。You should not assume that after these events fire, you will always get a one-item increase in the number of items in the Inbox.

Exchange Server アカウントを使用するユーザーの場合、Exchange キャッシュ モードを使用しているかどうかにかかわらず、このイベントは Outlook の起動後にサーバーに配信されるメッセージに対してのみ発生します。For users with an Exchange Server account (non-Cached Exchange Mode or Cached Exchange Mode), the event will fire only for messages that arrive at the server after Outlook has started. Exchange キャッシュ モードで Outlook の起動直後に同期されるメッセージや、非 Exchange キャッシュ モードで Outlook の起動時に既にサーバーに存在するメッセージに対しては、このイベントは発生しません。The event will not fire for messages that are synchronized in Cached Exchange Mode immediately after Outlook starts, nor for messages that are already on the server when Outlook starts in non-Cached Exchange Mode.

Exchange キャッシュ モードを使用するユーザーの場合、メッセージの受信時に Outlook が実行されていれば、すべての設定 ([ アイテムを完全にダウンロード]、[ ヘッダーをダウンロード]、および [ ヘッダーに続いてアイテムを完全にダウンロード]) でこのイベントが発生します。For users using Cached Exchange Mode, the event will fire in all settings, provided that Outlook is running when the message is received: Download Full Items, Download Headers, and Download Headers and then Full Items.

関連項目See also

Application オブジェクトApplication Object

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.