IRibbonUI.InvalidateControl メソッド (Office)

  • [アーティクル]

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

構文

式。InvalidateControl (bstrControlID)

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

パラメーター

名前 必須 / オプション データ型 説明
bstrControlID 必須 String 無効化するコントロールの ID を指定します。

注釈

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

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

例

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

<customUI … OnLoad="MyAddInInitialize" …>

Dim MyRibbon As IRibbonUI 
 
Sub MyAddInInitialize(Ribbon As IRibbonUI) 
 Set MyRibbon = Ribbon 
End Sub 
 
Sub myFunction() 
 MyRibbon.InvalidateControl("control1") ' Invalidates the cache of a single control 
End Sub

関連項目

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

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