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

admin

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

经典界面到RIbbon界面转换

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

• customer_men.men
• customer_toolbar.tbr
  % h7 t0 e  a1 f, D- Q

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

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  0 Z: D  q  C, [# M6 ]7 b

0 e' E" H6 }2 O$ ?  C
  R6 E9 B3 T+ w# a% n9 @$ x: f举例如下：
, `- I7 O+ W7 i4 x& f

' F" O, q' J* w$ J' v/ e& K% icustomer_men.men
!
!  Customer menu file
4 g+ J0 h" c  N1 j! r!
!  Contains button definitions to be used in
8 d: Z# n# Z' [!  toolbars and Ribbon files
+ C- g% \' x' J: I9 H/ ^!

0 o1 S% {( j+ `/ J- X: X' a, VVERSION 120
1 K$ [; E0 ~# k! ]7 l# F' \
( X4 y. L- V1 k, S6 ~# b: s( \EDIT UG_GATEWAY_MAIN_MENUBAR

TOP_MENU
3 m& g: s! T1 C$ Z& o  d; c/ O9 E    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu
! W+ e* y' i  Z# ^6 x+ X5 U; b
1 @8 x- t9 v6 i" v! xEND_OF_TOP_MENU

MENU CUSTOMER_MENU
! s* w% Z4 Z; Z2 {9 Y9 c
& G) @8 |6 V' o4 m2 O1 P# c4 [9 _6 [    BUTTON CUSTOMER_BUTTON_1
; Y5 o5 x' d# _    LABEL Menu Button1
' p. k" D' t7 |8 L! C+ Q4 O         RIBBON_LABEL Ribbon Button1
/ p: C- \. n' h2 ?( `7 e        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen
& X) D* T. Q" E  Q5 J
3 ^  ?6 _2 l4 S' y/ M: I    BUTTON CUSTOMER_BUTTON_2
+ }7 h, c2 B, g    LABEL Menu Button2
) S. H3 e0 a5 G4 J' p4 I2 u        RIBBON_LABEL Ribbon Button2
$ G. G: A5 i2 S% C        TOOLBAR_LABEL Toolbar Button2
# B; W- z+ B1 Q! R: O' g/ U6 g    BITMAP filesave

