Galería de Drop-Down
La Drop-Down Galería consta de un botón que cuando se hace clic muestra una lista desplegable que contiene una colección de elementos mutuamente excluyentes o Comandos.
Detalles
Este control es útil para exponer elementos relacionados o comandos en los que no hay ningún valor predeterminado obvio, y los elementos individuales se pueden representar mediante una imagen, texto o ambos.
La compatibilidad con barras de agarre vertical y de esquina, o controladores de cambio de tamaño, se proporciona a través del elemento DropDownGallery.MenuLayout .
En la siguiente captura de pantalla se muestra la cinta de opciones Drop-Down Galería en Microsoft Paint.
Propiedades de la Galería de Drop-Down
El marco de la cinta define una colección de claves de propiedad para el control galería de Drop-Down.
Normalmente, una propiedad Drop-Down 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 Drop-Down 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 a través de una llamada a IUIFramework::InvalidateUICommand, el marco consulta esta propiedad cuando UI_INVALIDATIONS_VALUE se pasa como el valor de las 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. |