Condividi tramite


Pulsante Attiva/Disattiva

L'interruttore quando si fa clic fornisce l'input a un'applicazione. Il controllo rappresenta uno stato di attivazione/disattivazione che si escludono a vicenda.

Dettagli

La schermata seguente illustra l'interruttore della barra multifunzione.

schermata di un controllo togglebutton nella barra multifunzione microsoft paint.

Attiva/Disattiva proprietà pulsante

Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Attiva/Disattiva pulsante.

In genere, una proprietà Toggle 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 Attiva/Disattiva pulsante.

Chiave della proprietà Note
UI_PKEY_BooleanValue Supporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. Nota: Se il comando associato al controllo viene invalidato tramite una chiamata a IUIFramework::InvalidateUICommand, il framework esegue una query su questa proprietà quando UI_INVALIDATIONS_VALUE viene passato come valore di flag .
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 ToggleButton