AccessibleEvents 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

AccessibleEvents 列挙体

ユーザー補助アプリケーションがレポートするイベントを指定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Enumeration AccessibleEvents

Visual Basic (使用法)

Dim instance As AccessibleEvents

public enum AccessibleEvents

C++

public enum class AccessibleEvents

public enum AccessibleEvents

JScript

public enum AccessibleEvents

メンバ

	メンバ名	説明
	AcceleratorChange	オブジェクトの KeyboardShortcut プロパティが変更されました。サーバーアプリケーションは、所有するユーザー補助オブジェクトにイベントを送信します。
	Create	オブジェクトが作成されました。オペレーティングシステムは、カレット、ヘッダーコントロール、リストビューコントロール、タブコントロール、ツールバーコントロール、ツリービューコントロール、ウィンドウオブジェクトの各ユーザーインターフェイス要素にイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。サーバーは、このイベントを、親オブジェクトに送信する前に、そのすべての子オブジェクトに送信する必要があります。また、親オブジェクトがイベントを送信するときに、すべての子オブジェクトが完全に作成され、クライアントからの呼び出しを受け入れる準備ができていることを確認する必要があります。
	DefaultActionChange	オブジェクトの DefaultAction プロパティが変更されました。システムは、ダイアログボックスにこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。そのため、サーバーアプリケーションは、このイベントを子オブジェクトに送信する必要はありません。隠しオブジェクトには AccessibleStates.Invisible の状態が設定されており、表示されているオブジェクトにはこの状態が設定されていません。AccessibleEvents.Hide のタイプのイベントは、AccessibleStates.Invisible の状態が設定されたことを示します。そのため、この場合は、サーバーが AccessibleEvents.StateChange イベントを送信する必要はありません。
	DescriptionChange	オブジェクトの Description プロパティが変更されました。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。
	Destroy	オブジェクトが破棄されました。システムは、カレット、ヘッダーコントロール、リストビューコントロール、タブコントロール、ツールバーコントロール、ツリービューコントロール、ウィンドウオブジェクトの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。このイベントは、子オブジェクトに送信される場合と送信されない場合があります。ただし、クライアントは、親オブジェクトがこのイベントを送信した時点で、その子オブジェクトはすべて破棄されていると判断できます。
	Focus	オブジェクトがキーボードフォーカスを受け取りました。システムは、リストビューコントロール、メニューバー、ショートカットメニュー、スイッチウィンドウ、タブコントロール、ツリービューコントロール、ウィンドウオブジェクトの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。
	HelpChange	オブジェクトの Help プロパティが変更されました。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。
	Hide	オブジェクトが非表示になりました。システムは、カレットおよびカーソルの各ユーザーインターフェイス要素にイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにイベントを送信します。このイベントが親オブジェクトに対して生成された時点で、子オブジェクトはすべて非表示になっています。そのため、サーバーアプリケーションは、子オブジェクトにイベントを送信する必要はありません。システムは、このイベントを一貫して送信するとは限りません。
	LocationChange	オブジェクトの位置、形、またはサイズが変更されました。システムは、カレットおよびウィンドウオブジェクトの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。このイベントは、変更があったオブジェクト階層内のトップレベルのオブジェクトに対する応答として生成されます。そのオブジェクトに含まれる子に対しては生成されません。たとえば、ユーザーがウィンドウのサイズを変更すると、システムは、この通知をウィンドウに送信します。同時に変更されたメニューバー、タイトルバー、スクロールバーなどのオブジェクトには送信しません。システムは、親ウィンドウが移動したときに、その子である非フローティングウィンドウのそれぞれにイベントを送信することはありません。ただし、サイズ変更の結果としてアプリケーションが子ウィンドウのサイズを明示的に変更した場合は、システムは、サイズ変更された子ウィンドウに複数のイベントを送信します。オブジェクトの State プロパティが AccessibleStates.Floating に設定されている場合は、サーバーは、そのオブジェクトの位置が変わるたびに位置変更のイベントを送信する必要があります。オブジェクトがこの状態に設定されていない場合は、サーバーは、そのオブジェクトが親に合わせて移動したときにこのイベントを発生させる必要があります。
	NameChange	オブジェクトの Name プロパティが変更されました。システムは、チェックボックス、カーソル、リストビューコントロール、プッシュボタン、オプションボタン、ステータスバーコントロール、ツリービューコントロール、ウィンドウオブジェクトの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。
	ParentChange	オブジェクトに新しい親オブジェクトが設定されました。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。
	Reorder	コンテナオブジェクトで子オブジェクトが追加、削除、または並べ替えされました。システムは、ヘッダーコントロール、リストビューコントロール、ツールバーコントロール、ウィンドウオブジェクトの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトに適宜にこのイベントを送信します。このイベントは、子ウィンドウの z オーダーが変更されたときに、親ウィンドウからも送信されます。
	Selection	コンテナオブジェクト内のユーザー補助オブジェクトが選択されました。このイベントは、単一の項目の選択を通知します。子が選択されていなかったコンテナで子が選択された、または選択が別の子に変更されたことを通知します。
	SelectionAdd	コンテナオブジェクト内の項目が選択に追加されました。システムは、リストボックス、リストビューコントロール、ツリービューコントロールの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。このイベントは、既存の選択に子が追加されたことを通知します。
	SelectionRemove	コンテナオブジェクト内の項目が選択から削除されました。システムは、リストボックス、リストビューコントロール、ツリービューコントロールの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。このイベントは、既存の選択から子が削除されたことを通知します。
	SelectionWithin	コンテナオブジェクト内で複数の選択変更がありました。システムは、リストボックスにこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。このイベントは、コントロール内での項目の選択に大きな変更があったときに送信できます。このイベントは、複数の選択変更があったことをクライアントに通知します。SelectionAdd イベントまたは SelectionRemove イベントを複数送信するよりも好ましい通知方法です。
	Show	隠しオブジェクトが表示されます。システムは、カレット、カーソル、ウィンドウオブジェクトの各ユーザーインターフェイス要素にこのイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。クライアントは、親オブジェクトがこのイベントを送信した時点で、その子オブジェクトはすべて表示されていると判断できます。そのため、サーバーアプリケーションは、このイベントを子オブジェクトに送信する必要はありません。
	StateChange	オブジェクトの状態が変更されました。システムは、チェックボックス、コンボボックス、ヘッダーコントロール、プッシュボタン、オプションボタン、スクロールバー、ツールバーコントロール、ツリービューコントロール、アップダウンコントロール、ウィンドウオブジェクトの各ユーザーインターフェイス要素にイベントを送信します。サーバーアプリケーションは、所有するユーザー補助オブジェクトにイベントを送信します。状態の変更は、ボタンオブジェクトを押すまたは離す、オブジェクトを有効または無効にするなどの動作が行われたときに発生します。システムは、このイベントを一貫して送信するとは限りません。
	SystemAlert	警告が生成されました。サーバーアプリケーションは、ユーザーへの通知が必要である可能性のある重要なユーザーインターフェイスの変更が発生するたびに、このイベントを送信します。システムは、ダイアログボックスオブジェクトにイベントを一貫して送信するとは限りません。
	SystemCaptureEnd	ウィンドウがマウスのキャプチャを失いました。このイベントは、システムが送信します。サーバーが送信することはありません。
	SystemCaptureStart	ウィンドウが移動またはサイズ変更されます。このイベントは、システムが送信します。サーバーが送信することはありません。
	SystemContextHelpEnd	ウィンドウが、状況依存のヘルプモードを終了しました。システムは、このイベントを一貫して送信するとは限りません。
	SystemContextHelpStart	ウィンドウが、状況依存のヘルプモードに入りました。システムは、このイベントを一貫して送信するとは限りません。
	SystemDialogEnd	ダイアログボックスが閉じました。システムは、標準ダイアログボックスにはイベントを送信しません。サーバーは、カスタムダイアログボックスにこのイベントを送信します。システムは、このイベントを一貫して送信するとは限りません。
	SystemDialogStart	ダイアログボックスが表示されました。システムは、標準ダイアログボックスにイベントを送信します。サーバーは、カスタムダイアログボックスにこのイベントを送信します。システムは、このイベントを一貫して送信するとは限りません。
	SystemDragDropEnd	アプリケーションが、ドラッグアンドドロップモードを終了しようとしています。このイベントは、ドラッグアンドドロップ操作をサポートするアプリケーションが送信する必要があります。システムは送信しません。
	SystemDragDropStart	アプリケーションが、ドラッグアンドドロップモードに入ろうとしています。このイベントは、ドラッグアンドドロップ操作をサポートするアプリケーションが送信する必要があります。システムは送信しません。
	SystemForeground	前面のウィンドウが変更されました。前面のウィンドウが、同じスレッド内の別のウィンドウに変更された場合でも、システムはこのイベントを送信します。サーバーアプリケーションがこのイベントを送信することはありません。
	SystemMenuEnd	メニューバーのメニューが閉じました。システムは、標準メニューにこのイベントを送信します。サーバーは、カスタムメニューにこのイベントを送信します。
	SystemMenuPopupEnd	ショートカットメニューが閉じました。システムは、標準メニューにこのイベントを送信します。サーバーは、カスタムメニューにこのイベントを送信します。ショートカットメニューが閉じると、クライアントは、このメッセージを受信し、その直後に SystemMenuEnd イベントを受信します。システムは、このイベントを一貫して送信するとは限りません。
	SystemMenuPopupStart	ショートカットメニューが表示されました。システムは、標準メニューにこのイベントを送信します。サーバーは、カスタムメニューにこのイベントを送信します。システムは、このイベントを一貫して送信するとは限りません。
	SystemMenuStart	メニューバーのメニュー項目が選択されました。システムは、標準メニューにこのイベントを送信します。サーバーは、カスタムメニューにこのイベントを送信します。システムは、対応する MenuEnd イベントの有無にかかわらず、複数の MenuStart イベントを発生させる場合があります。
	SystemMinimizeEnd	ウィンドウオブジェクトが最小化または最大化されました。このイベントは、システムが送信します。サーバーが送信することはありません。
	SystemMinimizeStart	ウィンドウオブジェクトが最小化または最大化されようとしています。このイベントは、システムが送信します。サーバーが送信することはありません。
	SystemMoveSizeEnd	ウィンドウの移動またはサイズ変更が完了しました。このイベントは、システムが送信します。サーバーが送信することはありません。
	SystemMoveSizeStart	ウィンドウが移動またはサイズ変更されます。このイベントは、システムが送信します。サーバーが送信することはありません。
	SystemScrollingEnd	スクロールバーでスクロールが終了しました。システムは、ウィンドウに割り当てられているスクロールバー、および標準スクロールバーコントロールにこのイベントを送信します。サーバーは、カスタムスクロールバーにこのイベントを送信します。
	SystemScrollingStart	スクロールバーでスクロールが開始しました。システムは、ウィンドウに割り当てられているスクロールバー、および標準スクロールバーコントロールにこのイベントを送信します。サーバーは、カスタムスクロールバーにこのイベントを送信します。
	SystemSound	サウンドが再生されました。システムは、メニューなどのシステムサウンドが再生されると、サウンドが聞こえない場合でも、このイベントを送信します。これは、サウンドファイルまたはサウンドカードがないことが原因で発生する可能性があります。カスタムユーザーインターフェイス要素がサウンドを生成する場合でも、サーバーはこのイベントを送信します。
	SystemSwitchEnd	ユーザーが Alt キーと Tab キーを離しました。SwitchEnd イベントは、システムが送信します。サーバーが送信することはありません。ユーザーが Alt キーを押しながら Tab キーを押したときに、実行中のアプリケーションが 1 つだけであった場合は、システムは、対応する SwitchStart イベントのない SwitchEnd イベントを送信します。
	SystemSwitchStart	ユーザーが、ウィンドウを切り替えるために Alt キーを押しながら Tab キーを押しました。ユーザーが Alt キーを押しながら Tab キーを押したときに、実行中のアプリケーションが 1 つだけであった場合は、システムは、対応する SwitchStart イベントのない SwitchEnd イベントを発生させます。
	ValueChange	オブジェクトの Value プロパティが変更されました。システムは、エディットコントロール、ヘッダーコントロール、ホットキーコントロール、プログレスバーコントロール、スクロールバー、スライダコントロール、アップダウンコントロールの各ユーザーインターフェイス要素に ValueChange イベントを発生させます。サーバーアプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。

