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

admin

关于NX二次开发，经典界面到RIbbon界面转换的菜单开发技巧
5 {7 N  Y, V6 D" z  B+ `, N' e

经典界面到RIbbon界面转换

  `6 s7 a2 V: R( g8 j6 H, a, b在经典界面下，需要的文件
6 J( Z& j5 W" i' S3 q$ c

• customer_men.men
• customer_toolbar.tbr
  

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

• customer_men.men
• customer_tab.rtb
• customer_toolbar.tbr
• customer_toolbar_alternate.tbr
• customer_group.grb
  
  1 J0 s5 e& B& d

4 ^( P, l2 d0 J& @8 c
- }1 ^4 x: M. f8 ]( Q5 Y: A: K举例如下：

0 T( b# O/ v( i, M% u3 N
customer_men.men
$ t% [9 |9 g0 \, k!
6 i$ Y2 V- b  a- a- M, L8 w7 p!  Customer menu file
% N% q( [+ V* q!
/ Q( m% W: t. [7 g( s7 l!  Contains button definitions to be used in
% n9 k' A) h1 ]  D" a1 Z1 Y!  toolbars and Ribbon files
7 }6 I: N0 \' S2 o!

) R( P& ?! ]7 f# r& bVERSION 120
% d7 l7 N" R4 ]" P3 ~/ @0 i
EDIT UG_GATEWAY_MAIN_MENUBAR
6 H, J5 H$ k; F7 T
) \# n$ I4 C" D6 ^* C$ b  BTOP_MENU
  @! N; W9 E' C- a+ [: g, z5 R: ]    CASCADE_BUTTON CUSTOMER_MENU
    LABEL Customer Menu
4 z9 I. O! d* r) e. ?
1 K& i$ s- Q, ^4 X. f! eEND_OF_TOP_MENU
, P5 e5 y+ h& s7 h7 H5 u/ y
MENU CUSTOMER_MENU
0 ]1 W* C& |4 U) n
+ q# b, S1 V8 T7 _, W    BUTTON CUSTOMER_BUTTON_1
    LABEL Menu Button1
        RIBBON_LABEL Ribbon Button1
4 c" i' J+ ~- S( X( f! W        TOOLBAR_LABEL Toolbar Button1
: \2 C9 Y3 h6 ^6 B* }    BITMAP fileopen
% R: Z+ l& M/ P) |* \# D' O
2 p. B4 d  ]" `+ s: u    BUTTON CUSTOMER_BUTTON_2
    LABEL Menu Button2
        RIBBON_LABEL Ribbon Button2
        TOOLBAR_LABEL Toolbar Button2
  J3 d5 B3 B. [2 s' `    BITMAP filesave
7 ~% H9 m/ |; _/ L5 F6 a# a5 o
3 F/ Q# f5 P  Y/ ^/ ?3 t5 F    BUTTON CUSTOMER_BUTTON_3
    LABEL Menu Button3
6 C! W0 S) [! m& z( }4 P        RIBBON_LABEL Ribbon Button3
        TOOLBAR_LABEL Toolbar Button3
' I! R4 E) R% g; s8 M' l3 ?+ m" m    BITMAP current_feature

    BUTTON CUSTOMER_BUTTON_4
. {6 a( G& k7 l" W    LABEL Menu Button4
& h( a- n4 V" T        RIBBON_LABEL Ribbon Button4
        TOOLBAR_LABEL Toolbar Button4
. Y. u! r% O5 I    BITMAP block
- _( Y; R- I/ M6 Q/ h* [5 c5 V7 i; f
" q* v' f+ [+ K4 _, v0 S    BUTTON CUSTOMER_BUTTON_5
    LABEL Menu Button5
6 @" P$ w9 p6 M0 p        RIBBON_LABEL Ribbon Button5
8 v) M  B4 D7 I7 F) S* p        TOOLBAR_LABEL Toolbar Button5
& R. P+ M& v: \' T$ c% P  x    BITMAP checkgreen

END_OF_MENU
# ~( Z) \! U3 _5 z
6 W: v# ~: {* w$ v+ m. x5 @0 V

customer_ribbon_tab.rtb
!
!  Customer Ribbon Tab
!
!  This file will create a new customer tab containing three groups and
! a6 n9 C$ O! L! N  ?!  one top level button.
!
8 N" N" l; r& J7 q: n
TITLE  Customer Tab
- x, U. q( R& u% b; tVERSION 170

* }, Z" M) m, k' w) W5 X!  The first group represents a Ribbon group that references an existing
!  toolbar with no Ribbon style changes.  
* n% x- M% b( O0 ~!
7 m5 `( L: n( _0 s; y0 y/ H+ a/ i0 k: \!  This is the quickest way to add existing toolbar content into Ribbon mode.
6 z! S& n# ~3 I/ x. s!
GROUP  customer_toolbar.tbr

!  The second group represents a Ribbon group that references an existing
9 N; x: b: v, @+ H9 `) d3 y1 E; H!  toolbar with Ribbon specific style changes added to it.  There is no difference
/ {3 G+ }3 ]# Y. \!  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.
!
9 h( s2 f: ^) f& l; I!  This approach has advantages for customers that will deploy both Ribbon and
!  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
!  will need to be maintained while still making use of RIBBON_STYLE to
  \" |- o6 O3 d7 m# o  w9 s!  control the presentation of the buttons on the Ribbon.
0 k- l  w8 X; L, u( F1 d& b; O!
/ Q$ Z, D) y' y8 iGROUP  customer_toolbar_alternate.tbr
: {: M& Q' _0 M7 Y/ d
% L6 r/ S6 K8 Y!  The third group represents a Ribbon group that has been created explicitly
, l% O% a& G3 i& P- F0 G!  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.  
. U4 V0 v& _0 J7 O  ?# C2 q% R+ P; ]2 q!
!  For customers that will deploy both Ribbon and Classic Mode customizations,
: D1 v" D1 c! i!  this approach will result in no synchronization and two sets of customizations
. t3 P( O  T! |! V0 T# l3 Q!  will need to be maintained.
!
!  A group can alternatively be defined directly inside the .rtb file by using the
!  keywords BEGIN_GROUP and END_GROUP.  
!
, y" _' Y0 H6 n8 D7 H2 _GROUP  customer_group.grb
- j, C; l. ~3 y# w$ y0 h
( a, O7 W7 l5 L8 D" L) L, s!  Example of a button that is placed directly on the Ribbon without being
* `9 W0 W. s: s) T3 ?7 `. [!  contained in a group.  This is a simple way to add a button to a tab
0 E% C' M4 L% U' N!  but is not recommended for many buttons since groups have advantages.
!  
/ X# t( K! x. ^9 O' v# D" \!  A few advantages of groups:
: O4 C, t) [  X( v' v!     1. Easier to move many buttons around together in quick customization.  
% K1 b( Q5 k- H!        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.
4 P. S0 E2 [( I+ O!
& o4 T( k7 a5 L# c!     2. Provide a label to describe its contents.
!
BUTTON CUSTOMER_BUTTON_1
LABEL Button1 Directly on Tab



9 q0 F- q/ \; H2 bcustomer_toolbar.tbr
* B7 c+ I9 O' ]! D!
!  Customer Toolbar File
6 B5 g# e0 H9 h6 E' W!
!  This is similar to an existing toolbar file containing
2 L% t( B6 B4 X  J! x/ ?0 {1 s!  no Ribbon changes.
  H& a6 N. Y! a( n; N!
/ a, p- x/ K/ R1 Z!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
9 C' A. Y$ ?% g- s: ~9 u!
!  In Ribbon mode - This toolbar will be automatically converted to a
!     Ribbon group and will appear in the "Classic Toolbars as Groups"
+ D0 O3 q# p% S  {$ z6 L1 S!     section in the Customize dialog.
!  

TITLE Toolbar
5 a' P5 ~2 L' ^- {VERSION 170

BUTTON CUSTOMER_BUTTON_1
3 T1 M: K% Q( s, [6 a4 [- O( l
BUTTON CUSTOMER_BUTTON_2

0 l! X. G. \/ L  H% ^1 aBUTTON CUSTOMER_BUTTON_3

( r0 N1 d* [- {6 y0 ^9 jBUTTON CUSTOMER_BUTTON_4
7 E5 \" d% v$ @9 r$ i8 _7 A1 i. U
3 G4 U( R. Z% nBUTTON CUSTOMER_BUTTON_5
: H( q5 w8 C) L" m9 x6 n


4 I3 Q2 b4 [2 Z! Q. u# a' \customer_toolbar_alternate.tbr
!
!  Customer Toolbar File (Alternate)
/ [$ K: W% L& r4 I7 M$ ]" J" V, f. j!
( K. P) h7 P6 B1 f; F!  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.
& o. ~$ \- X0 ^7 {( o!
  b* g" ?: y3 Z# x% c0 A!  In Classic Toolbars mode - This toolbar will still show up in the
!     toolbars list.
0 @( n2 t$ {' [" G9 I( J: E!
3 i' {1 X1 r, Z!  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.
!

# u; E" C- G) D1 g4 [TITLE Toolbar (Alternate)
9 \, \1 X, m5 q' C4 sVERSION 170

BUTTON CUSTOMER_BUTTON_1
* r; T$ g4 s' LLABEL Toolbar(Alt) Button1
/ P2 t" T4 ?( B, }RIBBON_STYLE LARGE_IMAGE

2 p3 a6 h1 G" s' Z# IBUTTON CUSTOMER_BUTTON_2
8 N' K" a! E6 N! W1 ]9 g* LLABEL Toolbar(Alt) Button2
RIBBON_STYLE LARGE_IMAGE
/ u% p; j' ^( R# Y5 \4 |" y
BUTTON CUSTOMER_BUTTON_3
LABEL Toolbar(Alt) Button3
RIBBON_STYLE SMALL_IMAGE_AND_TEXT

) C  L# \! w( b3 qBUTTON CUSTOMER_BUTTON_4
LABEL Toolbar(Alt) Button4
RIBBON_STYLE SMALL_IMAGE_AND_TEXT
. K! Y( s( H' D
  _; H: Z4 `0 {! Z, n  w+ [2 B! eBUTTON CUSTOMER_BUTTON_5
, `0 y- r6 S" e+ u$ jLABEL Toolbar(Alt) Button5
RIBBON_STYLE SMALL_IMAGE_AND_TEXT



customer_group.grb
, _6 Y) S) G4 l0 h+ ], ]!
!  Customer Ribbon Group File
!
4 S  w# j. w, C# J!  In Classic Toolbars mode - This group will be unavailable
!
1 y7 x" i6 V: ?$ \# \!  In Ribbon mode - This group will show up in the "All Groups" list
. s, X4 l/ e2 L!     in the Customize dialog.
* I& X5 b  O  A/ Z7 y1 i) j!
!  The labels of the buttons are defined using the RIBBON_LABEL token in the MEN files
/ B; [" v! F9 H6 j3 e!

, l+ b' E. h0 I  `  ^# aTITLE Group
: z  D/ p- n3 s9 a/ e' XVERSION 170
$ u; w- T& c; H( O; x
!  No LABEL defined, using RIBBON_LABEL defined in customer_men.men
BUTTON CUSTOMER_BUTTON_1
0 A1 J. R0 k! |2 g8 t1 M; |RIBBON_STYLE LARGE_IMAGE
' h" y* l1 k! r+ H/ M9 V) k7 t
!  Example of a gallery defined in a GRB file.
!
1 ?' f3 J0 \) r7 q1 K7 v!  If this gallery is to be used in other places, then it could be
0 f, e# e) e' Z9 l6 U" ?!  defined in its own gallery (GLY) file and referenced here
!  Example:
9 \0 H2 k& m) \  [1 B% f!    GALLERY customer_gallery.gly
) k" F3 A/ b9 _, C9 a# l!
BEGIN_GALLERY  CUSTOMER_GALLERY
COLUMN_IN_RIBBON 2
! Q) U1 a. A# W6 ^5 nCOLUMN_IN_POPUP 2
% d, w4 t* w6 s( L7 A7 kLABEL Gallery
GALLERY_STYLE MEDIUM_IMAGE_AND_TEXT
2 S, h4 B) M" _  b  Q7 R0 ]
    BUTTON CUSTOMER_BUTTON_2
; L/ T+ G8 B/ I1 w
    BUTTON CUSTOMER_BUTTON_3

6 _7 E% F# |5 v' |2 o    BUTTON CUSTOMER_BUTTON_4

: u( o1 K0 R/ E4 Q( H    BUTTON CUSTOMER_BUTTON_5
! Q' w2 |- P) f. p6 U; \
END_GALLERY
: x1 J$ {, q( V