Casella di controllo
La casella di controllo è un controllo su cui l'utente può fare clic per fornire l'input a un'applicazione. Il controllo fornisce uno stato di attivazione/disattivazione rappresentato visivamente.
Dettagli
La casella di controllo non supporta uno stato terziario o indeterminato.
Lo screenshot seguente illustra l'elemento Casella di controllo della barra multifunzione.
Proprietà casella di controllo
Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Casella di controllo.
In genere, una proprietà Check Box 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 Casella di controllo.
| 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. |