解説

オペレーティングシステムとユーザー補助サーバーアプリケーションは、ユーザーインターフェイスの変更に応答して、ユーザー補助イベントを生成します。

この列挙体は、AccessibleObject および Control で使用されます。

ユーザー補助アプリケーションの詳細については、MSDN ライブラリの「Microsoft Active Accessibility」を参照してください。

使用例

ユーザー補助情報を公開する AccessibleObject クラスおよび Control.ControlAccessibleObject クラスを使用して、ユーザー補助対応のチャートコントロールを作成する方法の例を次に示します。コントロールは、凡例に沿って 2 つの曲線をプロットします。ControlAccessibleObject から派生された ChartControlAccessibleObject クラスは、チャートコントロールの独自のユーザー補助情報を提供することを目的として、CreateAccessibilityInstance メソッドで使用します。チャートの凡例は実際の Control ベースのコントロールではなく、チャートコントロールによって描画されるため、組み込みのユーザー補助情報は含まれていません。このため、ChartControlAccessibleObject クラスは、GetChild メソッドをオーバーライドして、凡例の各部分のユーザー補助情報を表す CurveLegendAccessibleObject を返します。ユーザー補助対応のアプリケーションでこのコントロールが使用された場合、このコントロールは必要なユーザー補助情報を提供できます。

