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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
0 V$ m1 G4 e7 v; A. a* E5 Q

经典界面到RIbbon界面转换

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

• customer_men.men
• customer_toolbar.tbr
  4 b6 A  v5 Y/ g0 `. O

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

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

* {! Q: Q- K  Q/ N2 V举例如下：
0 y$ k* \5 `% }7 Y1 y
- ?4 o3 ]9 |# Z" @4 ^( U  B2 T+ F! }( t
customer_men.men
!
+ K, ?" L9 `, R( W( H2 U7 _2 U!  Customer menu file
!
!  Contains button definitions to be used in
!  toolbars and Ribbon files
!
% |- \' ^8 j" H& }9 Z) o
8 G( T$ m% k9 ZVERSION 120
3 J3 x6 |0 S1 f
; `# f$ e1 X8 E& A) DEDIT UG_GATEWAY_MAIN_MENUBAR
) N1 j' z8 ]' O( b% ]& G
TOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
. E/ ]7 g& S! V5 @5 y    LABEL Customer Menu
+ x: A9 I/ X. j9 r1 t: C& x4 [
END_OF_TOP_MENU
# M: b% L3 `" h- w3 B
MENU CUSTOMER_MENU

    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
; m1 E  ]7 s$ N; w1 p4 Q* E         RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
( o0 C$ N2 D% J5 o& P1 t    BITMAP fileopen

( r4 r' p6 G' S  A    BUTTON CUSTOMER_BUTTON_2
    LABEL Menu Button2
        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
) w- F. S" V0 j    BITMAP filesave

$ S7 ^5 e$ w. `4 @% n# x    BUTTON CUSTOMER_BUTTON_3
  o- h& f; \: l4 [, g    LABEL Menu Button3
        RIBBON_LABEL Ribbon Button3
        TOOLBAR_LABEL Toolbar Button3
    BITMAP current_feature
) N( j4 ~" V2 Q) U
1 y  P+ q; K: j0 T$ Y; h& x" C0 V    BUTTON CUSTOMER_BUTTON_4
# w+ X) R- K9 \' P) X    LABEL Menu Button4
        RIBBON_LABEL Ribbon Button4
9 X' B0 E  D3 `9 |) |0 N& i        TOOLBAR_LABEL Toolbar Button4
8 o. _5 n7 w: t3 ]2 Z  o    BITMAP block

% R& ]  q' k( M( @; ?    BUTTON CUSTOMER_BUTTON_5
    LABEL Menu Button5
        RIBBON_LABEL Ribbon Button5
