Galería de In-Ribbon
La galería de In-Ribbon es un control que muestra una colección de elementos relacionados o comandos en la cinta de opciones. Si hay demasiados elementos en la galería, se proporciona una flecha de expansión para mostrar el resto de la colección en un panel expandido.
Detalles
En la captura de pantalla siguiente se muestra el control De la galería de In-Ribbon cinta de opciones en Microsoft Paint.
Propiedades de la galería de In-Ribbon
El marco de la cinta define una colección de claves de propiedad para el control galería de In-Ribbon.
Normalmente, una propiedad In-Ribbon Gallery se actualiza 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 la propiedad se actualiza definida por el método de devolución de llamada IUICommandHandler::UpdateProperty .
El método de devolución de llamada IUICommandHandler::UpdateProperty no se ejecuta y la aplicación consulta para obtener 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 In-Ribbon Galería.
| Clave de propiedad | Notas |
|---|---|
| UI_PKEY_Categories | Admite IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Admite IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Admite IUIFramework::GetUICommandProperty e 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 e 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 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. |