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

admin

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

经典界面到RIbbon界面转换

在经典界面下，需要的文件
# Y$ g  c3 G5 d0 M

• customer_men.men
• customer_toolbar.tbr
  ) T, _/ n3 J2 A$ T

在ribbon界面下你可能需要的文件
8 j) Q  T4 i8 w) O9 Z

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  ) L% m: Z. j7 K, a% `5 S! a

7 d  W9 Y$ Y. t* b2 U3 C" w
& f! [% E! r% k2 X2 ^8 N; p举例如下：

) Z0 U5 d& O" n
% C$ n& U' y0 j5 {. T; i" zcustomer_men.men
* b" _$ q3 T) T+ H!
!  Customer menu file
7 {. z. F7 V" d' s1 ?2 w!
8 ^" Z3 C% M' C9 o7 a/ E!  Contains button definitions to be used in
9 r- g" U5 k- e0 Q' |+ B!  toolbars and Ribbon files
!

VERSION 120
* c/ ]9 E" E0 n! ~4 z% I
8 q: c* o) c3 @! h( ^, DEDIT UG_GATEWAY_MAIN_MENUBAR
. z4 U0 b7 b3 E$ v/ W  Y+ G
) ?, ]& I, }# b$ MTOP_MENU
    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu

/ m5 K* b) V. A' m$ w9 lEND_OF_TOP_MENU

# P; t& q8 Q4 s# I% p! J2 ]) CMENU CUSTOMER_MENU

    BUTTON CUSTOMER_BUTTON_1
# ?8 Y7 i) w7 f' f: y$ \  n0 [    LABEL Menu Button1
' u9 l: [: B$ V  ?/ m         RIBBON_LABEL Ribbon Button1
        TOOLBAR_LABEL Toolbar Button1
    BITMAP fileopen

    BUTTON CUSTOMER_BUTTON_2
    LABEL Menu Button2
" J  W/ w6 U7 q1 L* [# i, E; O0 l        RIBBON_LABEL Ribbon Button2
& T9 D9 ~8 F3 ?0 H! F( c: |        TOOLBAR_LABEL Toolbar Button2
    BITMAP filesave
! s) L6 Z% N! L2 }3 e1 c
. ^9 ^  M# P2 c4 J/ b; M  [5 U    BUTTON CUSTOMER_BUTTON_3
$ j9 M, Q7 n# h; ~5 B    LABEL Menu Button3
. c' O- S4 W: K2 |8 C        RIBBON_LABEL Ribbon Button3
        TOOLBAR_LABEL Toolbar Button3
8 A) L7 s& S5 r    BITMAP current_feature
. E2 J4 m8 A' |* J5 ?8 l4 W
  o  q( l7 Z6 f! C7 _    BUTTON CUSTOMER_BUTTON_4
    LABEL Menu Button4
        RIBBON_LABEL Ribbon Button4
        TOOLBAR_LABEL Toolbar Button4
/ Q" V& I4 x4 Z- i    BITMAP block
, Y8 f( J3 {! B/ g: h/ }+ j$ G
    BUTTON CUSTOMER_BUTTON_5
6 N' R. N3 d4 o    LABEL Menu Button5
        RIBBON_LABEL Ribbon Button5
, D; ]& I2 e3 Y2 A        TOOLBAR_LABEL Toolbar Button5
5 E. R: m" C  K; c! B    BITMAP checkgreen
$ i3 H% i6 _; t  j( @, w
END_OF_MENU


1 R/ `% N, X; z$ z
0 q8 k' U& D' r9 B) ]" ocustomer_ribbon_tab.rtb
: z/ G4 s7 T& Z) R7 A!
!  Customer Ribbon Tab
!
!  This file will create a new customer tab containing three groups and
1 r+ L1 |; U) F) D$ j; m) q!  one top level button.
!

