Botón Drop-Down
El botón de Drop-Down consta de un botón que cuando se hace clic muestra una lista desplegable de elementos mutuamente excluyentes.
Detalles
Este control es útil para exponer elementos estrechamente relacionados en los casos en los que no hay ningún valor predeterminado obvio disponible y donde los elementos individuales se pueden representar mediante una imagen, texto o ambos.
En la captura de pantalla siguiente se muestra la cinta de opciones Drop-Down Botón en una cinta de opciones de ejemplo.
Propiedades del botón Drop-Down
El marco de la cinta define una colección de claves de propiedad para el control Button de Drop-Down.
Normalmente, una propiedad Button de Drop-Down 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 Button de Drop-Down.
| Clave de propiedad | Notas |
|---|---|
| UI_PKEY_Categories | Admite IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Admite IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. Si todos los elementos secundarios están deshabilitados, el marco establece UI_PKEY_Enabled en false (0). De lo contrario, si uno o varios elementos secundarios están habilitados, UI_PKEY_Enabled se establece en true (-1). Importante: La propiedad UI_PKEY_Enabled del control Button de Drop-Down debe invalidarse después de que uno o varios elementos secundarios estén habilitados o deshabilitados. Esto garantiza que el marco consulta el valor de propiedad actualizado y actualiza el estado del control Botón de Drop-Down en la interfaz de usuario de la cinta de opciones. |
| 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 | 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. |