& Y2 @7 E4 m* @# }+ B5 h: k, Q: z8 W3 ?    BUTTON CUSTOMER_BUTTON_3
, I4 U' v4 |( |    LABEL Menu Button3
7 t& \& F6 P0 I8 z. f9 Y; ^( K        RIBBON_LABEL Ribbon Button3
        TOOLBAR_LABEL Toolbar Button3
+ P8 H. [& J, \, u9 @  w$ }3 Q    BITMAP current_feature
9 V' ?' d: \7 m) z5 a
. g  k% o* H2 u3 t    BUTTON CUSTOMER_BUTTON_4
3 c0 K) k/ k1 J3 @    LABEL Menu Button4
4 y: N' `4 e! Y& C. f        RIBBON_LABEL Ribbon Button4
' G; R+ F* M$ d) n        TOOLBAR_LABEL Toolbar Button4
" v' L8 Y* [/ l0 I    BITMAP block
+ q, g! r* ]& O/ ^! {8 o
    BUTTON CUSTOMER_BUTTON_5
4 U/ n$ ^0 D& w! E9 S( g! o8 d2 ^) \& P    LABEL Menu Button5
$ w, i+ p5 q; N" i3 J2 `        RIBBON_LABEL Ribbon Button5
- Y3 w$ D( B2 {3 S; s& U# o        TOOLBAR_LABEL Toolbar Button5
. u2 }( X6 d5 r* p! _# y! F: i3 \    BITMAP checkgreen
6 ]0 v5 p% Z( B. \
END_OF_MENU


; M; W, |& y' {0 o6 F( O
customer_ribbon_tab.rtb
! U# q6 q& Y1 ^% ~) G1 s8 I!
!  Customer Ribbon Tab
6 K( a! b3 K" w" I6 y$ F  w8 W!
0 C, v$ L! c2 n3 h, j* ^. t!  This file will create a new customer tab containing three groups and
!  one top level button.
!

$ Z- e! g" ]2 N2 L4 wTITLE  Customer Tab
$ S) y* j4 h8 l/ ~6 i, ?$ P) nVERSION 170

!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
!
. h! Q6 C$ {, z6 F!  This is the quickest way to add existing toolbar content into Ribbon mode.
!
+ S8 i" M7 Z& w. v- z2 GGROUP  customer_toolbar.tbr

1 z! J# w& H4 ^5 @" @/ ]7 P# O!  The second group represents a Ribbon group that references an existing
" H0 C5 {6 x/ D. x!  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
# }/ i6 j# l$ v5 s7 o7 n( q!  toolbar as a group.  The only differences from the first group exist within
!  the .tbr file itself.
6 t) v9 q0 J+ {!
+ Z1 w8 W$ y! d' Q6 H& w!  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
# C' E) r; }" O!  will need to be maintained while still making use of RIBBON_STYLE to
!  control the presentation of the buttons on the Ribbon.
!
# v& z# ^9 f+ `& Q8 R7 h; [GROUP  customer_toolbar_alternate.tbr
$ m( c* x0 H! H
1 H5 c: w, K+ y' U3 n$ W0 f# ]!  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.  
!
# e5 ]( D1 X. q! V  m2 r!  For customers that will deploy both Ribbon and Classic Mode customizations,
$ n# P* b5 S: Q- T- M% S5 Q4 K!  this approach will result in no synchronization and two sets of customizations
2 T$ ?1 r! k& P. f& C!  will need to be maintained.
- l7 G4 B/ _- m!
- Y4 t1 o8 I" y/ r8 W) s$ T!  A group can alternatively be defined directly inside the .rtb file by using the
. m) f) ]% J" j4 l!  keywords BEGIN_GROUP and END_GROUP.  
!
% E" A. }& O3 Q4 G( I1 }7 L; E! H( oGROUP  customer_group.grb
$ f& `1 n- i5 b' u& |
! Z1 L) M; \' `  X!  Example of a button that is placed directly on the Ribbon without being
# [3 l8 f/ k0 T+ O! D: N!  contained in a group.  This is a simple way to add a button to a tab
!  but is not recommended for many buttons since groups have advantages.
!  
5 P6 W+ g2 h& J( c" I* a!  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".  
1 F* H! E: ?$ O9 y1 g9 S% F!        This will move the whole group to a new location.  If buttons are
# a+ B) i- ]2 H5 G7 p8 _, c!        not in a group, they need to be moved one at a time.
!
' q. D0 y' ?( ?$ _0 e9 Y4 W!     2. Provide a label to describe its contents.
!
9 I7 p7 {" H5 a  ~BUTTON CUSTOMER_BUTTON_1
) [* [3 @) n$ \) e# m6 K2 sLABEL Button1 Directly on Tab
* O" @4 u( n4 z1 V: `1 Q) S, a) T

1 k) c9 o8 e$ j7 B9 E8 A
; g8 ]' G- P1 E1 k5 t& c: @customer_toolbar.tbr
!
0 N$ W0 e& q7 O, S' a; }!  Customer Toolbar File
!
!  This is similar to an existing toolbar file containing
; J9 R. p; }7 o5 D!  no Ribbon changes.
% ^" n! ]- Z8 B7 l+ U!
) q' F  ?. s4 d/ m!  In Classic Toolbars mode - This toolbar will still show up in the
2 }4 T* K0 E6 m% u2 {  y!     toolbars list.
!
!  In Ribbon mode - This toolbar will be automatically converted to a
1 t5 Y' k5 `. _; J, T" E3 ?!     Ribbon group and will appear in the "Classic Toolbars as Groups"
+ e: ]0 X$ @/ n- r!     section in the Customize dialog.
9 d6 b  b4 \2 \7 v/ g!  

