DC Help Authority

Overview

DC.HelpAuthority is a COM based component that allows you to assign a sensitive help for every control in within your form or even every column in your grid

DC.HelpAuthority may be used with any developing language support COM based application like Visual Basic,Visual C++,Borland C++,Delphi and others ..

EgyFirst has done a lot of work for you. now you can develop your application and make it comprehensive by supporting it with your sensitive help

Features

DC.HelpAuthority enables you to put the finish touch to your application by adding sensetive help to every control in your form , any column in your grid when you press F12 key this will trigger your sensitive help for focused control or column

Example:

Dim HA As New DynamicComponents.HelpAuthority()

HA.PrepareHelp(CN, Me, Me.AxDataGrid1)

System Requirements

DC.HelpAuthority runs as a COM class for Developing with Visual Basic.Net underMicrosoft Windows 98/NT/ 2000 or Windows XP.

Installing DC.HelpAuthority

The DC.HelpAuthority setup program will automatically register theDC_HelpAuthority10.dll file on your system.

There is no need to manually run RegSvr32.exe on your development system.

Including DC.HelpAuthority

To include DC.HelpAuthorityin your project

  1. From Project menu select add reference
  2. Push Browse button to locate your DC_HelpAuthority10.DLL file which by default located in c:\windows\system32 , now the specific DLL included in your references

Deploying DC.HelpAuthority Applications

There are two files need to be distributed withDC.HelpAuthority COM applications

  • DC_HelpAuthority10.dll
  • DCHA10_Lang.dll

this files should be copied to the WinSystem directory which by default is C:\Windows\System32

PrepareHelp

Prepare form to know every thing about the form and its controls and all binding information

syntax:

Function PrepareHelp(ByRef dm_DSN As ADODB.Connection, ByRef dm_Form As System.Windows.Forms.Form, Optional ByRef dm_Grid As AxMSDataGridLib.AxDataGrid = Nothing)

dm_DSN is a reference to your DSN connection

dm_Form is a reference to your form which passed as 'Me' keyword

Optional dm_Grid (if your form has a grid) is a reference to your grid

Example:

Dim HA As New DynamicComponents.HelpAuthority()

HA.PrepareHelp(CN, Me, Me.AxDataGrid1)

where CN is a reference to your DSN connection and Me is a reference to your form which passed as 'Me' keyword and AxDataGrid1 (if your form has a grid) is a reference to your grid

Sensitive F12 Help

When you press F12 Key , this trigger a sensitive help ,this require

  1. Create a new table , name it "Help" and put it in your database
  2. create 4 fields as specified
Name Type Length
Tag Text 50
Id Text 50
Description Text 50
Contents Memo
  1. Fill Tag field with your Form Tag

  2. Fill Id Field with your control name

  3. Fill Id Field with DataGrid name followed with underscore character "_" , which will be something like this

"axDatagrid_ProductId"

  1. Fill Description field with your control Description

  2. Fill Contents field with your supported help for this control

Note:

To change your form text put form name in both field tag and id

Configuration Utility

We supply you with Configuration Utility which enable you to assign your own language used with DC.HelpAuthority

Tutorial

This tutorial describe most of features supported by DC.HelpAuthority

also you can refer to the project example which installed by default into C:\Program Files\Dynamic Components\Help Authority\Tutorial\

Dim HA As New DynamicComponents.HelpAuthority()

Dim CN As New ADODB.Connection()

Dim oOrders As New ADODB.Recordset()

Dim oOrderDetails As New ADODB.Recordset()

Dim oAccess As New Access.Application()

Dim DAO\_DBEngine As New DAO.DBEngine()

'Press F12 to get help to any control on your form



Private Sub TestForm\_Load(ByVal eventSender As System.Object, ByVal eventArgs As System.EventArgs) Handles MyBase.Load

'establish DSN

oAccess.DBEngine.RegisterDatabase("DCDM\_Nwind", "Microsoft Access Driver (\*.mdb)", True, "DBQ=" & VB6.GetPath & "\Nwind.mdb")

CN.Open("DSN=DCDM\_NWind")

oOrders.Open("Orders", CN, oOrders.CursorType.adOpenKeyset, oOrders.LockType.adLockOptimistic)

oOrderDetails.Open("OrderDetails", CN, oOrderDetails.CursorType.adOpenKeyset, oOrderDetails.LockType.adLockOptimistic)

PopulateDate()

Me.AxDataGrid1.DataSource = oOrderDetails

HA.PrepareHelp(CN, Me, Me.AxDataGrid1)

End Sub