AccessibilityNotifyClients メソッドで AccessibleEvents 列挙体を使用する例を次に示します。コード例全体については、AccessibleObject クラスの概要を参照してください。

Visual Basic

' Gets or sets the location for the curve legend.            
Public Property Location() As
 Point
    Get
        Return m_location
    End Get
    Set
        m_location = value
        chart.Invalidate()

        ' Notifies the chart of the location change. This is used for
        ' the accessibility information. AccessibleEvents.LocationChange
        ' tells the chart the reason for the notification.
        chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
                CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
    End Set
End Property

' Gets or sets the Name for the curve legend.            
Public Property Name() As
 String
    Get
        Return m_name
    End Get
    Set
        If m_name <> value Then
            m_name = value
            chart.Invalidate()

            ' Notifies the chart of the name change. This is used for
            ' the accessibility information. AccessibleEvents.NameChange
            ' tells the chart the reason for the notification. 
            chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
                    CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
        End If
    End Set
End Property

' Gets or sets the Selected state for the curve legend.            
Public Property Selected() As
 Boolean
    Get
        Return m_selected
    End Get
    Set
        If m_selected <> value Then
            m_selected = value
            chart.Invalidate()

            ' Notifies the chart of the selection value change. This
 is used for
            ' the accessibility information. The AccessibleEvents value
 varies
            ' on whether the selection is true (AccessibleEvents.SelectionAdd)
 or 
            ' false (AccessibleEvents.SelectionRemove). 
            If m_selected Then
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd,
 _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
 
            Else
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove,
 _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
 
            End If
        End If
    End Set
