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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
% h" s* R! y6 p  S4 r8 U

经典界面到RIbbon界面转换

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

• customer_men.men
• customer_toolbar.tbr
  

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

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  " O  q$ m/ b- u: Z

9 n/ z- Q; Y9 j% t7 j
" v6 e0 ^& S3 C4 g' d  j- E6 F+ J举例如下：
( j0 M, I7 C  ?6 s

customer_men.men
!
!  Customer menu file
!
!  Contains button definitions to be used in
1 W2 V/ p- D* T!  toolbars and Ribbon files
. V% [+ \9 l" B- _6 a" ^!
$ H* H& K9 Q, V* b9 A  Y, j9 i
+ S; U8 n) |2 ~- U' r) u3 RVERSION 120
3 l3 }1 H, m5 r% e$ g+ }
1 `- I: C6 l/ a1 _EDIT UG_GATEWAY_MAIN_MENUBAR
9 ]* T# o2 d; `7 {
8 e6 f5 n" |: `: M3 Q9 C) Y8 PTOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
5 M. ~! r4 J( S6 \# I. N    LABEL Customer Menu
  n  C( y0 q  Y: m; o
: G; B( t" y2 i/ M: W2 IEND_OF_TOP_MENU
& V# C" `* n0 T, {( U- ~* g$ G+ \
2 a. P7 |) t6 s3 H/ `8 l+ iMENU CUSTOMER_MENU

    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
" l- _4 J7 k' y         RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen
( Z9 f  m+ s$ D2 }" P7 c) @8 m4 e2 D# k
    BUTTON CUSTOMER_BUTTON_2
, i! W# Z. Y4 f8 W+ F9 J    LABEL Menu Button2
9 c1 r* I3 V" E9 b        RIBBON_LABEL Ribbon Button2
% ~9 g, L8 e3 G. o* L        TOOLBAR_LABEL Toolbar Button2
+ g) m  b6 k' o7 c    BITMAP filesave
4 L0 _) {' S3 l1 N* h6 F1 c
    BUTTON CUSTOMER_BUTTON_3
- M; L0 {8 c2 C. ^2 j& |* i/ p* [    LABEL Menu Button3
+ g& p3 m3 Z. w1 B0 x& O5 i        RIBBON_LABEL Ribbon Button3
' m5 G/ c8 b. h' C  B5 b+ \9 {2 `5 G        TOOLBAR_LABEL Toolbar Button3
* i# p0 s' O# W* _! v    BITMAP current_feature
7 x: r2 `! n* ], F4 r; D7 M
    BUTTON CUSTOMER_BUTTON_4
" I# B2 p/ O' g, j6 `! B! M    LABEL Menu Button4
        RIBBON_LABEL Ribbon Button4
        TOOLBAR_LABEL Toolbar Button4
) a( s6 w7 O: a& `& E! K    BITMAP block
! E/ P. N0 @( k& v
    BUTTON CUSTOMER_BUTTON_5
    LABEL Menu Button5
5 ~6 R6 }/ c& l# _# n        RIBBON_LABEL Ribbon Button5
        TOOLBAR_LABEL Toolbar Button5
1 H8 t; t, o2 m8 V    BITMAP checkgreen
3 h+ v: O( Z5 J) }. |& i
END_OF_MENU
0 K' H. N- {+ A% Q8 l
# R3 i( J: @6 o1 z( d9 r

3 V1 V7 T# `, S0 q2 B8 ^  n8 Lcustomer_ribbon_tab.rtb
!
!  Customer Ribbon Tab
$ T7 i  [/ }! D9 m- z$ d, `!
+ u- E& {! U* [4 |$ g. O!  This file will create a new customer tab containing three groups and
!  one top level button.
!

TITLE  Customer Tab
9 ?6 `" f4 J& H  H, ZVERSION 170

1 G/ |9 b3 K9 A4 W- C+ m3 N5 C+ K!  The first group represents a Ribbon group that references an existing
0 J: b9 M( A4 B, M; ]$ {!  toolbar with no Ribbon style changes.  
!
!  This is the quickest way to add existing toolbar content into Ribbon mode.
!
GROUP  customer_toolbar.tbr

* r8 r1 i1 Y7 O  Q. l!  The second group represents a Ribbon group that references an existing
: h1 g9 A4 W/ l; e!  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
, K7 z1 V0 Y3 @$ `8 ^3 d!  toolbar as a group.  The only differences from the first group exist within
3 L6 a  b' k' z2 c  D!  the .tbr file itself.
!
!  This approach has advantages for customers that will deploy both Ribbon and
5 @0 X, b  r5 [! f!  Classic Mode customizations since all the content is defined in the .tbr
* H) d2 Q/ a' X* X2 X0 o!  file and it will stay synchronized in both modes.  Only one set of customizations
. |8 t+ @- }1 g0 d1 n1 d: |!  will need to be maintained while still making use of RIBBON_STYLE to
# M. h' L7 l& C9 t5 i( g7 N!  control the presentation of the buttons on the Ribbon.
2 }$ L! _+ Y3 P; a% m/ m/ w( V: P!
7 f/ b, r! t, E+ O3 Z( |GROUP  customer_toolbar_alternate.tbr

5 d, I0 B* R& Z2 h, ?6 u1 i( \+ C!  The third group represents a Ribbon group that has been created explicitly
!  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.  
!
) b1 G9 L' t# s- `, Q+ ~, F& b!  For customers that will deploy both Ribbon and Classic Mode customizations,
! @0 v: q6 r2 [! J8 q!  this approach will result in no synchronization and two sets of customizations
!  will need to be maintained.
!
) A0 J) M- S: c$ f$ R!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
!
# t  {+ D7 Y2 HGROUP  customer_group.grb

: T& _+ m8 F. t!  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
9 X* W8 z7 {# ]( f# z6 G+ w9 |!  but is not recommended for many buttons since groups have advantages.
6 |- g  y6 G+ r. b( L/ J' M!  
0 u+ ~1 x$ Z9 l' a* u5 m( R6 A!  A few advantages of groups:
/ f/ e7 L% S: r: C6 \* V' \, g; P8 f!     1. Easier to move many buttons around together in quick customization.  
!        For example, MB3 on a group and choose "Add to Left Border Bar".  
!        This will move the whole group to a new location.  If buttons are
!        not in a group, they need to be moved one at a time.
# I8 v( G$ h5 s!
' h) @! A7 e7 I( l* g!     2. Provide a label to describe its contents.
! K, ~+ ?6 S3 e5 J, V( H8 ]4 m' Z!
BUTTON CUSTOMER_BUTTON_1
- W5 Z/ T% b4 b1 F. R: x1 CLABEL Button1 Directly on Tab



customer_toolbar.tbr
!
!  Customer Toolbar File
) b( c4 g9 z# U!
!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
!
!  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
- j1 r( q, M6 V3 X!     Ribbon group and will appear in the "Classic Toolbars as Groups"
5 r$ m4 l% h6 R% r7 ~!     section in the Customize dialog.
2 ^6 Y* J/ H  ]3 t* t  s!  

TITLE Toolbar
VERSION 170

BUTTON CUSTOMER_BUTTON_1
# h; u) W  f5 s/ n: l
BUTTON CUSTOMER_BUTTON_2

2 `- i8 K! Q+ F. H! ]% F- L9 a, HBUTTON CUSTOMER_BUTTON_3

BUTTON CUSTOMER_BUTTON_4

BUTTON CUSTOMER_BUTTON_5
& n6 }: l. z8 p. B; P

5 W4 j8 H4 J( v8 d) `
# f- o$ E8 w0 T0 g( [$ l0 Q6 M  Xcustomer_toolbar_alternate.tbr
!
!  Customer Toolbar File (Alternate)
!
) T' R0 e! s) e!  This is similar to an existing toolbar file with new
!  Ribbon styles added.
!  
!  The RIBBON_STYLE will be honored when the toolbar is loaded
!  in Ribbon mode as a group but will be ignored when the toolbar
/ n  O/ S$ R: d- u!  is displayed in Classic Toolbars mode.
!
  K- D$ S! ^+ z0 k1 m3 G+ h!  In Classic Toolbars mode - This toolbar will still show up in the
& v6 }0 y6 [( J  i!     toolbars list.
& K/ E& K0 J$ t; X# ~& }- M!
6 `2 }, z1 t) S) G0 }% E; s!  In Ribbon mode - This toolbar will be automatically converted to a
  C( q  d8 p% G!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
6 q& o; _' h: v3 R. ^!
  X% Y: H$ Y6 P. K' G: p5 N, @
) U" c# m) ^+ o: g8 n- e& X' {+ \TITLE Toolbar (Alternate)
% [* _0 V4 }( i6 M/ v* Y' b/ [VERSION 170

0 b) x" @! |& x7 q4 p2 u5 \3 z/ ^BUTTON CUSTOMER_BUTTON_1
1 x( |1 n+ _' A  i' w0 m; p  HLABEL Toolbar(Alt) Button1
RIBBON_STYLE LARGE_IMAGE
( W: \0 ?0 T; H( f/ `7 ^
BUTTON CUSTOMER_BUTTON_2
/ Z9 Q9 p: x* v. g7 P8 KLABEL Toolbar(Alt) Button2
7 P+ P- o8 v3 W2 ^! M# B: U0 t; L2 GRIBBON_STYLE LARGE_IMAGE

2 ]1 ]* i+ G9 Z/ M, \. h& uBUTTON CUSTOMER_BUTTON_3
1 h2 i- d9 N  b5 p: G: zLABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
RIBBON_STYLE SMALL_IMAGE_AND_TEXT
, T8 \) \1 z0 y9 {4 p, P6 r, l8 r
BUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

' z; ?" s- @# _: F- T3 U. _
( x3 U+ `( n0 X8 |# p0 r0 _
' u* s+ l2 V, Z7 |9 G; Z) Xcustomer_group.grb
$ r  A' z9 s0 x7 C7 ^$ [!
!  Customer Ribbon Group File
!
!  In Classic Toolbars mode - This group will be unavailable
  C$ F7 v8 A2 T. Z: R3 `6 u+ L!
( O# z" G" ~, G7 x8 G4 w3 L!  In Ribbon mode - This group will show up in the "All Groups" list
) Y" Y/ G( a+ H; M' x$ q!     in the Customize dialog.
!
# S1 V. e; S+ Q; S5 t4 U0 A% G!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
. f! E8 C: K" e" O!

TITLE Group
VERSION 170

!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE
1 o) a0 j5 N4 M6 R: I+ p
!  Example of a gallery defined in a GRB file.
!
5 M7 H& B$ P, V+ d3 a2 q% s!  If this gallery is to be used in other places, then it could be
: V7 K# o4 A! c! Y  f!  defined in its own gallery (GLY) file and referenced here
!  Example:
!    GALLERY customer_gallery.gly
. t+ B! x( ~; {0 D!
BEGIN_GALLERY  CUSTOMER_GALLERY
COLUMN_IN_RIBBON 2
* \* _5 J' ^3 ]COLUMN_IN_POPUP 2
LABEL Gallery
& L" l( d+ }1 Q+ R* hGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT

    BUTTON CUSTOMER_BUTTON_2

    BUTTON CUSTOMER_BUTTON_3
2 w  M8 D; ?8 R& l4 P
    BUTTON CUSTOMER_BUTTON_4
& c, o# n( S% I) V$ L) p0 o
- Z) S5 [% h, b! e" ~- P. J1 t    BUTTON CUSTOMER_BUTTON_5
6 l- L; h: y5 O" K7 O
END_GALLERY

8 w  l& p6 Q# C* x  e* ^" E