IRibbonUI.Invalidate メソッド (Office)

リボン ユーザー インターフェイスのすべてのコントロールに対してキャッシュされた値を無効にします。

構文

無効化

IRibbonUI オブジェクトを返す式。

注釈

リボン UI は、COM アドインのコールバック プロシージャを使用してカスタマイズできます。アドインが実装するコールバックごとに、応答がキャッシュされます。

たとえば、アドイン ライターがボタンの getImage コールバック プロシージャを実装する場合、関数が 1 回呼び出されてイメージが読み込まれ、イメージを更新する必要がある場合は、プロシージャを呼び出す代わりにキャッシュされたイメージが使用されます。 このプロセスは、アドインが Invalidate メソッドを使用してキャッシュされた値が無効であることを示すまで実施されます。その時点で、コールバック プロシージャが再度呼び出され、戻り返された応答がキャッシュされます。 アドインからは、Refresh メソッドを呼び出すことによって、その場で UI の表示を更新できます。

次の例では、ホスト アプリケーションを起動すると、 onLoad イベント プロシージャがトリガーされ、リボン UI を表すオブジェクトを作成するプロシージャが呼び出されます。 次に、すべての ui コントロールを無効にし、UI を更新する、コールバック プロシージャを定義します。

<customUI … OnLoad="MyAddinInitialize" …>
Dim MyRibbon As IRibbonUI 
 
Sub MyAddInInitialize(Ribbon As IRibbonUI) 
 Set MyRibbon = Ribbon 
End Sub 
 
Sub myFunction() 
 MyRibbon.Invalidate() ' Invalidates the caches of all of this add-in's controls 
End Sub

関連項目

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。