End Property

// Gets or sets the location for the curve legend.
public Point Location
{   
    get {
        return location;
    }
    set {
        location = value;
        chart.Invalidate();

        // Notifies the chart of the location change. This is used for
        // the accessibility information. AccessibleEvents.LocationChange
        // tells the chart the reason for the notification.

        chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange, 
            ((CurveLegendAccessibleObject)AccessibilityObject).ID);
    }
}            
        
// Gets or sets the Name for the curve legend.
public string Name
{   
    get {
        return name;
    }
    set {
        if (name != value) 
        {
            name = value;
            chart.Invalidate();

            // Notifies the chart of the name change. This is used for
            // the accessibility information. AccessibleEvents.NameChange
            // tells the chart the reason for the notification.

            chart.AccessibilityNotifyClients(AccessibleEvents.NameChange, 
                ((CurveLegendAccessibleObject)AccessibilityObject).ID);
        }
    }
}

// Gets or sets the Selected state for the curve legend.
public bool Selected
{   
    get {
        return selected;
    }
    set {
        if (selected != value) 
        {
            selected = value;
            chart.Invalidate();

            // Notifies the chart of the selection value change. This
 is used for
            // the accessibility information. The AccessibleEvents value
 depends upon
            // if the selection is true (AccessibleEvents.SelectionAdd)
 or 
            // false (AccessibleEvents.SelectionRemove).
            chart.AccessibilityNotifyClients(
                selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove,
 
                ((CurveLegendAccessibleObject)AccessibilityObject).ID);
        }
    }
}

