Technical Standard Motif Toolkit API NICAL H S C T A E N T D A R D [This page intentionally left blank] X/Open CAE Specificaton Motif Toolkit API X/Open Company Ltd. March 1995, X/Open Company Limited All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior permission of the copyright owners. Portions of this document include text excerpted and/or derived from material licensed to X/Open by Open Software Foundation, Inc. ( 1994, Open Software Foundation, Inc.) X/Open CAE Specificaton Motif Toolkit API ISBN: 1-85912-024-5 X/Open Document Number: C320 Published by X/Open Company Ltd., U.K. Any comments relating to the material contained in this document may be submitted to X/Open at: X/Open Company Limited Apex Plaza Forbury Road Reading Berkshire, RG1 1AX United Kingdom or by Electronic Mail to: [email protected] ii X/Open CAE Specificaton Contents Chapter 1 Introduction............................................................................................... 1 1.1 Conformance ............................................................................................... 1 1.2 Terminology................................................................................................. 2 1.3 Relationship to Formal Standards........................................................... 3 1.4 Format of Entries......................................................................................... 3 Chapter 2 X/Open Motif Overview.................................................................... 5 2.1 Service Outline ............................................................................................ 5 2.2 Overview of Services by Type and Function ........................................ 14 2.2.1 Window Manager.................................................................................... 14 2.2.2 Widgets and Widget Functions ............................................................ 14 2.2.3 Toolkit Functions and Data Types........................................................ 20 2.2.4 User Interface Language......................................................................... 22 2.3 X/Open Motif Name Space...................................................................... 23 2.3.1 Header Files .............................................................................................. 23 2.3.2 Resource Name Format .......................................................................... 23 Chapter 3 X/Open Motif Commands................................................................. 27 mwm.................................................................................................................. 28 Chapter 4 Data Types.................................................................................................. 59 4.1 X11 Data Types............................................................................................ 59 4.2 XmFontList................................................................................................... 60 4.3 XmString....................................................................................................... 61 4.4 XmStringDirection...................................................................................... 62 4.5 XmStringTable ............................................................................................. 62 4.6 XmTextPosition............................................................................................ 62 Chapter 5 X/Open Motif Interfaces.................................................................... 63 ApplicationShell ............................................................................................... 64 Composite.......................................................................................................... 67 Constraint ......................................................................................................... 69 Core.................................................................................................................... 71 MrmCloseHierarchy( )..................................................................................... 74 MrmFetchBitmapLiteral( )............................................................................... 75 MrmFetchColorLiteral ( ) ................................................................................. 77 MrmFetchIconLiteral( ).................................................................................... 78 MrmFetchLiteral( )........................................................................................... 80 MrmFetchSetValues( ) ..................................................................................... 81 MrmFetchWidget( ).......................................................................................... 83 MrmFetchWidgetOverride( )........................................................................... 85 MrmInitialize( )................................................................................................ 87 Motif Toolkit API iii Contents MrmOpenHierarchyPerDisplay( ).................................................................. 88 MrmRegisterClass( ) ........................................................................................ 91 MrmRegisterNames( )...................................................................................... 92 MrmRegisterNamesInHierarchy( )................................................................. 94 Object................................................................................................................. 96 OverrideShell .................................................................................................... 97 RectObj.............................................................................................................. 99 Shell ................................................................................................................... 101 TopLevelShell .................................................................................................... 104 TransientShell ................................................................................................... 107 Uil( ) .................................................................................................................. 110 VendorShell....................................................................................................... 114 WMShell ........................................................................................................... 119 XmActivateProtocol( ) ..................................................................................... 124 XmActivateWMProtocol( ).............................................................................. 125 XmAddProtocolCallback ( ).............................................................................. 126 XmAddProtocols( )........................................................................................... 127 XmAddTabGroup( ) ......................................................................................... 128 XmAddWMProtocolCallback ( ) ...................................................................... 129 XmAddWMProtocols( )................................................................................... 130 XmArrowButton .............................................................................................. 131 XmArrowButtonGadget .................................................................................. 135 XmBulletinBoard.............................................................................................. 138 XmCascadeButton............................................................................................ 144 XmCascadeButtonGadget................................................................................ 149 XmCascadeButtonHighlight( )........................................................................ 153 XmChangeColor( ) ........................................................................................... 154 XmClipboardCancelCopy ( ) ............................................................................ 155 XmClipboardCopy( )........................................................................................ 156 XmClipboardCopyByName( ) ......................................................................... 158 XmClipboardEndCopy( ) ................................................................................. 159 XmClipboardEndRetrieve( ) ............................................................................ 160 XmClipboardInquireCount( ).......................................................................... 161 XmClipboardInquireFormat( ) ........................................................................ 162 XmClipboardInquireLength( )......................................................................... 164 XmClipboardInquirePendingItems( ) ............................................................. 165 XmClipboardLock( ) ......................................................................................... 166 XmClipboardRegisterFormat( )....................................................................... 167 XmClipboardRetrieve( )................................................................................... 168 XmClipboardStartCopy