% H4 Y: Q' p' F0 R  ~: s9 q        TOOLBAR_LABEL Toolbar Button5
. r' E5 [: v; [    BITMAP checkgreen
6 N# G! \4 v* n$ X# e8 d% Q" r0 X
( v) C! i0 ]1 b% \END_OF_MENU
+ `+ \6 g$ d. d3 D' e
2 ]' q* b5 p+ V; l* Q! m) R

" w- f9 {; y. k6 K1 I# @+ }$ `4 @+ [1 Pcustomer_ribbon_tab.rtb
!
' A1 @9 J( m) J9 H& b0 I6 Z1 x!  Customer Ribbon Tab
4 ~( t, j( P' C( D" d!
!  This file will create a new customer tab containing three groups and
!  one top level button.
! ]( w: l6 Z2 S7 d' P5 S!

- M/ W5 A- Q: T0 |& @# y2 z6 }) [TITLE  Customer Tab
- t. E! s% s* X1 d  A# SVERSION 170
9 d" R; C2 ?* Y% |5 E* d8 m
!  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.
!
2 V. H3 p1 N. S, ?GROUP  customer_toolbar.tbr

/ o, a$ S/ h* u. g* u! ^3 B!  The second group represents a Ribbon group that references an existing
!  toolbar with Ribbon specific style changes added to it.  There is no difference
- K( t: h4 L7 u/ h1 S& Z! {/ g/ J!  in how this toolbar is referenced in the .rtb file compared to the first
% p. D6 P" v+ V  O2 S: v!  toolbar as a group.  The only differences from the first group exist within
!  the .tbr file itself.
!
" @# o9 g2 q) u! s# _!  This approach has advantages for customers that will deploy both Ribbon and
, J; O! f% r2 M5 H!  Classic Mode customizations since all the content is defined in the .tbr
6 F% T! G* b# K* p4 Y!  file and it will stay synchronized in both modes.  Only one set of customizations
7 F3 H9 K5 U- u# {  O% F!  will need to be maintained while still making use of RIBBON_STYLE to
!  control the presentation of the buttons on the Ribbon.
4 z% r7 v4 z3 n4 x* w!
GROUP  customer_toolbar_alternate.tbr
) u" H' Z9 W6 `9 `* A$ \* X& n
!  The third group represents a Ribbon group that has been created explicitly
" P) n! v# Q, v7 Q1 y* }) m!  as a Ribbon group and will not exist in Classic Toolbar mode.  This is the
+ B; _7 a: e8 R5 ^5 Q( J!  preferred option since the user will be able to take advantage of all the
- `' _- e3 Y) `8 O. s3 o!  layout styles and containers offered by the Ribbon.  
' X/ r% A5 {1 i: I& z!
  O* Y8 R, I: V5 a. e' R5 H: o!  For customers that will deploy both Ribbon and Classic Mode customizations,
* Z& S; u/ R" p& Y9 M+ j!  this approach will result in no synchronization and two sets of customizations
# J4 H' M2 e, ]" z!  will need to be maintained.
!
  O4 k9 H0 N! f$ m!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
& ^- L2 W4 A/ R2 _6 ]!
GROUP  customer_group.grb

, ^  `) `! L8 e; e% u# g- Z!  Example of a button that is placed directly on the Ribbon without being
!  contained in a group.  This is a simple way to add a button to a tab
3 \0 X" k7 ]. R/ O; t6 t- u( m: a!  but is not recommended for many buttons since groups have advantages.
!  
6 P# t' @  b. j6 ?% i  M( m!  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".  
( C% K) o% M5 f# Z) M0 r!        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.
!
!     2. Provide a label to describe its contents.
!
BUTTON CUSTOMER_BUTTON_1
, }2 r7 S; b$ ELABEL Button1 Directly on Tab

! d- b% O# N/ r' H; z2 X& Z

* ~6 o6 X1 m. W! N" H: Acustomer_toolbar.tbr
0 T, r* f1 b2 ]( A5 m2 d!
!  Customer Toolbar File
: k$ ~! F6 w2 A!
!  This is similar to an existing toolbar file containing
/ _1 c  W9 C+ k2 }!  no Ribbon changes.
!
* r' d7 E" m  C  ], B!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
' G* B( X! Z6 P" Q" G!
* y/ @. k' ?9 h! E!  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.
!  
0 c5 `8 K6 n2 u) q# ]3 T
# [0 A9 p! v5 G1 z% {. f' }TITLE Toolbar
2 D9 o- V7 b. XVERSION 170

BUTTON CUSTOMER_BUTTON_1

BUTTON CUSTOMER_BUTTON_2

BUTTON CUSTOMER_BUTTON_3

9 ?3 M5 J; f3 @. _; DBUTTON CUSTOMER_BUTTON_4

BUTTON CUSTOMER_BUTTON_5
! f+ [! S9 W& l3 t; u5 k1 V6 k
3 G0 U( `+ w1 M9 Y5 h4 }3 P4 q

7 }* p" M' W9 s! X. ^! pcustomer_toolbar_alternate.tbr
!
!  Customer Toolbar File (Alternate)
!
# ?) ]3 a3 N. B3 P!  This is similar to an existing toolbar file with new
!  Ribbon styles added.
!  
!  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.
5 S* K& Y+ x1 ?  i% Z- W!
!  In Classic Toolbars mode - This toolbar will still show up in the
0 e( l! Q8 n( g# I' M!     toolbars list.
!
!  In Ribbon mode - This toolbar will be automatically converted to a
$ L- v* m1 d9 J) P( C!     Ribbon group and will appear in the "Classic Toolbars as Groups"
) \8 x$ f2 a4 Y6 K7 [) l!     section in the Customize dialog.
: }$ D6 M9 c4 [! w  W$ m. n!
0 L1 e; l5 J, w6 D. D% N/ j2 D+ C
TITLE Toolbar (Alternate)
: n3 q. Q- x$ B4 j9 ^VERSION 170

; ^" x3 m4 I7 K2 |. f* ^# ^BUTTON CUSTOMER_BUTTON_1
) J+ x/ m, p% K) t- d6 qLABEL Toolbar(Alt) Button1
! p" Y, [- Q+ I* q) Y1 ^3 R( FRIBBON_STYLE LARGE_IMAGE
. q1 c7 R& R5 x* V
+ P; R! b8 i6 M, H$ Q! OBUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
RIBBON_STYLE LARGE_IMAGE

