SELFLAG 定数

  • [アーティクル]

このトピックでは、アクセス可能なオブジェクトが選択される方法またはフォーカスを取得する方法を指定するために使用される定数値について説明します。 定数は oleacc.h で定義され、 IAccessible::accSelect メソッドと共に使用されます。

次の組み合わせは使用できません。

  • SELFLAG_ADDSELECTION |SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION |SELFLAG_TAKESELECTION
  • SELFLAG_REMOVESELECTION |SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION |SELFLAG_TAKESELECTION

クライアントへの注意: Microsoft Active Accessibility では、編集コントロールとリッチ エディット コントロールに含まれるテキストの選択はサポートされていません。これは、テキストがオブジェクトの Value プロパティの文字列として公開されるためです。

複雑な選択操作を実行する方法については、「 子オブジェクトの選択」を参照してください。

定数/値 Description
SELFLAG_NONE
0
 アクションを実行しません。 Microsoft Active Accessibility では、選択またはフォーカスは変更されません。
SELFLAG_TAKEFOCUS
0x1
 オブジェクトにフォーカスを設定し、選択アンカーにします。 単独で使用されるこのフラグは、選択範囲を変更しません。 この効果は、Windows エクスプローラーまたは複数選択リスト ボックスで Ctrl キーを押しながら方向キーを押して、フォーカスを手動で移動するのと似ています。
STATE_SYSTEM_MULTISELECTABLEを持つオブジェクトでは、SELFLAG_TAKEFOCUSは次の値と組み合わされます。
  • SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
HWND を持つオブジェクトに対して SELFLAG_TAKEFOCUS フラグを指定して IAccessible::accSelect を呼び出すと、オブジェクトの親に既にフォーカスがある場合にのみフラグが有効になります。
SELFLAG_TAKESELECTION
0x2
 オブジェクトを選択し、コンテナー内の他のすべてのオブジェクトから選択範囲を削除します。
SELFLAG_TAKEFOCUSと組み合わされていない限り、このフラグはフォーカスまたは選択アンカーを変更しません。 SELFLAG_TAKESELECTION/SELFLAG_TAKEFOCUSの組み合わせは、Windows エクスプローラーで項目を 1 回クリックする場合と同じです。
このフラグを次のフラグと組み合わせてはいけません。
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
SELFLAG_EXTENDSELECTION
0x4
 選択アンカーとこのオブジェクトの間のすべてのオブジェクトがアンカー オブジェクトの選択状態になるように選択範囲を変更します。 アンカー オブジェクトが選択されていない場合は、すべてのオブジェクトが選択から除外されます。 アンカー オブジェクトが選択されている場合、選択範囲は拡張され、このオブジェクトとその間にあるすべてのオブジェクトが含まれます。 このフラグをSELFLAG_ADDSELECTIONまたはSELFLAG_REMOVESELECTIONと組み合わせて選択状態を設定します。
SELFLAG_TAKEFOCUSと組み合わされていない限り、このフラグはフォーカスまたは選択アンカーを変更しません。 SELFLAG_EXTENDSELECTION/SELFLAG_TAKEFOCUSの組み合わせは、Shift キーを押しながら Windows エクスプローラーで選択されていないオブジェクトをクリックして、項目を手動で選択範囲に追加するのと同じです。
このフラグは、SELFLAG_TAKESELECTIONと組み合わせられません。
SELFLAG_ADDSELECTION
0x8
 オブジェクトを現在の選択範囲に追加します。可能性のある結果は、連続しない選択です。
SELFLAG_TAKEFOCUSと組み合わされていない限り、このフラグはフォーカスまたは選択アンカーを変更しません。 SELFLAG_ADDSELECTION/SELFLAG_TAKEFOCUSの組み合わせは、Ctrl キーを押しながら Windows エクスプローラーで選択されていないオブジェクトをクリックして、項目を手動で選択範囲に追加するのと同じです。
このフラグは、SELFLAG_REMOVESELECTIONまたはSELFLAG_TAKESELECTIONと組み合わせられません。
SELFLAG_REMOVESELECTION
0x10
 現在の選択範囲からオブジェクトを削除します。可能性のある結果は、連続しない選択です。
SELFLAG_TAKEFOCUSと組み合わされていない限り、このフラグはフォーカスまたは選択アンカーを変更しません。 SELFLAG_REMOVESELECTION/SELFLAG_TAKEFOCUSの組み合わせは、Windows エクスプローラーで選択したオブジェクトをクリックしながら Ctrl キーを押しながら選択項目を手動で削除するのと同じです。
このフラグは、SELFLAG_ADDSELECTIONまたはSELFLAG_TAKESELECTIONと組み合わせられません。

要件

要件 値
ヘッダー
Oleacc.h

関連項目

IAccessible::accSelect

子オブジェクトの選択