エクスプローラー。AddToSelection メソッド (Outlook)

アクティブなエクスプ ローラーで選択するには、指定されたMicrosoft Outlookの項目を追加します。

構文

AddToSelection (アイテム)

エクスプローラー オブジェクトを表す変数。

パラメーター

名前 必須 / オプション データ型 説明
Item 必須 オブジェクト型 (Object) アクティブなエクスプローラーの選択範囲に追加するアイテムを指定します。

注釈

アクティブなエクスプローラーでの選択は、エクスプローラーによって返される Selection オブジェクトによって表されます。選択プロパティ。

選択するには、アクティブなエクスプローラーの現在のビューでアイテムを選択可能にする必要があります。 ビューのアイテムが選択可能かどうかを確認するには、 IsItemSelectableInView メソッドを使用します。 ビューに表示されていないアイテムも確認できます。

次の条件では、Outlook では、 AddToSelection メソッドを呼び出したときにエラーが返されます。

  • 指定されたアイテムが、アクティブなエクスプローラーの現在のビューにない。
  • 指定されたアイテムが、アクティブなエクスプローラーの現在のビューで編集中である。
  • 現在のビューがフィルター処理され、フィルターを適用するとアイテムがビューから削除されました。
  • 指定されたアイテムが保存されていない。
  • 指定されたアイテムが StorageItem を表している。
  • アクティブなエクスプローラーに現在のビューが存在しない。

アイテムが選択されていないと現在のビューで選択可能な AddToSelection を呼び出すと、 SelectionChange イベントが発生します。

AddToSelection を呼び出して、選択した項目をビューに表示して、展開または折りたたみできないビュー内のグループをビューがスクロールされることはできません。

次の表は、現在の選択 (Selection.Count プロパティ) と [閲覧] ウィンドウが表示されるかどうかを考慮して、AddToSelection を呼び出した結果を示しています。

既存の Selection.Count 閲覧ウィンドウの表示 結果
0 あり
  • アイテムが選択範囲に追加されます。
  • SelectionChange が発生します。
  • 閲覧ウィンドウに項目が表示されます。
0 なし
  • アイテムが選択範囲に追加されます。
  • SelectionChange が発生します。
>=1 あり
  • アイテムが選択範囲に追加されます。
  • SelectionChange が発生します。
  • ビューが Calendar ビューでない限り、閲覧ウィンドウに表示されるアイテムは変更されません。その場合、AddToSelection を呼び出すと、閲覧ウィンドウに別のアイテムが表示される可能性があります。
>=1 なし
  • アイテムが選択範囲に追加されます。
  • SelectionChange が発生します。

アクティブなエクスプローラーで指定された項目が既に選択されている場合、 AddToSelection を呼び出しても、選択内容は変更されず、 SelectionChange イベントは発生しません。

定期的な予定またはタスクのアイテムを AddToSelection メソッドの引数として指定する場合は、引数を渡す前に、まず IncludeRecurrences プロパティと Items コレクションを使用して繰り返しを展開することによって、オカレンスのインスタンスを取得するようにしてください。 繰り返しを展開せず、系列の出現回数を取得しない場合は、予定またはタスク系列を表すインスタンス変数を渡し、 AddToSelection メソッドによって、出現箇所ではなく系列に対して実行されます。

、選択範囲に項目を追加するのには AddToSelection を使用することができますが、選択範囲に会話のヘッダーを追加することはできません。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。