6 O3 R8 K; E* _% R  c$ n2 uBUTTON CUSTOMER_BUTTON_3
/ m) Y- J1 |  Y% J7 ~LABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT
8 P* Q, m9 e; j3 s" j
BUTTON CUSTOMER_BUTTON_4
! J. j. R: ~7 A6 X8 y. WLABEL Toolbar(Alt) Button4
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_5
& o- w' C8 C" U6 s2 w! nLABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT
* v, I1 A, ]% v6 a4 M7 i% S
9 a% L; ~2 f- ~# Z- B

customer_group.grb
& E& S+ h, g2 R% }3 l9 G!
" F3 |  a# t! t0 z7 h!  Customer Ribbon Group File
* a( W0 ~: L" l, _1 t4 R* O8 q!
7 g) b  P9 A/ U$ A7 s!  In Classic Toolbars mode - This group will be unavailable
!
* r# c6 Q0 X, A7 r  X( B!  In Ribbon mode - This group will show up in the "All Groups" list
!     in the Customize dialog.
) c+ @& ?4 b0 P( D$ f+ r1 V!
  x8 q- i* |* C+ M! g$ B0 ~!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
!

TITLE Group
VERSION 170

!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
5 c" @6 d$ D  ?7 m& w2 c. C3 `BUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE

!  Example of a gallery defined in a GRB file.
!
1 a! B" U1 w; k2 j( w( y* t!  If this gallery is to be used in other places, then it could be
!  defined in its own gallery (GLY) file and referenced here
!  Example:
( M; w, _, }2 t' Y2 s7 l7 c!    GALLERY customer_gallery.gly
# p: N( u( d2 B: E) v$ w- K$ @!
; U- l% V+ w, b1 l# hBEGIN_GALLERY  CUSTOMER_GALLERY
COLUMN_IN_RIBBON 2
8 Z1 s; I1 X  e1 _COLUMN_IN_POPUP 2
* ?, U6 m+ g# K9 ^  m! T1 U! f0 t- JLABEL Gallery
7 P% ?7 v' w* d. KGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
4 [6 x7 D7 L4 z  Z2 ~- f* u' q
! D3 B2 p4 S  c0 v    BUTTON CUSTOMER_BUTTON_2

    BUTTON CUSTOMER_BUTTON_3
2 K5 O* n" W( q& Q$ q
& `* N' @) W% B/ v/ d" c    BUTTON CUSTOMER_BUTTON_4
: C6 p# W( q9 C8 D  l
6 d- m8 N/ u3 a3 ?    BUTTON CUSTOMER_BUTTON_5

END_GALLERY


! P' d, U: q% {