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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
3 V* V1 ?0 H0 ?- i+ S) a  a& x

经典界面到RIbbon界面转换

. D7 V4 v, h& j2 w在经典界面下，需要的文件
$ M9 M2 z, k) y2 N7 W: f' K. J! g- l4 y

• customer_men.men
• customer_toolbar.tbr
  

在ribbon界面下你可能需要的文件
6 E6 N( @3 ]5 q( O4 D

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

. w8 Q: y: B* @4 Y
3 `: n! X, `5 ?" v: E& ]$ L7 Z举例如下：
- h5 x" G& l& t# J0 }
2 E8 D2 o) J/ d7 z+ E$ U
customer_men.men
!
!  Customer menu file
!
4 W8 n  u. ~- ^2 m2 f+ U!  Contains button definitions to be used in
$ i+ N: t! V8 a5 V!  toolbars and Ribbon files
!
, r9 U, S8 }9 b9 z- K9 z
VERSION 120
0 m4 `) t  M! q  |9 H" F
EDIT UG_GATEWAY_MAIN_MENUBAR

/ S, s/ [8 K1 l* `. c6 b; {TOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu

9 h  O  l6 h3 j! N: v1 dEND_OF_TOP_MENU
& p  T8 W( y- O; y8 ~& Z
' K% F) y9 h& n4 B! D8 D. n8 sMENU CUSTOMER_MENU
! U3 }* T3 Q/ A: ~7 n! O' k+ x( M
    BUTTON CUSTOMER_BUTTON_1
3 d7 M/ X* S. V  j    LABEL Menu Button1
7 g) ~6 A2 U' x/ f7 q) m' ~         RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen

    BUTTON CUSTOMER_BUTTON_2
