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 のサポートおよびフィードバックを参照してください。

  • Last updated on