/* * Motif * * Copyright (c) 1987-2012, The Open Group. All rights reserved. * * These libraries and programs are free software; you can * redistribute them and/or modify them under the terms of the GNU * Lesser General Public License as published by the Free Software * Foundation; either version 2 of the License, or (at your option) * any later version. * * These libraries and programs are distributed in the hope that * they will be useful, but WITHOUT ANY WARRANTY; without even the * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See the GNU Lesser General Public License for more * details. * * You should have received a copy of the GNU Lesser General Public * License along with these librararies and programs; if not, write * to the Free Software Foundation, Inc., 51 Franklin Street, Fifth * Floor, Boston, MA 02110-1301 USA */ /* * HISTORY */ #ifdef HAVE_CONFIG_H #include #endif #ifdef REV_INFO #ifndef lint static char rcsid[] = "$XConsortium: Mrmwread.c /main/11 1996/11/13 14:07:06 drk $" #endif #endif /* (c) Copyright 1989, 1990, DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. */ /* *++ * FACILITY: * * UIL Resource Manager (URM): * * ABSTRACT: * * This module contains the widget read routines. All these routines * read a widget from a hierarchy or IDB file into a resource context. * *-- */ /* * * INCLUDE FILES * */ #include #include #include "MrmMsgI.h" /* * * TABLE OF CONTENTS * * UrmHGetWidget Read indexed widget from hierarchy * * UrmGetIndexedWidget Read indexed widget from IDB file * * UrmGetRIDWidget Read RID widget from IDB file * */ /* *++ * * PROCEDURE DESCRIPTION: * * UrmHGetWidget searches the database hierarchy for a public * (EXPORTed) widget given its index. It returns the RGM widget record * in a resource context. * * FORMAL PARAMETERS: * * hierarchy_id id of an open URM database hierarchy * index index of the desired widget * context_id widget context in which to return record read in * file_id_return to return IDB file in which widget was found * * IMPLICIT INPUTS: * * IMPLICIT OUTPUTS: * * FUNCTION VALUE: * * MrmSUCCESS operation succeeded * MrmNOT_FOUND widget not found * MrmBAD_HIERARCHY invalid URM file hierarchy * MrmBAD_WIDGET_REC invalid widget record in context * Others see UrmGetIndexedWidget * * SIDE EFFECTS: * *-- */ Cardinal UrmHGetWidget (MrmHierarchy hierarchy_id, String index, URMResourceContextPtr context_id, IDBFile *file_id_return) { /* * Local variables */ Cardinal result ; /* function results */ RGMWidgetRecordPtr widgetrec ; /* widget record in context */ /* * Get the widget */ result = UrmHGetIndexedResource (hierarchy_id, index, URMgWidget, URMtNul, context_id, file_id_return) ; if ( result != MrmSUCCESS ) return result ; /* * Validate the widget record in the context */ widgetrec = (RGMWidgetRecordPtr) UrmRCBuffer (context_id) ; if ( UrmWRValid(widgetrec) ) return MrmSUCCESS ; else { if ( (*file_id_return)->byte_swapped ) swapbytes(widgetrec->validation); if ( UrmWRValid(widgetrec) ) { Urm__SwapRGMWidgetRecord(widgetrec); return MrmSUCCESS ; } } return Urm__UT_Error("UrmHGetIndexedWidget", _MrmMMsg_0026, NULL, context_id, MrmBAD_WIDGET_REC) ; } /* *++ * * PROCEDURE DESCRIPTION: * * UrmGetIndexedWidget searches a single database file for a widget * given its index (i.e. it gets a public widget from a single file). * It returns the RGM widget record. * * FORMAL PARAMETERS: * * file_id id of an open URM database file (IDB file) * index index of the desired widget * context_id widget context in which to return record read in * * IMPLICIT INPUTS: * * IMPLICIT OUTPUTS: * * FUNCTION VALUE: * * MrmSUCCESS operation succeeded * MrmBAD_CONTEXT invalid resource context * Other See UrmIdbGetIndexedResource * * SIDE EFFECTS: * *-- */ Cardinal UrmGetIndexedWidget (IDBFile file_id, String index, URMResourceContextPtr context_id) { /* * Local variables */ Cardinal result ; /* function results */ RGMWidgetRecordPtr widgetrec ; /* widget record in context */ /* * Validate context, then attempt the read. */ if ( ! UrmRCValid(context_id) ) return Urm__UT_Error ("UrmGetIndexedWidget", _MrmMMsg_0043, file_id, NULL, MrmBAD_CONTEXT) ; result = UrmIdbGetIndexedResource (file_id, index, URMgWidget, URMtNul, context_id) ; if ( result != MrmSUCCESS ) return result ; /* * Validate the widget record in the context */ widgetrec = (RGMWidgetRecordPtr) UrmRCBuffer (context_id) ; if ( UrmWRValid(widgetrec) ) return MrmSUCCESS ; else { if ( file_id->byte_swapped ) swapbytes(widgetrec->validation); if ( UrmWRValid(widgetrec) ) { Urm__SwapRGMWidgetRecord(widgetrec); return MrmSUCCESS ; } } return Urm__UT_Error("UrmGetIndexedWidget", _MrmMMsg_0026, NULL, context_id, MrmBAD_WIDGET_REC) ; } /* *++ * * PROCEDURE DESCRIPTION: * * UrmGetRIDWidget retrieves a widget from a single database file * given its resource id as an accessor. It returns the widget record. * * FORMAL PARAMETERS: * * file_id id of an open URM database file (IDB file) * resource_id resource id for widget * context_id widget context in which to return record read in * * IMPLICIT INPUTS: * * IMPLICIT OUTPUTS: * * FUNCTION VALUE: * * MrmSUCCESS operation succeeded * MrmNOT_FOUND widget not found * MrmFAILURE operation failed, further reason not given. * * SIDE EFFECTS: * *-- */ Cardinal UrmGetRIDWidget (IDBFile file_id, MrmResource_id resource_id, URMResourceContextPtr context_id) { /* * Local variables */ Cardinal result ; /* function results */ RGMWidgetRecordPtr widgetrec ; /* widget record in context */ /* * Validate context, then attempt the read. */ if ( ! UrmRCValid(context_id) ) return Urm__UT_Error ("UrmGetRIDWidget", _MrmMMsg_0043, file_id, NULL, MrmBAD_CONTEXT) ; result = UrmIdbGetRIDResource (file_id, resource_id, URMgWidget, URMgNul, context_id) ; if ( result != MrmSUCCESS ) return result ; /* * Validate the widget record in the context */ widgetrec = (RGMWidgetRecordPtr) UrmRCBuffer (context_id) ; if ( UrmWRValid(widgetrec) ) return MrmSUCCESS ; else { if ( file_id->byte_swapped ) swapbytes(widgetrec->validation); if ( UrmWRValid(widgetrec) ) { Urm__SwapRGMWidgetRecord(widgetrec); return MrmSUCCESS ; } } return Urm__UT_Error("UrmGetRIDWidget", _MrmMMsg_0026, NULL, context_id, MrmBAD_WIDGET_REC) ; }