Rule.Execute メソッド (Outlook)
一時的な操作としてルールを適用します。
構文
expression. Execute
( _ShowProgress_
, _Folder_
, _IncludeSubfolders_
, _RuleExecuteOption_
)
式Rule オブジェクトを表す変数。
パラメーター
名前 | 必須 / オプション | データ型 | 説明 |
---|---|---|---|
ShowProgress | 省略可能 | Boolean | True のルールが実行されると、[進行状況] ダイアログ ボックスを表示するのには false を指定 ] ダイアログ ボックスを表示せずにルールを実行します。 |
Folder | 省略可能 | Folder | ルールを適用するフォルダーを表します。 |
IncludeSubfolders | 省略可能 | Boolean | TrueFolderパラメーターで指定されたフォルダーのサブフォルダーにルールを適用するには False が、そのフォルダー、サブフォルダーではなくにのみルールを適用します。 |
RuleExecuteOption | 省略可能 | OlRuleExecuteOption | Folder パラメーターと IncludeSubfolders パラメーターで指定されたフォルダーまたはフォルダー内の読み取り、未読、またはすべてのメッセージにルールを適用するかどうかを表します。 |
注釈
Rule.Execute を使用して、Rule.Enabled が True かどうかに関係なく、ルールを 1 回限りの操作として適用します。 ルールを一貫して適用し、現在のセッション以降もルールを持続させるには、Rule.Enabled の後に Rules.Save を使用します。
Execute メソッドのパラメーターはオプションです。 パラメーターを指定しない場合、ルールは受信トレイ内のすべてのメッセージに適用されますが、受信トレイのサブフォルダーには適用されません。 省略可能な引数の既定値は次のとおりです。
パラメーター | 既定値 |
---|---|
Folder | 受信トレイ |
IncludeSubfolders | False |
RuleExecuteOption | OlRuleExecuteOption.olRuleExecuteAllMessages |
ShowProgres が True で、ユーザーが進行状況ダイアログ ボックスを取り消した場合、ルールとアラート ウィザードを使用してルールの実行を取り消した場合と同じ方法でルールの実行が取り消されます。 Executeでは、ユーザーが進行状況ダイアログをキャンセルしたときにエラーが返されます。
進捗ダイアログ ボックスを使用する代わりに独自の進捗ユーザー インターフェイスを表示する場合は、ルールの実行の開始と終了を示すイベントがない点に注意してください。
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。