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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
' a6 x0 ~3 x, ~4 }6 U" m

经典界面到RIbbon界面转换

4 p0 |" k( \; N5 R在经典界面下，需要的文件

• customer_men.men
• customer_toolbar.tbr
  

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

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  . I9 Z1 |- Y# ^

  D: O/ t% R# R
, ^2 `* n  o5 q/ Z. D* J: f举例如下：

, F, x. m7 L9 [9 n4 A" Z
, F, \7 _& c6 j* L, x; Scustomer_men.men
0 E7 X6 k5 l9 g1 E8 h!
1 S  \- Q7 q) ~' j: u!  Customer menu file
" J% d& |+ V! i7 |* T!
!  Contains button definitions to be used in
!  toolbars and Ribbon files
!

VERSION 120
; t% r0 @  k  r3 Y+ W$ r4 }
+ s. P" J, K3 lEDIT UG_GATEWAY_MAIN_MENUBAR

TOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu
7 U0 \1 X6 q* K9 ?7 i1 \
3 ]  L9 o1 }9 Q. Z/ F. i7 z/ DEND_OF_TOP_MENU
# {$ Y& V& k) B. {; E3 j# b
MENU CUSTOMER_MENU
6 T7 K4 I1 H! p) _" m0 F
. l( X/ t' L9 n* m    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
: Q' N# x  G/ G9 e" |! x( B         RIBBON_LABEL Ribbon Button1
6 u% g. r. h! `8 d4 A- t        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen
: w6 _" Y, S& u( K4 r# N# r/ Y3 f( M
    BUTTON CUSTOMER_BUTTON_2
    LABEL Menu Button2
        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
1 r& y( _9 z$ i7 H    BITMAP filesave
7 N8 }2 R7 s4 `, n
& m3 ~3 t1 @' B5 H    BUTTON CUSTOMER_BUTTON_3
- t  h! n& p8 x' i    LABEL Menu Button3
  E. |: w7 Q" {        RIBBON_LABEL Ribbon Button3
0 t- M" j0 V1 g% ]9 ]& A+ ~( L0 ?, S        TOOLBAR_LABEL Toolbar Button3
- T: u' Y: @# ?( J+ z6 T* {    BITMAP current_feature
6 B5 ?; R. r& Z) A, [6 Z( T
    BUTTON CUSTOMER_BUTTON_4
3 F3 |) Q6 _. }% ~3 `) x" y& R    LABEL Menu Button4
6 F# w3 x. T. {  {8 V        RIBBON_LABEL Ribbon Button4
! S) u' q5 E, s( p. P) L6 H        TOOLBAR_LABEL Toolbar Button4
    BITMAP block

0 B, B. X8 u, b: {* o( S8 l8 X    BUTTON CUSTOMER_BUTTON_5
' A8 W* N$ I% j    LABEL Menu Button5
6 f; q/ x5 X( r, Q$ D/ N        RIBBON_LABEL Ribbon Button5
        TOOLBAR_LABEL Toolbar Button5
0 y) N2 l" y. {# o/ w* b: f    BITMAP checkgreen
% F* H8 M. I- d6 ~' |9 x# m, a! q
1 ^' R2 ]$ j, M, v9 T+ q! H8 F) |END_OF_MENU


5 r% ]! b! U2 N  Q: y) w( }
customer_ribbon_tab.rtb
!
8 S- d  m# H+ b. A" J7 a3 w, g!  Customer Ribbon Tab
!
!  This file will create a new customer tab containing three groups and
!  one top level button.
!

TITLE  Customer Tab
7 w: B5 A: ^: ~0 GVERSION 170

