3660 lines
121 KiB
C
3660 lines
121 KiB
C
/*
|
||
* CDE - Common Desktop Environment
|
||
*
|
||
* Copyright (c) 1993-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
|
||
*/
|
||
/* $XConsortium: HelpDialog.c /main/16 1996/11/22 12:24:49 cde-hp $ */
|
||
/************************************<+>*************************************
|
||
****************************************************************************
|
||
**
|
||
** File: HelpDialog.c
|
||
**
|
||
** Project: Cde Help 1.0 Project
|
||
**
|
||
** Description:
|
||
**
|
||
** (c) Copyright 1987, 1988, 1989, 1990, 1991, 1992 Hewlett-Packard Company
|
||
**
|
||
** (c) Copyright 1993, 1994 Hewlett-Packard Company
|
||
** (c) Copyright 1993, 1994 International Business Machines Corp.
|
||
** (c) Copyright 1993, 1994 Sun Microsystems, Inc.
|
||
** (c) Copyright 1993, 1994 Novell, Inc.
|
||
**
|
||
****************************************************************************
|
||
************************************<+>*************************************/
|
||
|
||
#include <stdio.h>
|
||
#include <signal.h>
|
||
#include <unistd.h> /* R_OK */
|
||
|
||
#include <X11/Intrinsic.h>
|
||
#include <X11/Shell.h>
|
||
#include <X11/Xatom.h>
|
||
|
||
/* These includes work in R4 and R5 */
|
||
#include <Xm/MwmUtil.h>
|
||
#include <Xm/Protocols.h>
|
||
#include <Xm/RepType.h>
|
||
#include <Xm/XmP.h>
|
||
#include <Xm/ScrolledW.h>
|
||
#include <Xm/DialogS.h>
|
||
#include <Xm/PanedW.h>
|
||
#include <Xm/List.h>
|
||
#include <Xm/RowColumnP.h>
|
||
#include <Xm/LabelG.h>
|
||
#include <Xm/Label.h>
|
||
#include <Xm/PushB.h>
|
||
#include <Xm/PushBG.h>
|
||
#include <Xm/SeparatoG.h>
|
||
#include <Xm/CascadeB.h>
|
||
#include <Xm/CascadeBG.h>
|
||
|
||
/* Copied from Xm/GeoUtilsI.h */
|
||
extern XmGeoMatrix _XmGeoMatrixAlloc(
|
||
unsigned int numRows,
|
||
unsigned int numBoxes,
|
||
unsigned int extSize) ;
|
||
|
||
/* Canvas Engine */
|
||
#include "CanvasP.h" /* for AccessI.h */
|
||
|
||
/* Help Dialog Widget Includes */
|
||
#include "Access.h"
|
||
#include "bufioI.h"
|
||
#include "AccessI.h"
|
||
#include "ActionsI.h"
|
||
#include "DisplayAreaI.h"
|
||
|
||
#include <Dt/Help.h>
|
||
#include "HelpI.h"
|
||
#include "HelpP.h"
|
||
#include "StringFuncsI.h"
|
||
#include "HelposI.h"
|
||
#include "HelpDialog.h"
|
||
#include "HelpDialogI.h"
|
||
#include "HelpDialogP.h"
|
||
#include "HistoryI.h"
|
||
#include "HelpUtilI.h"
|
||
#include "PathAreaI.h"
|
||
#include "HelpAccessI.h"
|
||
#include "HourGlassI.h"
|
||
#include "HyperTextI.h"
|
||
#include "FileUtilsI.h"
|
||
#include "Lock.h"
|
||
|
||
/* search dialogs */
|
||
#include "GlobSearchI.h"
|
||
|
||
/* print dialogs */
|
||
#include "PrintI.h"
|
||
|
||
/* Error Messages Includes */
|
||
#include "MessagesP.h"
|
||
|
||
/* Quick Help Widget Inlcudes */
|
||
#include "HelpQuickD.h"
|
||
|
||
/* Display Area Includes */
|
||
#include "XUICreateI.h"
|
||
#include "CallbacksI.h"
|
||
#include "DestroyI.h"
|
||
#include "FormatI.h"
|
||
#include "FormatManI.h"
|
||
#include "SetListI.h"
|
||
#include "ResizeI.h"
|
||
|
||
|
||
/*********** Global Variables **********/
|
||
|
||
/******** Messages *********/
|
||
/* Help Dialog Error message Defines */
|
||
|
||
#define HDMessage0 _DtHelpMsg_0000
|
||
#define HDMessage1 _DtHelpMsg_0001
|
||
#define HDMessage2 _DtHelpMsg_0002
|
||
#define HDMessage3 _DtHelpMsg_0003
|
||
#define HDMessage4 _DtHelpMsg_0004
|
||
#define HDMessage5 _DtHelpMsg_0005
|
||
#define HDMessage6 _DtHelpMsg_0006
|
||
#define HDMessage7 _DtHelpMsg_0007
|
||
#define HDMessage8 _DtHelpMsg_0008
|
||
#define HDMessage9 _DtHelpMsg_0009
|
||
|
||
|
||
/******** Static Function Declarations ********/
|
||
|
||
static void NavigationTypeDefault(
|
||
Widget widget,
|
||
int offset,
|
||
XrmValue *value) ;
|
||
|
||
static void ClassPartInitialize(
|
||
WidgetClass wc) ;
|
||
static void ClassInitialize(
|
||
void) ;
|
||
static void Initialize(
|
||
Widget rw,
|
||
Widget nw,
|
||
ArgList args,
|
||
Cardinal *num_args);
|
||
|
||
static void Destroy(
|
||
Widget w );
|
||
static Boolean SetValues(
|
||
Widget cw,
|
||
Widget rw,
|
||
Widget nw,
|
||
ArgList args,
|
||
Cardinal *num_args);
|
||
static void CloseHelpCB (
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XtPointer callData);
|
||
static void BuildDisplayArea(
|
||
Widget parent,
|
||
DtHelpDialogWidget nw);
|
||
static void ProcessJumpBack(
|
||
DtHelpDialogWidget nw);
|
||
static void VariableInitialize(
|
||
DtHelpDialogWidget nw);
|
||
static void CleanUpHelpDialog(
|
||
Widget nw,
|
||
int cleanUpKind);
|
||
static void CatchClose(Widget widget);
|
||
static void DisplayTopLevelCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data );
|
||
static void CopyTextCB(
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XtPointer callData );
|
||
static void DisplayPrintCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data );
|
||
static void ProcessBMenuBackCB(
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XButtonEvent * event,
|
||
Boolean *continueToDispatch);
|
||
static void ProcessJumpReuse(
|
||
Widget nw,
|
||
DtHelpHyperTextStruct *hyperData);
|
||
static Widget SetupHelpDialogMenus(
|
||
Widget parent);
|
||
static Widget CreatePopupMenu(
|
||
Widget parent);
|
||
static void ResizeHelpDialogCB (
|
||
XtPointer clientData);
|
||
static void InitialPopupCB(
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XtPointer callData);
|
||
|
||
|
||
/******** End Static Function Declarations ********/
|
||
|
||
|
||
|
||
/* Static variables */
|
||
|
||
/* Supported resources for the HelpDialog Widget */
|
||
|
||
static XtResource resources[] = {
|
||
|
||
{ DtNshowNewWindowButton,
|
||
DtCShowNewWindowButton,
|
||
XmRBoolean,
|
||
sizeof(Boolean),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.menu.showDupBtn),
|
||
XmRImmediate,
|
||
(XtPointer) False
|
||
},
|
||
|
||
{ DtNshowTopLevelButton,
|
||
DtCShowTopLevelButton,
|
||
XmRBoolean,
|
||
sizeof(Boolean),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.browser.showTopLevelBtn),
|
||
XmRImmediate,
|
||
(XtPointer) False
|
||
},
|
||
|
||
{
|
||
DtNscrollBarPolicy,
|
||
DtCScrollBarPolicy, DtRDtScrollBarPolicy, sizeof (unsigned char),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.scrollBarPolicy),
|
||
XmRImmediate, (XtPointer) DtHELP_AS_NEEDED_SCROLLBARS
|
||
},
|
||
|
||
{
|
||
DtNexecutionPolicy,
|
||
DtCExecutionPolicy, DtRDtExecutionPolicy, sizeof (unsigned char),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.executionPolicy),
|
||
XmRImmediate, (XtPointer) DtHELP_EXECUTE_QUERY_UNALIASED
|
||
},
|
||
|
||
{ DtNcolumns,
|
||
DtCColumns, XmRShort, sizeof(short),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.textColumns),
|
||
XmRImmediate, (XtPointer) 70
|
||
},
|
||
|
||
{ DtNrows,
|
||
DtCRows, XmRShort, sizeof(short),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.textRows),
|
||
XmRImmediate, (XtPointer) 25
|
||
},
|
||
|
||
{ DtNmarginWidth,
|
||
DtCMarginWidth, XmRHorizontalDimension, sizeof (Dimension),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.ghelp.marginWidth),
|
||
XmRImmediate, (XtPointer) 1
|
||
},
|
||
|
||
{ DtNmarginHeight,
|
||
DtCMarginHeight, XmRVerticalDimension, sizeof (Dimension),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.ghelp.marginHeight),
|
||
XmRImmediate, (XtPointer) 4
|
||
},
|
||
|
||
{ DtNvisiblePathCount,
|
||
DtCVisiblePathCount, XmRInt, sizeof(int),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.browser.visiblePathCount),
|
||
XmRImmediate, (XtPointer) 7
|
||
},
|
||
|
||
{ DtNlocationId,
|
||
DtCLocationId, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.locationId),
|
||
XmRImmediate, (XtPointer) _DtHelpDefaultLocationId
|
||
},
|
||
|
||
{ DtNhelpPrint,
|
||
DtCHelpPrint, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.print.helpPrint),
|
||
XmRImmediate, (XtPointer) _DtHelpDefaultHelpPrint
|
||
},
|
||
|
||
{ DtNprinter,
|
||
DtCPrinter, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.print.printer),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ DtNpaperSize,
|
||
DtCPaperSize, DtRDtPaperSize, sizeof (unsigned char),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.print.paperSize),
|
||
XmRImmediate, (XtPointer) DtHELP_PAPERSIZE_LETTER
|
||
},
|
||
|
||
{ DtNsrchHitPrefixFont,
|
||
DtCSrchHitPrefixFont, XmRString, sizeof (char *),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.srch.hitPrefixFont),
|
||
XmRImmediate, (XtPointer) _DtHelpDefaultSrchHitPrefixFont
|
||
},
|
||
|
||
{ DtNhelpVolume,
|
||
DtCHelpVolume, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.helpVolume),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ DtNmanPage,
|
||
DtCManPage, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.manPage),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ DtNstringData,
|
||
DtCStringData, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.stringData),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ DtNhelpFile,
|
||
DtCHelpFile, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.helpFile),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ DtNtopicTitle,
|
||
DtCTopicTitle, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.topicTitleStr),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ DtNhelpOnHelpVolume,
|
||
DtCHelpOnHelpVolume, XmRString, sizeof (char*),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.help.helpOnHelpVolume),
|
||
XmRImmediate, (XtPointer) _DtHelpDefaultHelp4HelpVolume
|
||
},
|
||
|
||
{ DtNhelpType,
|
||
DtCHelpType, DtRDtHelpType, sizeof(unsigned char),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.helpType),
|
||
XmRImmediate, (XtPointer) DtHELP_TYPE_TOPIC
|
||
},
|
||
|
||
{ DtNhyperLinkCallback,
|
||
DtCHyperLinkCallback, XmRCallback, sizeof (XtCallbackList),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.display.hyperLinkCallback),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ DtNcloseCallback,
|
||
DtCCloseCallback, XmRCallback, sizeof (XtCallbackList),
|
||
XtOffset (DtHelpDialogWidget, help_dialog.ghelp.closeCallback),
|
||
XmRImmediate, (XtPointer) NULL
|
||
},
|
||
|
||
{ XmNnavigationType, XmCNavigationType, XmRNavigationType,
|
||
sizeof(unsigned char),
|
||
XtOffsetOf (XmManagerRec, manager.navigation_type),
|
||
XmRCallProc, (XtPointer) NavigationTypeDefault
|
||
},
|
||
|
||
};
|
||
|
||
/*
|
||
* attach the action list to the widget. Then it does not
|
||
* matter which Xt[App]Initialize an application does.
|
||
*/
|
||
static XtActionsRec DrawnBActions[] =
|
||
{
|
||
{"DeSelectAll" , _DtHelpDeSelectAll },
|
||
{"SelectAll" , _DtHelpSelectAll },
|
||
{"ActivateLink" , _DtHelpActivateLink },
|
||
{"CopyToClipboard", _DtHelpCopyAction },
|
||
{"PageUpOrDown" , _DtHelpPageUpOrDown },
|
||
{"PageLeftOrRight", _DtHelpPageLeftOrRight},
|
||
{"NextLink" , _DtHelpNextLink }
|
||
};
|
||
|
||
|
||
|
||
/****************************************************************
|
||
*
|
||
* Full class record constant
|
||
*
|
||
****************************************************************/
|
||
|
||
externaldef( dthelpdialogwidgetclassrec) DtHelpDialogWidgetClassRec dtHelpDialogWidgetClassRec =
|
||
{
|
||
{ /* core_class fields */
|
||
(WidgetClass) &xmBulletinBoardClassRec, /* superclass */
|
||
"DtHelpDialog", /* class_name */
|
||
sizeof(DtHelpDialogWidgetRec), /* widget_size */
|
||
ClassInitialize, /* class_initialize */
|
||
ClassPartInitialize, /* class_part_init */
|
||
FALSE, /* class_inited */
|
||
Initialize, /* initialize */
|
||
NULL, /* initialize_hook */
|
||
XtInheritRealize, /* realize */
|
||
DrawnBActions, /* actions */
|
||
XtNumber(DrawnBActions), /* num_actions */
|
||
resources, /* resources */
|
||
XtNumber(resources), /* num_resources */
|
||
NULLQUARK, /* xrm_class */
|
||
TRUE, /* compress_motion */
|
||
XtExposeCompressMaximal, /* compress_exposure */
|
||
FALSE, /* compress_enterlv */
|
||
FALSE, /* visible_interest */
|
||
Destroy, /* destroy */
|
||
XtInheritResize, /* resize */
|
||
XtInheritExpose, /* expose */
|
||
SetValues, /* set_values */
|
||
NULL, /* set_values_hook */
|
||
XtInheritSetValuesAlmost, /* set_values_almost */
|
||
NULL, /* get_values_hook */
|
||
XtInheritAcceptFocus, /* enter_focus */
|
||
XtVersion, /* version */
|
||
NULL, /* callback_private */
|
||
XtInheritTranslations, /* tm_table */
|
||
XtInheritQueryGeometry, /* query_geometry */
|
||
NULL, /* display_accelerator*/
|
||
NULL, /* extension */
|
||
},
|
||
|
||
{ /* composite_class fields */
|
||
XtInheritGeometryManager, /* geometry_manager */
|
||
XtInheritChangeManaged, /* change_managed */
|
||
XtInheritInsertChild, /* insert_child */
|
||
XtInheritDeleteChild, /* delete_child */
|
||
NULL, /* extension */
|
||
},
|
||
|
||
{ /* constraint_class fields */
|
||
NULL, /* resource list */
|
||
0, /* num resources */
|
||
0, /* constraint size */
|
||
NULL, /* init proc */
|
||
NULL, /* destroy proc */
|
||
NULL, /* set values proc */
|
||
NULL, /* extension */
|
||
},
|
||
|
||
{ /* manager_class fields */
|
||
XmInheritTranslations, /* translations */
|
||
NULL, /* syn_resources */
|
||
0, /* num_syn_resources */
|
||
NULL, /* syn_cont_resources */
|
||
0, /* num_syn_cont_resources */
|
||
XmInheritParentProcess, /* parent_process */
|
||
NULL, /* extension */
|
||
},
|
||
|
||
{ /* bulletinBoard class */
|
||
TRUE, /*always_install_accelerators*/
|
||
_DtHelpDialogWidgetGeoMatrixCreate, /* geo__matrix_create */
|
||
XmInheritFocusMovedProc, /* focus_moved_proc */
|
||
NULL /* extension */
|
||
},
|
||
|
||
{ /* messageBox class - none */
|
||
0 /* mumble */
|
||
}
|
||
};
|
||
|
||
externaldef( dthelpdialogwidgetclass) WidgetClass dtHelpDialogWidgetClass
|
||
= (WidgetClass) &dtHelpDialogWidgetClassRec;
|
||
|
||
static char *HelpTypeNames[] =
|
||
{ "help_type_topic",
|
||
"help_type_string",
|
||
"help_type_man_page",
|
||
"help_type_file",
|
||
"help_type_dynamic_string"
|
||
};
|
||
|
||
static char *ScrollBarValueNames[] =
|
||
{ "help_no_scrollbars",
|
||
"help_static_scrollbars",
|
||
"help_as_needed_scrollbars"
|
||
};
|
||
|
||
static char *ExecutionValueNames[] =
|
||
{ "help_execute_none",
|
||
"help_execute_query_all",
|
||
"help_execute_query_unaliased",
|
||
"help_execute_all"
|
||
};
|
||
|
||
/* the _DtHelpPaperSizeNames[] are in Print.c */
|
||
|
||
#define NUM_NAMES( list ) (sizeof( list) / sizeof( char *))
|
||
|
||
|
||
|
||
|
||
|
||
/*********************************************************************
|
||
*
|
||
* NavigationTypeDefault
|
||
*
|
||
*
|
||
*********************************************************************/
|
||
static void
|
||
NavigationTypeDefault(
|
||
Widget widget,
|
||
int offset, /* unused */
|
||
XrmValue *value )
|
||
{
|
||
static XmNavigationType navigation_type;
|
||
Widget parent = XtParent(widget) ;
|
||
|
||
value->addr = (XPointer) &navigation_type;
|
||
if (XtIsShell(parent)) {
|
||
navigation_type = XmSTICKY_TAB_GROUP;
|
||
} else {
|
||
navigation_type = XmTAB_GROUP;
|
||
}
|
||
|
||
}
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void ClassInitialize (
|
||
* void)
|
||
*
|
||
* Parameters: Void.
|
||
*
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Register our representation types here
|
||
*
|
||
*****************************************************************************/
|
||
static void ClassInitialize(void)
|
||
{
|
||
XmRepTypeId checkId;
|
||
|
||
/* First check to see if these have already been registered */
|
||
checkId = XmRepTypeGetId(DtRDtScrollBarPolicy);
|
||
|
||
if (checkId == XmREP_TYPE_INVALID)
|
||
{
|
||
/* Register the help representation types here */
|
||
|
||
XmRepTypeRegister(DtRDtHelpType, HelpTypeNames, NULL,
|
||
NUM_NAMES(HelpTypeNames)) ;
|
||
XmRepTypeRegister(DtRDtScrollBarPolicy, ScrollBarValueNames, NULL,
|
||
NUM_NAMES(ScrollBarValueNames)) ;
|
||
XmRepTypeRegister(DtRDtExecutionPolicy, ExecutionValueNames, NULL,
|
||
NUM_NAMES(ExecutionValueNames)) ;
|
||
XmRepTypeRegister(DtRDtPaperSize, _DtHelpPaperSizeNames, NULL,
|
||
_DtHelpPaperSizeNamesCnt) ;
|
||
}
|
||
|
||
return ;
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void ClassPartInitialize (
|
||
* WidgetClass widgetClass)
|
||
*
|
||
* Parameters: WidgetClass
|
||
*
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose:
|
||
*
|
||
*****************************************************************************/
|
||
static void ClassPartInitialize(
|
||
WidgetClass widgetClass)
|
||
{
|
||
|
||
return ;
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void VariableInitialize()
|
||
*
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: This routine initializes all global variables to valid
|
||
* starting values.
|
||
*
|
||
*****************************************************************************/
|
||
static void VariableInitialize(
|
||
DtHelpDialogWidget nw)
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw ;
|
||
|
||
/* Set our current topic variables to initial values */
|
||
_DtHelpCommonHelpInit(&hw->help_dialog.help);
|
||
|
||
/* Make local copies of all resource strings assigned by the user */
|
||
if (hw->help_dialog.display.locationId != NULL)
|
||
hw->help_dialog.display.locationId = XtNewString(hw->help_dialog.display.locationId);
|
||
if (hw->help_dialog.display.helpVolume != NULL)
|
||
hw->help_dialog.display.helpVolume = XtNewString(hw->help_dialog.display.helpVolume);
|
||
if (hw->help_dialog.display.manPage != NULL)
|
||
hw->help_dialog.display.manPage = XtNewString(hw->help_dialog.display.manPage);
|
||
if (hw->help_dialog.display.stringData != NULL)
|
||
hw->help_dialog.display.stringData = XtNewString(hw->help_dialog.display.stringData);
|
||
if (hw->help_dialog.display.helpFile != NULL)
|
||
hw->help_dialog.display.helpFile = XtNewString(hw->help_dialog.display.helpFile);
|
||
|
||
/*
|
||
* Initialize the topic title variables.
|
||
*/
|
||
hw->help_dialog.display.count = 1;
|
||
hw->help_dialog.display.topicTitleLbl = NULL;
|
||
if (hw->help_dialog.display.topicTitleStr != NULL)
|
||
hw->help_dialog.display.topicTitleStr =
|
||
XtNewString(hw->help_dialog.display.topicTitleStr);
|
||
else
|
||
hw->help_dialog.display.topicTitleStr =
|
||
XtNewString((char *)_DTGETMESSAGE(2, 70,
|
||
"Nonexistent Topic Title."));
|
||
/*
|
||
* create the XmString version
|
||
*/
|
||
if (hw->help_dialog.display.topicTitleStr != NULL)
|
||
hw->help_dialog.display.topicTitleLbl = XmStringCreateLocalized(
|
||
hw->help_dialog.display.topicTitleStr);
|
||
|
||
if (hw->help_dialog.print.printer != NULL)
|
||
hw->help_dialog.print.printer = XtNewString(hw->help_dialog.print.printer);
|
||
|
||
if (hw->help_dialog.print.helpPrint != _DtHelpDefaultHelpPrint)
|
||
hw->help_dialog.print.helpPrint = XtNewString(hw->help_dialog.print.helpPrint);
|
||
|
||
|
||
hw->bulletin_board.auto_unmanage = FALSE;
|
||
hw->bulletin_board.resize_policy = XmRESIZE_NONE;
|
||
|
||
|
||
/* Setup some of our generic widget variables */
|
||
hw->help_dialog.print.printVolume = NULL;
|
||
|
||
|
||
/* Set our volume handle to an NULL initial value */
|
||
hw->help_dialog.display.volumeHandle = NULL;
|
||
hw->help_dialog.ghelp.volumeFlag = FALSE;
|
||
|
||
_DtHelpGlobSrchInitVars(&hw->help_dialog.srch);
|
||
|
||
|
||
/* Set our print display stuff to initial values */
|
||
hw->help_dialog.print.printForm = NULL;
|
||
|
||
/* Set our map flag: true after we hit our popup callback,
|
||
* false otherwise
|
||
*/
|
||
hw->help_dialog.display.firstTimePopupFlag = FALSE;
|
||
|
||
|
||
/* Set our history display stuff to initial vlaues */
|
||
hw->help_dialog.history.historyWidget = NULL;
|
||
hw->help_dialog.history.volumeList = NULL;
|
||
hw->help_dialog.history.topicList = NULL;
|
||
hw->help_dialog.history.pHistoryListHead = NULL;
|
||
|
||
/* Set our path display stuff to initial values */
|
||
hw->help_dialog.history.pPathListHead = NULL;
|
||
hw->help_dialog.history.pPathListTale = NULL;
|
||
hw->help_dialog.history.totalPathNodes = 0;
|
||
|
||
/* Set our jump list display stuff to initial values */
|
||
hw->help_dialog.backtr.pJumpListHead = NULL;
|
||
hw->help_dialog.backtr.pJumpListTale = NULL;
|
||
hw->help_dialog.backtr.totalJumpNodes = 0;
|
||
hw->help_dialog.backtr.scrollPosition = -1;
|
||
/* Set our help dialog widgets to NULL starting values */
|
||
hw->help_dialog.menu.menuBar = NULL;
|
||
hw->help_dialog.browser.panedWindow = NULL;
|
||
hw->help_dialog.browser.pathArea = NULL;
|
||
hw->help_dialog.menu.topBtn = NULL;
|
||
hw->help_dialog.menu.popupTopBtn = NULL;
|
||
hw->help_dialog.menu.keyBtn = NULL;
|
||
hw->help_dialog.menu.backBtn = NULL;
|
||
hw->help_dialog.menu.popupBackBtn = NULL;
|
||
hw->help_dialog.menu.historyBtn = NULL;
|
||
hw->help_dialog.menu.printBtn = NULL;
|
||
hw->help_dialog.menu.closeBtn = NULL;
|
||
hw->help_dialog.menu.helpBtn = NULL;
|
||
hw->help_dialog.ghelp.definitionBox = NULL;
|
||
hw->help_dialog.menu.newWindowBtn = NULL;
|
||
|
||
|
||
hw->help_dialog.browser.btnBoxBackBtn = NULL;
|
||
hw->help_dialog.browser.btnBoxHistoryBtn = NULL;
|
||
hw->help_dialog.browser.btnBoxIndexBtn = NULL;
|
||
|
||
/* Set our parentId to a null starting value */
|
||
hw->help_dialog.ghelp.parentId = NULL;
|
||
}
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void Initialize (
|
||
* WidgetClass widgetClass)
|
||
*
|
||
* Parameters: WidgetClass
|
||
*
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: This is the Help Dialog widget initialize routine. This
|
||
* routine is responsible for the following:
|
||
* 1) Validate all resources the user passed in.
|
||
* 2) Over ride any invalid resources.
|
||
* 3) Build the internal UI component for the Help Dialog.
|
||
* 4) Add any internal callbacks for the UI components.
|
||
*
|
||
*****************************************************************************/
|
||
static void Initialize(
|
||
Widget rw,
|
||
Widget nw,
|
||
ArgList args_init,
|
||
Cardinal *num_args)
|
||
{
|
||
|
||
Arg args[10]; /* arg list */
|
||
int n; /* arg count */
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw ;
|
||
|
||
/* Local variables */
|
||
DtHelpListStruct *pHelpInfo;
|
||
|
||
/* Initialize all global variables */
|
||
VariableInitialize(hw);
|
||
|
||
|
||
/* Validate the incomming arguments to make sure they are ok */
|
||
|
||
|
||
/* Build the Menus bar */
|
||
hw->help_dialog.menu.menuBar = SetupHelpDialogMenus((Widget)hw);
|
||
|
||
|
||
/* Build the Paned Window to hold the path area and display area */
|
||
n = 0;
|
||
XtSetArg (args[n], XmNspacing, 10); ++n;
|
||
hw->help_dialog.browser.panedWindow =
|
||
XmCreatePanedWindow ((Widget)hw, "panedWindow", args, n);
|
||
XtManageChild (hw->help_dialog.browser.panedWindow);
|
||
|
||
|
||
/* Call the setup routine to build the actual path area */
|
||
_DtHelpBuildPathArea(hw->help_dialog.browser.panedWindow, hw);
|
||
|
||
|
||
/* Force our keyboard traversal to start within the path area */
|
||
/*
|
||
* NOTE 04/25/96 : pathArea is NOT set by _DtHelpBuildPathArea().
|
||
* The test for NULL is a work-around for defect CDExc20246; but
|
||
* the proper widget should be given to XmProcessTraversal() someday.
|
||
*/
|
||
if (hw->help_dialog.browser.pathArea != (Widget)NULL)
|
||
XmProcessTraversal(hw->help_dialog.browser.pathArea, XmTRAVERSE_HOME);
|
||
|
||
/* We build our display area last because we need the other UI
|
||
* components created first.
|
||
*/
|
||
|
||
/* Call the setup routine to build the display area */
|
||
BuildDisplayArea(hw->help_dialog.browser.panedWindow, hw);
|
||
|
||
|
||
/* Add the proper help callback to the top level shell of our dialog */
|
||
|
||
/* Add all our help callbacks for each of the created widgets */
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_dialogShell_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback((Widget) hw, XmNhelpCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
|
||
/* Just for fun, lets make sure our sizes are correct */
|
||
XtAddCallback (XtParent(hw), XmNpopupCallback, (XtCallbackProc)
|
||
InitialPopupCB, (XtPointer) hw);
|
||
|
||
|
||
return;
|
||
}
|
||
|
||
|
||
|
||
/****************************************************************************
|
||
* Function: static XtCallbackProc InitialPopupCB
|
||
*
|
||
*
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: We do some last minute sizing of our dialog on its first
|
||
* mapping, then we remove the callback.
|
||
*
|
||
****************************************************************************/
|
||
static void InitialPopupCB(
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XtPointer callData)
|
||
{
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) clientData;
|
||
|
||
/* set our firstTimePopupFlag to TRUE because we map it right after
|
||
this call */
|
||
hw->help_dialog.display.firstTimePopupFlag = TRUE;
|
||
|
||
_DtHelpResizeDisplayArea (XtParent(hw),
|
||
hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.textRows,
|
||
hw->help_dialog.display.textColumns);
|
||
|
||
XtRemoveCallback (XtParent(hw), XmNpopupCallback, (XtCallbackProc)
|
||
InitialPopupCB, (XtPointer) hw);
|
||
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static Boolean SetValues(
|
||
* Widget cw,
|
||
* Widget rw,
|
||
* Widget nw,
|
||
* ArgList args,
|
||
* Cardinal *num_args )
|
||
*
|
||
* Parameters: cw Specifies the current working widget.
|
||
* rw Specifies the replacement working widget.
|
||
* nw Specifies the new widget.
|
||
* args Specifies the arguments to be applied to the
|
||
* New widget.
|
||
* numArgs Number of argument/value pars in args.
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: Set the attributes of the Help Dialog widget.
|
||
|
||
*
|
||
*****************************************************************************/
|
||
static Boolean SetValues(
|
||
Widget cw,
|
||
Widget rw,
|
||
Widget nw,
|
||
ArgList args,
|
||
Cardinal *numArgs)
|
||
{
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw ;
|
||
DtHelpDialogWidget current = (DtHelpDialogWidget) cw ;
|
||
Boolean updateRequest=FALSE;
|
||
Boolean newTitle=FALSE;
|
||
|
||
/* Validate the incomming arguments to make sure they are ok */
|
||
|
||
|
||
|
||
/* Setup some initial argument values we know we need on the B-board */
|
||
hw->bulletin_board.auto_unmanage = FALSE;
|
||
hw->bulletin_board.resize_policy = XmRESIZE_NONE;
|
||
|
||
|
||
/* Check DtNcolumns & or DtNrows resource for change */
|
||
if ((current->help_dialog.display.textRows != hw->help_dialog.display.textRows) ||
|
||
(current->help_dialog.display.textColumns != hw->help_dialog.display.textColumns))
|
||
{
|
||
/* Perform a resize on our display area */
|
||
_DtHelpResizeDisplayArea (XtParent(hw),
|
||
hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.textRows,
|
||
hw->help_dialog.display.textColumns);
|
||
}
|
||
|
||
|
||
/* Check DtNhelpVolume resource for change */
|
||
if (current->help_dialog.display.helpVolume != hw->help_dialog.display.helpVolume)
|
||
{
|
||
hw->help_dialog.display.helpVolume = XtNewString(hw->help_dialog.display.helpVolume);
|
||
XtFree(current->help_dialog.display.helpVolume);
|
||
|
||
/* Update our volumeFlag so we know to resolve our new help volume */
|
||
hw->help_dialog.ghelp.volumeFlag=FALSE;
|
||
|
||
updateRequest = TRUE;
|
||
}
|
||
|
||
|
||
/* Check DtNlocationId resource for change */
|
||
if (current->help_dialog.display.locationId != hw->help_dialog.display.locationId)
|
||
{
|
||
hw->help_dialog.display.locationId = XtNewString(hw->help_dialog.display.locationId);
|
||
XtFree(current->help_dialog.display.locationId);
|
||
updateRequest = TRUE;
|
||
}
|
||
|
||
/* set the printing resources */
|
||
_DtHelpPrintSetValues(¤t->help_dialog.print,&hw->help_dialog.print,
|
||
&hw->help_dialog.display,&hw->help_dialog.help);
|
||
|
||
/* Check XmhelpOnHelpVolume resource for change */
|
||
if (current->help_dialog.help.helpOnHelpVolume !=
|
||
hw->help_dialog.help.helpOnHelpVolume)
|
||
{
|
||
hw->help_dialog.help.helpOnHelpVolume =
|
||
XtNewString(hw->help_dialog.help.helpOnHelpVolume);
|
||
|
||
if (current->help_dialog.help.helpOnHelpVolume != _DtHelpDefaultHelp4HelpVolume)
|
||
XtFree(current->help_dialog.help.helpOnHelpVolume);
|
||
}
|
||
|
||
/* Check DtNmanPage resource for change */
|
||
if (current->help_dialog.display.manPage != hw->help_dialog.display.manPage)
|
||
{
|
||
hw->help_dialog.display.manPage = XtNewString(hw->help_dialog.display.manPage);
|
||
XtFree(current->help_dialog.display.manPage);
|
||
updateRequest = TRUE;
|
||
newTitle = TRUE;
|
||
}
|
||
|
||
|
||
/* Check DtNstringData resource for change */
|
||
if (current->help_dialog.display.stringData != hw->help_dialog.display.stringData)
|
||
{
|
||
hw->help_dialog.display.stringData = XtNewString(hw->help_dialog.display.stringData);
|
||
XtFree(current->help_dialog.display.stringData);
|
||
updateRequest = TRUE;
|
||
newTitle = TRUE;
|
||
}
|
||
|
||
/* Check DtNhelpFile resource for change */
|
||
if (current->help_dialog.display.helpFile != hw->help_dialog.display.helpFile)
|
||
{
|
||
hw->help_dialog.display.helpFile = XtNewString(hw->help_dialog.display.helpFile);
|
||
XtFree(current->help_dialog.display.helpFile);
|
||
updateRequest = TRUE;
|
||
newTitle = TRUE;
|
||
}
|
||
|
||
/* Check DtNtopicTitle resource for change */
|
||
if (hw->help_dialog.display.topicTitleStr != NULL &&
|
||
current->help_dialog.display.topicTitleStr !=
|
||
hw->help_dialog.display.topicTitleStr)
|
||
{
|
||
/*
|
||
* copy the string and make a XmString version.
|
||
*/
|
||
hw->help_dialog.display.topicTitleStr =
|
||
XtNewString(hw->help_dialog.display.topicTitleStr);
|
||
|
||
XtFree(current->help_dialog.display.topicTitleStr);
|
||
updateRequest = TRUE;
|
||
newTitle = TRUE;
|
||
}
|
||
else if (newTitle == True)
|
||
{
|
||
/*
|
||
* A new file, string or man page has been specified.
|
||
* But XmNtopicTitle has not been set or set to null (otherwise
|
||
* the if stmt would have been true). Therefore, create a new
|
||
* title for this entry for history and topic labels.
|
||
*/
|
||
int len;
|
||
char *str;
|
||
|
||
str = (char *)_DTGETMESSAGE(2, 70, "Nonexistent Topic Title.");
|
||
len = strlen(str);
|
||
hw->help_dialog.display.topicTitleStr = XtMalloc(sizeof(char)*(len+10));
|
||
if (NULL != hw->help_dialog.display.topicTitleStr)
|
||
{
|
||
sprintf(hw->help_dialog.display.topicTitleStr, "%s%d", str,
|
||
hw->help_dialog.display.count++);
|
||
newTitle = TRUE;
|
||
}
|
||
}
|
||
|
||
/*
|
||
* Turn the string into an XmString and free the old
|
||
*/
|
||
if (newTitle == TRUE)
|
||
{
|
||
hw->help_dialog.display.topicTitleLbl = XmStringCreateLocalized(
|
||
hw->help_dialog.display.topicTitleStr);
|
||
|
||
if (current->help_dialog.display.topicTitleLbl != NULL)
|
||
XmStringFree(current->help_dialog.display.topicTitleLbl);
|
||
}
|
||
|
||
/* Check the help type for change */
|
||
if (current->help_dialog.display.helpType != hw->help_dialog.display.helpType
|
||
|| updateRequest)
|
||
{
|
||
/* Setup and display our new topic */
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_AND_JUMP);
|
||
}
|
||
|
||
|
||
return(FALSE);
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void Destroy(Widget w );
|
||
*
|
||
* Parameters: w Specifies the widget to be destroyed.
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: Destroy any internally malloced memory.
|
||
*
|
||
*****************************************************************************/
|
||
static void Destroy(
|
||
Widget w)
|
||
{
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) w;
|
||
|
||
/* This routine will clean up all malloc'ed stuff in our instance
|
||
* structure. It does not remove any callbacks or delete any of the
|
||
* widgets created in this instance of the help dialog.
|
||
*/
|
||
|
||
CleanUpHelpDialog((Widget) hw, DtCLEAN_FOR_DESTROY);
|
||
|
||
/* Remove any of the callbacks added to the help dialog ??? */
|
||
|
||
|
||
}
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void MenuBarFix(
|
||
* XmGeoMatrix geoSpec,
|
||
* int action,
|
||
* XmGeoRowLayout layoutPtr,
|
||
* XmKidGeometry rowPtr)
|
||
*
|
||
*
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine is a fixup routine which can be used for rows
|
||
* which consist of a single MenuBar RowColumn. The effect of
|
||
* this routine is to have the RowColumn ignore the margin
|
||
* width and height.
|
||
*
|
||
*****************************************************************************/
|
||
static void MenuBarFix(
|
||
XmGeoMatrix geoSpec,
|
||
int action,
|
||
XmGeoMajorLayout layoutPtr,
|
||
XmKidGeometry rowPtr )
|
||
{
|
||
register Dimension marginW ;
|
||
register Dimension marginH ;
|
||
register Dimension twoMarginW ;
|
||
|
||
|
||
marginW = geoSpec->margin_w ;
|
||
twoMarginW = (marginW << 1) ;
|
||
marginH = geoSpec->margin_h ;
|
||
|
||
switch( action )
|
||
{
|
||
case XmGEO_PRE_SET:
|
||
{ rowPtr->box.x -= marginW ;
|
||
rowPtr->box.width += twoMarginW ;
|
||
rowPtr->box.y -= marginH ;
|
||
break ;
|
||
}
|
||
default:
|
||
{ if( rowPtr->box.width > twoMarginW )
|
||
{
|
||
/* Avoid subtracting a margin from box width which would
|
||
* result in underflow.
|
||
*/
|
||
rowPtr->box.x += marginW ;
|
||
rowPtr->box.width -= twoMarginW ;
|
||
}
|
||
if( action == XmGET_PREFERRED_SIZE )
|
||
{
|
||
/* Set width to some small value so it does not
|
||
* effect total width of matrix.
|
||
*/
|
||
rowPtr->box.width = 1 ;
|
||
}
|
||
break ;
|
||
}
|
||
}
|
||
return ;
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: XmGeoMatrix _DtHelpDialogWidgeGeoMatrixCreate(
|
||
* Widget wid,
|
||
* Widget instigator,
|
||
* XtWidgetGeometry *desired)
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine is responsible for all the positioning of the
|
||
* the internal Help Dialog widgets.
|
||
*
|
||
*****************************************************************************/
|
||
XmGeoMatrix _DtHelpDialogWidgetGeoMatrixCreate(
|
||
Widget wid,
|
||
Widget instigator,
|
||
XtWidgetGeometry *desired )
|
||
{
|
||
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) wid ;
|
||
XmGeoMatrix geoSpec ;
|
||
register XmGeoRowLayout layoutPtr ;
|
||
register XmKidGeometry boxPtr ;
|
||
|
||
geoSpec = _XmGeoMatrixAlloc( TB_MAX_WIDGETS_VERT, TB_MAX_NUM_WIDGETS, 0) ;
|
||
geoSpec->composite = (Widget) hw ;
|
||
geoSpec->instigator = (Widget) instigator ;
|
||
if( desired )
|
||
{ geoSpec->instig_request = *desired ;
|
||
}
|
||
geoSpec->margin_w = hw->help_dialog.ghelp.marginWidth
|
||
+ hw->manager.shadow_thickness ;
|
||
geoSpec->margin_h = hw->help_dialog.ghelp.marginHeight
|
||
+ hw->manager.shadow_thickness ;
|
||
geoSpec->no_geo_request = _DtHelpDialogWidgetNoGeoRequest ;
|
||
|
||
layoutPtr = (XmGeoRowLayout) geoSpec->layouts ;
|
||
boxPtr = geoSpec->boxes ;
|
||
|
||
/* Menubar setup stuff */
|
||
if( _XmGeoSetupKid( boxPtr, hw->help_dialog.menu.menuBar))
|
||
{
|
||
layoutPtr->fix_up = MenuBarFix;
|
||
boxPtr += 2;
|
||
++layoutPtr;
|
||
}
|
||
|
||
|
||
/* Display area setup stuff */
|
||
if( _XmGeoSetupKid(boxPtr, hw->help_dialog.browser.panedWindow))
|
||
{
|
||
layoutPtr->space_above = 0;
|
||
layoutPtr->stretch_height = TRUE ;
|
||
layoutPtr->min_height = 100 ;
|
||
boxPtr += 2 ; /* For new row, add 2. */
|
||
++layoutPtr ; /* For new row. */
|
||
}
|
||
|
||
|
||
|
||
layoutPtr->space_above = hw->help_dialog.ghelp.marginWidth;
|
||
layoutPtr->end = TRUE ; /* Mark the last row. */
|
||
return( geoSpec) ;
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: Boolean _DtHelpDialogWidgetNoGeoRequest(geoSpec)
|
||
* XmGeoMatrix geoSpec)
|
||
*
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose:
|
||
*
|
||
****************************************************************************/
|
||
Boolean _DtHelpDialogWidgetNoGeoRequest(XmGeoMatrix geoSpec)
|
||
{
|
||
|
||
if( BB_InSetValues( geoSpec->composite)
|
||
&& (XtClass( geoSpec->composite) == dtHelpDialogWidgetClass) )
|
||
{
|
||
return( TRUE) ;
|
||
}
|
||
return( FALSE) ;
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void DisplayTopLevelCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: causes the top level topic to be displayed.
|
||
*
|
||
****************************************************************************/
|
||
static void DisplayTopLevelCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data )
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) client_data;
|
||
|
||
/* Display the top level topic */
|
||
if (hw->help_dialog.help.topLevelId != NULL)
|
||
_DtHelpUpdateDisplayArea(hw->help_dialog.help.topLevelId, hw, TRUE,
|
||
DtHISTORY_AND_JUMP, DtHELP_TYPE_TOPIC);
|
||
else
|
||
_DtHelpUpdateDisplayArea(NULL, hw, TRUE, DtHISTORY_AND_JUMP,
|
||
DtHELP_TYPE_TOPIC);
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: extern void _DtHelpDisplayBackCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine will cause the top element in the jump
|
||
* stack to be displayed.
|
||
*
|
||
****************************************************************************/
|
||
void _DtHelpDisplayBackCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data)
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) client_data;
|
||
|
||
ProcessJumpBack(hw);
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: extern void _DtHelpDuplicateWindowCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine creates a new help widget by forcing the
|
||
* equivelent of a Jump New hyper text call
|
||
*
|
||
****************************************************************************/
|
||
void _DtHelpDuplicateWindowCB(
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XtPointer callData)
|
||
{
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) clientData;
|
||
DtHelpDialogCallbackStruct callDataStruct;
|
||
|
||
|
||
/* Setup the DtHelpHyperProcStruct to pass back
|
||
* to the client as callData
|
||
*/
|
||
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
if (hw->help_dialog.display.hyperLinkCallback != NULL)
|
||
{
|
||
/* Use the old one */
|
||
callDataStruct.helpVolume = XtNewString
|
||
(hw->help_dialog.display.helpVolume);
|
||
callDataStruct.reason = DtCR_HELP_LINK_ACTIVATE;
|
||
callDataStruct.event = NULL; /* should be hyperData->event */
|
||
callDataStruct.locationId = XtNewString
|
||
(hw->help_dialog.display.locationId);
|
||
callDataStruct.specification = NULL;
|
||
callDataStruct.hyperType = DtHELP_LINK_TOPIC;
|
||
callDataStruct.windowHint = DtHELP_NEW_WINDOW;
|
||
|
||
XtCallCallbackList((Widget)hw,hw->help_dialog.display.hyperLinkCallback,
|
||
&callDataStruct);
|
||
}
|
||
else
|
||
{ /* The application did not register a hypertext callback so
|
||
* we must generate the proper warning message and continue!
|
||
*/
|
||
XmeWarning((Widget)hw, (char*) HDMessage6);
|
||
}
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void CopyTextCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine will cause the display area to copy text to
|
||
* the clip-board.
|
||
*
|
||
****************************************************************************/
|
||
static void CopyTextCB(
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XtPointer callData)
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) clientData;
|
||
|
||
_DtHelpInitiateClipboard(hw->help_dialog.help.pDisplayArea);
|
||
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void ProcessBMenuBackCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine will cause the top element in the jump
|
||
* stack to be displayed, if their is a top element.
|
||
*
|
||
****************************************************************************/
|
||
static void ProcessBMenuBackCB(
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XButtonEvent * event,
|
||
Boolean *continueToDispatch)
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) clientData;
|
||
|
||
XmMenuPosition(hw->help_dialog.menu.popupMenu, event);
|
||
XtManageChild(hw->help_dialog.menu.popupMenu);
|
||
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: extern void _DtHelpDisplayHistoryCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine will cause the history dialog to be
|
||
* posted.
|
||
*
|
||
****************************************************************************/
|
||
void _DtHelpDisplayHistoryCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data )
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) client_data;
|
||
|
||
|
||
XmUpdateDisplay((Widget) hw);
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
_DtHelpDisplayHistoryInfo((Widget)hw);
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void _DtHelpDisplayBrowserHomeCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine will cause the top level of the browser.hv
|
||
* help volume to be displayed.
|
||
*
|
||
****************************************************************************/
|
||
void _DtHelpDisplayBrowserHomeCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data )
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) client_data;
|
||
XmUpdateDisplay((Widget) hw);
|
||
|
||
/* ??? Check to see if help volume is always fully expanded at this point
|
||
* ??? if so, we will never have a match.
|
||
*/
|
||
if ( hw->help_dialog.display.helpVolume == NULL
|
||
|| strstr (hw->help_dialog.display.helpVolume, DtBROWSER_NAME) == NULL)
|
||
{
|
||
XtFree(hw->help_dialog.display.helpVolume);
|
||
hw->help_dialog.display.helpVolume = XtNewString(DtBROWSER_NAME);
|
||
|
||
/* Set our help volume flag so we open the proper volume */
|
||
hw->help_dialog.ghelp.volumeFlag = FALSE;
|
||
}
|
||
|
||
XtFree(hw->help_dialog.display.locationId);
|
||
hw->help_dialog.display.locationId = XtNewString(DtBROWSER_HOME);
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_TOPIC;
|
||
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_AND_JUMP);
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void _DtHelpDisplayIndexCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine will cause the index dialog to be
|
||
* posted.
|
||
*
|
||
****************************************************************************/
|
||
void _DtHelpDisplayIndexCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data )
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) client_data;
|
||
|
||
|
||
XmUpdateDisplay((Widget) hw);
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
/* display the index search dialog */
|
||
_DtHelpGlobSrchDisplayDialog((Widget)hw,NULL,hw->help_dialog.display.helpVolume);
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void DisplayPrintCB(
|
||
* Widget w,
|
||
* XtPointer client_data,
|
||
* XtPointer call_data);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value:
|
||
*
|
||
* Purpose: This routine will cause the history dialog to be
|
||
* posted.
|
||
*
|
||
****************************************************************************/
|
||
static void DisplayPrintCB(
|
||
Widget w,
|
||
XtPointer client_data,
|
||
XtPointer call_data )
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) client_data;
|
||
|
||
XmUpdateDisplay((Widget) hw);
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
/* display the print dialog */
|
||
_DtHelpDisplayPrintDialog((Widget) hw,&hw->help_dialog.print,
|
||
&hw->help_dialog.display,&hw->help_dialog.help);
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: Widget DtCreateHelpDialog(Widget parent,
|
||
* String name,
|
||
* ArgList arglist,
|
||
* Cardinal argcount);
|
||
*
|
||
* Parameters: parent Specifies the parent widget ID.
|
||
* name Specifies the name of the created dialog
|
||
* shell widget.
|
||
* arglis Specifies the argument list.
|
||
* argcount Specifies the number of attribute/value pairs
|
||
* in the argument list (arglist).
|
||
*
|
||
* Return Value: Returns a Help Dialog shell widget ID.
|
||
*
|
||
* Purpose: Create an instance of a Help Dialog.
|
||
*
|
||
*****************************************************************************/
|
||
Widget DtCreateHelpDialog(
|
||
Widget parent,
|
||
char *name,
|
||
ArgList al,
|
||
Cardinal ac)
|
||
{
|
||
Widget w;
|
||
_DtHelpWidgetToAppContext(parent);
|
||
|
||
_DtHelpAppLock(app);
|
||
w = XmeCreateClassDialog (dtHelpDialogWidgetClass, parent, name, al, ac);
|
||
|
||
/* Add the CatchClose here so we catch the window manager close requests */
|
||
CatchClose(w);
|
||
|
||
_DtHelpAppUnlock(app);
|
||
return w;
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: _DtHelpFilterExecCmdCB
|
||
*
|
||
* clientData: The general help dialog widget
|
||
* cmdStr: cmd string to filter
|
||
* ret_filteredCmdStr: string after filtering. NULL if exec denied
|
||
*
|
||
* Return Value: 0: ok, < 0: error
|
||
*
|
||
* Purpose: filter an execution command using executionPolicy rsrc
|
||
*
|
||
* Memory:
|
||
* The caller must free memory allocated for the ret_filteredCmdStr
|
||
*****************************************************************************/
|
||
int _DtHelpFilterExecCmdCB(
|
||
void * clientData,
|
||
const char * cmdStr,
|
||
char * * ret_filteredCmdStr)
|
||
{
|
||
DtHelpDialogWidget hw;
|
||
char *hv_path;
|
||
|
||
hw = (DtHelpDialogWidget) _DtHelpDisplayAreaData(clientData);
|
||
hv_path = _DtHelpFileLocate(DtHelpVOLUME_TYPE,
|
||
hw->help_dialog.display.helpVolume,
|
||
_DtHelpFileSuffixList, False, R_OK);
|
||
|
||
return _DtHelpFilterExecCmd((Widget) hw, cmdStr,
|
||
hw->help_dialog.display.executionPolicy,
|
||
True, &hw->help_dialog.help, ret_filteredCmdStr, hv_path);
|
||
}
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void BuildDisplayArea(Widget parent,
|
||
* DtHelpDialogWidget nw);
|
||
*
|
||
*
|
||
* Parameters: parent Specifies the widget ID of the help dialog you
|
||
* want to set the topic in.
|
||
* nw Specifies the current help dialog widget.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Creates the Display area in the help dialog.
|
||
*
|
||
*****************************************************************************/
|
||
static void BuildDisplayArea(
|
||
Widget parent,
|
||
DtHelpDialogWidget nw)
|
||
{
|
||
Arg args[2];
|
||
int n;
|
||
XmFontList defaultList;
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw ;
|
||
|
||
|
||
/* Get our current fontlist value */
|
||
n = 0;
|
||
XtSetArg (args[n], XmNfontList, &(defaultList)); ++n;
|
||
XtGetValues (hw->help_dialog.menu.topBtn, args, n);
|
||
|
||
|
||
/* Build the Display Area */
|
||
hw->help_dialog.help.pDisplayArea = _DtHelpCreateDisplayArea(parent,
|
||
"DisplayArea",
|
||
((short) hw->help_dialog.display.scrollBarPolicy),
|
||
((short) hw->help_dialog.display.scrollBarPolicy),
|
||
False,
|
||
((int) hw->help_dialog.display.textRows),
|
||
((int) hw->help_dialog.display.textColumns),
|
||
_DtHelpDialogHypertextCB,
|
||
ResizeHelpDialogCB,
|
||
_DtHelpFilterExecCmdCB,
|
||
(XtPointer) hw,
|
||
defaultList);
|
||
|
||
/* Build the popup menu item for inside the display area */
|
||
hw->help_dialog.menu.popupMenu = CreatePopupMenu((Widget)hw);
|
||
|
||
|
||
/* Determin what type of info we are going to display */
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_AND_JUMP);
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void _DtHelpSetupDisplayType(DtHelpDialogWidget nw,
|
||
* int updateType);
|
||
*
|
||
*
|
||
* Parameters: nw Specifies the current help dialog widget.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Determins the type of topic the user want's to display
|
||
* in the current help dialog and sets it up for display.
|
||
*
|
||
*****************************************************************************/
|
||
void _DtHelpSetupDisplayType(
|
||
DtHelpDialogWidget nw,
|
||
Boolean vol_changed,
|
||
int updateType)
|
||
{
|
||
char *templocationId;
|
||
Boolean validAccessPath=FALSE;
|
||
XtPointer topicHandle;
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw ;
|
||
int status=VALID_STATUS;
|
||
char *tmpMessage;
|
||
char *tmpError;
|
||
char *locTitle;
|
||
char *volumeTitle;
|
||
DtTopicListStruct *tmpPtr;
|
||
Boolean adjustTopicTitle=TRUE;
|
||
/* This is a local flag that we use to determine
|
||
* if we need to re-adjust the topic volume title
|
||
* at the end of this
|
||
* Function: True == Modify title, False == leave alone.
|
||
*/
|
||
Boolean didWeHaveAnError=FALSE;
|
||
XmString labelString;
|
||
Arg args[10];
|
||
int n=0;
|
||
|
||
|
||
/* Here we need to store away our current scroll position as the currentlly
|
||
* displayed item is about replaced w/a new item.
|
||
* We already have placed this item in the jump stack, and now are just adding
|
||
* the proper value for our scrollPosition.
|
||
*/
|
||
|
||
if (hw->help_dialog.backtr.pJumpListHead != NULL)
|
||
{
|
||
tmpPtr = hw->help_dialog.backtr.pJumpListHead;
|
||
tmpPtr->scrollPosition =
|
||
_DtHelpGetScrollbarValue(hw->help_dialog.help.pDisplayArea);
|
||
}
|
||
|
||
|
||
/* Here we set our UP, and Home Topic buttons to FALSE, they should be
|
||
* true then the following code will set them correctly.
|
||
*/
|
||
XtSetSensitive(hw->help_dialog.menu.topBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupTopBtn, FALSE);
|
||
|
||
|
||
switch (hw->help_dialog.display.helpType)
|
||
{
|
||
case DtHELP_TYPE_TOPIC:
|
||
|
||
/* Expand the helpVolume resource if needed */
|
||
if ((hw->help_dialog.ghelp.volumeFlag) &&
|
||
(hw->help_dialog.display.volumeHandle != NULL))
|
||
validAccessPath = TRUE;
|
||
else
|
||
if (hw->help_dialog.display.helpVolume != NULL)
|
||
validAccessPath = _DtHelpExpandHelpVolume((Widget)hw,
|
||
&hw->help_dialog.display,
|
||
&hw->help_dialog.help,
|
||
&hw->help_dialog.print);
|
||
|
||
/* If the developer gave us a valid Access Path then we can continue
|
||
* else, we will do nothing
|
||
*/
|
||
if (validAccessPath)
|
||
{
|
||
#if 0
|
||
/* Update our keyword search dialog if needed */
|
||
if ( FALSE == hw->help_dialog.ghelp.volumeFlag)
|
||
_DtHelpGlobSrchUpdateCurVol((Widget) hw);
|
||
|
||
|
||
/* We now set this to true after we update our volumeTitle
|
||
* value in _DtHelpUpdateDisplayArea.
|
||
*/
|
||
|
||
/* hw->help_dialog.ghelp.volumeFlag = TRUE;*/
|
||
#endif
|
||
|
||
/* Setup all the proper lists and display area with the
|
||
* topic string
|
||
*/
|
||
templocationId = XtNewString(hw->help_dialog.display.locationId);
|
||
|
||
/* Set the initial locationId into the display area */
|
||
_DtHelpUpdateDisplayArea(templocationId, hw, vol_changed, updateType,
|
||
DtHELP_TYPE_TOPIC);
|
||
XtFree(templocationId);
|
||
adjustTopicTitle = FALSE;
|
||
|
||
}
|
||
else
|
||
{
|
||
if (hw->help_dialog.display.helpVolume == NULL)
|
||
{
|
||
didWeHaveAnError=TRUE;
|
||
tmpError = XtNewString((char *)_DTGETMESSAGE(2, 60,
|
||
"No help volume specified."));
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea,
|
||
(Widget)hw, tmpError, NULL);
|
||
|
||
_DtHelpUpdateJumpList(tmpError, DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(tmpError);
|
||
XtFree(tmpError);
|
||
}
|
||
else
|
||
{
|
||
/* We cannot find our HelpVolume so display the proper error
|
||
* message in the help dialog and continue.
|
||
*/
|
||
didWeHaveAnError=TRUE;
|
||
tmpMessage = XtNewString((char *)_DTGETMESSAGE(2, 58,
|
||
"The requested online help is either not installed "
|
||
"or not in the proper help search path. For "
|
||
"information on installing online help, consult "
|
||
"the documentation for the product.\n"));
|
||
locTitle = XtNewString((char *)_DTGETMESSAGE(2, 62,
|
||
"Location ID:"));
|
||
volumeTitle = XtNewString((char *)_DTGETMESSAGE(2, 61,
|
||
"Help Volume:"));
|
||
tmpError = XtMalloc(strlen(tmpMessage) +
|
||
strlen(locTitle) +
|
||
strlen(volumeTitle) +
|
||
strlen(hw->help_dialog.display.locationId) +
|
||
strlen(hw->help_dialog.display.helpVolume) + 4);
|
||
(void) strcpy(tmpError, tmpMessage);
|
||
(void) strcat(tmpError, volumeTitle);
|
||
(void) strcat(tmpError, " ");
|
||
(void) strcat(tmpError, hw->help_dialog.display.helpVolume);
|
||
(void) strcat(tmpError,"\n");
|
||
(void) strcat(tmpError, locTitle);
|
||
(void) strcat(tmpError, " ");
|
||
(void) strcat(tmpError, hw->help_dialog.display.locationId);
|
||
|
||
/* Set current path area to null by giving it a null id */
|
||
_DtHelpUpdatePathArea(NULL, hw);
|
||
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea,
|
||
(Widget)hw, tmpError, NULL);
|
||
|
||
_DtHelpUpdateJumpList(tmpError,DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(tmpError);
|
||
|
||
XtFree(tmpError);
|
||
XtFree(tmpMessage);
|
||
XtFree(locTitle);
|
||
XtFree(volumeTitle);
|
||
|
||
}
|
||
}
|
||
|
||
break;
|
||
|
||
case DtHELP_TYPE_STRING:
|
||
|
||
|
||
_DtHelpUpdatePathArea(NULL, hw);
|
||
|
||
/* Set the string to the current help dialog */
|
||
status = _DtHelpFormatAsciiString(hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.stringData,
|
||
&topicHandle);
|
||
if (status >= VALID_STATUS)
|
||
{
|
||
|
||
/* Update the History and Jump Lists */
|
||
if (updateType == DtHISTORY_AND_JUMP)
|
||
_DtHelpUpdateJumpList(hw->help_dialog.display.stringData,
|
||
DtHELP_TYPE_STRING, (Widget) hw);
|
||
|
||
|
||
_DtHelpUpdateHistoryList(hw->help_dialog.display.stringData,
|
||
DtHELP_TYPE_STRING, TRUE, (Widget)hw);
|
||
|
||
_DtHelpDisplayAreaSetList (hw->help_dialog.help.pDisplayArea,
|
||
topicHandle, FALSE,
|
||
hw->help_dialog.backtr.scrollPosition);
|
||
}
|
||
else
|
||
{
|
||
didWeHaveAnError=TRUE;
|
||
tmpError = XtNewString((char *)_DTGETMESSAGE(2, 50,
|
||
"String data could not be formatted."));
|
||
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea, (Widget)hw,
|
||
tmpError, (char*)HDMessage0);
|
||
|
||
_DtHelpUpdateJumpList(tmpError, DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(tmpError);
|
||
XtFree(tmpError);
|
||
}
|
||
|
||
break;
|
||
|
||
case DtHELP_TYPE_DYNAMIC_STRING:
|
||
|
||
_DtHelpUpdatePathArea(NULL, hw);
|
||
|
||
/* Set the string to the current help dialog */
|
||
status = _DtHelpFormatAsciiStringDynamic(
|
||
hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.stringData,
|
||
&topicHandle);
|
||
|
||
if (status >= VALID_STATUS)
|
||
{
|
||
|
||
/* Update the History and Jump Lists */
|
||
if (updateType == DtHISTORY_AND_JUMP)
|
||
_DtHelpUpdateJumpList(hw->help_dialog.display.stringData,
|
||
DtHELP_TYPE_DYNAMIC_STRING, (Widget) hw);
|
||
|
||
_DtHelpUpdateHistoryList(hw->help_dialog.display.stringData,
|
||
DtHELP_TYPE_DYNAMIC_STRING, TRUE, (Widget)hw);
|
||
_DtHelpDisplayAreaSetList (hw->help_dialog.help.pDisplayArea,
|
||
topicHandle, FALSE,
|
||
hw->help_dialog.backtr.scrollPosition);
|
||
}
|
||
else
|
||
{
|
||
didWeHaveAnError=TRUE;
|
||
tmpError = XtNewString((char *)_DTGETMESSAGE(2, 51,
|
||
"Dynamic string data could not be formatted."));
|
||
|
||
_DtHelpUpdateJumpList(tmpError, DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(tmpError);
|
||
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea,(Widget)hw,
|
||
tmpError, (char*) HDMessage1);
|
||
XtFree(tmpError);
|
||
}
|
||
break;
|
||
|
||
case DtHELP_TYPE_MAN_PAGE:
|
||
|
||
_DtHelpUpdatePathArea(NULL, hw);
|
||
|
||
/* Set the string to the current help dialog */
|
||
status = _DtHelpFormatManPage(
|
||
hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.manPage, &topicHandle);
|
||
|
||
if (status >= VALID_STATUS)
|
||
{
|
||
/* Update the History and Jump Lists */
|
||
|
||
if (updateType == DtHISTORY_AND_JUMP)
|
||
_DtHelpUpdateJumpList(hw->help_dialog.display.manPage,
|
||
DtHELP_TYPE_MAN_PAGE, (Widget)hw);
|
||
|
||
_DtHelpUpdateHistoryList(hw->help_dialog.display.manPage,
|
||
DtHELP_TYPE_MAN_PAGE, TRUE, (Widget)hw);
|
||
_DtHelpDisplayAreaSetList (hw->help_dialog.help.pDisplayArea,
|
||
topicHandle, FALSE,
|
||
hw->help_dialog.backtr.scrollPosition);
|
||
}
|
||
else
|
||
{
|
||
didWeHaveAnError=TRUE;
|
||
tmpError = XtNewString((char *)_DTGETMESSAGE(2, 52,
|
||
"Man Page could not be formatted. The requested Man Page is either not present, or corrupt."));
|
||
|
||
_DtHelpUpdateJumpList(tmpError, DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(tmpError);
|
||
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea, (Widget)hw,
|
||
tmpError, (char*) HDMessage2);
|
||
XtFree(tmpError);
|
||
|
||
}
|
||
break;
|
||
|
||
case DtHELP_TYPE_FILE:
|
||
|
||
_DtHelpUpdatePathArea(NULL, hw);
|
||
|
||
/* Set the string to the current help dialog */
|
||
status = _DtHelpFormatAsciiFile(hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.helpFile, &topicHandle);
|
||
|
||
if (status >= VALID_STATUS)
|
||
{
|
||
/* Update the History and Jump Lists */
|
||
|
||
if (updateType == DtHISTORY_AND_JUMP)
|
||
_DtHelpUpdateJumpList(hw->help_dialog.display.helpFile,
|
||
DtHELP_TYPE_FILE,(Widget)hw);
|
||
|
||
_DtHelpUpdateHistoryList(hw->help_dialog.display.helpFile,
|
||
DtHELP_TYPE_FILE, TRUE, (Widget)hw);
|
||
_DtHelpDisplayAreaSetList (hw->help_dialog.help.pDisplayArea,
|
||
topicHandle, FALSE,
|
||
hw->help_dialog.backtr.scrollPosition);
|
||
}
|
||
else
|
||
{
|
||
didWeHaveAnError=TRUE;
|
||
tmpError = XtNewString((char *)_DTGETMESSAGE(2, 53,
|
||
"Text file data could not be formatted. The requested text file is either not present, or corrupt."));
|
||
|
||
_DtHelpUpdateJumpList(tmpError, DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(tmpError);
|
||
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea, (Widget)hw,
|
||
tmpError, (char*) HDMessage3);
|
||
|
||
XtFree(tmpError);
|
||
|
||
}
|
||
break;
|
||
|
||
|
||
default:
|
||
|
||
/* ERROR-MESSAGE */
|
||
/* This means the user used the wrong help type */
|
||
didWeHaveAnError=TRUE;
|
||
tmpError = XtNewString((char *)_DTGETMESSAGE(2, 80,
|
||
"The specified help type is invalid."));
|
||
|
||
_DtHelpUpdateJumpList(tmpError, DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(tmpError);
|
||
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea, (Widget)hw,
|
||
tmpError, (char*) HDMessage4);
|
||
|
||
XtFree(tmpError);
|
||
|
||
break;
|
||
|
||
} /* End Switch Statement */
|
||
|
||
|
||
if ((adjustTopicTitle == TRUE) && (didWeHaveAnError == FALSE))
|
||
{
|
||
/* We have a valid HelpType other than a volume and
|
||
* no error condition, so lets update the Topics title.
|
||
*/
|
||
XtSetArg(args[0], XmNlabelString, hw->help_dialog.display.topicTitleLbl);
|
||
XtSetValues (hw->help_dialog.browser.volumeLabel, args, 1);
|
||
}
|
||
else if (didWeHaveAnError)
|
||
{
|
||
/* error messages displayed, clear out the topics title */
|
||
n=0;
|
||
labelString = XmStringCreateLocalized(" ");
|
||
XtSetArg (args[n], XmNlabelString, labelString); n++;
|
||
XtSetValues (hw->help_dialog.browser.volumeLabel, args, n);
|
||
XmStringFree(labelString);
|
||
if (hw->help_dialog.history.topicList != NULL)
|
||
XmListDeselectAllItems(hw->help_dialog.history.topicList);
|
||
if (hw->help_dialog.history.volumeList != NULL)
|
||
XmListDeselectAllItems(hw->help_dialog.history.volumeList);
|
||
|
||
/* Set current path area to null by giving it a null id */
|
||
_DtHelpUpdatePathArea(NULL, hw);
|
||
}
|
||
|
||
/* Update our keyword search dialog */
|
||
_DtHelpGlobSrchUpdateCurVol((Widget) hw);
|
||
|
||
/* Update the print dialog */
|
||
_DtHelpUpdatePrintDialog(&hw->help_dialog.print,
|
||
&hw->help_dialog.display,&hw->help_dialog.help,False);
|
||
|
||
/* covers error states and non-help topics; case of help topic but
|
||
in/not in the top-level volume is covered elsewhere */
|
||
if ( hw->help_dialog.browser.showTopLevelBtn == TRUE
|
||
&& hw->help_dialog.display.helpType != DtHELP_TYPE_TOPIC)
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxTopLevelBtn, TRUE);
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void _DtHelpUpdateDisplayArea(char *locationId,
|
||
* DtHelpDialogWidget nw,
|
||
* int listUpdateType,
|
||
* int topicUpdateType);
|
||
*
|
||
*
|
||
* Parameters: locationId Specifies the ID string for the new topic we
|
||
* are going to display in the HelpDialog widget.
|
||
*
|
||
* nw Specifies the current help dialog widget.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Updates the Display area with a new Cache Creek Topic.
|
||
*
|
||
*****************************************************************************/
|
||
void _DtHelpUpdateDisplayArea(
|
||
char *locationId,
|
||
DtHelpDialogWidget nw,
|
||
Boolean vol_changed,
|
||
int listUpdateType,
|
||
int topicUpdateType)
|
||
{
|
||
XtPointer topicHandle;
|
||
Boolean validlocationId=FALSE;
|
||
int status=NON_VALID_STATUS;
|
||
char *userErrorStr=NULL;
|
||
char *sysErrorStr=NULL;
|
||
char *tmpMsg=NULL;
|
||
char *retTitle;
|
||
XmString labelString;
|
||
Arg args[10];
|
||
int n=0;
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw;
|
||
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
validlocationId = False; /* default */
|
||
|
||
/* If we have a null idString, assign the top level topic to it */
|
||
if (locationId == NULL
|
||
&& hw->help_dialog.help.topLevelId != NULL)
|
||
{
|
||
locationId = XtNewString(hw->help_dialog.help.topLevelId);
|
||
}
|
||
|
||
if (locationId != NULL)
|
||
{
|
||
XmUpdateDisplay((Widget)hw);
|
||
|
||
/* format the initial locationId info to display */
|
||
status = _DtHelpFormatTopic (
|
||
hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.volumeHandle,
|
||
locationId,
|
||
True,
|
||
&topicHandle);
|
||
|
||
/* unless locationId not found, the topic is valid */
|
||
if (status != -2)
|
||
validlocationId = True;
|
||
} /* if existing loc id, try to format it */
|
||
|
||
if (status == 0) /* success */
|
||
{
|
||
if (hw->help_dialog.ghelp.volumeFlag == FALSE)
|
||
{
|
||
XmFontList fontList;
|
||
Boolean mod = False;
|
||
|
||
XtSetArg(args[0], XmNfontList, &fontList);
|
||
XtGetValues(hw->help_dialog.browser.volumeLabel, args, 1);
|
||
|
||
/* We have a new volume, so update the volume title */
|
||
|
||
_DtHelpFormatVolumeTitle(hw->help_dialog.help.pDisplayArea,
|
||
hw->help_dialog.display.volumeHandle,
|
||
&labelString, &fontList, &mod);
|
||
|
||
if(labelString == NULL && NULL != hw->help_dialog.display.helpVolume)
|
||
labelString = XmStringCreateLocalized(
|
||
hw->help_dialog.display.helpVolume);
|
||
|
||
if (NULL != labelString)
|
||
{
|
||
n = 0;
|
||
XtSetArg (args[n], XmNlabelString, labelString); n++;
|
||
if (mod == True)
|
||
{ XtSetArg (args[n], XmNfontList, fontList); n++; }
|
||
XtSetValues (hw->help_dialog.browser.volumeLabel, args, n);
|
||
XmStringFree(labelString);
|
||
}
|
||
|
||
if (True == mod)
|
||
XmFontListFree(fontList);
|
||
|
||
/* Update our volumeFlag because we know that its we have just,
|
||
* opened a new volume. It will get set to false when we need
|
||
* to process a different help volume, and remain true while
|
||
* processing the current help volume.
|
||
*/
|
||
hw->help_dialog.ghelp.volumeFlag = TRUE;
|
||
} /* if volumeFlag == False */
|
||
|
||
/* Update our history and jump lists */
|
||
if (listUpdateType == DtHISTORY_AND_JUMP)
|
||
{
|
||
_DtHelpUpdateHistoryList(locationId, topicUpdateType,
|
||
vol_changed, (Widget)hw);
|
||
_DtHelpUpdateJumpList(locationId, topicUpdateType,(Widget) hw);
|
||
}
|
||
else if (listUpdateType == DtHISTORY_ONLY)
|
||
_DtHelpUpdateHistoryList(locationId, topicUpdateType,
|
||
vol_changed, (Widget)hw);
|
||
else if (listUpdateType == DtJUMP_ONLY)
|
||
_DtHelpUpdateJumpList(locationId, topicUpdateType,(Widget)hw);
|
||
|
||
/* Adjust our "Top Level" browser home buttons */
|
||
if (hw->help_dialog.browser.showTopLevelBtn == TRUE)
|
||
{
|
||
if (strstr (hw->help_dialog.display.helpVolume, DtBROWSER_NAME) != NULL)
|
||
{
|
||
/* FIX: get top topic of the current volume & compare with locationId */
|
||
if (strcmp (hw->help_dialog.display.locationId, DtBROWSER_HOME)== 0)
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxTopLevelBtn, FALSE);
|
||
else
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxTopLevelBtn, TRUE);
|
||
}
|
||
else
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxTopLevelBtn, TRUE);
|
||
} /* if showTopLevelBtn */
|
||
|
||
/* Check to see if we are going to display the top level is so */
|
||
if (_DtHelpCeIsTopTopic(hw->help_dialog.display.volumeHandle,
|
||
hw->help_dialog.display.locationId) == 0)
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.topBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupTopBtn, FALSE);
|
||
}
|
||
else
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.topBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupTopBtn, TRUE);
|
||
}
|
||
|
||
/* Change the widget instance record locationId field to
|
||
* represent the new locationId being desplayed.
|
||
*/
|
||
XtFree(hw->help_dialog.display.locationId);
|
||
hw->help_dialog.display.locationId = XtNewString(locationId);
|
||
|
||
|
||
/* Update the current path area for the given topic */
|
||
_DtHelpUpdatePathArea(hw->help_dialog.display.locationId, hw);
|
||
|
||
_DtHelpDisplayAreaSetList (hw->help_dialog.help.pDisplayArea,
|
||
topicHandle, FALSE, hw->help_dialog.backtr.scrollPosition);
|
||
|
||
} /* if status == 0 */
|
||
|
||
if (status < 0)
|
||
{
|
||
/* Invalid idString */
|
||
|
||
/* Clear the current volume title label */
|
||
/* ??? Is this the best way to null out a label gadget ??? */
|
||
labelString = XmStringCreateLocalized(" ");
|
||
XtSetArg (args[n], XmNlabelString, labelString);
|
||
XtSetValues (hw->help_dialog.browser.volumeLabel, args, 1);
|
||
XmStringFree(labelString);
|
||
|
||
/* Clear our history dialog selected items */
|
||
if (hw->help_dialog.history.topicList != NULL)
|
||
XmListDeselectAllItems(hw->help_dialog.history.topicList);
|
||
if (hw->help_dialog.history.volumeList != NULL)
|
||
XmListDeselectAllItems(hw->help_dialog.history.volumeList);
|
||
|
||
/* Set current path area to null by giving it a null idStirng */
|
||
_DtHelpUpdatePathArea(NULL, hw);
|
||
|
||
/* De-sensatize our buttons, they do not work
|
||
* with out valid topics.
|
||
*/
|
||
|
||
XtSetSensitive(hw->help_dialog.menu.topBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupTopBtn, FALSE);
|
||
|
||
if (hw->help_dialog.history.pHistoryListHead == NULL)
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.historyBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxHistoryBtn, FALSE);
|
||
}
|
||
else
|
||
{
|
||
/* in case they were desensitized for any reason */
|
||
XtSetSensitive(hw->help_dialog.menu.historyBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxHistoryBtn, TRUE);
|
||
}
|
||
|
||
if (hw->help_dialog.backtr.pJumpListHead != NULL)
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.backBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupBackBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxBackBtn, TRUE);
|
||
}
|
||
|
||
|
||
/* Determin the proper error message to give */
|
||
if (!validlocationId)
|
||
{
|
||
|
||
if (locationId == NULL)
|
||
{
|
||
tmpMsg = (char *)_DTGETMESSAGE(2, 59,
|
||
"No location ID specified.");
|
||
userErrorStr = XtNewString(tmpMsg);
|
||
}
|
||
else
|
||
{
|
||
tmpMsg = (char *)_DTGETMESSAGE(2, 55,
|
||
"Nonexistent location ID:");
|
||
userErrorStr = XtMalloc(strlen(tmpMsg) +
|
||
strlen(hw->help_dialog.display.locationId)+ 2);
|
||
(void) strcpy(userErrorStr, tmpMsg);
|
||
(void) strcat(userErrorStr, " ");
|
||
(void) strcat(userErrorStr, hw->help_dialog.display.locationId);
|
||
sysErrorStr = XtNewString(HDMessage9);
|
||
}
|
||
}
|
||
else
|
||
{
|
||
tmpMsg = (char*)_DTGETMESSAGE(2, 54,
|
||
"Help topic could not be formatted.");
|
||
userErrorStr = XtNewString(tmpMsg);
|
||
sysErrorStr = XtNewString(HDMessage5);
|
||
}
|
||
|
||
|
||
_DtHelpUpdateJumpList(userErrorStr, DtHELP_TYPE_DYNAMIC_STRING,
|
||
(Widget) hw);
|
||
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_DYNAMIC_STRING;
|
||
hw->help_dialog.display.stringData = XtNewString(userErrorStr);
|
||
|
||
_DtHelpDisplayFormatError(hw->help_dialog.help.pDisplayArea, (Widget) hw,
|
||
userErrorStr, sysErrorStr);
|
||
XtFree(userErrorStr);
|
||
XtFree(sysErrorStr);
|
||
} /* if (status < 0) */
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void _DtHelpUpdateJumpList(char *topicInfo,
|
||
* int topicType,
|
||
* DtHelpDialogWidget nw);
|
||
*
|
||
*
|
||
* Parameters: topicInfo Specifies the
|
||
* int Specifies the topicInfo type.
|
||
*
|
||
* nw Specifies the current help dialog widget.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Updates the Jump List with the new topic.
|
||
*
|
||
*****************************************************************************/
|
||
void _DtHelpUpdateJumpList(
|
||
char *topicInfo,
|
||
int topicType,
|
||
Widget nw)
|
||
{
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw ;
|
||
|
||
/* Add the new topic to the top of the jump list */
|
||
/* We add a -1 for the scrollbar position value, and will replace it with the
|
||
* actual value just prior to changing the window to the new topic.
|
||
*/
|
||
_DtHelpTopicListAddToHead(topicInfo, hw->help_dialog.display.topicTitleLbl,
|
||
topicType, DtJUMP_LIST_MAX,
|
||
hw->help_dialog.display.helpVolume,
|
||
&hw->help_dialog.backtr.pJumpListHead,
|
||
&hw->help_dialog.backtr.pJumpListTale,
|
||
&hw->help_dialog.backtr.totalJumpNodes,
|
||
-1);
|
||
|
||
if (hw->help_dialog.backtr.totalJumpNodes <= 1)
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.backBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupBackBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxBackBtn, FALSE);
|
||
}
|
||
else
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.backBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupBackBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxBackBtn, TRUE);
|
||
}
|
||
}
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void ProcessJumpBack(DtHelpDialogWidget nw);
|
||
*
|
||
*
|
||
* Parameters: helpDialogWidget Specifies the current help dialog widget.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Pops the top element in the jump list off the stack
|
||
* and jumps
|
||
*
|
||
* back to that topic.
|
||
*
|
||
*****************************************************************************/
|
||
static void ProcessJumpBack(
|
||
DtHelpDialogWidget nw)
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw ;
|
||
DtTopicListStruct *pTemp= NULL;
|
||
|
||
|
||
/* Pop the top element off our jump list and display the new top element */
|
||
_DtHelpTopicListDeleteHead(&hw->help_dialog.backtr.pJumpListHead,
|
||
&hw->help_dialog.backtr.pJumpListTale,
|
||
&hw->help_dialog.backtr.totalJumpNodes);
|
||
|
||
|
||
|
||
/* Assign pTemp to the current head pointer for or jump list */
|
||
pTemp = hw->help_dialog.backtr.pJumpListHead;
|
||
|
||
if (hw->help_dialog.backtr.totalJumpNodes <= 1)
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.backBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupBackBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxBackBtn, FALSE);
|
||
}
|
||
else
|
||
{
|
||
XtSetSensitive(hw->help_dialog.menu.backBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupBackBtn, TRUE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxBackBtn, TRUE);
|
||
}
|
||
|
||
|
||
/* Assign the jump values to or instance structure variables */
|
||
if (NULL != pTemp->helpVolume &&
|
||
strcmp (hw->help_dialog.display.helpVolume, pTemp->helpVolume) != 0)
|
||
{
|
||
XtFree(hw->help_dialog.display.helpVolume);
|
||
hw->help_dialog.display.helpVolume = XtNewString(pTemp->helpVolume);
|
||
|
||
/* Set our help volume flag so we open the proper volume */
|
||
hw->help_dialog.ghelp.volumeFlag = FALSE;
|
||
|
||
}
|
||
|
||
/* grab the current backtracs's topic title value */
|
||
XmStringFree(hw->help_dialog.display.topicTitleLbl);
|
||
hw->help_dialog.display.topicTitleLbl = XmStringCopy(pTemp->topicTitleLbl);
|
||
|
||
|
||
/* Assign our scrollbar value to our instance structure so we jump to the
|
||
* proper location
|
||
*/
|
||
|
||
hw->help_dialog.backtr.scrollPosition = pTemp->scrollPosition;
|
||
|
||
|
||
hw->help_dialog.display.helpType = pTemp->topicType;
|
||
|
||
switch (pTemp->topicType)
|
||
{
|
||
case DtHELP_TYPE_TOPIC:
|
||
|
||
/* Update our help dialog with top jump element */
|
||
XtFree(hw->help_dialog.display.locationId);
|
||
hw->help_dialog.display.locationId = XtNewString(pTemp->locationId);
|
||
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_ONLY);
|
||
|
||
break;
|
||
|
||
case DtHELP_TYPE_STRING:
|
||
case DtHELP_TYPE_DYNAMIC_STRING:
|
||
XtFree(hw->help_dialog.display.stringData);
|
||
hw->help_dialog.display.stringData = XtNewString(pTemp->locationId);
|
||
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_ONLY);
|
||
|
||
break;
|
||
|
||
case DtHELP_TYPE_MAN_PAGE:
|
||
XtFree(hw->help_dialog.display.manPage);
|
||
hw->help_dialog.display.manPage = XtNewString(pTemp->locationId);
|
||
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_ONLY);
|
||
|
||
break;
|
||
|
||
case DtHELP_TYPE_FILE:
|
||
XtFree(hw->help_dialog.display.helpFile);
|
||
hw->help_dialog.display.helpFile = XtNewString(pTemp->locationId);
|
||
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_ONLY);
|
||
|
||
break;
|
||
|
||
|
||
default:
|
||
|
||
/* ERROR-MESSAGE */
|
||
/* This means the user used the worng help type */
|
||
XmeWarning((Widget)hw, (char*) HDMessage4);
|
||
|
||
break;
|
||
|
||
} /* End Switch Statement */
|
||
|
||
/* reset our scrollPosition back to its default here so in any other case,
|
||
* we jump to the top of the topic
|
||
*/
|
||
hw->help_dialog.backtr.scrollPosition = -1;
|
||
|
||
}
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void _DtHelpDialogHypertextCB(
|
||
* XtPointer pDisplayAreaStruct,
|
||
* XtPointer clientData,
|
||
* DtHelpHyperTextStruct *hyperData.)
|
||
*
|
||
* Parameters: pDisplayAreaStruct Specifies the curretn display are info.
|
||
*
|
||
* clientData Specifies the client data passed into
|
||
* the hypertext callback.
|
||
*
|
||
* hyperData Specifies the current hypertext info
|
||
* structure.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Process all hypertext requests in a given Help Dialogs
|
||
* display area.
|
||
*
|
||
****************************************************************************/
|
||
void _DtHelpDialogHypertextCB (
|
||
XtPointer pDisplayAreaStruct,
|
||
XtPointer clientData,
|
||
DtHelpHyperTextStruct *hyperData)
|
||
{
|
||
char *pTempAccessPath;
|
||
char *pTempLocationId;
|
||
DtHelpDialogCallbackStruct callData;
|
||
char *tmpErrorMsg;
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) clientData ;
|
||
|
||
/* We allow users to force a new window and override the jump-reuse
|
||
* hyper type and force a new window to be used
|
||
*/
|
||
if ( ( ButtonRelease == hyperData->event->type
|
||
&& hyperData->event->xbutton.state & (ControlMask|ShiftMask))
|
||
|| ( KeyPress == hyperData->event->type
|
||
&& hyperData->event->xkey.state & (ControlMask|ShiftMask)))
|
||
hyperData->window_hint = _DtCvWindowHint_NewWindow;
|
||
|
||
|
||
|
||
switch (hyperData->hyper_type)
|
||
{
|
||
|
||
case _DtCvLinkType_SameVolume:
|
||
case _DtCvLinkType_CrossLink:
|
||
|
||
|
||
switch (hyperData->window_hint)
|
||
{
|
||
|
||
case _DtCvWindowHint_CurrentWindow:
|
||
ProcessJumpReuse((Widget)hw, hyperData);
|
||
break;
|
||
|
||
case _DtCvWindowHint_NewWindow:
|
||
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
if (hw->help_dialog.display.hyperLinkCallback != NULL)
|
||
{
|
||
pTempAccessPath =
|
||
_DtHelpParseAccessFile(hyperData->specification);
|
||
|
||
if (pTempAccessPath != NULL) /* Use the New one */
|
||
callData.helpVolume = pTempAccessPath;
|
||
else /* Use the old one */
|
||
callData.helpVolume =
|
||
XtNewString(hw->help_dialog.display.helpVolume);
|
||
|
||
|
||
callData.reason = DtCR_HELP_LINK_ACTIVATE;
|
||
callData.event = hyperData->event;
|
||
callData.locationId = _DtHelpParseIdString
|
||
(hyperData->specification);
|
||
callData.specification = NULL;
|
||
callData.hyperType = DtHELP_LINK_TOPIC;
|
||
callData.windowHint = DtHELP_NEW_WINDOW;
|
||
|
||
/* Now, envoke the apps hyper callback */
|
||
XtCallCallbackList(
|
||
(Widget)hw,hw->help_dialog.display.hyperLinkCallback,&callData);
|
||
}
|
||
else
|
||
{ /* The application did not register a hypertext callback so
|
||
* we must generate the proper warning message and
|
||
* continue!
|
||
*/
|
||
XmeWarning((Widget)hw, (char*) HDMessage6);
|
||
|
||
/* Call jump-reuse procedure for default */
|
||
ProcessJumpReuse((Widget)hw, hyperData);
|
||
}
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
|
||
break;
|
||
|
||
case _DtCvWindowHint_PopupWindow:
|
||
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
pTempAccessPath =
|
||
_DtHelpParseAccessFile(hyperData->specification);
|
||
|
||
if (pTempAccessPath == NULL) /* Use the old one */
|
||
pTempAccessPath = XtNewString(hw->help_dialog.display.helpVolume);
|
||
|
||
pTempLocationId = _DtHelpParseIdString(hyperData->specification);
|
||
|
||
_DtHelpDisplayDefinitionBox((Widget)hw,
|
||
(Widget **)&(hw->help_dialog.ghelp.definitionBox),
|
||
pTempAccessPath, pTempLocationId);
|
||
|
||
XtFree(pTempLocationId);
|
||
XtFree(pTempAccessPath);
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
|
||
break;
|
||
|
||
default:
|
||
|
||
/* Non valid window hint generage the proper
|
||
* error message.
|
||
*/
|
||
|
||
/* ERROR-MESSAGE */
|
||
break;
|
||
|
||
|
||
} /* End Window_hint Switch Statement */
|
||
|
||
break;
|
||
|
||
|
||
|
||
case _DtCvLinkType_Execute:
|
||
_DtHelpExecFilteredCmd((Widget) hw,
|
||
hyperData->specification, DtHELP_ExecutionPolicy_STR,
|
||
&hw->help_dialog.display, &hw->help_dialog.help);
|
||
break;
|
||
|
||
|
||
case _DtCvLinkType_ManPage:
|
||
case _DtCvLinkType_AppDefine:
|
||
case _DtCvLinkType_TextFile:
|
||
|
||
/* Process Application Man page link or App Defined link types */
|
||
_DtHelpTurnOnHourGlass(XtParent(hw));
|
||
|
||
/* If the application registered a hypertext callback use it! */
|
||
if (hw->help_dialog.display.hyperLinkCallback != NULL)
|
||
{
|
||
|
||
/* Setup the DtHyperProcStructer to pass back to the
|
||
* client as callData.
|
||
*/
|
||
callData.reason = DtCR_HELP_LINK_ACTIVATE;
|
||
callData.event = hyperData->event;
|
||
callData.locationId = NULL;
|
||
callData.helpVolume = NULL;
|
||
if (_DtCvLinkType_AppDefine == hyperData->hyper_type)
|
||
{
|
||
callData.locationId =
|
||
_DtHelpParseIdString(hyperData->specification);
|
||
callData.helpVolume =
|
||
XtNewString(hw->help_dialog.display.helpVolume);
|
||
}
|
||
callData.specification = hyperData->specification;
|
||
callData.hyperType = hyperData->hyper_type;
|
||
callData.windowHint = hyperData->window_hint;
|
||
|
||
XtCallCallbackList ((Widget) hw,
|
||
hw->help_dialog.display.hyperLinkCallback, &callData);
|
||
}
|
||
else
|
||
{
|
||
/* The application did not register a hypertext
|
||
* callback so we must generate the proper error
|
||
* message and continue!
|
||
*/
|
||
XmeWarning((Widget)hw, (char*) HDMessage8);
|
||
|
||
if (hyperData->hyper_type == DtHELP_LINK_APP_DEFINE)
|
||
{
|
||
tmpErrorMsg = XtNewString((char *)_DTGETMESSAGE(2, 56,
|
||
"The selected Hypertext link is not supported within this application."));
|
||
_DtHelpErrorDialog(XtParent(hw),tmpErrorMsg);
|
||
}
|
||
else
|
||
{
|
||
tmpErrorMsg = XtNewString((char *)_DTGETMESSAGE(2, 57,
|
||
"Links to Man Pages are not supported by this application."));
|
||
_DtHelpErrorDialog(XtParent(hw),tmpErrorMsg);
|
||
|
||
}
|
||
XtFree(tmpErrorMsg);
|
||
|
||
}
|
||
|
||
_DtHelpTurnOffHourGlass(XtParent(hw));
|
||
break;
|
||
|
||
default: /* This catches bogus link types */
|
||
|
||
/* Non valid link type so we are dropping it and are generating
|
||
* the proper error message.
|
||
*/
|
||
|
||
/* ERROR-MESSAGE */
|
||
XmeWarning((Widget)hw, (char*) HDMessage7);
|
||
break;
|
||
|
||
|
||
} /* End Switch Statement */
|
||
|
||
|
||
} /* End _DtHelpDialogHypertextCB */
|
||
|
||
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void ResizeHelpDialogCB()
|
||
*
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Adjust the widget instance values for rows and columns.
|
||
*
|
||
****************************************************************************/
|
||
static void ResizeHelpDialogCB (
|
||
XtPointer clientData)
|
||
{
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) clientData ;
|
||
|
||
|
||
/* Re-Set our rows and colums values */
|
||
if ((hw->help_dialog.help.pDisplayArea != NULL) &&
|
||
hw->help_dialog.display.firstTimePopupFlag == TRUE)
|
||
_DtHelpDisplayAreaDimensionsReturn (hw->help_dialog.help.pDisplayArea,
|
||
&(hw->help_dialog.display.textRows),
|
||
&(hw->help_dialog.display.textColumns));
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: static void ProcessJumpReuse(nw, hyperData)
|
||
* Widget nw;
|
||
* DtHelpHyperTextStruct *hyperData;
|
||
*
|
||
* Parameters: nw Specifies the widget ID of the current help dialog
|
||
* widget.
|
||
*
|
||
* hyperData Specifies the hypertext data callback struct.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Process the jump-reuse hypertext link data.
|
||
*
|
||
*****************************************************************************/
|
||
static void ProcessJumpReuse(
|
||
Widget nw,
|
||
DtHelpHyperTextStruct *hyperData)
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw;
|
||
char *pTempAccessPath;
|
||
char *pTempLocationId;
|
||
|
||
|
||
/* Parse our specification into the proper fields in our instance
|
||
* record.
|
||
*/
|
||
|
||
pTempAccessPath = _DtHelpParseAccessFile(hyperData->specification);
|
||
|
||
if (pTempAccessPath != NULL)
|
||
{
|
||
/* Free the old one and assign the new path */
|
||
XtFree(hw->help_dialog.display.helpVolume);
|
||
hw->help_dialog.display.helpVolume = pTempAccessPath;
|
||
hw->help_dialog.ghelp.volumeFlag = FALSE;
|
||
}
|
||
|
||
/* Free old copy fisrt ??? */
|
||
pTempLocationId = _DtHelpParseIdString(hyperData->specification);
|
||
XtFree(hw->help_dialog.display.locationId);
|
||
hw->help_dialog.display.locationId = pTempLocationId;
|
||
hw->help_dialog.display.helpType = DtHELP_TYPE_TOPIC;
|
||
|
||
_DtHelpSetupDisplayType(hw, TRUE, DtHISTORY_AND_JUMP);
|
||
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void _DtHelpTopicListFree (DtTopicListStruct *pHead);
|
||
*
|
||
*
|
||
* Parameters: pHead Specifies the head pointer to the topic list.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Frees all elements in a Topic List.
|
||
*
|
||
*****************************************************************************/
|
||
void _DtHelpTopicListFree(
|
||
DtTopicListStruct *pHead)
|
||
{
|
||
DtTopicListStruct *pTemp=NULL;
|
||
|
||
|
||
while (pHead != NULL)
|
||
{
|
||
/* Free up each element in the current node */
|
||
pTemp = pHead;
|
||
pHead = pHead->pNext;
|
||
pTemp->pNext = NULL;
|
||
pTemp->pPrevious = NULL;
|
||
|
||
/* Free the id String and AccessPath elements */
|
||
XtFree(pTemp->locationId);
|
||
XtFree(pTemp->helpVolume);
|
||
XmStringFree(pTemp->topicTitleLbl);
|
||
|
||
/* Now, free the whole node */
|
||
XtFree((char *)pTemp);
|
||
|
||
}
|
||
|
||
|
||
|
||
}
|
||
|
||
|
||
|
||
/*****************************************************************************
|
||
* Function: void CleanUpHelpDialog(DtHelpDialogWidget nw,
|
||
* int cleanUpKind);
|
||
*
|
||
*
|
||
* Parameters: nw Specifies the current help dialog widget.
|
||
* cleanUpKind Specifies the type of clean up we are doing,
|
||
* celan up and reuse or clean up and destroy.
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: This function will re-initializes a Help Dialog Widget to
|
||
* known good starting values or clean up in prepretion for
|
||
* an impending destroy.
|
||
*
|
||
*****************************************************************************/
|
||
static void CleanUpHelpDialog(
|
||
Widget nw,
|
||
int cleanUpKind)
|
||
{
|
||
Arg args[10];
|
||
|
||
DtHistoryListStruct *pTempVolume=NULL;
|
||
DtHistoryListStruct *pTempVolumeCurrent=NULL;
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw;
|
||
|
||
|
||
XtFree(hw->help_dialog.print.printVolume);
|
||
hw->help_dialog.print.printVolume = NULL;
|
||
|
||
/* must clean volume list and topic list from history */
|
||
pTempVolume = hw->help_dialog.history.pHistoryListHead;
|
||
while (pTempVolume != NULL)
|
||
{
|
||
_DtHelpTopicListFree(pTempVolume->pTopicHead);
|
||
pTempVolumeCurrent = pTempVolume;
|
||
pTempVolume = pTempVolume->pNext;
|
||
|
||
XmStringFree(pTempVolumeCurrent->itemTitle);
|
||
XtFree((char *)pTempVolumeCurrent);
|
||
}
|
||
hw->help_dialog.history.pHistoryListHead = NULL;
|
||
|
||
_DtHelpTopicListFree(hw->help_dialog.history.pPathListHead);
|
||
hw->help_dialog.history.pPathListHead = NULL;
|
||
hw->help_dialog.history.pPathListTale = NULL;
|
||
hw->help_dialog.history.totalPathNodes = 0;
|
||
|
||
|
||
/* Free our jump list display stuff */
|
||
_DtHelpTopicListFree(hw->help_dialog.backtr.pJumpListHead);
|
||
hw->help_dialog.backtr.pJumpListHead = NULL;
|
||
hw->help_dialog.backtr.pJumpListTale = NULL;
|
||
hw->help_dialog.backtr.totalJumpNodes = 0;
|
||
|
||
|
||
/* do nothing for index search dialog on a Clean for Reuse */
|
||
|
||
/* Close our current help volume */
|
||
if (hw->help_dialog.display.volumeHandle != NULL)
|
||
{
|
||
_DtHelpCloseVolume(hw->help_dialog.display.volumeHandle);
|
||
hw->help_dialog.display.volumeHandle = NULL;
|
||
}
|
||
|
||
/* Depending on weither we are just closing this help dialog or destroying
|
||
* it we will do the following!
|
||
*/
|
||
|
||
if (cleanUpKind == DtCLEAN_FOR_DESTROY)
|
||
{
|
||
|
||
/* Free any remaining char * values we malloc'ed in our help dialog */
|
||
XtFree(hw->help_dialog.display.locationId);
|
||
XtFree(hw->help_dialog.display.helpVolume);
|
||
|
||
XtFree(hw->help_dialog.display.manPage);
|
||
XtFree(hw->help_dialog.display.stringData);
|
||
XtFree(hw->help_dialog.display.helpFile);
|
||
XtFree(hw->help_dialog.display.topicTitleStr);
|
||
if (hw->help_dialog.display.topicTitleLbl != NULL)
|
||
XmStringFree(hw->help_dialog.display.topicTitleLbl);
|
||
|
||
XtFree(hw->help_dialog.ghelp.parentId);
|
||
|
||
XtFree(hw->help_dialog.print.printer);
|
||
if (hw->help_dialog.print.helpPrint != _DtHelpDefaultHelpPrint)
|
||
XtFree(hw->help_dialog.print.helpPrint);
|
||
|
||
/* Clean and close and destroy (True) our index search dialog */
|
||
_DtHelpGlobSrchCleanAndClose(&hw->help_dialog.srch,True);
|
||
|
||
/* Set our current topic variables to initial values */
|
||
_DtHelpCommonHelpClean(&hw->help_dialog.help,True);
|
||
}
|
||
else
|
||
{
|
||
|
||
/* Reset our buttons to the proper state */
|
||
XtSetSensitive(hw->help_dialog.menu.backBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.menu.popupBackBtn, FALSE);
|
||
XtSetSensitive(hw->help_dialog.browser.btnBoxBackBtn, FALSE);
|
||
|
||
/* Clean and close our index search dialog */
|
||
_DtHelpGlobSrchCleanAndClose(&hw->help_dialog.srch,False);
|
||
|
||
if (hw->help_dialog.history.historyWidget != NULL)
|
||
{
|
||
XtUnmanageChild(hw->help_dialog.history.historyWidget);
|
||
}
|
||
|
||
if (hw->help_dialog.print.printForm != NULL)
|
||
{
|
||
XtUnmanageChild(hw->help_dialog.print.printForm);
|
||
}
|
||
|
||
/* Free our history display stuff */
|
||
if (hw->help_dialog.history.volumeList != NULL)
|
||
{
|
||
XtSetArg(args[0], XmNitems, NULL);
|
||
XtSetArg(args[1], XmNitemCount, 0);
|
||
XtSetValues(hw->help_dialog.history.volumeList, args, 2);
|
||
}
|
||
if (hw->help_dialog.history.topicList != NULL)
|
||
{
|
||
XtSetArg(args[0], XmNitems, NULL);
|
||
XtSetArg(args[1], XmNitemCount, 0);
|
||
XtSetValues(hw->help_dialog.history.topicList, args, 2);
|
||
}
|
||
|
||
/* Set our toc areay area to a null starting vlaues */
|
||
_DtHelpDisplayAreaClean(hw->help_dialog.browser.pTocArea);
|
||
|
||
/* Set our current topic variables to initial values */
|
||
_DtHelpCommonHelpClean(&hw->help_dialog.help,False);
|
||
}
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
/****************************************************************************
|
||
* Function: CatchClose( Widget w);
|
||
*
|
||
* Parameters:
|
||
*
|
||
* Return Value: Void.
|
||
*
|
||
* Purpose: Catches the window manager close requests and assigns our
|
||
* CloseHelpCB to handel them.
|
||
*
|
||
***************************************************************************/
|
||
static void CatchClose (
|
||
Widget widget)
|
||
{
|
||
|
||
Atom wm_delete_window;
|
||
Arg args[2];
|
||
|
||
/* Grab the window mgr close */
|
||
wm_delete_window = XmInternAtom(XtDisplay(XtParent(widget)),
|
||
"WM_DELETE_WINDOW", FALSE);
|
||
XtSetArg(args[0], XmNdeleteResponse, XmDO_NOTHING);
|
||
|
||
/* Current Help Dialog Window */
|
||
XmAddWMProtocolCallback(XtParent(widget),wm_delete_window,
|
||
(XtCallbackProc)CloseHelpCB, (XtPointer) widget);
|
||
XtSetValues(XtParent(widget), args, 1);
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
/************************************************************************
|
||
* Function: CloseHelpCB()
|
||
*
|
||
* Close the Help Dialog Window
|
||
*
|
||
************************************************************************/
|
||
static void CloseHelpCB (
|
||
Widget w,
|
||
XtPointer clientData,
|
||
XtPointer callData)
|
||
{
|
||
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) clientData;
|
||
DtHelpDialogCallbackStruct callDataInfo;
|
||
XmPushButtonCallbackStruct *callbackStruct =
|
||
(XmPushButtonCallbackStruct*) callData;
|
||
|
||
/*
|
||
* Check to see if a selection is in process.
|
||
* If so, cancel the selection and don't close the dialog
|
||
*/
|
||
if (_DtHelpCancelSelection(hw->help_dialog.help.pDisplayArea) == True)
|
||
return;
|
||
|
||
/* No selection in progress. Close the dialog.
|
||
*
|
||
* ??? By definition, when a user closes a Help Dialog if it is
|
||
* used again by the application the state will be new. So we should
|
||
* flush out any info currently in the help, history, and search dialogs.
|
||
*/
|
||
|
||
CleanUpHelpDialog((Widget)hw, DtCLEAN_FOR_REUSE);
|
||
|
||
/* Look to see if they registered their own close callback */
|
||
if (hw->help_dialog.ghelp.closeCallback != NULL)
|
||
{
|
||
callDataInfo.reason = DtCR_HELP_CLOSE;
|
||
callDataInfo.event = callbackStruct->event;
|
||
callDataInfo.locationId = NULL;
|
||
callDataInfo.helpVolume = NULL;
|
||
callDataInfo.specification = NULL;
|
||
callDataInfo.hyperType = 0;
|
||
|
||
|
||
/* All we do is envoke the applications close callback */
|
||
XtCallCallbackList((Widget)hw,hw->help_dialog.ghelp.closeCallback,
|
||
(XtPointer) &callDataInfo);
|
||
}
|
||
else
|
||
XtUnmanageChild((Widget)hw);
|
||
|
||
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
/*********************************************************************
|
||
* Function: SetupHelpDialogMenus
|
||
*
|
||
* This procedure build the menubar pulldows buttons for the Index
|
||
* Browser and the Topic Viewer.
|
||
*
|
||
* Called by: MakeIndexWindow, and MakeTopicWindow.
|
||
*********************************************************************/
|
||
static Widget SetupHelpDialogMenus(
|
||
Widget parent)
|
||
{
|
||
Widget menuBar;
|
||
Widget c[10];
|
||
Widget cascadeB5;
|
||
Widget menupane1, menupane2, menupane3, menupane4, menupane5;
|
||
Widget helpBtn1, helpBtn2, helpBtn3, helpBtn4, helpBtn5, helpBtn6;
|
||
Arg args[10];
|
||
int n;
|
||
XmString labelStr;
|
||
char *mnemonic;
|
||
DtHelpListStruct *pHelpInfo;
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) parent;
|
||
|
||
|
||
/* Build the menubar */
|
||
|
||
n = 0;
|
||
menuBar = XmCreateMenuBar (parent, "menuBar", args, n);
|
||
XtManageChild (menuBar);
|
||
|
||
|
||
/*******************************************************
|
||
* Menupane: Close, and related buttons
|
||
*******************************************************/
|
||
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmarginWidth, 0); ++n;
|
||
XtSetArg(args[n], XmNmarginHeight, 0); ++n;
|
||
menupane1 = XmCreatePulldownMenu(menuBar, "fileMenu", args, n);
|
||
|
||
/* Add callback for File Menu */
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_FileMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback((Widget) menupane1, XmNhelpCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
|
||
/* Print button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 1,"Print...")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 2,"P"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[0] = hw->help_dialog.menu.printBtn = XmCreatePushButtonGadget(menupane1,
|
||
"print", args, n);
|
||
XtAddCallback(hw->help_dialog.menu.printBtn,XmNactivateCallback,
|
||
DisplayPrintCB, (XtPointer) hw);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
if (hw->help_dialog.menu.showDupBtn == True)
|
||
{
|
||
/* Duplicate button */
|
||
labelStr = XmStringCreateLocalized(((char *)
|
||
_DTGETMESSAGE(2, 5,"New Window...")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 6,"W"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[1] = hw->help_dialog.menu.newWindowBtn =
|
||
XmCreatePushButtonGadget(menupane1,"newWindowBtn", args, n);
|
||
XtAddCallback(hw->help_dialog.menu.newWindowBtn,XmNactivateCallback,
|
||
_DtHelpDuplicateWindowCB, (XtPointer) hw);
|
||
XmStringFree(labelStr);
|
||
|
||
/* Exit button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 3,"Close")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 4,"C"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[2] = hw->help_dialog.menu.closeBtn =
|
||
XmCreatePushButtonGadget(menupane1,"close", args, n);
|
||
|
||
XtAddCallback(hw->help_dialog.menu.closeBtn,XmNactivateCallback,
|
||
CloseHelpCB, (XtPointer) hw);
|
||
XmStringFree(labelStr);
|
||
|
||
/* set the cancel button (for KCancel) */
|
||
hw->bulletin_board.cancel_button= hw->help_dialog.menu.closeBtn;
|
||
|
||
|
||
/* Manage the children for the File menu pane */
|
||
XtManageChildren(c, 3);
|
||
|
||
}
|
||
else
|
||
{
|
||
/* Exit button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 3,"Close")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 4,"C"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[1] = hw->help_dialog.menu.closeBtn =
|
||
XmCreatePushButtonGadget(menupane1,"close", args, n);
|
||
|
||
XtAddCallback(hw->help_dialog.menu.closeBtn,XmNactivateCallback,
|
||
CloseHelpCB, (XtPointer) hw);
|
||
XmStringFree(labelStr);
|
||
|
||
/* set the cancel button (for KCancel) */
|
||
hw->bulletin_board.cancel_button= hw->help_dialog.menu.closeBtn;
|
||
|
||
/* Manage the children for the File menu pane */
|
||
XtManageChildren(c, 2);
|
||
}
|
||
|
||
|
||
/*******************************************************
|
||
* Menupane: Edit, (Copy)
|
||
*******************************************************/
|
||
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmarginWidth, 0); ++n;
|
||
XtSetArg(args[n], XmNmarginHeight, 0); ++n;
|
||
menupane2 = XmCreatePulldownMenu(menuBar, "editMenu", args, n);
|
||
|
||
/* Add callback for Edit Menu */
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_EditMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback((Widget) menupane2, XmNhelpCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
/* Edit button */
|
||
labelStr = XmStringCreateLocalized((
|
||
(char *)_DTGETMESSAGE(2,7,"Copy")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 8,"C"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[0] = hw->help_dialog.menu.copyBtn = XmCreatePushButtonGadget
|
||
(menupane2, "copy", args, n);
|
||
XtAddCallback(hw->help_dialog.menu.copyBtn,XmNactivateCallback,
|
||
CopyTextCB, (XtPointer) hw);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
XtManageChildren(c, 1);
|
||
|
||
|
||
/*******************************************************
|
||
* Menupane: Search, (Topic Index)
|
||
*******************************************************/
|
||
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmarginWidth, 0); ++n;
|
||
XtSetArg(args[n], XmNmarginHeight, 0); ++n;
|
||
menupane3 = XmCreatePulldownMenu(menuBar, "searchMenu", args, n);
|
||
|
||
/* Add callback for Search Menu */
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_SearchMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback((Widget) menupane3, XmNhelpCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
/* Search button */
|
||
labelStr = XmStringCreateLocalized((
|
||
(char *)_DTGETMESSAGE(2, 9,"Index...")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 10,"I"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[0] = hw->help_dialog.menu.keyBtn = XmCreatePushButtonGadget
|
||
(menupane3, "keyword", args, n);
|
||
XtAddCallback(hw->help_dialog.menu.keyBtn,XmNactivateCallback,
|
||
_DtHelpDisplayIndexCB, (XtPointer) hw);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
XtManageChildren(c, 1);
|
||
|
||
|
||
|
||
/*******************************************************
|
||
* Menupane: Navigate, and related buttons
|
||
*******************************************************/
|
||
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmarginWidth, 0); ++n;
|
||
XtSetArg(args[n], XmNmarginHeight, 0); ++n;
|
||
menupane4 = XmCreatePulldownMenu(menuBar, "navigateMenu", args, n);
|
||
|
||
/* Add callback for Navigate Menu */
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_NavigateMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback((Widget) menupane4 , XmNhelpCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
|
||
/* Back Button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 13,"Backtrack")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 14,"B"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[0] = hw->help_dialog.menu.backBtn = XmCreatePushButtonGadget(menupane4,
|
||
"backTrack", args, n);
|
||
XtAddCallback(hw->help_dialog.menu.backBtn,XmNactivateCallback,
|
||
_DtHelpDisplayBackCB, (XtPointer) hw);
|
||
XtSetSensitive(hw->help_dialog.menu.backBtn, FALSE);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* Top Button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 11,"Home Topic")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 12,"T"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[1] = hw->help_dialog.menu.topBtn = XmCreatePushButtonGadget(menupane4,
|
||
"homeTopic", args, n);
|
||
XtAddCallback(hw->help_dialog.menu.topBtn,XmNactivateCallback,
|
||
DisplayTopLevelCB, (XtPointer) hw);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* Place a menu break here */
|
||
n = 0;
|
||
c[2] = XmCreateSeparatorGadget(menupane4, "seporator",args, n);
|
||
|
||
/* History Button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 15,"History...")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 16,"H"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[3] = hw->help_dialog.menu.historyBtn = XmCreatePushButtonGadget(menupane4,
|
||
"history",args, n);
|
||
|
||
XtAddCallback(hw->help_dialog.menu.historyBtn,XmNactivateCallback,
|
||
_DtHelpDisplayHistoryCB, (XtPointer) hw);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* Manage all the children of this manu pane */
|
||
XtManageChildren(c, 4);
|
||
|
||
|
||
|
||
|
||
/*******************************************************
|
||
* Menupane: Help, and related buttons
|
||
*******************************************************/
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmarginWidth, 0); ++n;
|
||
XtSetArg(args[n], XmNmarginHeight, 0); ++n;
|
||
menupane5 = XmCreatePulldownMenu(menuBar, "helpMenu", args, n);
|
||
|
||
/* Add callback for Help Menu */
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_HelpMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback((Widget) menupane5, XmNhelpCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
/* On HELP button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 17,"Overview - Using Help")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 18,"v"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[0] = helpBtn1 = XmCreatePushButtonGadget(menupane5,
|
||
"usingHelp", args, n);
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_onHelpMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback(helpBtn1, XmNactivateCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* Place a menu break here */
|
||
n = 0;
|
||
c[1] = XmCreateSeparatorGadget(menupane5, "seporator",args, n);
|
||
|
||
|
||
/* On Table Of Contents Help button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2,19,"Table Of Contents")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 20, "C"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[2] = helpBtn2 = XmCreatePushButtonGadget(menupane5,
|
||
"tableOfContents", args, n);
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_onTableOfContenseMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback(helpBtn2, XmNactivateCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* On Tasks Help button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 21,"Tasks")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 22, "T"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[3] = helpBtn3 = XmCreatePushButtonGadget(menupane5,
|
||
"tasks", args, n);
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_onTasksMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback(helpBtn3, XmNactivateCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* On Reference button */
|
||
labelStr = XmStringCreateLocalized(((char *)
|
||
_DTGETMESSAGE(2, 23,"Reference")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 24,"R"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[4] = helpBtn4 = XmCreatePushButtonGadget(menupane5,
|
||
"reference",args, n);
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_onReferenceMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback(helpBtn4, XmNactivateCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* On Mouse & Keyboard button */
|
||
labelStr = XmStringCreateLocalized(((char *)
|
||
_DTGETMESSAGE(2, 25,"Mouse and Keyboard")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 26,"M"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[5] = helpBtn5 = XmCreatePushButtonGadget(menupane5,
|
||
"reference",args, n);
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_onMouseAndKeysMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback(helpBtn5, XmNactivateCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* Place a menu break here */
|
||
n = 0;
|
||
c[6] = XmCreateSeparatorGadget(menupane5, "seporator",args, n);
|
||
|
||
/* On Version */
|
||
labelStr = XmStringCreateLocalized(((char *)
|
||
_DTGETMESSAGE(2, 27,"About Help")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 28,"A"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[7] = helpBtn6 = XmCreatePushButtonGadget(menupane5,
|
||
"reference",args, n);
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_onVersionMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback(helpBtn6, XmNactivateCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
XmStringFree(labelStr);
|
||
|
||
|
||
/* Manage the children for the Help menu pane */
|
||
XtManageChildren(c, 8);
|
||
|
||
|
||
|
||
/* Create Cascade buttons for menubar */
|
||
|
||
/* File Menu */
|
||
labelStr = XmStringCreateLocalized(((char *) _DTGETMESSAGE(2, 29,"File")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 30,"F"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
XtSetArg(args[n], XmNsubMenuId, menupane1); n++;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
c[0] = XmCreateCascadeButton(menuBar,"file",args, n);
|
||
XmStringFree(labelStr);
|
||
|
||
/* Edit Menu */
|
||
labelStr = XmStringCreateLocalized(((char *) _DTGETMESSAGE(2, 37,"Edit")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 38,"E"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
XtSetArg(args[n], XmNsubMenuId, menupane2); n++;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
c[1] = XmCreateCascadeButton(menuBar, "edit", args, n);
|
||
XmStringFree(labelStr);
|
||
|
||
/* Search Menu */
|
||
labelStr = XmStringCreateLocalized(((char *) _DTGETMESSAGE(2, 31,"Search")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 32,"S"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
XtSetArg(args[n], XmNsubMenuId, menupane3); n++;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
c[2] = XmCreateCascadeButton(menuBar, "search", args, n);
|
||
XmStringFree(labelStr);
|
||
|
||
/* Navigate Menu */
|
||
labelStr = XmStringCreateLocalized(((char *) _DTGETMESSAGE(2, 33,"Navigate")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 34,"N"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
XtSetArg(args[n], XmNsubMenuId, menupane4); n++;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
c[3] = XmCreateCascadeButton(menuBar, "navigate", args, n);
|
||
XmStringFree(labelStr);
|
||
|
||
/* Help Menu */
|
||
labelStr = XmStringCreateLocalized(((char *) _DTGETMESSAGE(2, 35,"Help")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 36,"H"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
XtSetArg(args[n], XmNsubMenuId, menupane5); n++;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
c[4] = cascadeB5 = XmCreateCascadeButton(menuBar, "help", args, n);
|
||
XmStringFree(labelStr);
|
||
|
||
XtManageChildren(c, 5);
|
||
|
||
|
||
/* Attaches the Help menupane to the right side */
|
||
n = 0;
|
||
XtSetArg (args[n], XmNmenuHelpWidget, cascadeB5); n++;
|
||
XtSetValues (menuBar, args, n);
|
||
|
||
|
||
return(menuBar);
|
||
|
||
|
||
} /* End SetupHelpDialogMenus */
|
||
|
||
|
||
|
||
|
||
/*********************************************************************
|
||
* Function: CreatePopupMenu
|
||
*
|
||
* This procedure builds the popup menu for the display area
|
||
*
|
||
**********************************************************************/
|
||
static Widget CreatePopupMenu(
|
||
Widget nw)
|
||
{
|
||
Widget popup;
|
||
Widget c[10];
|
||
Arg args[10];
|
||
int n;
|
||
XmString labelStr;
|
||
DtHelpDialogWidget hw = (DtHelpDialogWidget) nw;
|
||
DtHelpListStruct *pHelpInfo;
|
||
char *mnemonic;
|
||
int numButtons = XGetPointerMapping(XtDisplay(nw),(unsigned char *)NULL, 0);
|
||
|
||
/* Build the popup */
|
||
/* If no Btn3 then use Btn2 to post the menu */
|
||
n = 0;
|
||
if (numButtons < 3) {
|
||
XtSetArg(args[n], XmNwhichButton, Button2); n++;
|
||
}
|
||
popup = XmCreatePopupMenu (
|
||
_DtHelpDisplayAreaWidget(hw->help_dialog.help.pDisplayArea),
|
||
"popup", args, n);
|
||
|
||
/* Add our button three event handler to our newly created display area */
|
||
XtAddEventHandler(
|
||
_DtHelpDisplayAreaWidget(hw->help_dialog.help.pDisplayArea),
|
||
ButtonPressMask, FALSE,
|
||
(XtEventHandler)ProcessBMenuBackCB, hw);
|
||
|
||
/* Add Help callback for Popup Menu */
|
||
pHelpInfo = _DtHelpListAdd(DtHELP_PopupMenu_STR,
|
||
(Widget) hw, &hw->help_dialog.help,
|
||
&hw->help_dialog.help.pHelpListHead);
|
||
XtAddCallback((Widget) popup, XmNhelpCallback,
|
||
_DtHelpCB, (XtPointer) pHelpInfo);
|
||
|
||
/* Build the popup menu items */
|
||
|
||
/* Popup Label*/
|
||
labelStr = XmStringCreateLocalized(((char *) _DTGETMESSAGE(3, 4,"Help")));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
c[0] = XmCreateLabelGadget(popup, "popupLabel", args, n);
|
||
XmStringFree(labelStr);
|
||
|
||
/* Place a menu break here */
|
||
n = 0;
|
||
c[1] = XmCreateSeparatorGadget(popup, "seporator",args, n);
|
||
|
||
|
||
/* Back Button */
|
||
labelStr = XmStringCreateLocalized(((char *) _DTGETMESSAGE(2, 13,"Backtrack")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 14,"B"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[2] = hw->help_dialog.menu.popupBackBtn = XmCreatePushButtonGadget(popup,
|
||
"backTrack", args, n);
|
||
XmStringFree(labelStr);
|
||
|
||
XtAddCallback(hw->help_dialog.menu.popupBackBtn,XmNactivateCallback,
|
||
_DtHelpDisplayBackCB, (XtPointer) hw);
|
||
XtSetSensitive(hw->help_dialog.menu.popupBackBtn, FALSE);
|
||
|
||
|
||
/* Top Button */
|
||
labelStr = XmStringCreateLocalized(((char *)_DTGETMESSAGE(2, 11,"Home Topic")));
|
||
mnemonic = ((char *)_DTGETMESSAGE(2, 12,"T"));
|
||
n = 0;
|
||
XtSetArg(args[n], XmNlabelString, labelStr); n++;
|
||
XtSetArg(args[n], XmNmnemonic, mnemonic[0]); n++;
|
||
c[3] = hw->help_dialog.menu.popupTopBtn = XmCreatePushButtonGadget(popup,
|
||
"homeTopic", args, n);
|
||
XmStringFree(labelStr);
|
||
XtAddCallback(hw->help_dialog.menu.popupTopBtn,XmNactivateCallback,
|
||
DisplayTopLevelCB, (XtPointer) hw);
|
||
|
||
XtManageChildren(c, 4);
|
||
|
||
return(popup);
|
||
|
||
|
||
}
|