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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
9 {0 e9 c- k. F3 q1 U6 B* }

经典界面到RIbbon界面转换

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

• customer_men.men
• customer_toolbar.tbr
  

在ribbon界面下你可能需要的文件
! t+ Z  z8 R. H. Q

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  $ @/ e& T9 B. H9 R3 e  N" z- q

. I4 i: ^. |+ `+ C
举例如下：
' `; _  O) h  p: h
; V% R! `  N( f4 L
customer_men.men
!
!  Customer menu file
!
!  Contains button definitions to be used in
!  toolbars and Ribbon files
* K: H. U& P. V0 C! j!
% C. ]4 B2 D. O0 K: a8 u+ c1 k
VERSION 120
3 L! s8 M% m6 {! c
EDIT UG_GATEWAY_MAIN_MENUBAR
" K8 L5 L$ a( j0 K
3 a. [" h9 E# r4 u6 W4 GTOP_MENU
- |) b. _# j" b3 E8 L$ H3 w    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu

% Z- ^+ D$ T3 H4 wEND_OF_TOP_MENU

MENU CUSTOMER_MENU
9 S1 d, u4 j$ ~( M; l* h
    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
        RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
. g2 o( S/ V5 z6 U, i    BITMAP fileopen

    BUTTON CUSTOMER_BUTTON_2
0 e5 T& v4 x, C$ f5 U; O1 `    LABEL Menu Button2
        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
