Galería de botones de división
La Galería de botones divididos es un control compuesto que contiene un botón principal que expone un único elemento predeterminado o Comando, y un botón secundario que cuando se hace clic muestra el resto del elemento o colección Command en una lista desplegable mutuamente excluyente.
Detalles
Este control es útil para exponer elementos estrechamente relacionados en casos en los que un valor predeterminado obvio está disponible y donde los elementos individuales se pueden representar mediante una imagen, texto o ambos.
En la captura de pantalla siguiente se muestra la Galería de botones de división de la cinta de opciones en Microsoft Paint.
Propiedades de la galería de botones de división
El marco de la cinta define una colección de claves de propiedad para el control Galería de botones de división.
Normalmente, se actualiza una propiedad Split Button Gallery en la interfaz de usuario de la cinta de opciones invalidando el comando asociado al control a través de una llamada al método IUIFramework::InvalidateUICommand. El evento de invalidación se controla y las actualizaciones de propiedades definidas por el IUICommandHandler::UpdateProperty método de devolución de llamada.
El IUICommandHandler::UpdateProperty método de devolución de llamada no se ejecuta y la aplicación consultada para un valor de propiedad actualizado, hasta que el marco requiera la propiedad. Por ejemplo, cuando se activa una pestaña y se muestra un control en la interfaz de usuario de la cinta de opciones, o cuando se muestra una información sobre herramientas.
Nota
En algunos casos, se puede recuperar una propiedad a través del método IUIFramework::GetUICommandProperty y establecer con el método IUIFramework::SetUICommandProperty.
En la tabla siguiente se enumeran las claves de propiedad asociadas al control Split Button Gallery.
| Clave de propiedad | Notas |
|---|---|
| UI_PKEY_BooleanValue | Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty. |
| UI_PKEY_Categories | Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Solo se puede actualizar a través de la invalidación. |
| UI_PKEY_Label | Solo se puede actualizar a través de la invalidación. |
| UI_PKEY_LargeHighContrastImage | Solo se puede actualizar a través de la invalidación. |
| UI_PKEY_LargeImage | Solo se puede actualizar a través de la invalidación. |
|
UI_PKEY_SelectedItem(solo válido para una galería de elementos) |
Admite IUIFramework::GetUICommandProperty y IUIFramework::SetUICommandProperty.
Nota: Si el comando asociado al control se invalida mediante una llamada a IUIFramework::InvalidateUICommand, el marco consulta esta propiedad cuando UI_INVALIDATIONS_VALUE se pasa como el valor de marcas. |
| UI_PKEY_SmallHighContrastImage | Solo se puede actualizar a través de la invalidación. |
| UI_PKEY_SmallImage | Solo se puede actualizar a través de la invalidación. |
| UI_PKEY_TooltipDescription | Solo se puede actualizar a través de la invalidación. |
| UI_PKEY_TooltipTitle | Solo se puede actualizar a través de la invalidación. |