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