All Frameworks Class Hierarchy This Framework Previous Next Indexes
ComponentsCatalogsInterfaces Interface CATICatalogChapterFactory
System.IUnknown
|
+---System.IDispatch
|
+---System.CATBaseUnknown
|
+---CATICatalogChapterFactory
Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.
interface CATICatalogChapterFactory
Interface to manage (create,delete,list) chapters in a catalog document.
Role: This interface is used to create, to find or to
delete chapters within a catalog document. This interface is implemented
on the root container of the catalog document. You retrieve it thanks to
the CATInit.GetRootContainer method.
All the chapters are stored
in the root container. The tree structure of the chapters is done by
descriptions.
- See also:
- CATICatalogChapter, CATICatalogDescription
Method Index
- o
CreateChapter(CATUnicodeString&,CATBoolean,CATICatalogChapter*&)
- Creates a new chapter.
- o
DeleteChapter(CATICatalogChapter*&,CATUnicodeString&,int)
- Removes a chapter and all its descriptions and keywords.
- o
FindChapter(CATUnicodeString&,CATICatalogChapter*&)
- Retrieves a chapter from its name in the current document.
- o
FindListChapter(CATUnicodeString&,CATListValCATICatalogChapter_var&)
- Retrieves the list of chapters from its name in the root container.
- o
GetRootChapter(CATICatalogChapter*&)
- Retrieves the root chapter of the current document.
- o
ListChapters(CATListValCATICatalogChapter_var*&)
- Retrieves the list of chapters in the root container.
Methods
o CreateChapter
-
Creates a new chapter.
- Parameters:
-
- iName
- The name of the chapter.
- iKindIsEndChapter
- The type of the chapter.
- FALSE:This chapter contains sub-chapter.
- TRUE:This chapter contains descriptions which all
have links towards a component (feature,document,...) but not an
another chapter. In this case the chapter is also named a family
- oNewChapter
- [out, CATBaseUnknown#Release] The new created chapter.
o DeleteChapter
-
Removes a chapter and all its descriptions and keywords.
- Parameters:
-
- iChapterToDelete
- The chapter to delete.
- oErrorMessage
- The error message if E_FAIL.
- iManageImpact
- 1 to delete all links on this chapter in the current container.
o FindChapter
-
Retrieves a chapter from its name in the current document.
- Parameters:
-
- iName
- The name of the chapter to retrieve.
- oChapter
- [out, CATBaseUnknown#Release] The retrieved chapter.
o FindListChapter
public virtual HRESULT FindListChapter( | const CATUnicodeString& | iName, |
| CATListValCATICatalogChapter_var& | oChapterList) = 0 |
-
Retrieves the list of chapters from its name in the root container.
Role:This method retrieves only the chapters inside the current
root container. It means that this method doesn't retrieve the external chapters.
- Parameters:
-
- iName
- The name of the chapter to retrieve.
- oChapterList
- The list of retrieved chapters.
o GetRootChapter
-
Retrieves the root chapter of the current document.
Role:The first chapter created by the
CreateChapter method is the root chapter. This method retrievesn among all the chapters of the root
container, the first created.
- Parameters:
-
- oChapter
- [out, CATBaseUnknown#Release] The root chapter.
o ListChapters
public virtual HRESULT ListChapters( | CATListValCATICatalogChapter_var*& | oListChapters)= 0 |
-
Retrieves the list of chapters in the root container.
Role:This method retrieves only the chapters inside the current
root container. It means that this method doesn't retrieve the external chapters.
- Parameters:
-
- oListChapters
- The list of chapters.
This object is included in the file: CATICatalogChapterFactory.h
If needed, your Imakefile.mk should include the module: CATCclInterfaces