关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧

经典界面到RIbbon界面转换

; ^- a) k9 X5 C) j在经典界面下，需要的文件
# q# D; H8 f. t4 N9 q0 T( ~( N: O

• customer_men.men
• customer_toolbar.tbr
  ! s4 A1 T: v3 F' @

在ribbon界面下你可能需要的文件

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  9 ^7 ^4 s/ O/ ~+ s4 ?( s1 y

& T" ?  B" l9 ~' ^' s
举例如下：
- e" P# h* h- W" J. R) N

* ~, r3 K% L4 `0 w) p7 s8 }, Fcustomer_men.men
" K7 R# S3 i( @+ T9 t!
/ j: V3 j* Y0 r!  Customer menu file
!
3 Y7 |( ^  b) d) c!  Contains button definitions to be used in
& O+ A# y9 u5 w!  toolbars and Ribbon files
: s, r- n+ t. }4 c* ]& m# y!
4 M% R4 Z! U9 q: i8 z* [
2 O! w/ e6 G: {# i& {' P# `VERSION 120

EDIT UG_GATEWAY_MAIN_MENUBAR

& u  D( `2 Z; T7 Z2 tTOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
% j2 t6 Q  ?, N+ {5 i- {    LABEL Customer Menu

END_OF_TOP_MENU
: r  C( [0 \6 o/ j
MENU CUSTOMER_MENU

4 @$ V  k9 B5 @) ]; x8 G    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
        RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen
1 L' p5 R0 Z% o2 a, G
2 f  r. {0 M9 F  a    BUTTON CUSTOMER_BUTTON_2
# m+ T1 a( w. k& }9 o" @    LABEL Menu Button2
        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
    BITMAP filesave

    BUTTON CUSTOMER_BUTTON_3
( U% S- e) @) ^    LABEL Menu Button3
        RIBBON_LABEL Ribbon Button3
2 F9 p% W3 p9 Z        TOOLBAR_LABEL Toolbar Button3
, T5 q. b+ d- x. t; w    BITMAP current_feature

    BUTTON CUSTOMER_BUTTON_4
) V: W' y+ l$ N+ e7 D2 Q    LABEL Menu Button4
* k$ q6 }0 d: w8 r: d' y; S, p: L        RIBBON_LABEL Ribbon Button4
        TOOLBAR_LABEL Toolbar Button4
    BITMAP block

    BUTTON CUSTOMER_BUTTON_5
' f( z! D" V$ k9 m% ?- z& a, c) N    LABEL Menu Button5
/ ?0 o! `3 W3 K. H        RIBBON_LABEL Ribbon Button5
  E% L# K2 X7 A/ y8 p" R% ?$ Z        TOOLBAR_LABEL Toolbar Button5
1 v$ h! R0 ~8 {4 G- N/ _2 N    BITMAP checkgreen

* L/ H4 P% m& ^" y% e6 ]END_OF_MENU


6 K. C3 g/ a/ w, q4 J
customer_ribbon_tab.rtb
!
!  Customer Ribbon Tab
5 Y! X8 [% O: `7 D!
6 U6 r4 C& R* v9 _! G2 @6 i  ^% k0 W!  This file will create a new customer tab containing three groups and
!  one top level button.
!

TITLE  Customer Tab
VERSION 170
' ]( g) _2 `6 B+ @) g+ X$ x( r
; Q1 w( _, _! k; [!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
$ l4 |8 r6 u* G% ]- Z2 m/ p!
  e( d' f7 }4 k7 e% e/ N!  This is the quickest way to add existing toolbar content into Ribbon mode.
& e3 q% N9 [+ Q! U5 p!
GROUP  customer_toolbar.tbr

# i5 Q3 c- ~  y9 W+ j& K- A!  The second group represents a Ribbon group that references an existing
!  toolbar with Ribbon specific style changes added to it.  There is no difference
!  in how this toolbar is referenced in the .rtb file compared to the first
0 r" x# o8 P4 A/ R5 y% h$ D/ o3 ]!  toolbar as a group.  The only differences from the first group exist within
!  the .tbr file itself.
!
!  This approach has advantages for customers that will deploy both Ribbon and
2 v' [4 I: l7 d2 I( }% ~!  Classic Mode customizations since all the content is defined in the .tbr
!  file and it will stay synchronized in both modes.  Only one set of customizations
( q) D3 U  y. p& d# n. T" M!  will need to be maintained while still making use of RIBBON_STYLE to
!  control the presentation of the buttons on the Ribbon.
1 ]0 c2 m; a5 D3 |( V' V5 o!
  B) N5 e: w* kGROUP  customer_toolbar_alternate.tbr

" ~5 [6 p9 o+ \; A) J) c4 J!  The third group represents a Ribbon group that has been created explicitly
" t4 g/ ]: `' G!  as a Ribbon group and will not exist in Classic Toolbar mode.  This is the
!  preferred option since the user will be able to take advantage of all the
!  layout styles and containers offered by the Ribbon.  
!
9 D+ N1 u( @$ E* i. z. P5 A$ ]!  For customers that will deploy both Ribbon and Classic Mode customizations,
; g: S/ p) J4 m5 P!  this approach will result in no synchronization and two sets of customizations
9 s7 \' [9 q2 J* J* W!  will need to be maintained.
!
( M+ s. `( C! X) @. E9 L!  A group can alternatively be defined directly inside the .rtb file by using the
/ f! ?1 }5 u# h!  keywords BEGIN_GROUP and END_GROUP.  
- r$ C3 P  m6 F8 R!
* R7 {; {6 |* QGROUP  customer_group.grb

/ E7 `7 @1 A) w$ g: t; B0 s!  Example of a button that is placed directly on the Ribbon without being
!  contained in a group.  This is a simple way to add a button to a tab
!  but is not recommended for many buttons since groups have advantages.
!  
. l' [2 G0 \" w, D  ]!  A few advantages of groups:
% W. B8 L! d) t3 G!     1. Easier to move many buttons around together in quick customization.  
!        For example, MB3 on a group and choose "Add to Left Border Bar".  
$ j8 J1 ?) J% ^9 r0 ]" w!        This will move the whole group to a new location.  If buttons are
) x* p+ O% e9 H: g6 Q!        not in a group, they need to be moved one at a time.
% b0 P, M3 z1 p' M$ I7 D!
8 |6 P$ L% u5 Z# A( O& _!     2. Provide a label to describe its contents.
!
BUTTON CUSTOMER_BUTTON_1
. `9 W) V5 }8 }: d. Q2 K: x1 sLABEL Button1 Directly on Tab



% F9 c3 s1 V4 Q, X0 ]& {% y7 s3 tcustomer_toolbar.tbr
!
!  Customer Toolbar File
9 s% Q' R" i. M% R$ S& z! t!
" |7 L# k$ q' E6 K9 _7 v7 {!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
! t$ \. I% u6 R! E7 {!
!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
/ z% ~# i4 R' }4 ~+ c% P  L!
!  In Ribbon mode - This toolbar will be automatically converted to a
3 s. S) Y7 O5 F# i1 D7 h) N!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
6 z0 D1 i- P1 N1 R3 f!  
9 S% }9 V7 w  k# q6 A  z' o
TITLE Toolbar
VERSION 170

; l3 ]. Y) v. b# [BUTTON CUSTOMER_BUTTON_1
7 o% Q' [2 f6 `# D
+ o0 x+ ]& ^& }5 g+ EBUTTON CUSTOMER_BUTTON_2

