37

importación javax.swing.event.ChangeEvent ;

38

importación javax.swing.event.ChangeListener ;

39

40

importar org.pushingpixels.flamingo.api.common *. ;

41
 importación org.pushingpixels.flamingo.api.common.icon.ResizableIcon ;

42

importación org.pushingpixels.flamingo.internal.ui.ribbon.BasicRibbonUI ;

43

importación org.pushingpixels.flamingo.internal.ui.ribbon.RibbonUI ;

El componente de la cinta.

La cinta tiene las siguientes partes principales:

Tareas de la cinta añadidas con addTask(org.pushingpixels.flamingo.api.ribbon.RibbonTask)

Grupos de tareas de cinta contextual agregados

conaddContextualTaskGroup(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)

Botón del menú de aplicaciones establecido

porsetApplicationMenu(org.pushingpixels.flamingo.api.ribbon.RibbonApplicationMenu)

Panel de la barra de tareas poblado por addTaskbarComponent(java.awt.Component)

Botón de ayuda establecido por

configureHelp(org.pushingpixels.flamingo.api.common.icon.ResizableIcon,java.awt.event.ActionListener)
Si bien se pueden agregar varias tareas de la cinta a la cinta, sólo se puede ver una en cada momento. Esta
tarea se llama la tarea seleccionada . Las tareas se pueden cambiar con los botones de tareas colocados a lo
largo de la parte superior de la cinta. Una vez que se ha agregado una tarea a la cinta, no se puede quitar.

Los grupos de tareas de la cinta contextual permiten mostrar y ocultar las tareas de la cinta en función de
la selección actual en la aplicación. Por ejemplo, Word sólo muestra las tareas de tabla cuando se
selecciona una tabla en el documento. De forma predeterminada, las tareas pertenecientes a los grupos adde
poraddContextualTaskGroup(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)no son visibles.
Para mostrar las tareas pertenecientes al grupo específico, llame
alsetVisible(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup,boolean)API. Tenga en cuenta
que puede tener varios grupos de tareas visibles al mismo tiempo.

El botón de menú de la aplicación es un gran botón redondo que se muestra en la esquina superior izquierda
de la cinta. Si setApplicationMenu(org.pushingpixels.flamingo.api.ribbon.RibbonApplicationMenu)no se llama o
se llama con el nullvalor, no se muestra el botón de menú de la aplicación y los botones de tarea de cinta
se desplazan hacia la izquierda.

El panel de la barra de tareas permite mostrar los controles que son visibles sin importar qué tarea de la
cinta esté seleccionada. Para agregar un componente de la barra de tareas, utilice
laaddTaskbarComponent(java.awt.Component)API. El panel de la barra de tareas vive a la derecha del botón de
menú de la aplicación. Los componentes de la barra de tareas se pueden quitar con la
removeTaskbarComponent(java.awt.Component)API.

La cinta se puede minimizar de una de las siguientes maneras:

Llamando setMinimized(boolean)con true.

Usuario haciendo doble clic en un botón de tarea.

Usuario que presiona la Ctrl+F1combinación de teclas.

Una cinta minimizada muestra el botón del menú de la aplicación, el panel de la barra de tareas, los botones
de tareas y el botón de ayuda, pero no las bandas de la cinta de la tarea seleccionada. Al hacer clic en un
botón de tarea se muestran las bandas de cinta de esa tarea en una ventana emergente sin cambiar el
contenido de la aplicación.
Autor (es):

Kirill Grouchnikov

112

113

