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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
0 h  ^8 `" n: e

经典界面到RIbbon界面转换

在经典界面下，需要的文件
$ t: j0 N: y4 P; R

• customer_men.men
• customer_toolbar.tbr
  

在ribbon界面下你可能需要的文件
( ~, d+ N% P, ]) D2 \* }

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  - d% S) g4 u1 M, n* ^: e

* T0 M" n  x: ]举例如下：


. ]( O$ `& I$ G4 T2 gcustomer_men.men
!
!  Customer menu file
2 t: s- o$ K5 H' P  @!
!  Contains button definitions to be used in
7 ?! j5 B; y1 W' v& M3 N5 ^!  toolbars and Ribbon files
) _1 {' Z( E# w  _* z!
4 a' r5 s( D" N; Z* @: v
VERSION 120

EDIT UG_GATEWAY_MAIN_MENUBAR

. _7 Y& H+ E% e/ M* z. |/ ^$ ^TOP_MENU
) ^! B# \  T- d    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu

$ P& _( Y, f- y  a. X1 p/ q& B& w- }END_OF_TOP_MENU
/ x5 c' `# X7 i" c: t+ L
MENU CUSTOMER_MENU
4 }  o; Q3 ^4 G3 v; }/ E
    BUTTON CUSTOMER_BUTTON_1
4 b& ^* L: p0 y4 c, P. @8 a    LABEL Menu Button1
* l+ ?% p, I0 T0 @         RIBBON_LABEL Ribbon Button1
/ c7 U& X, N: j$ M" H2 O' W        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen
0 I/ n! c+ A" y0 A  h* D3 E& p
6 V8 p2 d8 r6 r4 `    BUTTON CUSTOMER_BUTTON_2
    LABEL Menu Button2
6 L' B, F0 [: N$ u8 T! k        RIBBON_LABEL Ribbon Button2
: n/ d8 y( P+ b6 |+ e/ Z6 U6 H        TOOLBAR_LABEL Toolbar Button2
    BITMAP filesave
: \6 K! K6 z. _7 `  ]- g# t
    BUTTON CUSTOMER_BUTTON_3
    LABEL Menu Button3
        RIBBON_LABEL Ribbon Button3
8 J7 R: c- g  I7 h  N# }        TOOLBAR_LABEL Toolbar Button3
    BITMAP current_feature