4 [* i  w; a0 W2 g, q9 Y    BITMAP filesave

4 ]  K+ \! j( D3 h. b% h    BUTTON CUSTOMER_BUTTON_3
# d" e7 ]4 J6 U' h1 o8 Y0 c: z- x    LABEL Menu Button3
        RIBBON_LABEL Ribbon Button3
# ?" n9 T. ?3 [9 }2 V  B        TOOLBAR_LABEL Toolbar Button3
    BITMAP current_feature

9 a" u8 t& J  H) P4 ]    BUTTON CUSTOMER_BUTTON_4
' N3 F! X9 l$ f$ b5 r% Z    LABEL Menu Button4
* f' {; R5 q* Y1 C7 g5 }4 c        RIBBON_LABEL Ribbon Button4
/ ~# L  v3 e4 i$ f$ E! q        TOOLBAR_LABEL Toolbar Button4
6 B, m( v4 K' T8 S; v4 v    BITMAP block

# \6 l7 a3 m$ D% u: ]1 s    BUTTON CUSTOMER_BUTTON_5
/ \  R8 `) ^: _% Z( e+ o4 P7 y    LABEL Menu Button5
0 N7 G- ~) X% l+ _        RIBBON_LABEL Ribbon Button5
        TOOLBAR_LABEL Toolbar Button5
4 t$ S# v# d7 v. o2 d) V4 F    BITMAP checkgreen

END_OF_MENU
7 q9 P/ ]  D. z% X. y/ ]
5 c# f1 T- ?; ^* l5 ~, x

5 F# Z5 F  ~( G. R( lcustomer_ribbon_tab.rtb
3 r8 _$ q5 v# ?+ a!
2 n+ T" }# m7 ^+ v# Y!  Customer Ribbon Tab
!
!  This file will create a new customer tab containing three groups and
!  one top level button.
  ~4 _' Z: p5 o1 |8 L!

/ L9 W2 }, f$ x. Y1 Q, KTITLE  Customer Tab
% D4 B& n5 i8 VVERSION 170
% k3 z! ~* ?/ c7 A
!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
2 W+ N/ M0 B& _!
!  This is the quickest way to add existing toolbar content into Ribbon mode.
!
+ m# x7 f7 r7 X, RGROUP  customer_toolbar.tbr

!  The second group represents a Ribbon group that references an existing
6 X- u& `: c* F1 ]: V  d# p!  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
1 p7 c0 `" Y& b) w7 O: @!  toolbar as a group.  The only differences from the first group exist within
0 F' v. A; X8 c: x!  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
; B! S1 c% k' f( B( K' C% C!  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.
$ @/ r+ a$ W0 K) I; R!
4 \- j! K5 K: {' G4 {6 MGROUP  customer_toolbar_alternate.tbr
+ ~1 R. p! V$ W+ Y$ X* L
( z* e3 `& X9 h" u!  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
/ ^! e6 L( r6 T1 i/ r: Q!  preferred option since the user will be able to take advantage of all the
7 c: n8 ]( V: j; h" b+ D  o% L- q!  layout styles and containers offered by the Ribbon.  
!
!  For customers that will deploy both Ribbon and Classic Mode customizations,
& ^: d! r) Z8 a, a8 C1 k  ^!  this approach will result in no synchronization and two sets of customizations
% U- t8 z0 D  f& |, ^8 Z!  will need to be maintained.
2 ]$ K; Y, M2 P- _4 ?4 d. \, ]!
9 P& r4 b3 Q, {4 d# f!  A group can alternatively be defined directly inside the .rtb file by using the
* Y0 i, e! D4 N- r- ^! `% d' H7 d!  keywords BEGIN_GROUP and END_GROUP.  
!
GROUP  customer_group.grb
6 ~7 ?! m5 t4 ^. p" L6 W+ u
+ F1 F/ e7 |" `2 Y8 P! ~5 `5 k!  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
!  but is not recommended for many buttons since groups have advantages.
  ?# j6 P& u4 R!  
!  A few advantages of groups:
! ~/ F) w% L+ ?) m7 u  X1 T!     1. Easier to move many buttons around together in quick customization.  
4 \. @$ v. n$ P: \, B!        For example, MB3 on a group and choose "Add to Left Border Bar".  
$ Z0 S% T) M! Y- C4 ?5 B% J!        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.
!
, h8 G- O" R- O+ p!     2. Provide a label to describe its contents.
/ s8 n* Y% `2 e5 ?!
/ j2 K6 C3 [/ t# hBUTTON CUSTOMER_BUTTON_1
5 b6 I2 \" O( l' ILABEL Button1 Directly on Tab
6 \; D& \+ ^/ P! w6 u
# b7 N3 F7 c: z8 p" h" c3 s, V$ Q

customer_toolbar.tbr
!
!  Customer Toolbar File
!
!  This is similar to an existing toolbar file containing
+ A2 ], V, {4 _9 t!  no Ribbon changes.
7 M7 v; S9 T! w* @) ~( p5 ?!
!  In Classic Toolbars mode - This toolbar will still show up in the
: G6 D3 |1 v5 j* x' F8 e!     toolbars list.
!
!  In Ribbon mode - This toolbar will be automatically converted to a
0 U/ D5 T0 V2 \7 x; i- r- \!     Ribbon group and will appear in the "Classic Toolbars as Groups"
4 c: |0 R6 b: ]4 j!     section in the Customize dialog.
/ }9 R4 i' N& l) S% R' R" U8 q!  
" r# r, i1 y% o5 @
! B" g9 v. L4 E$ u1 ]TITLE Toolbar
' K5 j- Z6 m7 g0 ~9 r5 `, ^6 ^VERSION 170
0 y& v9 c  e3 [
BUTTON CUSTOMER_BUTTON_1

BUTTON CUSTOMER_BUTTON_2
, L# W3 t3 G+ }0 q9 W% y0 H* s6 ?
BUTTON CUSTOMER_BUTTON_3
& E( E& B& l9 J  r# q; p
2 z3 E+ i# m- _) s- |* p- KBUTTON CUSTOMER_BUTTON_4
* s" J/ w. s4 x; w: }" Q* u4 x
7 d# r' Y0 [& Y$ }' ?BUTTON CUSTOMER_BUTTON_5
  |( f# f$ c6 B! O& t) b# D# E


" q, t3 L, u7 {0 O+ [( Hcustomer_toolbar_alternate.tbr
* ?! L& W+ C: l3 V!
$ [8 n$ \& i4 f- O3 B/ o* G!  Customer Toolbar File (Alternate)
6 _5 p/ J; T# Y1 t4 C8 l!
- u0 x# h+ j& u/ _" e9 L!  This is similar to an existing toolbar file with new
!  Ribbon styles added.
% d5 M- q+ a/ r) N$ }!  
!  The RIBBON_STYLE will be honored when the toolbar is loaded
!  in Ribbon mode as a group but will be ignored when the toolbar
2 r0 j9 |; i6 P5 Z, X!  is displayed in Classic Toolbars mode.
!
!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
5 M  a7 M( P+ E, a!
+ s. F  y5 H( L1 m8 g!  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 ]+ l0 G$ m. ^- [: K2 }( d!
, q  [" g  L. a; m8 ~+ A
* ^" ?. D- K5 ]0 P5 {7 c/ dTITLE Toolbar (Alternate)
  `% b2 n$ e- S/ h% @" jVERSION 170

: L- ^! R" _4 j2 \BUTTON CUSTOMER_BUTTON_1
LABEL Toolbar(Alt) Button1
RIBBON_STYLE LARGE_IMAGE
: ?: b% f# ?0 n# k
' B) f1 w# p* _5 uBUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
RIBBON_STYLE LARGE_IMAGE
& v: A  x6 \9 s7 f3 v
) g7 e$ p9 P# P* V! h) }" c8 m$ sBUTTON CUSTOMER_BUTTON_3
LABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

" ?4 p( U' O% X+ s( N0 t) S+ `6 KBUTTON CUSTOMER_BUTTON_4
, @5 K- ?, {8 i/ T; F" RLABEL Toolbar(Alt) Button4
1 C5 o  N7 ^& J+ `RIBBON_STYLE SMALL_IMAGE_AND_TEXT
" \) F1 W( J& K" K( d
. X7 T* n. Y5 z; w- zBUTTON CUSTOMER_BUTTON_5
LABEL Toolbar(Alt) Button5
8 S8 A4 Z2 V) e; {/ ?RIBBON_STYLE SMALL_IMAGE_AND_TEXT

9 C, \0 o1 l: X) y! H" t* Y; d# d
1 w7 r. S0 G) P! |+ s  }0 K
: ], x2 r4 C% h& Q; t8 ^) K, p0 [2 Bcustomer_group.grb
% s$ Z+ J% ~6 U6 T- m, |!
7 h# `2 b" X  Z; `!  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
: g: Q4 z" K! O, v!     in the Customize dialog.
5 ?% w% {0 p! y/ q* s( ~: [!
- c7 Z. S+ ^! K  u!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
& \8 c, A2 _' a$ `+ q: v0 a!

TITLE Group
VERSION 170

!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
% w9 H5 P$ o0 V: A0 L; w9 TBUTTON CUSTOMER_BUTTON_1
RIBBON_STYLE LARGE_IMAGE
* B* [9 i) S4 X7 u6 O( F
!  Example of a gallery defined in a GRB file.
/ m) Y2 h* c$ N1 \  O) y; V" ~!
!  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:
' T$ }+ m/ @- x( ?5 l!    GALLERY customer_gallery.gly
. n# I+ s; L  N5 y!
BEGIN_GALLERY  CUSTOMER_GALLERY
/ s3 l  L/ e$ G# p/ DCOLUMN_IN_RIBBON 2
5 C! s2 A! ^" M( |- Q& H" a, h- LCOLUMN_IN_POPUP 2
LABEL Gallery
7 u% R' j% T- CGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
( @# P5 P+ C7 O- j
    BUTTON CUSTOMER_BUTTON_2
; |: O% V4 [0 K/ P) d
6 K$ b0 g4 {! t0 }4 G8 }+ b    BUTTON CUSTOMER_BUTTON_3
, ~7 E+ V5 g5 ~8 {" ~
    BUTTON CUSTOMER_BUTTON_4

7 K! `; J0 ~) l% M- B6 @* E    BUTTON CUSTOMER_BUTTON_5

7 N/ f* ~/ w) J9 AEND_GALLERY
. \; w8 o3 _" q4 W
( u9 c% F. r9 _- b
/ X' L1 G/ t" x. ]