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

admin

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

经典界面到RIbbon界面转换

在经典界面下，需要的文件
% C  e# J9 M4 X$ [2 R! K+ C

• customer_men.men
• customer_toolbar.tbr
    I5 W; q% c! q

在ribbon界面下你可能需要的文件
& e7 O9 L* |2 @8 y

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

$ L& K: n  \& r3 {举例如下：
, B" r0 K1 `, d7 X- W3 n

  \; j9 W5 e  O2 ccustomer_men.men
, \- \/ }6 g0 A9 L. A- [& W!
+ M) `7 _* a# M! S1 K' Z!  Customer menu file
9 O; R3 p0 E! S4 H; y; S0 x2 g!
0 |4 y' ^6 e$ Y8 A!  Contains button definitions to be used in
6 p! |4 @6 Y( d3 Z# a!  toolbars and Ribbon files
3 T1 b0 B4 Y. b! V3 G; v!

VERSION 120

0 H  h; P! D% m. G1 lEDIT UG_GATEWAY_MAIN_MENUBAR
! B1 q2 d6 k9 E! d! L
3 m. E, e+ e" X2 h. sTOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
+ i5 }6 g, Q% O) B    LABEL Customer Menu
) C. X$ C" P% v, x* l: T$ f. W0 P
# ]- \2 t, f$ f7 B* {END_OF_TOP_MENU

( N. J) _- a5 D" S% i; T, Y0 C; k7 ~- EMENU CUSTOMER_MENU
  s3 H( D3 f- `$ h6 ~' M
2 `4 o( I# F% u0 q5 \    BUTTON CUSTOMER_BUTTON_1
2 `' W) m8 E0 M* q    LABEL Menu Button1
8 m2 P! J9 g, }4 J         RIBBON_LABEL Ribbon Button1
. h3 W9 m9 \* q: Q; g- u1 Y        TOOLBAR_LABEL Toolbar Button1
3 G1 W8 O, h& G: j0 N& h1 v# H    BITMAP fileopen