$ W  U. \& A% i
" A0 H% O& K5 q- v; `    BUTTON CUSTOMER_BUTTON_4
# p6 B9 s* s+ \- Y* G/ y5 Z) X5 ]    LABEL Menu Button4
6 l+ j& [, s' N, \+ h        RIBBON_LABEL Ribbon Button4
& r( W+ z4 b  \4 M  {/ I* O        TOOLBAR_LABEL Toolbar Button4
8 S  B1 n: V1 I& _: G9 P0 H    BITMAP block
6 Q9 h6 T- K) u" Z8 E' }, h
7 E1 n2 e3 g. t6 x6 @3 [    BUTTON CUSTOMER_BUTTON_5
    LABEL Menu Button5
( L& H  t9 n: R+ F5 E1 v; h8 R" K0 C        RIBBON_LABEL Ribbon Button5
        TOOLBAR_LABEL Toolbar Button5
    BITMAP checkgreen

END_OF_MENU


- F$ N: Z* j  R$ t* U1 c0 E
) X3 \. A$ d: ?  l4 ucustomer_ribbon_tab.rtb
# @2 D5 Q6 Q- u2 v1 |" z  t( D!
!  Customer Ribbon Tab
!
!  This file will create a new customer tab containing three groups and
( T1 e  J# ]' ]: d6 i" f3 u0 I0 q!  one top level button.
!
9 z* Q& _( i! d& k5 s
TITLE  Customer Tab
VERSION 170
; n2 D1 `. ]( v9 }( ^  T: D, m
' r! Q& [- N9 D# F6 q!  The first group represents a Ribbon group that references an existing
  ?0 ^3 M: F) I6 l!  toolbar with no Ribbon style changes.  
7 P' y  i" A; u& U!
5 N  P  p& Z0 O! V!  This is the quickest way to add existing toolbar content into Ribbon mode.
9 s- i7 ~. Q# p( j) u5 r!
# w) n; N9 [) bGROUP  customer_toolbar.tbr
2 _( f3 H* L5 W. c
!  The second group represents a Ribbon group that references an existing
!  toolbar with Ribbon specific style changes added to it.  There is no difference
! w7 X' W. S2 J; z!  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.
!
!  This approach has advantages for customers that will deploy both Ribbon and
!  Classic Mode customizations since all the content is defined in the .tbr
# A. p4 L& C8 ~9 y5 a!  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
' p+ g1 R0 J2 d4 d* A- E!  control the presentation of the buttons on the Ribbon.
!
( Q9 _' a2 D" j+ l% `8 t- ]% bGROUP  customer_toolbar_alternate.tbr

* Y. k, h: }! Y. O- ]! E' F0 Y) h!  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.  
  Z# O. C4 `  f" q!
!  For customers that will deploy both Ribbon and Classic Mode customizations,
!  this approach will result in no synchronization and two sets of customizations
% l. V/ Y* r1 K2 d!  will need to be maintained.
2 W  m% q3 N, O# f1 W. D!
3 j4 b0 S3 L+ H% c; |!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
!
GROUP  customer_group.grb

!  Example of a button that is placed directly on the Ribbon without being
1 W: |5 h& B) L6 u+ O* ^!  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.
; H3 g! \- R4 k6 h4 N!  
!  A few advantages of groups:
1 z/ W; q3 D) C+ f2 U6 L' m: z% A!     1. Easier to move many buttons around together in quick customization.  
8 [8 o& @6 B  D/ M6 ?' C- M9 T!        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
4 c% ]% T$ {0 C, t7 [- q% E!        not in a group, they need to be moved one at a time.
!
!     2. Provide a label to describe its contents.
( Y% j7 o' x# [, u$ k* W! |4 V!
BUTTON CUSTOMER_BUTTON_1
LABEL Button1 Directly on Tab

1 t# l# e- ]! _* x7 O
$ [! F5 D% q# r, U5 W
customer_toolbar.tbr
- b( `' n. K* v0 @9 i- Q" ^! `!
4 a. m% ?" H. L$ }!  Customer Toolbar File
) v5 `$ w: g8 ?1 ~) x5 z5 [7 n" E!
% Q/ p' p  e$ V& v! |!  This is similar to an existing toolbar file containing
) d  l* V3 T+ i3 d& C0 c!  no Ribbon changes.
!
5 D$ _8 |. o6 _  Q. l+ ~' W!  In Classic Toolbars mode - This toolbar will still show up in the
  U0 U6 B4 @7 `; [& _4 M( O3 H# _!     toolbars list.
: B5 y3 J, j5 j!
0 u* L- \$ L7 y5 K3 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.
!  

5 [7 |0 H4 m; N2 C; aTITLE Toolbar
VERSION 170

BUTTON CUSTOMER_BUTTON_1

9 x' d& J* b( u% ~BUTTON CUSTOMER_BUTTON_2
1 ]  ]" }0 z5 {7 V* P* }
BUTTON CUSTOMER_BUTTON_3

BUTTON CUSTOMER_BUTTON_4
$ j* O) l$ j9 J% q
BUTTON CUSTOMER_BUTTON_5
7 x! O: v$ }7 ^3 I' d. y
- A" Q: D- Q  h- I

( S# C/ b2 ^. I, N1 R+ }customer_toolbar_alternate.tbr
!
!  Customer Toolbar File (Alternate)
!
2 ?6 {0 r; v- Z) |1 P!  This is similar to an existing toolbar file with new
!  Ribbon styles added.
!  
' b% I( r$ t" f1 Y- V3 ~!  The RIBBON_STYLE will be honored when the toolbar is loaded
!  in Ribbon mode as a group but will be ignored when the toolbar
7 e" Q* Q/ t1 O- V4 ^* i!  is displayed in Classic Toolbars mode.
!
!  In Classic Toolbars mode - This toolbar will still show up in the
( {% D) B6 K! u, U!     toolbars list.
!
!  In Ribbon mode - This toolbar will be automatically converted to a
- ]+ X* j9 ~# D1 N4 ~  j!     Ribbon group and will appear in the "Classic Toolbars as Groups"
6 ?( Q. G0 P1 l  I& D' ^- R! ~!     section in the Customize dialog.
. h6 ^- W! v4 x1 J# @/ H; `!
! u8 N$ V6 C  ~0 G$ d8 E
# u/ z- X5 N  u% ~1 `- wTITLE Toolbar (Alternate)
VERSION 170
; C$ n% T6 h1 T. f
/ M- z* w( q; L+ lBUTTON CUSTOMER_BUTTON_1
LABEL Toolbar(Alt) Button1
, \: j; o$ y! XRIBBON_STYLE LARGE_IMAGE

BUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
* |- ]7 E+ `9 K( P& X! `RIBBON_STYLE LARGE_IMAGE
1 E/ D7 a$ a+ x8 {$ h/ m( S& E6 Z# m
3 M+ K! i7 V" O' K  v' J8 @7 ?BUTTON CUSTOMER_BUTTON_3
LABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
1 \- b) x( i& n9 `RIBBON_STYLE SMALL_IMAGE_AND_TEXT
! {' a8 H9 B  _7 Z' G) v
* u# W% M& v, T
5 K9 c' h- J# l' Q% |
. z9 G: _" i, N% b  B4 ?7 G( jcustomer_group.grb
9 V- \5 Q* x: q- e1 s!
4 w5 f: E# _$ @" g$ V( @- i$ X!  Customer Ribbon Group File
!
!  In Classic Toolbars mode - This group will be unavailable
!
3 t, J. J. Z8 Y+ g& z1 [7 C!  In Ribbon mode - This group will show up in the "All Groups" list
!     in the Customize dialog.
+ a3 ^% T8 E4 ?!
!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
: {, v, E6 e$ {!

TITLE Group
$ e8 I( h) [& b3 @8 YVERSION 170
" q' F" }# m& {8 F4 `) a) r) i
+ T& w- F" y4 ?# O. }  o  A0 C9 w!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
2 V; e3 N3 Q2 ~3 b4 `. zRIBBON_STYLE LARGE_IMAGE
4 o( Q# u' p3 n1 k# l" p
2 Z  O/ a3 E/ a2 [( Q1 G!  Example of a gallery defined in a GRB file.
!
!  If this gallery is to be used in other places, then it could be
!  defined in its own gallery (GLY) file and referenced here
$ _8 ~  u& m- C1 O( e!  Example:
!    GALLERY customer_gallery.gly
, \4 Q( a) v* P!
BEGIN_GALLERY  CUSTOMER_GALLERY
COLUMN_IN_RIBBON 2
0 f! J, V$ D6 J$ ~! S, S' XCOLUMN_IN_POPUP 2
9 s# \- U; s6 {LABEL Gallery
GALLERY_STYLE MEDIUM_IMAGE_AND_TEXT

    BUTTON CUSTOMER_BUTTON_2

# f* T7 W. T4 {3 s3 V    BUTTON CUSTOMER_BUTTON_3

. E" Q: ]  Z  M  V' O2 l: ~* Y# t    BUTTON CUSTOMER_BUTTON_4
6 Q/ s+ c5 k- n( T2 J+ {5 A9 z7 @0 k
    BUTTON CUSTOMER_BUTTON_5

END_GALLERY
1 u9 ^9 v+ }  t, F: R
( E' g+ f9 Q/ c3 {: h