2 W  D0 I  \$ A, |' K9 v8 JTITLE Toolbar
VERSION 170
) U1 A% m- N8 x  X9 C
BUTTON CUSTOMER_BUTTON_1
. D2 v  A8 }! U5 @1 a
7 e) \3 r7 i' V) e3 c% DBUTTON CUSTOMER_BUTTON_2
+ [" R/ `4 n9 Q& k/ E/ ^' d
BUTTON CUSTOMER_BUTTON_3
/ _: [# [( Z' t* w! Y& z1 o
BUTTON CUSTOMER_BUTTON_4

6 t& y4 P% P1 j. j& v! D! @+ oBUTTON CUSTOMER_BUTTON_5
. V, D# d& v3 E3 X' [


/ {5 b: `2 P, j/ I4 s: d9 gcustomer_toolbar_alternate.tbr
% Y8 h- p$ S9 E; \5 u( z!
!  Customer Toolbar File (Alternate)
6 P2 L& n; f" \; Z/ z- }' w+ A!
8 t7 F. s. i6 m" v2 [!  This is similar to an existing toolbar file with new
' H6 v( g- v& ~* @!  Ribbon styles added.
0 g# ]9 h0 W! i8 @$ M# Q!  
; r1 z, m+ |, Y. 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.
!
0 j- p; ~& _, v4 ^2 @- @, P!  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
9 w5 c' }; P! Z2 u& `5 F/ ~3 G7 U!     Ribbon group and will appear in the "Classic Toolbars as Groups"
, R+ Y* Q, y& o!     section in the Customize dialog.
!
, n* Y7 @% v+ h3 s( [
TITLE Toolbar (Alternate)
VERSION 170

: b% e2 V& v# ]" M1 N- hBUTTON CUSTOMER_BUTTON_1
LABEL Toolbar(Alt) Button1
. b# F( F% g' d! K  g$ _2 CRIBBON_STYLE LARGE_IMAGE

* G9 [+ @8 t6 ]+ r( Z2 F' U$ TBUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
RIBBON_STYLE LARGE_IMAGE

& f2 m" S, Q9 Q* T1 r# iBUTTON CUSTOMER_BUTTON_3
: L7 F) q2 ?5 QLABEL Toolbar(Alt) Button3
$ w2 Q# c& W& n( iRIBBON_STYLE SMALL_IMAGE_AND_TEXT
* N( d1 y& |3 z5 i5 _" C& C
BUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
, c9 d5 B: k6 t" U2 ^3 O$ nRIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
# m( E1 W9 _5 ]2 r0 P; ARIBBON_STYLE SMALL_IMAGE_AND_TEXT
& v2 L  _# C" H$ h3 d. d* b) Z0 F
1 J6 I" ?5 O( W; m5 y

customer_group.grb
2 S) U6 U* R  n!
6 h( O+ _( r1 }8 ^! ]: W/ H4 B!  Customer Ribbon Group File
!
0 c, Z7 z% t3 K& M5 @$ Q!  In Classic Toolbars mode - This group will be unavailable
!
2 j, s1 u8 x6 H" o9 h7 D!  In Ribbon mode - This group will show up in the "All Groups" list
!     in the Customize dialog.
: d$ b+ \9 j, `) t1 p!
!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!
/ b) b& Z9 o9 L; g
TITLE Group
VERSION 170

!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE
# r1 T6 [# V5 w) C9 y
!  Example of a gallery defined in a GRB file.
, d/ j) ]5 N# ~- o/ o3 C!
!  If this gallery is to be used in other places, then it could be
* P4 i  m) X2 K. o1 }1 n0 g0 J!  defined in its own gallery (GLY) file and referenced here
!  Example:
" n6 n9 @  t) k5 I!    GALLERY customer_gallery.gly
!
% E: ]/ Q' K* n& c: L+ d( tBEGIN_GALLERY  CUSTOMER_GALLERY
COLUMN_IN_RIBBON 2
COLUMN_IN_POPUP 2
* S7 ?7 U* z9 z2 }! l. gLABEL Gallery
GALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
2 \% ]0 q9 ~/ z% h7 z, z7 u* I
    BUTTON CUSTOMER_BUTTON_2

1 j7 I8 I0 i0 [    BUTTON CUSTOMER_BUTTON_3
; o" F- Y5 V  m" m$ U% s
3 v. X. b3 |8 q* n    BUTTON CUSTOMER_BUTTON_4

    BUTTON CUSTOMER_BUTTON_5
/ l7 L# n# Z7 |3 [6 i  ]$ a
END_GALLERY


$ [6 Y2 g" R. |) x/ Y