Technical Standard X/Open Common Desktop Environment (XCDE) Services and Applications NICAL H S C T A E N T D A R D [This page intentionally left blank] X/Open CAE Specification X/Open Common Desktop Environment (XCDE) Services and Applications 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. X/Open CAE Specification X/Open Common Desktop Environment (XCDE) Services and Applications ISBN: 1-85912-074-1 X/Open Document Number: C323 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 Specification Contents Chapter 1 Window Management Services..................................................... 1 1.1 Introduction ................................................................................................. 1 1.2 Data Formats................................................................................................ 2 Chapter 2 Workspace Management Services ............................................... 3 2.1 Introduction ................................................................................................. 3 2.2 Functions ...................................................................................................... 3 DtWsmAddCurrentWorkspaceCallback ( ) ..................................................... 4 DtWsmAddWorkspaceFunctions( )................................................................. 5 DtWsmAddWorkspaceModifiedCallback( ).................................................... 6 DtWsmFreeWorkspaceInfo( )........................................................................... 8 DtWsmGetCurrentBackdropWindow( ) ......................................................... 9 DtWsmGetCurrentWorkspace( ) ..................................................................... 10 DtWsmGetWorkspaceInfo( )............................................................................ 11 DtWsmGetWorkspaceList( ) ............................................................................ 13 DtWsmGetWorkspacesOccupied( ) ................................................................. 14 DtWsmOccupyAllWorkspaces( )..................................................................... 15 DtWsmRemoveWorkspaceCallback ( ) ............................................................. 16 DtWsmRemoveWorkspaceFunctions( )........................................................... 17 DtWsmSetCurrentWorkspace( )...................................................................... 18 DtWsmSetWorkspacesOccupied( ).................................................................. 19 2.3 Headers......................................................................................................... 20 <Dt/Wsm.h> ................................................................................................... 21 Chapter 3 Session Management Services....................................................... 23 3.1 Introduction ................................................................................................. 23 3.2 Functions ...................................................................................................... 23 DtSaverGetWindows( ).................................................................................... 24 DtSessionRestorePath( ) .................................................................................. 25 DtSessionSavePath( )....................................................................................... 26 3.3 Headers......................................................................................................... 27 <Dt/Saver.h> .................................................................................................. 28 <Dt/Session.h> .............................................................................................. 29 3.4 Actions .......................................................................................................... 30 <dtsessionaction> ......................................................................................... 31 3.5 Capabilities................................................................................................... 32 Chapter 4 Help Services............................................................................................ 33 4.1 Introduction ................................................................................................. 33 4.2 Widgets ......................................................................................................... 33 DtHelpDialog( )................................................................................................ 34 DtHelpQuickDialog( ) ..................................................................................... 42 X/Open Common Desktop Environment (XCDE) Services and Applications iii Contents 4.3 Functions ...................................................................................................... 51 DtCreateHelpDialog( )..................................................................................... 52 DtCreateHelpQuickDialog( ) .......................................................................... 53 DtHelpQuickDialogGetChild ( )...................................................................... 54 DtHelpReturnSelectedWidgetId( ).................................................................. 55 DtHelpSetCatalogName( )............................................................................... 56 4.4 Headers......................................................................................................... 57 <Dt/Help.h> ................................................................................................... 58 <Dt/HelpDialog.h> ...................................................................................... 60 <Dt/HelpQuickD.h>.................................................................................... 61 4.5 Actions .......................................................................................................... 62 <dtmanaction>............................................................................................... 63 <dthelpaction>............................................................................................... 64 4.6 Formats ......................................................................................................... 65 4.7 Capabilities................................................................................................... 72 4.7.1 Presentation in the Quick Help Window............................................ 72 4.7.2 Navigation in the Quick Help Window.............................................. 72 4.7.3 Presentation for the General Help Window....................................... 72 4.7.4 Navigation for the General Help Window......................................... 73 Chapter 5 Calendar and Appointment Services ......................................... 75 5.1 Introduction ................................................................................................. 75 5.2 Functions ...................................................................................................... 75 csa_x_process_updates( ) ................................................................................. 76 5.3 Headers......................................................................................................... 77 5.4 Command-Line Interfaces ........................................................................ 77 dtcm_admin ...................................................................................................... 78 dtcm_delete ....................................................................................................... 81 dtcm_insert ....................................................................................................... 83 dtcm_lookup ..................................................................................................... 86 5.5 Actions .......................................................................................................... 88 <dtcalendaraction>....................................................................................... 89 5.6 Messages....................................................................................................... 90 5.7 Formats ......................................................................................................... 90 5.7.1 Calendar Archive File Format............................................................... 90 5.7.1.1 Attribute Definition.............................................................................. 91 5.7.1.2 Long Values............................................................................................ 92 5.7.2 Calendar Entry Format ........................................................................... 92 5.8 Capabilities................................................................................................... 94 5.8.1 Calendar Main Window......................................................................... 94 5.8.2 Options/Properties