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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
. t% O) C$ `7 G

经典界面到RIbbon界面转换

在经典界面下，需要的文件

• customer_men.men
• customer_toolbar.tbr
  8 u& T+ z  Q2 Z0 t

在ribbon界面下你可能需要的文件
! i+ {' I! ~% z% U

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  : U0 |) w7 T) q) {& p

+ X$ I& L9 r5 [: Z/ i5 z4 q0 m! K, @
2 }# H* M0 A! k9 N, g# S举例如下：
$ S- M5 d/ c" i

: T0 r- O/ u( o) z3 ?customer_men.men
3 V, a7 l( s& T7 D!
4 f# m7 k" `* n# I2 r; j: x$ X!  Customer menu file
!
!  Contains button definitions to be used in
& w' U) K* W3 A, q- v) f!  toolbars and Ribbon files
!
- t0 U/ B1 q# O+ W% X
; B( h: }, F+ s* u# HVERSION 120

8 @9 l% S; w. l3 L- Q3 |EDIT UG_GATEWAY_MAIN_MENUBAR
3 U% I9 d8 [% t1 I8 G2 v* g1 o
5 ]# v6 l) N6 zTOP_MENU
0 g% Q8 `; j+ p$ p6 R    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu

  i; S6 v. u: V3 J) U2 d1 mEND_OF_TOP_MENU
+ w0 }; R1 `+ M9 T8 o# L7 V
: m0 b9 r, r! \& k( QMENU CUSTOMER_MENU

9 M0 v4 h0 w1 |2 ?! |, Q# i    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
        RIBBON_LABEL Ribbon Button1
  f& {0 S5 |2 p+ x        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen

# `5 n6 v/ \) H( B, u3 Z    BUTTON CUSTOMER_BUTTON_2
7 J3 \+ h' B4 D7 P8 r    LABEL Menu Button2
        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
  N* z2 {: N5 C: y3 C    BITMAP filesave

% K& m) b8 O( B% u. b+ x: h    BUTTON CUSTOMER_BUTTON_3
7 s. a/ k! I  r4 k6 ~  \  r    LABEL Menu Button3
        RIBBON_LABEL Ribbon Button3
, f8 v  |+ E' N+ p+ T        TOOLBAR_LABEL Toolbar Button3
    BITMAP current_feature

' O; X/ L6 B4 L( m  n# ~    BUTTON CUSTOMER_BUTTON_4
8 n' D6 s' ]8 _& T- @    LABEL Menu Button4
        RIBBON_LABEL Ribbon Button4
- |5 V/ I0 C5 @        TOOLBAR_LABEL Toolbar Button4
    BITMAP block

    BUTTON CUSTOMER_BUTTON_5
    LABEL Menu Button5
3 W- ^; ^" n' F1 r% l3 M! u- \        RIBBON_LABEL Ribbon Button5
3 _! ^; V, e( H' ?; B8 t        TOOLBAR_LABEL Toolbar Button5
    BITMAP checkgreen

END_OF_MENU
7 t) n' m: |! K, }


customer_ribbon_tab.rtb
' d/ _4 h* K; W) a- t' G!
!  Customer Ribbon Tab
!
" K, _* k$ r2 A, u6 N!  This file will create a new customer tab containing three groups and
2 n" k+ A5 n' N/ j0 E/ `!  one top level button.
; i/ S3 R7 f$ }. I1 k5 i/ i( l7 V!
. k& p% s) @( E$ q+ J
2 z" h: M! b, l( {1 T6 GTITLE  Customer Tab
  [) f+ ^% L2 n7 E. A1 u/ VVERSION 170

: `# r" e+ a' g' W8 N1 |; H' G5 f!  The first group represents a Ribbon group that references an existing
" A# y+ L2 ^4 `!  toolbar with no Ribbon style changes.  
!
!  This is the quickest way to add existing toolbar content into Ribbon mode.
% p: c% u  s& M!
$ k0 D2 t4 s; {, ^GROUP  customer_toolbar.tbr

7 b7 m# r8 {) C$ R: M. c. V!  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
2 ?; f9 `! `. `" Z) Y4 R7 i!  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
!  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
!  will need to be maintained while still making use of RIBBON_STYLE to
  V3 h6 O; E- w) t!  control the presentation of the buttons on the Ribbon.
!
) c9 O$ T+ H3 n& D+ A" |2 BGROUP  customer_toolbar_alternate.tbr

!  The third group represents a Ribbon group that has been created explicitly
8 i) w+ u& a, H6 d+ `) K!  as a Ribbon group and will not exist in Classic Toolbar mode.  This is the
2 m5 T/ V- B+ D& F: D* b8 l!  preferred option since the user will be able to take advantage of all the
! d* A9 W5 M$ A7 {3 T2 J7 O!  layout styles and containers offered by the Ribbon.  
, X$ B, v! W' O, L7 i!
( d8 ~! y9 w! G) x2 h4 w/ ]!  For customers that will deploy both Ribbon and Classic Mode customizations,
!  this approach will result in no synchronization and two sets of customizations
!  will need to be maintained.
8 l$ W9 T6 [. O9 J5 o+ \: r!
2 E, I' F0 c/ q- i  u: U, q!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
!
GROUP  customer_group.grb
$ D$ j( t* \2 h# r' r% L: y5 [8 `; k
!  Example of a button that is placed directly on the Ribbon without being
4 J4 g7 l* u7 ^' N!  contained in a group.  This is a simple way to add a button to a tab
. Y. ]$ F- ^- d& {!  but is not recommended for many buttons since groups have advantages.
% I( h2 f; Z+ z5 Q: d, X- j!  
8 u6 u2 j. }# S7 w) Z' Y# F!  A few advantages of groups:
!     1. Easier to move many buttons around together in quick customization.  
: P" r9 f2 u" M0 M& `) ^* m!        For example, MB3 on a group and choose "Add to Left Border Bar".  
, g, M9 h( M. a- O!        This will move the whole group to a new location.  If buttons are
+ }, S# B+ p3 |+ G2 _: z!        not in a group, they need to be moved one at a time.
!
: d9 l# z7 v) k6 E!     2. Provide a label to describe its contents.
0 D$ n# Q( m, D' F9 r9 t% U!
# `9 I; ^/ _5 d8 [' _1 PBUTTON CUSTOMER_BUTTON_1
, C) R2 e3 c1 C8 a/ o  R4 NLABEL Button1 Directly on Tab
% A& K- O: X- ^2 l9 |, ?/ P


5 u% Y1 ~' _( h- p/ H  S7 f3 [+ zcustomer_toolbar.tbr
6 ]3 a8 V+ r, R. W6 D!
3 T  s) W* I2 G7 X!  Customer Toolbar File
!
7 u9 R6 m' V, o2 X( `; {!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
9 z5 F- D2 H1 e- D4 {9 H3 D+ e!
!  In Classic Toolbars mode - This toolbar will still show up in the
( z" U" t# k: T  O!     toolbars list.
& W% o+ W5 T# g4 W9 |4 y1 Z!
: g8 k3 J8 e* J) s# S* O!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
1 Q1 a" @* J6 \) m- i( p; Z!     section in the Customize dialog.
!  

- }- F; d* l3 f  J9 ^( ETITLE Toolbar
1 s5 T2 E/ q4 `. ]0 mVERSION 170
. ^8 t" i$ X8 {& v
( B: |5 X3 [7 J# D3 o3 f6 LBUTTON CUSTOMER_BUTTON_1

+ |8 B4 i8 w; r+ _6 O7 Y4 v' L, SBUTTON CUSTOMER_BUTTON_2

BUTTON CUSTOMER_BUTTON_3
. ?+ q- B2 B+ M
# ~0 _' }6 I% N1 V4 V0 TBUTTON CUSTOMER_BUTTON_4
( K9 i) W, _/ N/ e. U. Q, O
BUTTON CUSTOMER_BUTTON_5

5 |5 [0 }" M' k
( i6 s% k4 N0 \: V
9 l1 o1 f, |$ p2 v1 K5 Xcustomer_toolbar_alternate.tbr
0 B' O1 c+ N6 T/ H5 a! E4 q& L4 N!
- f# m, y2 X2 g0 H% p  u5 |!  Customer Toolbar File (Alternate)
!
3 Y0 A6 u" A  i% E& m6 V. Z!  This is similar to an existing toolbar file with new
!  Ribbon styles added.
1 n4 G: ?( j8 H* Y& h4 J0 D!  
3 M- M: M) Q: G+ Z!  The RIBBON_STYLE will be honored when the toolbar is loaded
; N+ t& ^3 t: C0 \: q7 n!  in Ribbon mode as a group but will be ignored when the toolbar
  S3 w9 Q# Z8 I0 c!  is displayed in Classic Toolbars mode.
!
!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
!
!  In Ribbon mode - This toolbar will be automatically converted to a
4 h) p& V9 R+ F$ I* ~7 u6 E!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
!

$ ^! I+ h# h9 K, V+ vTITLE Toolbar (Alternate)
VERSION 170
* ]) v! T3 `/ i% U" u2 Y
; G, y! r( o( i  w# _( BBUTTON CUSTOMER_BUTTON_1
! C7 m5 Z, E* o3 |5 r: W: uLABEL Toolbar(Alt) Button1
  r9 @) u) D% J7 ARIBBON_STYLE LARGE_IMAGE
( R) O) P# U* u2 g7 ~) X! A
BUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
1 f( X- g1 }- w) ZRIBBON_STYLE LARGE_IMAGE
7 {# e9 D: E' Q1 Z2 d( b+ d4 H
BUTTON CUSTOMER_BUTTON_3
LABEL Toolbar(Alt) Button3
+ h$ _  A- P. z# ]RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_4
, w& [8 M. ]' }2 T  ILABEL Toolbar(Alt) Button4
( t/ \  l! K# i9 K! I  F3 B( q3 URIBBON_STYLE SMALL_IMAGE_AND_TEXT
0 c9 F/ Z7 t* L9 `/ R6 j
3 G! Q* @. R: j( x+ H8 QBUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT
7 Q) M/ Z8 }: w. E$ o

: m" r* @/ p% L, Q  c- t
' @* \1 W5 H: ^9 v  J/ e( Vcustomer_group.grb
6 f- J3 P( }6 I7 Z& G* C/ d!
!  Customer Ribbon Group File
!
# r+ E% I/ x8 T. P+ s3 w( L!  In Classic Toolbars mode - This group will be unavailable
!
!  In Ribbon mode - This group will show up in the "All Groups" list
* t2 X' a# ]8 x( j3 h1 s" v* }  j!     in the Customize dialog.
/ d' ^' S; S$ J/ r* e% ^: W7 V!
!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!

' n4 d2 U+ n3 _TITLE Group
VERSION 170
: C. v$ y4 A, H
!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
0 u! r' M) a% Z6 b3 G$ V, KBUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE

9 I. _8 `  x" e( b# \!  Example of a gallery defined in a GRB file.
!
!  If this gallery is to be used in other places, then it could be
  K2 `! e' i- ]6 }% j!  defined in its own gallery (GLY) file and referenced here
# E5 f  |( C( f: }!  Example:
3 t) p: v3 D+ [& J! e!    GALLERY customer_gallery.gly
9 W5 ?& v( c; A+ T!
( l& ?* M* q# V  ~" N2 yBEGIN_GALLERY  CUSTOMER_GALLERY
5 W  Z# s. X3 K, G' R! Z% eCOLUMN_IN_RIBBON 2
COLUMN_IN_POPUP 2
& {, j& u) E$ O% O- D, \* l6 M) xLABEL Gallery
GALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
  y# D% ?% U. ]# R! r
$ _9 M7 H& n* B# z6 H    BUTTON CUSTOMER_BUTTON_2
1 \8 m3 D1 ]+ B: J, e0 a) Y0 q) b
    BUTTON CUSTOMER_BUTTON_3
; `0 d0 G; M0 k
$ I5 q& P/ C( k5 y; R  H    BUTTON CUSTOMER_BUTTON_4
- w9 X+ h. q2 n8 H8 _; r# h
    BUTTON CUSTOMER_BUTTON_5
, A( P2 M& ]/ s. _( U1 j- j
# X% s1 L4 f% w4 ?END_GALLERY
5 I, q) I$ |, b& X* @% M

4 B5 B* n  k% M# E/ `4 M