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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
4 ?; z; u( k( f* h

经典界面到RIbbon界面转换

在经典界面下，需要的文件
9 M" C$ p1 t  ?- J

• customer_men.men
• customer_toolbar.tbr
  ' g- F0 M6 G( O' w0 k0 x0 [

在ribbon界面下你可能需要的文件
  f: U0 z/ ?: H7 ^' p4 e3 f/ S

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  ' Z: t& A+ G/ u* ^

; P$ s2 ]' l2 n8 B, e! H5 l( \/ e; e举例如下：

6 C# Z% X- }( P# n7 U
% D$ o) C) a" `' z( ]. mcustomer_men.men
4 }3 q$ _; c* [* _!
!  Customer menu file
, L1 H, q; I& B# A- i' o% n2 k5 E!
!  Contains button definitions to be used in
!  toolbars and Ribbon files
!

' y9 ^; Q  U8 {( W1 mVERSION 120
, p$ h% d) c4 c; H3 p3 x. k& _8 M
8 y9 G$ p" H! y8 ?' ?' g1 O# ]8 k; d- HEDIT UG_GATEWAY_MAIN_MENUBAR

5 Y3 ^7 J0 I7 r. @1 ~0 |) }0 H9 CTOP_MENU
! H# ]4 p8 q% k    CASCADE_BUTTON CUSTOMER_MENU
( k3 J. q% r2 d7 |" I0 W. Y    LABEL Customer Menu
% e  o+ x( r2 R# ]
END_OF_TOP_MENU

! A; _# _  w% b. hMENU CUSTOMER_MENU
8 f+ k, p8 O% M' y. ]. a; w6 h3 g
    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
$ z1 G! s; C: K' `% c         RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
: m$ [  n/ J- W- E* o9 N    BITMAP fileopen

. ^$ o. t  b+ K% t% ?# B    BUTTON CUSTOMER_BUTTON_2
+ K- G6 F, ^/ C2 A    LABEL Menu Button2
0 M; _$ X- n$ p$ B7 J        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
    BITMAP filesave
  Z: b6 k3 V; r# }) \% B
    BUTTON CUSTOMER_BUTTON_3
; @& x- K1 n1 p0 s- r    LABEL Menu Button3
        RIBBON_LABEL Ribbon Button3
        TOOLBAR_LABEL Toolbar Button3
! @( D' D2 A7 \0 v, A, k    BITMAP current_feature

    BUTTON CUSTOMER_BUTTON_4
% C7 y0 j$ C/ e    LABEL Menu Button4
0 B% W  B  V& B& Q" ^( H8 k5 m$ y        RIBBON_LABEL Ribbon Button4
        TOOLBAR_LABEL Toolbar Button4
, O7 L! ^" T+ Z" y+ P  k    BITMAP block
, @0 B& E+ G- Q
. s6 P8 ?6 [" k( _: |& ^( W) A/ F, w    BUTTON CUSTOMER_BUTTON_5
    LABEL Menu Button5
6 P* k) Y! W  P5 E7 d        RIBBON_LABEL Ribbon Button5
        TOOLBAR_LABEL Toolbar Button5
    BITMAP checkgreen

END_OF_MENU

3 n* n! u6 Q5 R4 T; R
+ e% @' B3 Y. `) U  r
customer_ribbon_tab.rtb
2 r7 {. e1 k& K. M) r+ f!
!  Customer Ribbon Tab
* v% J6 ^7 n( {* t* Z, ]!
!  This file will create a new customer tab containing three groups and
!  one top level button.
!

5 Q9 K; i! h( l$ NTITLE  Customer Tab
% R5 L: [% R0 b% {  N: \VERSION 170

!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
5 ~. R6 H& w# J& ]2 b0 ?! a!
!  This is the quickest way to add existing toolbar content into Ribbon mode.
/ a2 }! Z4 P; ^. L' z!
8 _3 [5 ~, g' o3 A6 LGROUP  customer_toolbar.tbr

!  The second group represents a Ribbon group that references an existing
* N3 _0 C& p! k- l* J( u!  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
( i% r4 {% Z8 R8 U!  toolbar as a group.  The only differences from the first group exist within
$ P1 c& i' w6 y3 ~!  the .tbr file itself.
* V- I6 u# a0 f5 R/ K" Z' u!
!  This approach has advantages for customers that will deploy both Ribbon and
  A2 @6 g! ^2 w1 b; s!  Classic Mode customizations since all the content is defined in the .tbr
! N) U! e8 E6 X3 P. f!  file and it will stay synchronized in both modes.  Only one set of customizations
# J; Q8 z$ e' `0 T!  will need to be maintained while still making use of RIBBON_STYLE to
!  control the presentation of the buttons on the Ribbon.
" Z/ e  u' o" u5 g1 \! R4 A!
GROUP  customer_toolbar_alternate.tbr
7 @; c( f* a: r5 X$ N
7 N7 t, |9 q2 H* J) 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
; h+ K) h& f+ T) l!  preferred option since the user will be able to take advantage of all the
+ o* R8 @. w/ \!  layout styles and containers offered by the Ribbon.  
!
$ D, D6 t* u8 A/ \/ G; I: |8 Q3 _* O!  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.
!
; u; p( _6 [6 J+ C: b!  A group can alternatively be defined directly inside the .rtb file by using the
( G# }1 V7 O& k0 J7 A9 ^% M& \!  keywords BEGIN_GROUP and END_GROUP.  
!
GROUP  customer_group.grb

!  Example of a button that is placed directly on the Ribbon without being
$ S0 D' E7 ~7 S# R2 N; m# o. s!  contained in a group.  This is a simple way to add a button to a tab
' z5 S# o/ O; }, ?5 ?7 c!  but is not recommended for many buttons since groups have advantages.
2 U. o4 R8 Y* X9 l. e!  
! i1 d* {  i* {' I5 T* }" I  N2 r!  A few advantages of groups:
!     1. Easier to move many buttons around together in quick customization.  
!        For example, MB3 on a group and choose "Add to Left Border Bar".  
# ^4 T9 I* t( V. n  [2 Y!        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.
0 ]9 r3 }) g+ m" z/ [!
!     2. Provide a label to describe its contents.
!
BUTTON CUSTOMER_BUTTON_1
LABEL Button1 Directly on Tab

- K  B0 U1 J8 n) H! O, i

customer_toolbar.tbr
!
) [4 U9 Q9 x% ^1 i% s* y, g!  Customer Toolbar File
!
* n" q; p; P( Z. X% m+ J, \!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
!
  q, W9 w4 I- F+ {( A!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
% |5 V# O' w- g& V!
!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
!  

TITLE Toolbar
& W( |3 B% I# f2 iVERSION 170
7 J& _9 H, |3 v: @. v* B
" _. Y/ O& X6 I! X: Y; WBUTTON CUSTOMER_BUTTON_1

BUTTON CUSTOMER_BUTTON_2

0 p8 D, G6 e" U+ Q% l2 GBUTTON CUSTOMER_BUTTON_3

, Y- y1 |" K% v: C. ~* K3 t& RBUTTON CUSTOMER_BUTTON_4
5 p/ _6 }# e: ?5 }0 U5 I, u
BUTTON CUSTOMER_BUTTON_5

4 K, W$ U& h: d# y* i) d1 ?  z0 ~
: w/ f4 y+ f3 |2 P3 ^4 x5 k
customer_toolbar_alternate.tbr
!
) {6 \2 o; s; G/ ^- r' q!  Customer Toolbar File (Alternate)
!
, F/ H* g9 X5 a" \  Q!  This is similar to an existing toolbar file with new
  |1 g2 t( }9 b!  Ribbon styles added.
) R9 a9 ], O! y) X  H7 P9 H; f!  
!  The RIBBON_STYLE will be honored when the toolbar is loaded
!  in Ribbon mode as a group but will be ignored when the toolbar
!  is displayed in Classic Toolbars mode.
# {9 C5 Z+ x, ~6 j( }3 H!
!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
!
- q* {, d# D" Z( W7 M% U!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
8 n3 y/ h6 `* c3 I7 d!

# [4 Y, x$ Q: S1 B1 I* MTITLE Toolbar (Alternate)
; q+ m3 I% W  |8 s5 x0 vVERSION 170
( i7 W  \7 q) F. ^" f; {  Y
BUTTON CUSTOMER_BUTTON_1
' H4 M) g, }# fLABEL Toolbar(Alt) Button1
RIBBON_STYLE LARGE_IMAGE
) _2 P' x9 C- d, E2 s9 Z2 o) N5 G% E
BUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
; N& t0 [5 M1 D; KRIBBON_STYLE LARGE_IMAGE

BUTTON CUSTOMER_BUTTON_3
1 l/ H: j2 M8 s; _% D0 J2 T- nLABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
" E# k: p2 h7 W: j: y7 R3 mRIBBON_STYLE SMALL_IMAGE_AND_TEXT
0 V5 R, S" L" k9 v0 K; B% v
BUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT



8 N( U; ?' F& Gcustomer_group.grb
!
4 ^  X5 d0 l: e, E!  Customer Ribbon Group File
! n3 @, o8 \# k1 b!
$ l- N* a, \- ^2 T. P& `* v!  In Classic Toolbars mode - This group will be unavailable
9 O! }( f4 w- x' i8 E!
- T, _* o* `* t: Z!  In Ribbon mode - This group will show up in the "All Groups" list
) p- |4 F6 X1 b( B( \- j% I!     in the Customize dialog.
$ y7 H& H3 B0 x!
1 k7 f7 x8 A9 l  v- h5 `!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!

9 ^  i% A# U, v# r& T+ dTITLE Group
VERSION 170

. U  E0 f5 k$ A9 Q!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
9 w) Q  U7 q1 k5 P7 F1 Q0 uBUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE
9 X+ c; W, r! H/ }  C# e6 n" S8 c
!  Example of a gallery defined in a GRB file.
( L5 g# m. c' w& N. R# y!
!  If this gallery is to be used in other places, then it could be
1 e* [; N# _) c!  defined in its own gallery (GLY) file and referenced here
0 p; m* C1 x) P" y6 s4 v( r+ Q6 e!  Example:
5 D5 _4 T7 _- ], C!    GALLERY customer_gallery.gly
$ h4 O( `" d1 _+ B, p0 e2 E0 U!
! D& [; X) b# ?, ?, i( K8 c2 xBEGIN_GALLERY  CUSTOMER_GALLERY
$ L8 l  ~9 E5 _3 J2 X- f' NCOLUMN_IN_RIBBON 2
COLUMN_IN_POPUP 2
LABEL Gallery
' ?, J( G; X2 `* i' SGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT

$ O) }8 @, u4 V6 y; L8 _    BUTTON CUSTOMER_BUTTON_2

  W2 C' K% I1 j$ b7 _. A( T# t    BUTTON CUSTOMER_BUTTON_3

    BUTTON CUSTOMER_BUTTON_4

8 C" l* L9 w1 P( a    BUTTON CUSTOMER_BUTTON_5

END_GALLERY
: H& B7 v; X' N; k% g/ \
9 I; g+ M/ E1 W
: D1 A! E" S0 a2 f+ ?9 Z