Explorer.AddToSelection メソッド (Outlook)

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

構文

AddToSelection (Item)

Explorer オブジェクトを表す変数。

パラメーター

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

注釈

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

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

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

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

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

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

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

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

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

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

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

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

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