TITLE  Customer Tab
VERSION 170
9 d# x& M2 E) n. w; L3 r  Q
!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
' _4 g0 X" C4 L: F" t, @$ p!
!  This is the quickest way to add existing toolbar content into Ribbon mode.
!
) E+ X. F9 Q& L- QGROUP  customer_toolbar.tbr
/ W+ j9 x5 \, R- N) }5 ^3 M( A
!  The second group represents a Ribbon group that references an existing
2 v5 B% p8 v2 J8 }. f$ ?2 h6 U!  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
, `- r" n' c  o6 U9 }, ?# w, ^0 @!  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
( L; ^; S1 {- c  F!  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
) e: V) [+ A; U7 W7 i& x!  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
!  as a Ribbon group and will not exist in Classic Toolbar mode.  This is the
$ v0 H" ]" F) F2 G/ _4 e& R!  preferred option since the user will be able to take advantage of all the
!  layout styles and containers offered by the Ribbon.  
!
& J+ X& J) I4 E/ i4 @0 x!  For customers that will deploy both Ribbon and Classic Mode customizations,
( Y. C3 k  k+ i1 G4 z!  this approach will result in no synchronization and two sets of customizations
2 h6 o" H! }1 x( I/ m!  will need to be maintained.
4 |( T) q( `$ x9 T6 a/ C!
" N9 R& u  H- f  a!  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
!  contained in a group.  This is a simple way to add a button to a tab
4 F, V0 ^3 ~/ J0 S+ J0 {% W$ G!  but is not recommended for many buttons since groups have advantages.
, a% U& {. n* O3 \!  
) c9 M; z9 {7 h!  A few advantages of groups:
/ M! ~) F1 q( S2 F# \!     1. Easier to move many buttons around together in quick customization.  
!        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.
!
, S1 A* I: [1 @!     2. Provide a label to describe its contents.
/ r( }- e% b9 V0 u0 a& N: F!
' S, \- W# R' vBUTTON CUSTOMER_BUTTON_1
LABEL Button1 Directly on Tab

  d' `, k1 ]! Z
  e3 {3 M- e5 Q* }5 T  g
9 {8 @9 v. |9 E7 ?1 ^& l  Jcustomer_toolbar.tbr
) S6 T) H8 ^, T. p3 M!
!  Customer Toolbar File
- G/ r8 B# Y+ z! h8 M!
!  This is similar to an existing toolbar file containing
!  no Ribbon changes.
! {$ y- b+ [* w! U( q!
: N- h7 D! P* a, S  [!  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
7 L9 Y2 \. f1 F, U- n: k. h4 \!     Ribbon group and will appear in the "Classic Toolbars as Groups"
!     section in the Customize dialog.
9 y' r4 E$ @) e6 G5 U( Z$ q!  
2 t% p. w+ H4 o& r) U( v& L
TITLE Toolbar
7 y0 P7 l! B6 T3 n8 R) FVERSION 170

. X2 d4 W& B" p% ^1 B) h' vBUTTON CUSTOMER_BUTTON_1
- F# ^2 \9 o5 `- j
BUTTON CUSTOMER_BUTTON_2
8 g( e1 E& Z; p0 k' }
BUTTON CUSTOMER_BUTTON_3
9 u" w  o  c: d9 I0 N2 Q# @, ?% \
BUTTON CUSTOMER_BUTTON_4
: g: a0 N6 x! `
' ~+ L% }! t2 G8 Q5 D/ M" x5 UBUTTON CUSTOMER_BUTTON_5
' U. L6 K9 C$ K3 |, K. p


& p) N4 _. o8 |0 Ucustomer_toolbar_alternate.tbr
!
!  Customer Toolbar File (Alternate)
$ Q- u# T& v) s, q!
6 @" r) {4 A9 J!  This is similar to an existing toolbar file with new
# F) {0 U$ X, ]/ k6 q  q: I5 f/ Z!  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
: m8 e  A% e' m6 z$ _/ X!  is displayed in Classic Toolbars mode.
% f* v/ q6 w+ K0 O4 z!
& E# b/ E" k' e: F  m+ ?1 q& f) G! h!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
!
; |6 {- U* m7 e$ w$ c- M2 l!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
+ E9 h0 A+ L% \!     section in the Customize dialog.
!
" K6 `  o& Q; a' \. |6 p
TITLE Toolbar (Alternate)
VERSION 170

BUTTON CUSTOMER_BUTTON_1
LABEL Toolbar(Alt) Button1
RIBBON_STYLE LARGE_IMAGE

BUTTON CUSTOMER_BUTTON_2
LABEL Toolbar(Alt) Button2
% {3 h3 U- o/ y# K) R  hRIBBON_STYLE LARGE_IMAGE
' L0 e+ C6 c" H: n
7 D" a4 r- a, ?BUTTON CUSTOMER_BUTTON_3
' p: J9 s6 l9 ^LABEL Toolbar(Alt) Button3
' t) F4 J) h0 ?: T% N7 n6 x# z3 N: FRIBBON_STYLE SMALL_IMAGE_AND_TEXT
$ w1 u8 w& K: `* l; {
BUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

BUTTON CUSTOMER_BUTTON_5
' R6 a+ [0 i6 ~% ILABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

# ~1 }$ C- z. q9 y6 n

- s! V- z% _- [customer_group.grb
!
5 W$ @  v; ]& f, \8 l7 A- E!  Customer Ribbon Group File
!
!  In Classic Toolbars mode - This group will be unavailable
6 r' k5 B" w1 A; ~!
* k. I# N4 t3 @2 }!  In Ribbon mode - This group will show up in the "All Groups" list
9 `/ j$ Q& p( p: V2 f!     in the Customize dialog.
0 `9 i" `6 X. v2 A5 s1 h!
, t. `9 l2 V& I: ~" `!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
6 O. s! X8 ?2 s5 ~!

TITLE Group
, s& ~1 H: |1 Z' b: d) p6 Q0 F9 \VERSION 170
3 \8 G) F1 ~% P
' a" \7 M! B# M  E!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
, c/ d. e- C8 u1 V& ?) o  S  iRIBBON_STYLE LARGE_IMAGE

!  Example of a gallery defined in a GRB file.
!
" S. C& s3 Z2 [. S" i* Z1 k!  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 \1 }7 y+ y+ ~4 B4 K/ i!  Example:
" {: `. c! [, V8 }: Q0 ^/ a!    GALLERY customer_gallery.gly
!
4 }3 n1 t, `& h# bBEGIN_GALLERY  CUSTOMER_GALLERY
COLUMN_IN_RIBBON 2
COLUMN_IN_POPUP 2
& X1 q1 n8 v4 f% x. uLABEL Gallery
  s( y2 y" H4 T; H/ F* ?  gGALLERY_STYLE MEDIUM_IMAGE_AND_TEXT

    BUTTON CUSTOMER_BUTTON_2
, r0 C% K" \! s( s& l
2 T/ ]! v% E$ C8 n    BUTTON CUSTOMER_BUTTON_3

1 G0 m2 _% p( y% b, D* K# m! a    BUTTON CUSTOMER_BUTTON_4
' a3 w  p* e: N9 L5 K& Y
+ @6 e2 X# S1 ~5 n% _    BUTTON CUSTOMER_BUTTON_5

; w8 \7 Z0 V$ V/ I- q+ h" K, D7 xEND_GALLERY


2 k* k8 A" D6 b1 e- B* y, O