IUIFramework::Metode InvalidateUICommand (uiribbon.h)

  • Artikel

Membatalkan properti, nilai, atau status Perintah kerangka kerja Windows Ribbon.

Sintaks

HRESULT InvalidateUICommand(
  [in] UINT32            commandId,
  [in] UI_INVALIDATIONS  flags,
  [in] const PROPERTYKEY *key
);

Parameter

[in] commandId

Jenis: UINT32

ID untuk Perintah, yang ditentukan dalam file sumber daya markup.

[in] flags

Jenis: UI_INVALIDATIONS

Mengidentifikasi aspek perintah mana yang akan divalidasi.

Catatan Meneruskan UI_INVALIDATIONS_ALLPROPERTIES membatalkan semua properti yang terikat ke perintah, termasuk nilai dan status.
 

[in] key

Jenis: const PROPERTYKEY*

Kunci properti properti perintah atau status. Parameter ini bisa NULL.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil; jika tidak, nilai kesalahan dari daftar berikut.

Nilai Deskripsi
E_INVALIDARG Nilai untuk kunci yang tidak valid disediakan.
E_FAIL Operasi gagal. Semua perintah gagal dibatalkan, atau tidak ada properti yang ditentukan yang didukung.

Keterangan

Sumber daya yang ditentukan dalam markup kerangka kerja Pita disimpan dalam tabel sumber daya yang dibuat saat file markup dikompilasi ke dalam format biner. Sumber daya tidak dapat dipulihkan dari tabel sumber daya Markup setelah dibatalkan.

Setelah pembatalan, kerangka kerja meminta aplikasi host untuk detail sumber daya.

Ketika nilai Perintah tidak valid (bendera berisi UI_INVALIDATIONS_VALUE) nilai kunci adalah NULL.

Jika IUIFramework::InvalidateUICommand dipanggil beberapa kali dan nilai UI_INVALIDATIONS yang diteruskan di setiap panggilan menentukan properti yang tumpang tindih, seperti UI_INVALIDATIONS_STATE dan UI_INVALIDATIONS_ALLPROPERTIES, maka hanya satu panggilan balik ke aplikasi host yang dibuat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header uiribbon.h
DLL Mshtml.dll

Lihat juga

IUIFramework

UI_INVALIDATIONS

Sampel Windows Ribbon Framework