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

admin

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

经典界面到RIbbon界面转换

2 I1 ^) j' s3 b' \, e4 @在经典界面下，需要的文件
( J0 H6 P9 @# U1 R, @1 b* o" e- s

• customer_men.men
• customer_toolbar.tbr
  

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

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  

0 n8 s0 K. L+ d
举例如下：


  V# w1 Y# x) V+ X7 Vcustomer_men.men
!
  i7 ]6 n3 T; k9 P# F, W; C' x! [: i0 L!  Customer menu file
!
!  Contains button definitions to be used in
!  toolbars and Ribbon files
!

) N0 q& c: E- LVERSION 120

# e# U" S$ `4 {  EEDIT UG_GATEWAY_MAIN_MENUBAR
# D, L: `; p: q. e# ]  ?
TOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
) o! l: K! D2 M& l* |& P8 G    LABEL Customer Menu
; T* L0 [% n( {8 |) x
END_OF_TOP_MENU
' s8 g/ c: P$ s! c7 Y
' R2 v& v  _3 w# l3 _+ b0 uMENU CUSTOMER_MENU
4 |4 I7 |8 i- N, |1 j( |& O
1 `! Q0 D+ Q! N) [9 p% A9 b/ Z    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
* l. A3 w( R$ B7 B         RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen

    BUTTON CUSTOMER_BUTTON_2
    LABEL Menu Button2
/ [, @$ H- O# j  @        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
    BITMAP filesave
, Q9 Y9 m, k7 N! f( ]
: w3 A6 U# I' v, R    BUTTON CUSTOMER_BUTTON_3
9 Q% b: {, `- q    LABEL Menu Button3
/ F4 o3 p. m" h0 w; A) E        RIBBON_LABEL Ribbon Button3
. v, a0 A  K% o( s- W/ s' x; d        TOOLBAR_LABEL Toolbar Button3
& t: s" e- B1 g& r# [0 X! o    BITMAP current_feature

    BUTTON CUSTOMER_BUTTON_4
    LABEL Menu Button4
0 V, V, K# K$ i3 |( Y        RIBBON_LABEL Ribbon Button4
; H6 q& u: t( i  e# b        TOOLBAR_LABEL Toolbar Button4
    BITMAP block

) u$ J  L! _: Q8 s! K$ R    BUTTON CUSTOMER_BUTTON_5
3 y3 i/ n4 ~! b5 [    LABEL Menu Button5
        RIBBON_LABEL Ribbon Button5
        TOOLBAR_LABEL Toolbar Button5
: b: l) V! a( y8 Q" \    BITMAP checkgreen
- U; `: a1 h1 D* k3 I) \. b
END_OF_MENU


4 @3 _. g( P% Z& x
customer_ribbon_tab.rtb
% v2 L& R  e% ]  f0 O3 ^!
!  Customer Ribbon Tab
!
!  This file will create a new customer tab containing three groups and
8 P9 w3 U% l$ Z, q) @!  one top level button.
!
6 B! B" _  L  Y& P, C, R- r
, ?. ?! p" o3 l* a# p$ LTITLE  Customer Tab
  X' S' _' v+ I! n2 r& V$ eVERSION 170
4 h0 H; _  _8 {" M& q" u
!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
!
, b8 N. X/ J1 K( S, z7 n!  This is the quickest way to add existing toolbar content into Ribbon mode.
!
GROUP  customer_toolbar.tbr

!  The second group represents a Ribbon group that references an existing
* I" v- |  q' k. E  x4 y3 h5 t!  toolbar with Ribbon specific style changes added to it.  There is no difference
( e+ b! f0 t! ~# W. |# x9 w2 @; c!  in how this toolbar is referenced in the .rtb file compared to the first
!  toolbar as a group.  The only differences from the first group exist within
!  the .tbr file itself.
9 G+ a, |( J: _1 X3 l+ ]0 A- E!
- h4 z% `9 }2 c! L; z!  This approach has advantages for customers that will deploy both Ribbon and
: Y; U* A' E, R$ `" W( e; a8 a0 Q!  Classic Mode customizations since all the content is defined in the .tbr
, s" L. `) A/ i9 O!  file and it will stay synchronized in both modes.  Only one set of customizations
% A% V. ?" Y; [5 l3 m. }!  will need to be maintained while still making use of RIBBON_STYLE to
!  control the presentation of the buttons on the Ribbon.
!
GROUP  customer_toolbar_alternate.tbr
' x5 v% H- K# B) r; u
!  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
' b' i2 B) R5 b!  layout styles and containers offered by the Ribbon.  
!
1 n3 X; P- M1 M, p, ~* ?0 ~+ `( t!  For customers that will deploy both Ribbon and Classic Mode customizations,
6 H; ~$ z# b1 e8 U!  this approach will result in no synchronization and two sets of customizations
2 g- h- H  f; g! k" h!  will need to be maintained.
!
- _+ H' a8 h( G4 B!  A group can alternatively be defined directly inside the .rtb file by using the
2 n; @4 Q1 e) t! |0 h!  keywords BEGIN_GROUP and END_GROUP.  
6 q$ c1 W6 v$ c/ D( _( s4 P/ b!
/ W+ q9 T+ J, x9 }' XGROUP  customer_group.grb

5 G( p! X/ c; d1 ?* v( z2 Q$ r7 ?!  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
0 D7 }7 r2 ^, b! i!  but is not recommended for many buttons since groups have advantages.
  S  c9 ^, N' T+ @. i. x2 U  ~2 F!  
!  A few advantages of groups:
!     1. Easier to move many buttons around together in quick customization.  
4 j0 e, ?" o+ h' \!        For example, MB3 on a group and choose "Add to Left Border Bar".  
3 X, \3 O/ D0 M/ `0 R8 ]# C!        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.
!
!     2. Provide a label to describe its contents.
6 Z9 Z7 I7 d$ u& `- V) ~!
: z) g6 U; U( OBUTTON CUSTOMER_BUTTON_1
LABEL Button1 Directly on Tab
' q' L% Z9 V+ l1 x. v9 _
6 ~' a/ r9 _( I# k
7 w' a! A4 D" z  E, A" S; }
* U+ B# F4 C3 n( [7 d: m! |& g7 Icustomer_toolbar.tbr
!
- h, W% K  A. n) J% ]7 }( G!  Customer Toolbar File
: n: M. c* r) H: ~% ^/ P. W  W2 X% K!
!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
!
  V4 ?' I; ?, L2 a8 p!  In Classic Toolbars mode - This toolbar will still show up in the
- }! N; ^/ R( }$ q!     toolbars list.
!
!  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.
!  
4 o" ], V- Z: D" ^) _8 z) M
1 n7 ~* E/ u/ `; p. u5 KTITLE Toolbar
7 C9 U) ]' w- _! ?3 C3 ^  dVERSION 170
( ]/ l3 K! t9 v) {
5 b$ P9 |- t" t5 f. i# cBUTTON CUSTOMER_BUTTON_1

BUTTON CUSTOMER_BUTTON_2

3 T6 V6 Z: o; t  D) }" q7 _BUTTON CUSTOMER_BUTTON_3
- Y6 B" I+ K) d  j2 [# Y
& c5 a0 b: }  R3 Z5 Y" hBUTTON CUSTOMER_BUTTON_4
) a' `: d7 @+ L' Q
- _& d8 {7 W( |& i& O5 A0 IBUTTON CUSTOMER_BUTTON_5

( {9 A9 k  ]% p- y/ H5 T  }

+ u1 ]# w2 |) N# F" ?1 n& z' \6 ]customer_toolbar_alternate.tbr
!
# {; W1 Z( @6 w$ L& R( G!  Customer Toolbar File (Alternate)
9 {: p9 k6 E3 y1 V7 u" t% [& `!
; V# I' w! `* }( \) {- b1 @* b% n!  This is similar to an existing toolbar file with new
/ R  U0 `- }9 h4 `9 C' F! r!  Ribbon styles added.
!  
) s/ z6 a5 u( h; o!  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.
7 k7 N+ k4 D& D% B5 N!
9 b. W  I8 I3 l: X9 R$ A+ u!  In Classic Toolbars mode - This toolbar will still show up in the
# |7 }0 m( X% y( g0 u( A!     toolbars list.
8 K& K: j( [- a" n, r+ M!
8 x6 f5 K1 |" f!  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.
# @* o7 x+ Y1 K4 q' t# \( S!

* ?  b$ u+ D. ~TITLE Toolbar (Alternate)
. U; p+ j+ C& F: F5 aVERSION 170

) M+ c7 k/ |# j* X6 WBUTTON CUSTOMER_BUTTON_1
LABEL Toolbar(Alt) Button1
. k3 q6 K, l; R* @! U1 cRIBBON_STYLE LARGE_IMAGE
' x. p6 o0 u- l8 ~5 T- ?
BUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
RIBBON_STYLE LARGE_IMAGE

6 m, v0 o0 c8 O: A; e# \1 c0 ?( T9 CBUTTON CUSTOMER_BUTTON_3
LABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_4
. [8 Y7 h7 K# x% Q8 KLABEL Toolbar(Alt) Button4
" x. ?  z: u1 R0 T9 v; xRIBBON_STYLE SMALL_IMAGE_AND_TEXT
) m+ y9 k1 g* ?  s: }8 M: K# q
7 z' y$ ^% |3 D4 D5 ]+ RBUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT
5 _! X# A4 R5 u- f: @( t
  C" D1 _$ k4 P8 `+ u, i0 T  x$ \& W
9 [0 F3 K0 g2 `
customer_group.grb
- k) R" U4 _7 m8 ^: j" A8 G4 V!
!  Customer Ribbon Group File
% v8 W9 I! i3 w+ f  u7 @$ L!
!  In Classic Toolbars mode - This group will be unavailable
!
!  In Ribbon mode - This group will show up in the "All Groups" list
; R  C- A3 \- \5 \# u4 i: n!     in the Customize dialog.
0 [1 M0 d" L, l6 C; [: E" k!
!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
% v3 S$ K; n) [: m3 I! h7 _!
& L4 K& @: A: m. B* c
TITLE Group
VERSION 170
% A& o+ Y; D' e4 S8 t$ I1 d; I5 G: D% N
9 y0 @! B1 n9 D2 i!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
" v& i$ R  {# P  n9 q- w8 tBUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE

!  Example of a gallery defined in a GRB file.
!
!  If this gallery is to be used in other places, then it could be
$ C5 H& o5 r- T!  defined in its own gallery (GLY) file and referenced here
- P, [8 {0 A5 L0 ?3 F5 Q!  Example:
!    GALLERY customer_gallery.gly
1 x# X* S: E0 ]& p; l5 n! e!
# j! r0 P, j! ?- d8 A6 p9 CBEGIN_GALLERY  CUSTOMER_GALLERY
COLUMN_IN_RIBBON 2
  H/ S1 _* o3 A( z, \  mCOLUMN_IN_POPUP 2
LABEL Gallery
5 @; W9 x% c  t% h% OGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT

    BUTTON CUSTOMER_BUTTON_2

  y9 R) N) o5 E% ^, c9 n) t    BUTTON CUSTOMER_BUTTON_3

    BUTTON CUSTOMER_BUTTON_4
4 J0 g  e6 F) ]8 z
    BUTTON CUSTOMER_BUTTON_5
$ }) }! k0 i7 g5 e0 c. R" q, b( X% i
8 H9 P5 u% r$ fEND_GALLERY