Condividi tramite


Pulsante (Windows Ribbon Framework)

Il pulsante è un controllo che l'utente può fare clic per fornire l'input a un'applicazione.

Introduzione

La schermata seguente contiene tre esempi dell'elemento Ribbon Button.

schermata dei controlli pulsante nella barra multifunzione di Microsoft Wordpad.

Proprietà pulsante

Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Button.

In genere, una proprietà Button viene aggiornata nell'interfaccia utente della barra multifunzione invalidando il comando associato al controllo tramite una chiamata al metodo IUIFramework::InvalidateUICommand. L'evento di invalidazione viene gestito e gli aggiornamenti delle proprietà definiti dal metodo di callback IUICommandHandler::UpdateProper ty.

L'IUICommandHandler::UpdateProperty metodo di callback non viene eseguito e l'applicazione ha eseguito una query per un valore di proprietà aggiornato, fino a quando la proprietà non è richiesta dal framework. Ad esempio, quando viene attivata una scheda e un controllo visualizzato nell'interfaccia utente della barra multifunzione o quando viene visualizzata una descrizione comando.

Nota

In alcuni casi, una proprietà può essere recuperata tramite il metodo IUIFramework::GetUICommandProperty e impostato con il metodo IUIFramework::SetUICommandProperty.

 

Nella tabella seguente sono elencate le chiavi delle proprietà associate al controllo Button.

Chiave della proprietà Note
UI_PKEY_Enabled Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Può essere aggiornato solo tramite invalidazione.
UI_PKEY_Label Può essere aggiornato solo tramite invalidazione.
UI_PKEY_LabelDescription Può essere aggiornato solo tramite invalidazione.
UI_PKEY_LargeHighContrastImage Può essere aggiornato solo tramite invalidazione.
UI_PKEY_LargeImage Può essere aggiornato solo tramite invalidazione.
UI_PKEY_SmallHighContrastImage Può essere aggiornato solo tramite invalidazione.
UI_PKEY_SmallImage Può essere aggiornato solo tramite invalidazione.
UI_PKEY_TooltipDescription Può essere aggiornato solo tramite invalidazione.
UI_PKEY_TooltipTitle Può essere aggiornato solo tramite invalidazione.

 

libreria di controlli di Windows Ribbon Framework

elemento di markup Button