Share via

Galería de Drop-Down

  • Artículo

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.

captura de pantalla de un control desplegable de la cinta de opciones de pintura de Microsoft.

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.

Biblioteca de controles del marco de la cinta de opciones de Windows

Elemento de marcado DropDownGallery

Trabajar con galerías

Ejemplo de galería