C++

   // Gets or sets the location for the curve legend.
   Point get()
   {
      return location;
   }

   void set( Point value )
   {
      location = value;
      chart->Invalidate();
      
      // Notifies the chart of the location change. This is used for
      // the accessibility information. AccessibleEvents::LocationChange
      // tells the chart the reason for the notification.
      chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID
 );
   }

}

property String^ Name 
{

   // Gets or sets the Name for the curve legend.
   String^ get()
   {
      return name;
   }

   void set( String^ value )
   {
      if ( name != value )
      {
         name = value;
         chart->Invalidate();
         
         // Notifies the chart of the name change. This is used for
         // the accessibility information. AccessibleEvents::NameChange
         // tells the chart the reason for the notification.
         chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID
 );
      }
   }

}

property bool Selected 
{

   // Gets or sets the Selected state for the curve legend.
   bool get()
   {
      return selected;
   }

   void set( bool value
 )
   {
      if ( selected != value )
      {
         selected = value;
         chart->Invalidate();
         
         // Notifies the chart of the selection value change. This is
 used for
         // the accessibility information. The AccessibleEvents value
 depends upon
         // if the selection is true (AccessibleEvents::SelectionAdd)
 or
         // false (AccessibleEvents::SelectionRemove).
         chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd
 : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID
 );
      }
   }

// Gets or sets the location for the curve legend.
/** @property 
 */
public Point get_Location()
{
    return location;
} //get_Location

/** @property 
 */
public void set_Location(Point value)
{
    location = value;
    chart.Invalidate();
    // Notifies the chart of the location change. This is used for
    // the accessibility information. AccessibleEvents.LocationChange
    // tells the chart the reason for the notification.
    chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange, 
        ((CurveLegendAccessibleObject)get_AccessibilityObject()).
        get_ID());
} //set_Location

// Gets or sets the Name for the curve legend.
/** @property 
 */
public String get_Name()
{
    return name;
} //get_Name

/** @property 
 */
public void set_Name(String value)
{
    if (!name.Equals(value)) {
        name = value;
        chart.Invalidate();

        // Notifies the chart of the name change. This is used for
        // the accessibility information. AccessibleEvents.NameChange
        // tells the chart the reason for the notification.
        chart.AccessibilityNotifyClients(AccessibleEvents.NameChange,
            ((CurveLegendAccessibleObject)get_AccessibilityObject()).
            get_ID());
    }
} //set_Name

// Gets or sets the Selected state for the curve legend.
/** @property 
 */
public boolean get_Selected()
{
    return selected;
} //get_Selected

/** @property 
 */
public void set_Selected(boolean value)
{
    if (selected != value) {
        selected = value;
        chart.Invalidate();

        // Notifies the chart of the selection value change. 
        // This is used for the accessibility information. 
        // The AccessibleEvents value depends upon
        // if the selection is true (AccessibleEvents.SelectionAdd)
 or 
        // false (AccessibleEvents.SelectionRemove).
        chart.AccessibilityNotifyClients(selected ? 
            AccessibleEvents.SelectionAdd : 
            AccessibleEvents.SelectionRemove, 
            ((CurveLegendAccessibleObject)get_AccessibilityObject()).
            get_ID());
    }
} //set_Selected