!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
!
!  This is the quickest way to add existing toolbar content into Ribbon mode.
3 c4 X2 d" G+ j!
( ?- c  [6 q, Y' R! |5 a$ l6 m6 r6 d; eGROUP  customer_toolbar.tbr

+ v, O, u' \+ {$ B6 |+ P+ I!  The second group represents a Ribbon group that references an existing
7 {3 W4 @6 E" f. |8 i!  toolbar with Ribbon specific style changes added to it.  There is no difference
% i0 C' S! X# p( |!  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
$ P/ k7 M( y9 w, j3 m!  the .tbr file itself.
7 A9 d1 a! Z7 p!
/ e7 e9 a; ^+ _/ ]) U!  This approach has advantages for customers that will deploy both Ribbon and
. V( U( p2 g* l, e!  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
/ q* r5 `7 j2 R6 F! V!  will need to be maintained while still making use of RIBBON_STYLE to
!  control the presentation of the buttons on the Ribbon.
& L, E) V9 x- a2 m7 u- l!
% q) e$ y/ d  uGROUP  customer_toolbar_alternate.tbr
6 x  q+ g7 c8 e
( u) ?! @: v4 ]1 @: R4 [!  The third group represents a Ribbon group that has been created explicitly
" D( F2 F' I7 D, w/ n* {/ |!  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
, c2 s1 ~0 [2 A! F!  layout styles and containers offered by the Ribbon.  
( y( b2 d5 v& j. w. ]3 o# E/ ~' j( o!
/ ~3 i7 f0 Y  ?% U9 k. L. C!  For customers that will deploy both Ribbon and Classic Mode customizations,
!  this approach will result in no synchronization and two sets of customizations
!  will need to be maintained.
- m3 M, H1 X5 s!
0 ]5 u, b7 ~. L0 e+ J* B+ h5 m- ?!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
0 @% N4 |( J0 q+ k) f5 e!
- b) C6 `& ?; S7 OGROUP  customer_group.grb

!  Example of a button that is placed directly on the Ribbon without being
& T/ ~5 j  s" [8 Y& l!  contained in a group.  This is a simple way to add a button to a tab
3 z2 B% ^% \  w!  but is not recommended for many buttons since groups have advantages.
' `, x; W2 k/ m9 A! u- X7 X' i!  
- Z0 N: q# \# r: V5 }, a!  A few advantages of groups:
/ S) n% c4 O" W, s( h0 k!     1. Easier to move many buttons around together in quick customization.  
8 U5 B! n+ r" w$ ]!        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
!        not in a group, they need to be moved one at a time.
+ C+ U/ w- w: i3 D0 v4 Z0 N8 s!
2 \  C) }6 j7 ^4 S. T3 {!     2. Provide a label to describe its contents.
!
3 F( B- y2 @* v, ]& TBUTTON CUSTOMER_BUTTON_1
' b# y/ Y+ e! V2 n7 ?7 \LABEL Button1 Directly on Tab

) ~" w4 e/ A6 K

customer_toolbar.tbr
3 w, S* q5 m. O, W" x& g9 s!
!  Customer Toolbar File
!
!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
' m" @8 U* w6 ^+ o$ V!
!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
4 e4 v5 H, @* E0 W5 Y!
# u  {. j; U+ C1 O! {!  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, p& H* ~7 h* z6 q/ h/ E!  

TITLE Toolbar
VERSION 170

2 J0 V- X# H% ?: O0 RBUTTON CUSTOMER_BUTTON_1

BUTTON CUSTOMER_BUTTON_2

* t0 p! p9 Y; K9 R( ~' G& F" a9 h% CBUTTON CUSTOMER_BUTTON_3

BUTTON CUSTOMER_BUTTON_4
5 F; I) k+ p3 ?6 \; f0 {
BUTTON CUSTOMER_BUTTON_5
1 n  E/ y7 S/ `: ]* ~; b7 n

2 ^2 }3 y9 [  }. H- |
* L2 R6 P3 V6 n9 w% w2 c4 ccustomer_toolbar_alternate.tbr
!
!  Customer Toolbar File (Alternate)
* _/ L8 c! q" }2 Z& _& D7 `3 c!
* `* _& W0 N% b!  This is similar to an existing toolbar file with new
6 V0 f/ B7 [/ [0 s# h( D# K!  Ribbon styles added.
$ ]( p/ m$ y# b7 o( r+ Y!  
' J3 Q) |' Z7 h9 M!  The RIBBON_STYLE will be honored when the toolbar is loaded
! g) i$ F1 Q1 z+ C4 W' r9 b!  in Ribbon mode as a group but will be ignored when the toolbar
!  is displayed in Classic Toolbars mode.
" O3 F$ h9 M' V, S- x2 E!
8 m8 Z& y: W) o: Q$ x0 J. V!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
- \6 q/ t& ~8 ]  d+ @* P1 n. [!
!  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.
!

( O2 T$ b5 c1 d' m. p6 P, \% y3 I! W6 yTITLE Toolbar (Alternate)
% U4 X- A$ g( UVERSION 170
- z5 q. V% q/ @; V( `" l1 G$ Q+ f5 V! D
BUTTON CUSTOMER_BUTTON_1
4 |) s; O% E. [3 @9 ?9 }LABEL Toolbar(Alt) Button1
( A: D7 D& x" U' pRIBBON_STYLE LARGE_IMAGE

$ h- D# ]( `4 P4 \: D) z5 nBUTTON CUSTOMER_BUTTON_2
& F. \# J) P" f% b2 a* iLABEL Toolbar(Alt) Button2
RIBBON_STYLE LARGE_IMAGE

$ ^! b  I. g3 g" a. H- fBUTTON CUSTOMER_BUTTON_3
  T) Z9 L7 g9 r6 ?LABEL Toolbar(Alt) Button3
* ^. ?- l8 r# o3 L; eRIBBON_STYLE SMALL_IMAGE_AND_TEXT
% ]/ A/ I# k( b9 ]" [  L: ]
BUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
6 x! ^1 f4 k& YRIBBON_STYLE SMALL_IMAGE_AND_TEXT

