UiaChangeInfo 結構 (uiautomationcore.h)

包含發生之 使用者介面自動化 變更的相關數據。

語法

struct UiaChangeInfo {
  int     uiaId;
  VARIANT payload;
  VARIANT extraInfo;
};

成員

uiaId

識別變更信息的類型。 可能的值為 變更標識碼、 屬性標識碼、 文字屬性標識碼、 批註類型標識碼 和 樣式標識碼的所有值。

payload

發生之變更類型的相關信息。

extraInfo

所發生變更的詳細資訊。

備註

提供者可以呼叫 UiaRaiseChangesEvent ，並傳入 UiaChangeInfo 結構的陣列，以通知用戶端相關變更群組。 承載和 extraInfo 會根據 UiaChangeInfo 結構中填入的 uiaId 而有所不同。

如果有多個這些事件類型，則會建立多個 UiaChangeInfo 結構。 以下是每對值之內容的描述。

UiaId	承載	extraInfo
UIA_SummaryChangeId	VT_BSTR 字串，描述從應用程式觀點變更的意義。	提供者的常數標識碼值，指出這個事件的意義。
針對UIA屬性變更，在 [ 屬性標識符 ] 區段中識別。	類型是屬性的類型，而值是 屬性的新值。
對於文字屬性變更，在 [ 文字屬性標識符 ] 區段中識別，不會使用 extraInfo 。	類型是屬性的類型，而值是屬性的新值。
對於批註變更，在 [註釋類型標識符 ] 區段中識別，不會使用 extraInfo 。	VT_BSTR 如果是文字，則為批註套用範圍中的字元。
對於樣式變更，在 [ 樣式標識符 ] 區段中識別，不會使用 extraInfo 。	VT_BSTR 如果是文字，則為套用樣式範圍中的字元。

規格需求

需求	值
標頭	uiautomationcore.h