BUTTON CUSTOMER_BUTTON_3
/ m* E/ H, }% k7 o' [
BUTTON CUSTOMER_BUTTON_4
  |; D: s6 [6 N  U% R$ w+ b; p" i9 E
. M9 T' C6 U, v) n" R3 P6 @: tBUTTON CUSTOMER_BUTTON_5
3 A7 c- B- e, g
; N4 q+ \. o1 x" N& Q, v  v
4 g8 l! S4 F5 h' `8 D+ ~& V& @
customer_toolbar_alternate.tbr
* @  Q- v4 l- X9 h( R!
!  Customer Toolbar File (Alternate)
!
!  This is similar to an existing toolbar file with new
!  Ribbon styles added.
2 ]  o$ n  L5 Q!  
!  The RIBBON_STYLE will be honored when the toolbar is loaded
!  in Ribbon mode as a group but will be ignored when the toolbar
9 H( V  V/ [9 q5 y. |% ]3 M!  is displayed in Classic Toolbars mode.
4 r, [3 C  F$ w* ]1 H!
!  In Classic Toolbars mode - This toolbar will still show up in the
1 H2 ]; b- B- v1 I! w5 L7 n5 W! e!     toolbars list.
!
!  In Ribbon mode - This toolbar will be automatically converted to a
& ]; `6 [' T' g# }' n' i!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
!

TITLE Toolbar (Alternate)
* T( X$ \% ^" y* F( VVERSION 170

0 @' E& z7 z% [3 z! p8 z1 a/ _BUTTON CUSTOMER_BUTTON_1
LABEL Toolbar(Alt) Button1
RIBBON_STYLE LARGE_IMAGE
* _- Y0 h) D. t) I) ^4 [& F# r) k
BUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
/ P, R( g4 N6 ?: U% h; d, J! uRIBBON_STYLE LARGE_IMAGE

( Q6 I8 f2 _" J% X5 lBUTTON CUSTOMER_BUTTON_3
9 d: B) x  T1 _3 {( L2 |LABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

! P7 r/ C6 d7 _5 S8 l  o6 s2 n) gBUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
2 |+ V( _+ P6 p# u5 v" dRIBBON_STYLE SMALL_IMAGE_AND_TEXT
4 y7 H3 F) {0 d& q! a3 Z, x/ L* F
BUTTON CUSTOMER_BUTTON_5
& w" u9 @  c- Q" V5 J2 y8 vLABEL Toolbar(Alt) Button5
$ w3 l  ~; T" a) Y& {7 \RIBBON_STYLE SMALL_IMAGE_AND_TEXT
: L6 f' F7 q1 L: W7 m9 X6 c
. e/ m4 n& N6 n- w* f
4 d0 E, J7 e# V5 c/ |/ z
0 P! o4 U& d. M/ ?& ?% ]6 Vcustomer_group.grb
# O  Y- l+ C  d1 _' d6 }  ~, S!
. u' t6 }; K: [2 r! T- p  ^!  Customer Ribbon Group File
5 l3 D! {( z) g0 \3 i% ]!
!  In Classic Toolbars mode - This group will be unavailable
5 n/ G3 }2 {# t# O- p!
!  In Ribbon mode - This group will show up in the "All Groups" list
!     in the Customize dialog.
. Q$ z2 `! Y6 S% W  s* l6 z1 f+ L!
+ x' K( Z* @. `!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!
8 V. x2 K% P4 Q1 _6 m
- ]9 n* P) ]2 Q' j, Q+ `1 d) H7 k. YTITLE Group
VERSION 170