9 b* C2 Q8 v( l# q% h7 s( J% vBUTTON CUSTOMER_BUTTON_5
, t" L1 ^( a# J8 ]# f& M8 |+ j7 lLABEL Toolbar(Alt) Button5
# \# \; f1 b; x. @) H4 RRIBBON_STYLE SMALL_IMAGE_AND_TEXT


+ F& ]. U6 _. ]1 P
customer_group.grb
!
' f! q5 W# b9 ~: k" @) `  X!  Customer Ribbon Group File
!
!  In Classic Toolbars mode - This group will be unavailable
!
!  In Ribbon mode - This group will show up in the "All Groups" list
!     in the Customize dialog.
!
!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!
3 Q; [- _4 F! c) O. l+ e
TITLE Group
: h$ M# |4 \1 W: A% H6 ZVERSION 170

! ]2 Q9 @" C" u$ B9 A3 G3 P  D7 f!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE

!  Example of a gallery defined in a GRB file.
' j+ q) u$ i4 N- q; b, T9 w!
% H7 e. P2 f9 ?0 ^7 x- r!  If this gallery is to be used in other places, then it could be
) v: M5 @# T; h7 E; B# _" F; e! d!  defined in its own gallery (GLY) file and referenced here
" k. I; h5 _$ |* J& b!  Example:
!    GALLERY customer_gallery.gly
8 _: I$ J; O* a2 |- x$ i6 V!
/ f4 i. e' a/ g- U( ]* FBEGIN_GALLERY  CUSTOMER_GALLERY
; K* F' h" E( D2 }; R. |  |. fCOLUMN_IN_RIBBON 2
COLUMN_IN_POPUP 2
LABEL Gallery
GALLERY_STYLE MEDIUM_IMAGE_AND_TEXT

) g" @3 D  n" u    BUTTON CUSTOMER_BUTTON_2

    BUTTON CUSTOMER_BUTTON_3
% K  M, Z: W0 ~' X- Z: v! P8 ^( h. c; g
- g% J% Z% x8 x    BUTTON CUSTOMER_BUTTON_4

    BUTTON CUSTOMER_BUTTON_5
( v, N* i! ~1 \2 X' p4 v! H, }
END_GALLERY

" E; a% H4 |7 i# |# V( f  S