Win32 API 日本語リファレンス
ホーム › UI.Accessibility › StructureChangeType

StructureChangeType

列挙型
📘 Microsoft Learn (日本語) · English
基底型i4

メンバー 6

名前10進16進説明
StructureChangeType_ChildAdded00x0UI オートメーション要素ツリーに子要素が追加されました。
StructureChangeType_ChildRemoved10x1UI オートメーション要素ツリーから子要素が削除されました。
StructureChangeType_ChildrenInvalidated20x2UI オートメーション要素ツリー内の子要素が無効化されました。これは、1 つ以上の子要素が追加されたか削除されたか、またはその両方が行われたことを意味する場合があります。また、この値は UI 内のあるサブツリーが別のサブツリーに置き換えられたことを示す場合もあります。たとえば、ダイアログ ボックスの内容全体が一度に変更された場合や、エクスプローラー形式のアプリケーションが別の場所に移動したためにリストのビューが変更された場合などです。正確な意味は、UI オートメーション プロバイダーの実装によって異なります。
StructureChangeType_ChildrenBulkAdded30x3UI オートメーション要素ツリーに子要素が一括で追加されました。
StructureChangeType_ChildrenBulkRemoved40x4UI オートメーション要素ツリーから子要素が一括で削除されました。
StructureChangeType_ChildrenReordered50x5UI オートメーション要素ツリー内の子要素の順序が変更されました。子要素の追加や削除は行われている場合も、行われていない場合もあります。

公式ドキュメント

Microsoft UI オートメーション ツリー構造における変更の種類を指定する値が含まれます。

解説(Remarks)

構造変更イベントの実装は基盤となる UI フレームワークに依存するため、プロバイダーが個々の ChildAdded イベントまたは ChildRemoved イベントの送信から一括版のイベントに切り替えるタイミングについて、UI オートメーションは厳密な規則を定めていません。ただし、通常は 2 個から 5 個の子要素が一度に追加または削除されたときに切り替えが行われます。一括イベントは、クライアントが個々の ChildAdded イベントおよび ChildRemoved イベントで溢れることを防ぐのに役立ちます。

ChildAdded を除き、構造変更イベントは常に子要素を保持するコンテナー要素に関連付けられます。ChildAdded イベントは、追加されたばかりの要素に関連付けられます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum StructureChangeType : int {
    StructureChangeType_ChildAdded = 0,
    StructureChangeType_ChildRemoved = 1,
    StructureChangeType_ChildrenInvalidated = 2,
    StructureChangeType_ChildrenBulkAdded = 3,
    StructureChangeType_ChildrenBulkRemoved = 4,
    StructureChangeType_ChildrenReordered = 5
} StructureChangeType;
public enum StructureChangeType : int
{
    StructureChangeType_ChildAdded = 0,
    StructureChangeType_ChildRemoved = 1,
    StructureChangeType_ChildrenInvalidated = 2,
    StructureChangeType_ChildrenBulkAdded = 3,
    StructureChangeType_ChildrenBulkRemoved = 4,
    StructureChangeType_ChildrenReordered = 5,
}
Public Enum StructureChangeType As Integer
    StructureChangeType_ChildAdded = 0
    StructureChangeType_ChildRemoved = 1
    StructureChangeType_ChildrenInvalidated = 2
    StructureChangeType_ChildrenBulkAdded = 3
    StructureChangeType_ChildrenBulkRemoved = 4
    StructureChangeType_ChildrenReordered = 5
End Enum
import enum

class StructureChangeType(enum.IntEnum):
    StructureChangeType_ChildAdded = 0
    StructureChangeType_ChildRemoved = 1
    StructureChangeType_ChildrenInvalidated = 2
    StructureChangeType_ChildrenBulkAdded = 3
    StructureChangeType_ChildrenBulkRemoved = 4
    StructureChangeType_ChildrenReordered = 5
// StructureChangeType
pub const StructureChangeType_ChildAdded: i32 = 0;
pub const StructureChangeType_ChildRemoved: i32 = 1;
pub const StructureChangeType_ChildrenInvalidated: i32 = 2;
pub const StructureChangeType_ChildrenBulkAdded: i32 = 3;
pub const StructureChangeType_ChildrenBulkRemoved: i32 = 4;
pub const StructureChangeType_ChildrenReordered: i32 = 5;
// StructureChangeType
const (
	StructureChangeType_ChildAdded int32 = 0
	StructureChangeType_ChildRemoved int32 = 1
	StructureChangeType_ChildrenInvalidated int32 = 2
	StructureChangeType_ChildrenBulkAdded int32 = 3
	StructureChangeType_ChildrenBulkRemoved int32 = 4
	StructureChangeType_ChildrenReordered int32 = 5
)
const
  StructureChangeType_ChildAdded = 0;
  StructureChangeType_ChildRemoved = 1;
  StructureChangeType_ChildrenInvalidated = 2;
  StructureChangeType_ChildrenBulkAdded = 3;
  StructureChangeType_ChildrenBulkRemoved = 4;
  StructureChangeType_ChildrenReordered = 5;
// StructureChangeType
pub const StructureChangeType_ChildAdded: i32 = 0;
pub const StructureChangeType_ChildRemoved: i32 = 1;
pub const StructureChangeType_ChildrenInvalidated: i32 = 2;
pub const StructureChangeType_ChildrenBulkAdded: i32 = 3;
pub const StructureChangeType_ChildrenBulkRemoved: i32 = 4;
pub const StructureChangeType_ChildrenReordered: i32 = 5;
const
  StructureChangeType_ChildAdded* = 0
  StructureChangeType_ChildRemoved* = 1
  StructureChangeType_ChildrenInvalidated* = 2
  StructureChangeType_ChildrenBulkAdded* = 3
  StructureChangeType_ChildrenBulkRemoved* = 4
  StructureChangeType_ChildrenReordered* = 5
enum StructureChangeType : int {
    StructureChangeType_ChildAdded = 0,
    StructureChangeType_ChildRemoved = 1,
    StructureChangeType_ChildrenInvalidated = 2,
    StructureChangeType_ChildrenBulkAdded = 3,
    StructureChangeType_ChildrenBulkRemoved = 4,
    StructureChangeType_ChildrenReordered = 5,
}
#define global StructureChangeType_ChildAdded          0x0
#define global StructureChangeType_ChildRemoved        0x1
#define global StructureChangeType_ChildrenInvalidated 0x2
#define global StructureChangeType_ChildrenBulkAdded   0x3
#define global StructureChangeType_ChildrenBulkRemoved 0x4
#define global StructureChangeType_ChildrenReordered   0x5