Knappen Dela
Delningsknappen är en sammansatt kontroll med vilken användaren kan välja ett standardvärde som är bundet till en primär knapp eller välja från en lista med ömsesidigt uteslutande värden som visas i en listruta som är bunden till en sekundär knapp.
Införandet
Den här kontrollen är användbar för att exponera närbesläktade objekt i fall där en uppenbar standard är tillgänglig och där de enskilda objekten kan representeras av en bild, text eller både och.
Följande skärmbild illustrerar knappen Dela upp i menyfliksområdet.
Egenskaper för delningsknapp
Menyfliksområdet definierar en samling egenskapsnycklar för kontrollen Dela knapp.
Vanligtvis uppdateras en split button-egenskap i menyfliksområdets användargränssnitt genom att kommandot som är associerat med kontrollen ogiltigförklaras via ett anrop till metoden IUIFramework::InvalidateUICommand. Ogiltighetshändelsen hanteras och egenskapsuppdateringarna definieras av IUICommandHandler::UpdateProperty återanropsmetod.
Metoden IUICommandHandler::UpdateProperty motringning körs inte och programmet efterfrågade ett uppdaterat egenskapsvärde tills egenskapen krävs av ramverket. Till exempel när en flik aktiveras och en kontroll visas i menyfliksområdets användargränssnitt, eller när en knappbeskrivning visas.
Not
I vissa fall kan en egenskap hämtas via metoden IUIFramework::GetUICommandProperty och anges med metoden IUIFramework::SetUICommandProperty.
I följande tabell visas de egenskapsnycklar som är associerade med kontrollen Dela knapp.
| Egenskapsnyckel | Anteckningar |
|---|---|
| UI_PKEY_Enabled | Stöder IUIFramework::GetUICommandProperty och IUIFramework::SetUICommandProperty. Om alla underordnade objekt är inaktiverade UI_PKEY_Enabled ramverket till false (0). Om ett eller flera underordnade objekt är aktiverade anges annars UI_PKEY_Enabled till true (-1). Viktigt: Egenskapen UI_PKEY_Enabled för kontrollen Dela knapp ska vara ogiltig när ett eller flera underordnade objekt har aktiverats eller inaktiverats. Detta säkerställer att ramverket frågar efter det uppdaterade egenskapsvärdet och uppdaterar tillståndet för kontrollen Dela knapp i menyfliksområdets användargränssnitt. |
| UI_PKEY_Keytip | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_TooltipDescription | Kan bara uppdateras genom ogiltighet. |
| UI_PKEY_TooltipTitle | Kan bara uppdateras genom ogiltighet. |