c# .net pdf viewer : Adding a page to a pdf in preview application SDK cloud windows wpf asp.net class robohelp_help36-part1278

Context-sensitive Help
331
Author and developer roles in creating context-sensitive Help
Information for developers
About map numbers, map files, and map IDs
Map number
A numeric value associated with a topic ID. Map numbers and topic IDs are saved in map files. 
Map numbers are used with applications to specify a topic for calling context-sensitive Help. 
Whether application developers use map numbers, topics IDs, or both depends on the 
programming language they use.
Map file
A text file containing topic IDs and map numbers. You associate map IDs and map files with 
topics. As author, if you receive a map file from your developer, assign a map ID from the map 
file. If you manually create a map file, either auto-generate or manually create the map ID. A 
project can include multiple map files. Map files use the extensions .h, .hh, and .hm. The 
default map file is BSSCDefault.h.
Map ID
A string that pairs a topic ID with a map number. For example:
#define ID_SetupScreen 101
ID_SetupScreen is the topic ID.
101 is the map number.
ID_SetupScreen 101 is the Map ID.
An Icon indicates the status of a map ID:
Blue icons  indicate that map IDs match topics.
Yellow icons  indicate that map IDs do not match any topics.
Locked icons  (blue or yellow) indicate that the map ID is in a map file that is locked. 
It cannot be assigned or unassigned.
Create map IDs, auto-generate map IDs, or import map files to use map IDs. A unique map ID 
must be assigned to each topic ID. Assign a map ID to a Help topic to display the Help topic in 
context-sensitive Help.
Mapping table
A mechanism that maps fields and controls in dialog boxes to map numbers. The mapping 
table is programmed into the application to provide context-sensitive Help functionality.
Adding a page to a pdf in preview - insert pages into PDF file in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Guide C# Users to Insert (Empty) PDF Page or Pages from a Supported File Format
add contents page to pdf; add page numbers to pdf
Adding a page to a pdf in preview - VB.NET PDF Page Insert Library: insert pages into PDF file in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Easy to Use VB.NET APIs to Add a New Blank Page to PDF Document
adding page numbers in pdf; add pages to pdf acrobat
Context-sensitive Help
11
332
Managing map files
Create a map file
Map files are text files that include a map ID list. Map filenames use the .h extension. When creating 
filenames, use underscores instead of spaces, and avoid using these illegal characters: \ / : * ? < > | # 
", $, &, [ ]
Authors or developers can create the map file. If the developer creates the map file, the author then 
imports it.
NOTE
RoboHelp also supports dynamic context-sensitive mapping of dialog boxes and topics. This 
approach eliminates the need for technical authors to manually keep track of map IDs. See Dynamic 
editing of context-sensitive topics.
TIP
:You can lock a map file to make it read-only.
1) Open the Output Setup pod.
2) Expand the Context-Sensitive Help folder.
3) Right-click the Map Files folder.
4) Choose New Map File.
5) Enter a name.
6) Click OK. The file is added to the Map Files folder.
NOTE
Obsolete files potentially contain map numbers used for updated files.
Import a map file
1) Do one of the following:
Click Project > Import > Map File.
Expand the context-sensitive Help folder in the Output Setup pod.
2) Navigate to the map file. Make sure that it’s unlocked.
3) Double-click the map file to add it to the project Map Files folder.
Export a map file
1) In the Output Setup pod, expand the Context-Sensitive Help folder.
2) Right-click the Map Files folder.
3) Select Export Map Files.
C# PDF insert image Library: insert images into PDF in C#.net, ASP
digital photo, scanned signature or logo into PDF document page in C# solve this technical problem, we provide this C#.NET PDF image adding control, XDoc
add a blank page to a pdf; add page number to pdf document
C# PDF insert text Library: insert text into PDF content in C#.net
Insert formatted text and plain text to PDF page using .NET XDoc.PDF component in C#.NET class. Supports adding text to PDF in preview without adobe reader
add page number to pdf online; adding page numbers to pdf in preview
Context-sensitive Help
333
4) Select the programming languages to save the map files to.
5) Specify a location for the map file. Click OK.
TIP
:When you export a map file, the original file remains in your project.
Lock or unlock a map file
Locked map files are read-only files. Do not add, remove, or change map IDs in locked map files. Do 
not modify the file if Remove Unused Map IDs is selected. If you do, you can possibly lose changes 
in the files. Imported map files are locked by default.
1) Select Project > Open > Pods > Output Setup.
2) Expand the Map Files folder (or a custom folder in the Map Files folder).
3) Right-click the map file.
4) Select Properties.
5) Select the Locked option. To unlock the file, deselect the Locked option.
6) Click Close.
Remove an obsolete map file
Obsolete map files sometimes contain map numbers used for updated files. These map numbers can 
dynamically call a wrong topic. Delete unused map files to prevent this issue.
1) Open the Output Setup pod.
2) Expand the Context-Sensitive Help folder.
3) Expand the Map Files folder.
4) Select the map file.
5) Click Delete.
Remove an unused map ID
Your map files must be unlocked to use this option. To remove unused map IDs:
Expand the Context-Sensitive Help folder in the Output Setup pod.
Right-click the Map Files folder.
Select Edit.
Do the following:
VB.NET PDF insert text library: insert text into PDF content in vb
Studio .NET PDF SDK library supports adding text content to Add text to certain position of PDF page in Visual Add text to PDF in preview without adobe reader
adding page numbers pdf file; adding page numbers to pdf
C# Create PDF Library SDK to convert PDF from other file formats
What's more, you can also protect created PDF file by adding digital signature (watermark) on PDF Create a new PDF Document with one Blank Page in C#
adding page numbers to a pdf document; adding pages to a pdf
Context-sensitive Help
11
334
Map Files
Select the map files from which to remove unused map IDs.
Select All
Click to remove unused map IDs from all map files.
Clear All
Click to deselect all map files and not remove unused map IDs.
Managing map IDs
Create a map ID
1) Open the Output Setup pod.
2) Expand the Context-Sensitive Help folder.
3) Expand the Map Files folder.
4) Double-click All Map IDs.
5) In Map File, click the Down Arrow and select a map file to store the map ID.
6) Click the Create/Edit Map ID button .
7) In Topic ID, type a word or phrase to identify the topic.
8) In Map Number, type a number.
NOTE
You can create individual map IDs per topic or 
auto-generate using the Auto Map button. See Auto-generate a map ID
Edit a map ID
You can assign or unassign topic map IDs, create new map IDs and files, and automatically map 
(auto-map) IDs. You can sort the topics by column.
1) Open the Output Setup pod.
2) Expand the Context-Sensitive Help folder.
3) Right-click the Map Files folder.
4) Select Edit Map IDs.
5) Choose from the following options:
Map File
List available map files (including imported map files).
C# Word - Insert Blank Word Page in C#.NET
This C# .NET Word document page inserting & adding component from RasterEdge is written in managed C# code and designed particularly for .NET class applications
add pages to pdf reader; add remove pages from pdf
C# PowerPoint - Insert Blank PowerPoint Page in C#.NET
This C# .NET PowerPoint document page inserting & adding component from RasterEdge is written in managed C# code and designed particularly for .NET class
add page break to pdf; add and delete pages in pdf online
Context-sensitive Help
335
<All Map Files>
Display all map IDs.
<Project Map File>
Display map IDs in the default map file BSSCDdefault.h. The map IDs for deselected map files 
reside in BSSCDefault.h.
Map file icon 
Click to open the New Map File dialog box and create a custom map file. Map numbers for 
custom map files are numbered automatically.
Map #
Display the map number of the topic ID. Map numbers reside in map files (.h, .hh, .hm).
Topic
Display the topic assigned to the map ID.
Hide Used IDs
Show unassigned map IDs.
New icon 
Create a map ID. The ID is appended to the map file selected in Map File.
Edit icon 
Edit the selected map ID.
Delete 
Remove the selected map ID. Before removing the ID, click Unassign to prevent a broken link 
to the topic.
Options
Customize topic auto-mapping.
Assign
Assign the selected topic to the selected topic ID. This button is available when a topic is 
selected on the right and a map ID is selected on the left.
Unassign
Disassociate the map ID from the topic on the right.
Auto Map
Assign a map ID in the custom or default map file (BSSCDefault.h). Select a map file and a 
topic. Click Auto Map. This button is available only when you select <Project Map File> or a 
C# PowerPoint - How to Process PowerPoint
& Insert PowerPoint Page/Slide in C#. Use the provided easy to call and write APIs programmed in C# class to develop user-defined PowerPoint slide adding and
add and remove pages from a pdf; adding page numbers to pdf documents
C# TIFF: TIFF Editor SDK to Read & Manipulate TIFF File Using C#.
1. Support embedding, removing, adding and updating ICCProfile. 2. Render text to text, PDF, or Word file. You will see the following aspects on this guide page.
adding page numbers to pdf in; adding a page to a pdf file
Context-sensitive Help
11
336
custom map file. If you auto-map a map ID and a map file is not selected, the map ID resides 
in the default map file (BSSCDefault.h).
The program assigns the topic title or filename as the topic ID and assigns a map number. 
Click Options to customize auto-mapping.
You cannot assign multiple topics to a map ID. You can assign multiple map IDs to a 
topic.
Topic
Lists the project topics. To filter the list, click the triangle . Select All Folders, Top Level 
Folder, or a custom folder.
Properties icon 
Show all topic IDs assigned to the topic.
Preview icon 
Display the topic.
NOTE
:If you assign a map ID to a bookmark, you see a misleading error message indicating 
that the file does not exist. Disregard the warning. The topic does exist.
Reassign a map ID
Update the map ID if the Help topic doesn’t open, if the wrong topic opens, or if the developer 
changed the application that in way that affects the map IDs.
1) Select a map file under Map IDs in the Edit Map IDs dialog box.
2) Click Create/Edit Map ID.
3) Do one of the following:
Reassign the map ID. Under Map ID, select the map ID. Click Unassign. Select another topic 
and click Assign.
Change the topic ID or map number. Double-click the map ID and change the desired value.
Auto-generate a map ID
You can generate map IDs using a custom map file or the default map file (BSSCDefault.h). Before 
you generate map files, check with the developer to determine naming conventions.
1) In the Output Setup pod, expand the Context-Sensitive Help folder.
2) Expand the Map Files folder.
3) Double-click All Map IDs.
C# Word - Insert Image to Word Page in C#.NET
VB.NET How-to, VB.NET PDF, VB.NET Word, VB.NET Excel, VB.NET PowerPoint, VB.NET Tiff, VB.NET Imaging It's a demo code for adding image to word page using C#.
add a page to a pdf in reader; add page number to pdf preview
Context-sensitive Help
337
4) In Map File, click the triangle button.
5) Select a map file.
6) Set options for naming and numbering map IDs. By default, the application assigns the topic 
title or filename as the topic ID and assigns a map number.
7) In the Topic field, select the topic.
8) Click Auto Map to create a map ID.
9) If necessary, double-click the map file to edit it.
10) Provide a copy of the map file to the developer.
Generate a map ID
The IDs reside in the map file you select from the Edit Map IDs dialog box.
1) Click Options in the Edit Map IDs dialog box.
Prefix Map IDs With
Select to enter a value at the beginning of each map ID.
Make Uppercase
Select for uppercase auto-generated map IDs.
Start Numbering With
Select to enter a starting number for map numbers.
Notes:
Setting these options does not affect existing map IDs.
By default, the application assigns the topic title or filename as the topic ID and assigns a map 
number.
Auto-generating map IDs is available when you select <Project Map File> or a custom map file. 
If you auto-map a map ID and do not select a map file, the map ID resides in the default map 
file (BSSCDefault.h).
You cannot assign multiple topics to a map ID. You can assign multiple map IDs to one topic.
Context-sensitive Help
11
338
Assign a map ID to a topic
NOTE
RoboHelp also supports dynamic context-sensitive mapping of dialog boxes and topics. This 
approach eliminates the need for technical authors to manually keep track of map IDs. See Dynamic 
editing of context-sensitive topics.
1) Open the Output Setup pod.
2) Expand the Context-Sensitive Help folder.
3) Expand the Map Files folder.
4) Double-click All Map IDs.
5) In Map File, click the Down Arrow and select the map file that contains the map ID.
6) Select the map ID to assign.
7) Select the topic.
8) Click Assign.
9) Click Close.
10) Generate the project.
11) Test the window-level topics with the application.
Unassign a map ID
1) Open the topic.
2) Click the Properties button .
3) Click the Advanced tab.
4) Click Assigned Map IDs.
5) Select the map ID to unassign.
6) Click Edit Map IDs.
7) Click Unassign.
8) Click Close.
9) Generate the project.
10) Test the window-level topics with the application.
NOTE
:If you assign map IDs to bookmarks and remove the bookmarks from the topics, manually unas-
sign map IDs from the bookmarks.
Context-sensitive Help
339
Dynamic editing of context-sensitive topics
RoboHelp supports dynamic editing of the context-sensitive topic associated with an application 
dialog box. If no topic is associated with the dialog box, you can either dynamically map an existing 
topic with the dialog box or create a new topic and then map it with the dialog box.
NOTE
To use this feature, you must open the application from within RoboHelp. Also, the application 
must implement context-sensitive help using the RoboHelp 9 Context-Sensitive Help API. Currently, 
only C++ APIs on Windows are supported.
Usage scenarios
Mapping dialog boxes with Help topics requires close collaboration between developers and tech-
nical authors. Normally, developers define map IDs for dialog boxes in the code and communicate 
them to technical authors. Technical authors then manually associate the map IDs with Help topics.
Dynamic context-sensitive mapping of dialog boxes and topics eliminates the need for technical 
authors to manually keep track of map IDs. Instead, technical authors can open the application and 
associate the relevant Help topic dynamically with a dialog box.
This feature also greatly facilitates Help integration testing and troubleshooting. Technical authors 
can readily test whether all dialog boxes are mapped to the correct Help topics. When a mismatch is 
found, they can quickly fix it and associate the dialog box with the correct Help topic.
Map an application dialog box with a topic
1) Open the Help project for the application in RoboHelp.
2) Click Tools > CSH > Open CSH Help.
3) Browse and select the executable file (.exe) for the application. Click Open.
4) Once the application has launched, browse to an application dialog box with context-sensitive 
Help mapping. Press F1 or click the Help button.
5) In the CSH Options dialog box in RoboHelp, select a map file from the Project Map File 
pop-up menu.
NOTE
The CSH Options dialog box appears only if you launched the application from within 
RoboHelp using Tools > CSH > Open CSH Help.
6) Do one of the following:
If you want to map an existing topic in the RoboHelp project with the dialog box, select 
Map To Selected Topic and select a topic for the mapping from the right pane.
If you want to create a new topic and map it with the dialog box, select Map To New 
Topic.
Context-sensitive Help
11
340
If you want to edit the contents of the topic currently mapped with the dialog box, select 
Edit Mapped Topic.
If you want to remove the current mapping between the dialog box and a Help topic, 
select Remove Mapping.
7) Click OK.
Information for developers
The API shares parameters with HTML Help and WinHelp. You can create custom dialog 
boxes.
NOTE
"Custom dialog boxes" refers to the feature that the projects using these APIs have to create 
their own dialog boxes based on their requirements.
Call your Help projects with the function RH_ShowHelp. The source code for this function is 
contained in the support files which you import into your development project. Languages 
supported are Visual Basic, C/C++, JavaScript, and Java. The files are in C:\Program 
Files\Adobe\Adobe RoboHelp [version]\CSH API. The files are:
CSH API\RoboHelp_CSH.vb (Visual Basic)
CSH API\RoboHelp_CSH.cpp (C/C++, dependent on the .h)
CSH API\RoboHelp_CSH.h (C/C++, dependent on the .cpp)
CSH API\RoboHelp_CSH.js (Web pages - HTML/JavaScript)
CSH API\RoboHelp_CSH.java (Java applications)
RH_ShowHelp has four parameters as shown in the following table:
Parameter
Description
hParent
Handle to calling dialog HTML Help Only: This parameter closes the Help dialog when 
the calling window is closed.
a_pszHelpFile
Help Source (depends on the Output type)
For Webhelp/FlashHelp: "Path to project start page"
For Webhelp Pro: "http://<ServerName>/roboapi.asp"
For HTML Help: "Path to .CHM file". To specify a dialog, use ">WindowName" at the 
end of the parameter.
uCommand
Constants:
HH_DISPLAY_INDEX Displays Index pane and default topic.
HH_DISPLAY_SEARCH Displays Search pane and default topic.
HH_DISPLAY_TOC Displays Contents pane and default topic.
HH_HELP_CONTEXT Opens topic associated with map ID in dwData parameter.
Documents you may be interested
Documents you may be interested