2 I- q1 f& d( q    BUTTON CUSTOMER_BUTTON_2
3 a1 s/ g7 v- U7 o  ^" R; p9 E' r    LABEL Menu Button2
5 O; k5 v- u- V% K1 N1 |        RIBBON_LABEL Ribbon Button2
" P+ D& X% {' R! _+ X& ~9 C        TOOLBAR_LABEL Toolbar Button2
    BITMAP filesave
- V. p( f& k6 [% E0 d: R' w
/ F$ |+ w' E5 d! l0 g9 w' A    BUTTON CUSTOMER_BUTTON_3
# f& v; e7 l# Z* Q3 ~    LABEL Menu Button3
: ^  l% }9 @3 G% e+ d4 s: G# }        RIBBON_LABEL Ribbon Button3
8 M2 I  ?0 O$ k6 z1 o; H( `        TOOLBAR_LABEL Toolbar Button3
    BITMAP current_feature

1 ?, C1 r1 Z* P' W! ?1 a    BUTTON CUSTOMER_BUTTON_4
3 L  l! I3 F) t" h; }  T3 T' f2 ]8 g    LABEL Menu Button4
        RIBBON_LABEL Ribbon Button4
        TOOLBAR_LABEL Toolbar Button4
0 q( T0 I4 h, b  A4 K9 I8 z    BITMAP block

7 X! o  I, d, F" l    BUTTON CUSTOMER_BUTTON_5
3 Y2 z0 e; Q: G$ O2 f    LABEL Menu Button5
        RIBBON_LABEL Ribbon Button5
        TOOLBAR_LABEL Toolbar Button5
    BITMAP checkgreen
% _# ]9 s# Y; k
* y$ A$ V3 o3 w) P9 [, G& P4 lEND_OF_MENU
: V5 o, L! H: q$ [5 n" d
6 a- T- C' |0 r1 \
3 J- V% ~) I, P( j6 U& G
7 J$ J/ ~' x+ X1 scustomer_ribbon_tab.rtb
!
6 r1 L2 V' ?) w( m4 {5 n; v!  Customer Ribbon Tab
; x: |: b3 w9 w0 M2 C+ W- Y!
! w% w& o8 W7 f!  This file will create a new customer tab containing three groups and
!  one top level button.
!
( b7 a/ @3 k' e1 w$ P/ ^9 x3 f% {
; R( L$ F. R/ B, ]/ L! uTITLE  Customer Tab
3 \9 G4 n1 q# g3 L1 @1 b5 \3 iVERSION 170
2 n6 z! u7 v4 k. Y& W4 U. ]
!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
6 D4 u- U3 L: x: m3 U!
  E% v) ?1 V4 ~6 L4 h0 O!  This is the quickest way to add existing toolbar content into Ribbon mode.
5 G$ \& F0 O& u" k!
9 F" B8 T, M/ _) y4 y/ IGROUP  customer_toolbar.tbr
# o- V. d9 Y2 ?. t2 i
!  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
1 P! _5 K6 J; i* V7 ^!  toolbar as a group.  The only differences from the first group exist within
!  the .tbr file itself.
) N" f% B/ e) a. [0 k- z!
!  This approach has advantages for customers that will deploy both Ribbon and
( L5 c7 Q, M. Z' W3 l!  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
8 e2 X5 G% l5 M!  will need to be maintained while still making use of RIBBON_STYLE to
7 n2 h; g) b' Y3 ?4 s!  control the presentation of the buttons on the Ribbon.
: ^0 o" y2 N7 x7 m!
, T4 S- ?  T0 {- qGROUP  customer_toolbar_alternate.tbr

!  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
' i1 ~1 [8 J+ v- o' \! X!  layout styles and containers offered by the Ribbon.  
!
!  For customers that will deploy both Ribbon and Classic Mode customizations,
!  this approach will result in no synchronization and two sets of customizations
5 S0 j9 J$ l5 J3 F8 q5 c!  will need to be maintained.
7 Y/ D4 U% z+ n; C!
!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
!
. R( t; f! r4 f! ZGROUP  customer_group.grb

!  Example of a button that is placed directly on the Ribbon without being
) J) s+ n& U0 j+ e!  contained in a group.  This is a simple way to add a button to a tab
; B4 C. I1 |' T6 c" w!  but is not recommended for many buttons since groups have advantages.
!  
& K& E! X' ~! R# M/ E!  A few advantages of groups:
1 u( z- d" h9 `- Z!     1. Easier to move many buttons around together in quick customization.  
!        For example, MB3 on a group and choose "Add to Left Border Bar".  
  g+ A/ C0 H* h. C3 {3 ~1 n!        This will move the whole group to a new location.  If buttons are
9 U/ l. k" q" L% F: N: |' y!        not in a group, they need to be moved one at a time.
/ {; A3 i, c1 h8 Y  p5 X& t!
0 e* s3 s7 A2 @8 |6 Z!     2. Provide a label to describe its contents.
!
' X0 v% j- A8 a1 lBUTTON CUSTOMER_BUTTON_1
LABEL Button1 Directly on Tab
( y4 R4 o+ T; D' y! q


8 Q% }6 X' X* M8 A) j! U: Gcustomer_toolbar.tbr
!
!  Customer Toolbar File
) {, f4 ^( K# k2 s!
: `, R% b: N* N, f( ^!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
!
!  In Classic Toolbars mode - This toolbar will still show up in the
( S) X2 L% g+ O3 f2 _8 c+ t!     toolbars list.
5 @+ U9 X$ f( M!
!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
' \/ @; p. a  ^* s9 J( Z!     section in the Customize dialog.
/ e# r; Q" D$ C: S/ t!  
. S7 q; Q! w7 B& S" k- U7 S2 ^; @
TITLE Toolbar
, S$ W, U& I8 ~9 @! vVERSION 170

7 p0 G% V* R! ^2 FBUTTON CUSTOMER_BUTTON_1

BUTTON CUSTOMER_BUTTON_2

BUTTON CUSTOMER_BUTTON_3

BUTTON CUSTOMER_BUTTON_4

BUTTON CUSTOMER_BUTTON_5



" i/ q9 `2 Q( zcustomer_toolbar_alternate.tbr
  }* I* q$ ~# l9 u4 x!
8 u; F, k; H) `* W" f2 |- b!  Customer Toolbar File (Alternate)
! a8 {9 S: h0 g" ^9 a) r!
!  This is similar to an existing toolbar file with new
3 X& Z' D. B) T' P7 h, _!  Ribbon styles added.
+ f+ q/ e5 l  p2 J# l8 [1 |/ c7 J5 m! e!  
: l) G% G4 O1 _' \( p4 G8 [4 |!  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.
!
!  In Classic Toolbars mode - This toolbar will still show up in the
# [$ A  b; X3 w6 \9 M!     toolbars list.
2 W9 |/ `; i* i# I: R2 Q, c!
+ `. y3 |) G- H( F!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
* o  d( J4 ^% _. q!     section in the Customize dialog.
!
5 x0 {; b0 A' i, Z7 q  T# o
8 I& }) Q; [. |& f: cTITLE Toolbar (Alternate)
VERSION 170

BUTTON CUSTOMER_BUTTON_1
4 ]! w0 u9 z: U8 S' d# M, iLABEL Toolbar(Alt) Button1
, `: B+ O/ c0 X0 S6 M, g+ ^, @RIBBON_STYLE LARGE_IMAGE

BUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
5 O, e/ [! L  aRIBBON_STYLE LARGE_IMAGE

6 D/ L$ G( j5 R: \7 U' C7 VBUTTON CUSTOMER_BUTTON_3
LABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

4 d: \5 |  z7 z: t# o4 g* ABUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
3 Y+ r' L( T5 e9 hRIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT


( J. e) q' D; A
customer_group.grb
!
!  Customer Ribbon Group File
9 |1 }) t3 ?9 ?- {! R!
!  In Classic Toolbars mode - This group will be unavailable
!
!  In Ribbon mode - This group will show up in the "All Groups" list
: X* x8 y9 s0 U2 h( ]!     in the Customize dialog.
0 e, B8 w' P& N8 s  ?) Q  k2 F9 J# p) y!
- g+ \. y7 ?$ S/ a' b  n!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!
) d! e& Y, }7 I4 @: }( [, V
TITLE Group
$ @& |& r5 J, _4 _VERSION 170
+ d# R8 S3 I) B7 ^
  ]2 h8 `3 G- p2 J) O!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
4 L  S6 M) r* [/ p9 l+ d9 N$ J6 Z! oBUTTON 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
) b1 t) g0 T, z/ H/ ~!  defined in its own gallery (GLY) file and referenced here
!  Example:
!    GALLERY customer_gallery.gly
!
BEGIN_GALLERY  CUSTOMER_GALLERY
5 A& X1 h  C+ F1 \COLUMN_IN_RIBBON 2
* \' p2 h. a( c5 \: GCOLUMN_IN_POPUP 2
LABEL Gallery
0 W- P& r8 S6 E- X' _" t0 TGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
2 o# q" i  z. G( ~( L
& ~) r, c- B* R  W    BUTTON CUSTOMER_BUTTON_2
4 @5 w# \) e' v* ]( J
    BUTTON CUSTOMER_BUTTON_3

    BUTTON CUSTOMER_BUTTON_4

# O) r! z* T% H+ ~( O  W3 u    BUTTON CUSTOMER_BUTTON_5
2 H: R- i7 r, N- H9 Y
5 `& ]+ r+ O+ w% o2 @' `END_GALLERY
1 |; K3 n. X' j8 f
5 S& ]9 }+ D4 N  u, p9 t" U) o) `