7 A; a2 [( s! N+ R+ i( _* d    LABEL Menu Button2
+ M" Y( |: d5 x        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
    BITMAP filesave

    BUTTON CUSTOMER_BUTTON_3
    LABEL Menu Button3
4 C. p, n. w8 v' y, t- P: B0 |1 p        RIBBON_LABEL Ribbon Button3
0 M3 N7 m0 ]+ X# B& _        TOOLBAR_LABEL Toolbar Button3
+ g# ~2 P+ D& `9 ]% H: Y) p    BITMAP current_feature

' A) F& B1 g2 I( m* c9 r* ?: _    BUTTON CUSTOMER_BUTTON_4
    LABEL Menu Button4
/ |' P3 q; i# L8 P/ ^3 ^        RIBBON_LABEL Ribbon Button4
* n4 m! T: j* }1 {8 j3 b        TOOLBAR_LABEL Toolbar Button4
% _0 v( @& Y% k1 Z% F    BITMAP block

    BUTTON CUSTOMER_BUTTON_5
4 M% R, u: x4 Z    LABEL Menu Button5
        RIBBON_LABEL Ribbon Button5
& z$ O8 Y! C& T+ n! q) J8 o        TOOLBAR_LABEL Toolbar Button5
    BITMAP checkgreen

6 L) n5 g' n% A8 A  |2 B  QEND_OF_MENU



customer_ribbon_tab.rtb
!
!  Customer Ribbon Tab
  f: J  g1 c; l, @!
!  This file will create a new customer tab containing three groups and
!  one top level button.
+ Z3 ~/ ?& n2 R% D3 ?( E!

1 ], R4 T6 Y  D+ _/ {) ~* QTITLE  Customer Tab
5 y4 P1 I* p# yVERSION 170

!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
5 _+ T% W  @' D: h- m. U9 `: U!
!  This is the quickest way to add existing toolbar content into Ribbon mode.
!
GROUP  customer_toolbar.tbr
2 i+ M) p, o# u3 W' C
0 {' d5 V7 n: d. p% A. B* x!  The second group represents a Ribbon group that references an existing
4 H- h9 o% q: L8 o!  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
!  toolbar as a group.  The only differences from the first group exist within
4 U& D, Q( h% F5 r!  the .tbr file itself.
!
7 g* w( Q: l9 m5 B9 [) G!  This approach has advantages for customers that will deploy both Ribbon and
5 L$ K( [; S, p- K; y2 K7 ~!  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
!  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

!  The third group represents a Ribbon group that has been created explicitly
0 A8 g- S3 y$ N# k) k& y!  as a Ribbon group and will not exist in Classic Toolbar mode.  This is the
3 Y4 Z8 ~0 {- u/ F4 w!  preferred option since the user will be able to take advantage of all the
2 t" T. ?: C9 A5 x9 O6 z!  layout styles and containers offered by the Ribbon.  
!
!  For customers that will deploy both Ribbon and Classic Mode customizations,
" v% l5 Y" B! S% G  |  i!  this approach will result in no synchronization and two sets of customizations
3 P2 L& A, {$ H1 R" A6 \1 ~9 f. Q* Y!  will need to be maintained.
!
!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
!
GROUP  customer_group.grb
- F; @( y4 C7 E5 `5 y* p
!  Example of a button that is placed directly on the Ribbon without being
" J) H4 J& A, q2 l8 `  m. V' p7 G# `!  contained in a group.  This is a simple way to add a button to a tab
" W  _% k4 o# n$ ~!  but is not recommended for many buttons since groups have advantages.
!  
- ?* }0 ], A5 R!  A few advantages of groups:
6 b, Z) F( i2 n" v9 r!     1. Easier to move many buttons around together in quick customization.  
, }7 O& [4 U8 P7 D8 ?!        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
( C  u( C5 Y9 o( e& D!        not in a group, they need to be moved one at a time.
!
!     2. Provide a label to describe its contents.
!
$ K1 D* [0 E/ v, G# u5 T1 ZBUTTON CUSTOMER_BUTTON_1
5 A2 s! k- a+ |: W  ]. F/ y. @7 LLABEL Button1 Directly on Tab
7 k* h0 _+ a, r7 `* o3 L


customer_toolbar.tbr
  T% K: w, ]) D!
!  Customer Toolbar File
!
!  This is similar to an existing toolbar file containing
& j: `9 S& N2 }4 [( S!  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
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
: E& a( b' y5 k6 i" H" Q!  

6 k0 \/ g* a2 t6 u- [2 B3 yTITLE Toolbar
/ A+ [' h% ]! w+ U5 A& E4 J6 f* KVERSION 170

BUTTON CUSTOMER_BUTTON_1
1 A; }' ]5 [0 H
BUTTON CUSTOMER_BUTTON_2

BUTTON CUSTOMER_BUTTON_3
& z# x3 i" r6 u# }; D2 [+ L
) k% H# e8 `' V: q, {, E2 OBUTTON CUSTOMER_BUTTON_4

8 J; u0 m" s3 G& S. q; l# hBUTTON CUSTOMER_BUTTON_5

6 A0 N% }* j& O: W) Z
4 ^( K) j8 {. B" z+ f4 O
customer_toolbar_alternate.tbr
!
!  Customer Toolbar File (Alternate)
!
!  This is similar to an existing toolbar file with new
* e3 Y  Z; }# j4 _* j!  Ribbon styles added.
!  
) t/ ?) v. k$ z' T!  The RIBBON_STYLE will be honored when the toolbar is loaded
4 _: N1 q: d* ?; R!  in Ribbon mode as a group but will be ignored when the toolbar
7 V$ p1 ~! M. _, Y5 }!  is displayed in Classic Toolbars mode.
5 W. b% n0 |& e4 _" E0 U!
!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
- q  r4 c" s/ w( P8 E!
9 b% m* n( Y, t/ s!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
8 u# Y+ m8 @6 w) v( u( @' F6 D!     section in the Customize dialog.
' D4 Y' N+ }4 W!

TITLE Toolbar (Alternate)
VERSION 170

BUTTON CUSTOMER_BUTTON_1
LABEL Toolbar(Alt) Button1
6 i6 ~4 u, c% W6 hRIBBON_STYLE LARGE_IMAGE

9 B! l/ i" f/ A3 n% pBUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
4 F- i- U7 q! h$ IRIBBON_STYLE LARGE_IMAGE

BUTTON CUSTOMER_BUTTON_3
LABEL Toolbar(Alt) Button3
9 z+ @8 s+ \/ R& sRIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
& b  [; s3 K% a, `RIBBON_STYLE SMALL_IMAGE_AND_TEXT

, i6 L1 M- ~/ n# h; ABUTTON CUSTOMER_BUTTON_5
7 P* P/ K- I' v4 KLABEL Toolbar(Alt) Button5
. D! H$ g* P4 d' oRIBBON_STYLE SMALL_IMAGE_AND_TEXT
6 a: M' U( k( [; X5 u0 A1 V


2 U1 q- I5 E# p  T; ?3 Icustomer_group.grb
+ b3 P3 ]6 m+ b, N3 G!
3 R, I2 J& n$ R. E7 i' u4 x% i!  Customer Ribbon Group File
9 M. b/ ]. |. w& C$ A+ u!
) K0 X! n6 ?) r!  In Classic Toolbars mode - This group will be unavailable
!
$ O3 {: h& u9 a4 j. [6 Q% g!  In Ribbon mode - This group will show up in the "All Groups" list
. g9 ~/ d1 G; V!     in the Customize dialog.
# r4 G9 U* H% c' w9 ^!
$ S, _  I2 `% [; w, }7 C8 A$ h( S!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!
1 u) q( ^' I9 L: r0 r; b
TITLE Group
5 V) x( C: Q, \4 }5 PVERSION 170
( c, c, K% @: }* J
7 R) {4 k% d$ d/ j- V2 l0 }!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE

$ n1 w6 r1 X/ E; s% T  T6 W( u  z!  Example of a gallery defined in a GRB file.
!
!  If this gallery is to be used in other places, then it could be
( }' T7 Y, B. V5 `6 c!  defined in its own gallery (GLY) file and referenced here
!  Example:
!    GALLERY customer_gallery.gly
2 l$ G( H/ ^* x!
BEGIN_GALLERY  CUSTOMER_GALLERY
4 G/ Z% T  M/ Q* ?1 MCOLUMN_IN_RIBBON 2
3 H' _! Q6 j' J1 pCOLUMN_IN_POPUP 2
7 ^. D  Q; f& J9 \: q% n& bLABEL Gallery
GALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
2 o' L6 [- c  s3 K. P
    BUTTON CUSTOMER_BUTTON_2
# g, R2 ^: A+ j: A4 A; D* {; ~
8 {. m1 G0 x& R+ w- ]; P    BUTTON CUSTOMER_BUTTON_3
% F/ S8 a8 _4 _& B; B6 c* J6 b9 a' b2 M
    BUTTON CUSTOMER_BUTTON_4

    BUTTON CUSTOMER_BUTTON_5

4 F8 t0 T! o% |: `4 y. z3 cEND_GALLERY