público de clase JRibbon extiende JComponent {

Las tareas generales.

Ver también:

addTask(org.pushingpixels.flamingo.api.ribbon.RibbonTask)

getTaskCount()

getTask(int)

120
121

Private ArrayList < RibbonTask > tareas ;

Los grupos de tareas contextuales.

Ver también:

addContextualTaskGroup(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)

setVisible(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup,boolean)

isVisible(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)

getContextualTaskGroupCount()

getContextualTaskGroup(int)

131

132

Private ArrayList < RibbonContextualTaskGroup > contextualTaskGroups ;

Los componentes de la barra de tareas (a la derecha del botón de menú de la aplicación).

Ver también:

addTaskbarComponent(java.awt.Component)

getTaskbarComponents()

removeTaskbarComponent(java.awt.Component)

140

141

Private ArrayList < Component > taskbarComponents ;

Bandas de la tarea actualmente mostrada.

145
146

Private ArrayList < AbstractRibbonBand > bandas ;

Tarea actualmente seleccionada (mostrada).

150

151

Private RibbonTask actualmenteSelectedTask ;

Icono de ayuda. Cuando no null, la cinta mostrará un botón de ayuda en el extremo derecho del área de la
pestaña.

Ver también:
helpActionListener

configureHelp(org.pushingpixels.flamingo.api.common.icon.ResizableIcon,java.awt.event.ActionListener)

getHelpIcon()

160

161

privada ResizableIcon HelpIcon ;

Cuando helpIconno está null, este oyente será invocado cuando el usuario active el botón de ayuda.

Ver también:

configureHelp(org.pushingpixels.flamingo.api.common.icon.ResizableIcon,java.awt.event.ActionListener)

getHelpActionListener()

169
170

Private ActionListener helpActionListener ;

Estado de visibilidad del grupo de tareas contextual. Debe contener un valor para cada grupo en
contextualTaskGroups.

Ver también:

setVisible(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup,boolean)

isVisible(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)

178

179

Private Mapa < RibbonContextualTaskGroup , Boolean > groupVisibilityMap ;

El menú de la aplicación.

Ver también:

setApplicationMenu(org.pushingpixels.flamingo.api.ribbon.RibbonApplicationMenu)

getApplicationMenu()

186

187

Private RibbonApplicationMenu applicationMenu ;

La rica herramienta de applicationMenubotón.

Ver también:

applicationMenu

setApplicationMenuRichTooltip(org.pushingpixels.flamingo.api.common.RichTooltip)

getApplicationMenuRichTooltip()
195

196

Private RichTooltip applicationMenuRichTooltip ;

La punta clave del applicationMenubotón.

Ver también:

applicationMenu

setApplicationMenuKeyTip(java.lang.String)

getApplicationMenuKeyTip()

204

205
 Privado String applicationMenuKeyTip ;

Indica si la cinta está actualmente minimizada.

Ver también:

setMinimized(boolean)

isMinimized()

212

213

Private boolean isMinimized ;

El marco de cinta de acogida. Es nullcuando la cinta no está alojada en un archivo JRibbonFrame.

218
219

Private JRibbonFrame ribbonFrame ;

La cadena de ID de clase de UI.

223

224

pública estática última cadena uiClassID = "RibbonUI" ;

Crea una nueva cinta vacía. Se recomienda encarecidamente que las aplicaciones utilicen JRibbonFramey
accedan a la cinta con la JRibbonFrame.getRibbon()API.
230

231

pública JRibbon () {

232

esta . tareas = nuevo ArrayList < RibbonTask > ();

233

esta . contextualTaskGroups = nuevo ArrayList < RibbonContextualTaskGroup > ();

234

esta . TaskbarComponents = new ArrayList < Component > ();

235

esta . Bands = new ArrayList < AbstractRibbonBand > ();

236

esta . CurrentlySelectedTask = null ;

237

esta . GroupVisibilityMap = nuevo HashMap < RibbonContextualTaskGroup , Boolean > ();

238

239

UpdateUI ();
240

Crea una cinta vacía para el marco de cinta especificado.

Parámetros:

ribbonFrame Anfitrión marco de la cinta.

247

248

JRibbon ( JRibbonFrame ribbonFrame ) {

419
 pública sincronizado vacío addContextualTaskGroup (

420

Grupo RibbonContextualTaskGroup ) {

421

grupo . SetRibbon ( este );

422

423

esta . ContextualTaskGroups . Añadir ( grupo );

424
 esta . GroupVisibilityMap . Poner ( grupo , falso );

425

426

esta . FireStateChanged ();

427

Devuelve el número de tareas normales en la thiscinta.

Devoluciones:

Número de tareas regulares en la thiscinta.

Ver también:

getTask(int)
addTask(org.pushingpixels.flamingo.api.ribbon.RibbonTask)

435

436

pública sincronizado int getTaskCount () {

437

devolver este . Tareas . Tamaño ();

438

Recupera la tarea normal en el índice especificado.

Parámetros:

index Índice de tareas.

Devoluciones:

Tarea que coincida con el índice especificado.

Ver también:

getTaskCount()

addTask(org.pushingpixels.flamingo.api.ribbon.RibbonTask)

448

449

Público sincronizado RibbonTask getTask ( int index ) {

450

devolver este . Tareas . Obtener ( índice );

451

Devuelve el número de grupos de tareas contextuales en la thiscinta.

Devoluciones:

Número de grupos de tareas contextuales en la thiscinta.

Ver también:

addContextualTaskGroup(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)

getContextualTaskGroup(int)

459

460

pública sincronizado int getContextualTaskGroupCount () {

461

devolver este . ContextualTaskGroups . Tamaño ();

462

Recupera el grupo de tareas contextual en el índice especificado.

Parámetros:

index Índice de grupo.

Devoluciones:

Grupo que coincida con el índice especificado.

Ver también:

addContextualTaskGroup(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)

getContextualTaskGroupCount()

472
473

Público sincronizado RibbonContextualTaskGroup getContextualTaskGroup (

474

Int index ) {

475

devolver este . ContextualTaskGroups . Obtener ( índice );

476

}
Selecciona la tarea especificada. La tarea puede ser regular (agregada
conaddTask(org.pushingpixels.flamingo.api.ribbon.RibbonTask)) o una tarea en un grupo de tareas contextual
visible (se agrega
conaddContextualTaskGroup(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup).) Inicia
unselectedTaskevento de cambio de propiedad.

Parámetros:

task Tarea para seleccionar.

Tiros:

java.lang.IllegalArgumentException Si la tarea especificada no está en la cinta o no está visible.

Ver también:

getSelectedTask()

490

491

pública sincronizado vacío setSelectedTask ( RibbonTask tarea ) {

492
 Boolean válido = esto . Tareas . Contiene ( tarea );

493

If (! Valid ) {

494

Para ( int i = 0; i < this . GetContextualTaskGroupCount (); i ++) {

495

RibbonContextualTaskGroup group = this

496

. GetContextualTaskGroup ( i );

497
 si (! esto . isVisible ( grupo ))

498

Continuar ;

499

Para ( int j = 0; j < grupo . GetTaskCount (); j ++) {

500

si ( grupo . getTask ( j ) == tarea ) {

501

Valid = true ;
502

romper ;

503

504

505

Si ( válido )

506

romper ;
507

508

509

If (! Valid ) {

510

arrojar nueva IllegalArgumentException (

511
 "La tarea especificada que se va a seleccionar no es"

512

+ "Parte de esta cinta o no está marcada como visible" );

513

514

515

Para ( AbstractRibbonBand ribbonBand : this . Bandas ) {

516
 RibbonBand . SetVisible ( false );

517

518

esta . bandas . Clear ();

519

520

Para ( int i = 0; i < tarea . GetBandCount (); i ++) {

521
 AbstractRibbonBand ribbonBand = tarea . GetBand ( i );

522

RibbonBand . SetVisible ( true );

523

esta . bandas . Añadir ( ribbonBand );

524

525

526
 RibbonTask viejo = este . ActualmenteSelectedTask ;

527

esta . CurrentlySelectedTask = tarea ;

528

529

esta . Revalidar ();

530

esta . Repintar ();

531
532

esta

533

. FirePropertyChange ( "selectedTask" , antiguo ,

534

esta . ActualmenteSelectedTask );

535

Devuelve la tarea seleccionada actualmente.

Devoluciones:

La tarea actualmente seleccionada.

Ver también:

setSelectedTask(org.pushingpixels.flamingo.api.ribbon.RibbonTask)

542

543

Público sincronizado RibbonTask getSelectedTask () {

544

devolver este . ActualmenteSelectedTask ;

545

}
546

547

Todos los derechos reservados

548

* (No Javadoc)

549

550

* @see javax.swing.JComponent # updateUI ()

551

* /

552

@ Override

553

pública vacío updateUI () {

554

si (UIManager. obtener ( getUIClassID ())! = nula ) {

555
 SetUI (UIManager. GetUI ( este ));

556

} Else {

557

SetUI ( nuevo BasicRibbonUI ());

558

559

Para ( componente comp : this . TaskbarComponents ) {

560
 SwingUtilities. UpdateComponentTreeUI ( comp );

561

562

Devuelve el objeto UI que implementa el L & F para este componente.

Devoluciones:

Un RibbonUIobjeto

Ver también:

javax.swing.JComponent.setUI(javax.swing.plaf.ComponentUI)

569
570

pública RibbonUI getUI () {

571

Return ( RibbonUI ) ui ;

572

573

574
 Todos los derechos reservados

575

* (No Javadoc)

576

577

* @see javax.swing.JComponent # getUIClassID ()

578

* /

579
 @ Override

580

pública Cadena getUIClassID () {

581

Return uiClassID ;

582

Obtiene una lista no modificable de todos los componentes de la barra de tareas de la this cinta.

Devoluciones:

Todos los componentes de la barra de tareas de la thiscinta.

Ver también:

addTaskbarComponent(java.awt.Component)

removeTaskbarComponent(java.awt.Component)

591

592

pública sincronizada Lista < Componente > getTaskbarComponents () {

593

Return Colecciones. unmodifiableList ( este . taskbarComponents );

594

}
Agrega el detector de cambios especificado para realizar un seguimiento de los cambios en esta cinta.

Parámetros:

l Cambiar audiencia para agregar.

Ver también:

removeChangeListener(javax.swing.event.ChangeListener)

602

603

pública vacío addChangeListener ( ChangeListener l ) {

604

esta . ListenerList . añadir ( ChangeListener . clase , l );

605
 }

Elimina el detector de cambios especificado de los cambios de seguimiento a esta cinta.

Parámetros:

l Cambiar audiencia para eliminar.

Ver también:

addChangeListener(javax.swing.event.ChangeListener)

614

615

pública vacío removeChangeListener ( ChangeListener l ) {

616
 esta . ListenerList . eliminar ( ChangeListener . clase , l );

617

Notifica a todos los oyentes registrados que el estado de esta cinta ha cambiado.

622

623

protegida void fireStateChanged () {

624

// Garantizado para devolver un array no nulo

625

Objeto [] listeners = esto . ListenerList . GetListenerList ();

626

// Procesar a los oyentes primero, notificando

627

// los que estén interesados en este evento

628

ChangeEvent event = new ChangeEvent ( this );

629
 para ( int i = oyentes . longitud - 2; i > = 0; i - = 2) {

630

si ( oyentes [ i ] == ChangeListener . clase ) {

631

(( ChangeListener ) oyentes [ i + 1]). StateChanged ( evento );

632

633

634
 }

Establece la visibilidad de las tareas de la cinta de opciones en el grupo de tareas contextual

especificado. La visibilidad de todas las tareas de la cinta en el grupo especificado se ve afectada. Tenga
en cuenta que la cinta puede mostrar tareas de cinta de varios grupos al mismo tiempo.

Parámetros:

group Grupo de tareas contextuales.

isVisible Si true, todas las tareas de la cinta en el grupo especificado serán visibles. Si false, se
ocultarán todas las tareas de la cinta en el grupo especificado.

Ver también:

isVisible(org.pushingpixels.flamingo.api.ribbon.RibbonContextualTaskGroup)

649

650

pública sincronizado vacío setVisible ( RibbonContextualTaskGroup grupo ,

651