5 D" f( d$ {( h7 J!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
. d* z) x5 U7 HRIBBON_STYLE LARGE_IMAGE
$ Z+ O9 q1 y- L, f
!  Example of a gallery defined in a GRB file.
: ~# e6 d* U& f+ l3 v, @! Q!
/ o, g* ~  A/ M  \. Q) h* Y! r!  If this gallery is to be used in other places, then it could be
# o8 {# M7 }6 I! R% y7 \+ I' D!  defined in its own gallery (GLY) file and referenced here
" H$ P9 n# G* N% v!  Example:
!    GALLERY customer_gallery.gly
!
2 ^6 c  |1 C  |& S& yBEGIN_GALLERY  CUSTOMER_GALLERY
8 D) X! Q# X  C  l2 NCOLUMN_IN_RIBBON 2
COLUMN_IN_POPUP 2
LABEL Gallery
$ ?0 x4 h# W+ I/ M3 @& TGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
7 R1 E2 s. f6 Y& e' A- @
    BUTTON CUSTOMER_BUTTON_2
5 o- p& [- w! H% g7 G4 n
    BUTTON CUSTOMER_BUTTON_3

$ N1 m9 @; t% \! S    BUTTON CUSTOMER_BUTTON_4
/ }6 t* ]3 k- q- ], A2 F3 X: Z7 _* z
& K: n* R, ^' ~' T! r    BUTTON CUSTOMER_BUTTON_5

0 H2 E! G" F3 X5 V0 }  VEND_GALLERY