dsinclair | f34518b | 2016-09-13 12:03:48 -0700 | [diff] [blame] | 1 | // Copyright 2016 PDFium Authors. All rights reserved. |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 2 | // Use of this source code is governed by a BSD-style license that can be |
| 3 | // found in the LICENSE file. |
Tom Sepez | c6ab172 | 2015-02-05 15:27:25 -0800 | [diff] [blame] | 4 | |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 5 | // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com |
| 6 | |
dsinclair | 735606d | 2016-10-05 15:47:02 -0700 | [diff] [blame] | 7 | #ifndef FPDFSDK_CPDFSDK_FORMFILLENVIRONMENT_H_ |
| 8 | #define FPDFSDK_CPDFSDK_FORMFILLENVIRONMENT_H_ |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 9 | |
Dan Sinclair | 85c8e7f | 2016-11-21 13:50:32 -0500 | [diff] [blame] | 10 | #include <map> |
Lei Zhang | aa8bf7e | 2015-12-24 19:13:32 -0800 | [diff] [blame] | 11 | #include <memory> |
Dan Sinclair | 85c8e7f | 2016-11-21 13:50:32 -0500 | [diff] [blame] | 12 | #include <vector> |
Lei Zhang | 606346f | 2015-06-19 18:11:07 -0700 | [diff] [blame] | 13 | |
dsinclair | 41872fa | 2016-10-04 11:29:35 -0700 | [diff] [blame] | 14 | #include "core/fpdfapi/page/cpdf_page.h" |
dsinclair | 488b7ad | 2016-10-04 11:55:50 -0700 | [diff] [blame] | 15 | #include "core/fpdfapi/parser/cpdf_document.h" |
dsinclair | 1727aee | 2016-09-29 13:12:56 -0700 | [diff] [blame] | 16 | #include "core/fpdfdoc/cpdf_occontext.h" |
dsinclair | a52ab74 | 2016-09-29 13:59:29 -0700 | [diff] [blame] | 17 | #include "core/fxcrt/cfx_observable.h" |
dsinclair | b959010 | 2016-04-27 06:38:59 -0700 | [diff] [blame] | 18 | #include "fpdfsdk/cfx_systemhandler.h" |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 19 | #include "fpdfsdk/cpdfsdk_annot.h" |
dsinclair | 114e46a | 2016-09-29 17:18:21 -0700 | [diff] [blame] | 20 | #include "fpdfsdk/fsdk_define.h" |
Lei Zhang | b4e7f30 | 2015-11-06 15:52:32 -0800 | [diff] [blame] | 21 | #include "public/fpdf_formfill.h" |
Dan Sinclair | df5a116 | 2016-03-09 16:51:34 -0500 | [diff] [blame] | 22 | #include "public/fpdf_fwlevent.h" |
Tom Sepez | 40e9ff3 | 2015-11-30 12:39:54 -0800 | [diff] [blame] | 23 | |
dsinclair | b94d7c9 | 2016-09-21 12:07:00 -0700 | [diff] [blame] | 24 | class CFFL_InteractiveFormFiller; |
dsinclair | b959010 | 2016-04-27 06:38:59 -0700 | [diff] [blame] | 25 | class CFX_SystemHandler; |
Tom Sepez | dcbc02f | 2015-07-17 09:16:17 -0700 | [diff] [blame] | 26 | class CPDFSDK_ActionHandler; |
jaepark | 98e1019 | 2016-08-15 10:51:11 -0700 | [diff] [blame] | 27 | class CPDFSDK_AnnotHandlerMgr; |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 28 | class CPDFSDK_InterForm; |
| 29 | class CPDFSDK_PageView; |
dsinclair | 64376be | 2016-03-31 20:03:24 -0700 | [diff] [blame] | 30 | class IJS_Runtime; |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 31 | |
dsinclair | 3a7741a | 2016-10-11 10:39:49 -0700 | [diff] [blame] | 32 | class CPDFSDK_FormFillEnvironment |
| 33 | : public CFX_Observable<CPDFSDK_FormFillEnvironment> { |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 34 | public: |
dsinclair | 735606d | 2016-10-05 15:47:02 -0700 | [diff] [blame] | 35 | CPDFSDK_FormFillEnvironment(UnderlyingDocumentType* pDoc, |
| 36 | FPDF_FORMFILLINFO* pFFinfo); |
| 37 | ~CPDFSDK_FormFillEnvironment(); |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 38 | |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 39 | CPDFSDK_PageView* GetPageView(UnderlyingPageType* pPage, bool renew); |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 40 | CPDFSDK_PageView* GetPageView(int nIndex); |
| 41 | CPDFSDK_PageView* GetCurrentView(); |
| 42 | void RemovePageView(UnderlyingPageType* pPage); |
| 43 | void UpdateAllViews(CPDFSDK_PageView* pSender, CPDFSDK_Annot* pAnnot); |
| 44 | |
| 45 | CPDFSDK_Annot* GetFocusAnnot() { return m_pFocusAnnot.Get(); } |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 46 | bool SetFocusAnnot(CPDFSDK_Annot::ObservedPtr* pAnnot); |
| 47 | bool KillFocusAnnot(uint32_t nFlag); |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 48 | void ClearAllFocusedAnnots(); |
| 49 | |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 50 | bool ExtractPages(const std::vector<uint16_t>& arrExtraPages, |
| 51 | CPDF_Document* pDstDoc); |
| 52 | bool InsertPages(int nInsertAt, |
| 53 | const CPDF_Document* pSrcDoc, |
| 54 | const std::vector<uint16_t>& arrSrcPages); |
| 55 | bool ReplacePages(int nPage, |
| 56 | const CPDF_Document* pSrcDoc, |
| 57 | const std::vector<uint16_t>& arrSrcPages); |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 58 | |
| 59 | int GetPageCount() { return m_pUnderlyingDoc->GetPageCount(); } |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 60 | bool GetPermissions(int nFlag); |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 61 | |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 62 | bool GetChangeMark() const { return m_bChangeMask; } |
| 63 | void SetChangeMark() { m_bChangeMask = true; } |
| 64 | void ClearChangeMark() { m_bChangeMask = false; } |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 65 | |
| 66 | UnderlyingPageType* GetPage(int nIndex); |
| 67 | |
| 68 | void ProcJavascriptFun(); |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 69 | bool ProcOpenAction(); |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 70 | |
Dan Sinclair | 6eec1c4 | 2017-02-21 17:20:43 -0500 | [diff] [blame] | 71 | void Invalidate(FPDF_PAGE page, const FX_RECT& rect); |
Dan Sinclair | 60fd9fc | 2017-02-21 17:21:08 -0500 | [diff] [blame] | 72 | void OutputSelectedRect(FPDF_PAGE page, const CFX_FloatRect& rect); |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 73 | |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 74 | void SetCursor(int nCursorType); |
| 75 | int SetTimer(int uElapse, TimerCallback lpTimerFunc); |
| 76 | void KillTimer(int nTimerID); |
| 77 | FX_SYSTEMTIME GetLocalTime() const; |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 78 | |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 79 | void OnChange(); |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 80 | bool IsSHIFTKeyDown(uint32_t nFlag) const; |
| 81 | bool IsCTRLKeyDown(uint32_t nFlag) const; |
| 82 | bool IsALTKeyDown(uint32_t nFlag) const; |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 83 | |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 84 | FPDF_PAGE GetPage(FPDF_DOCUMENT document, int nPageIndex); |
| 85 | FPDF_PAGE GetCurrentPage(FPDF_DOCUMENT document); |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 86 | |
Dan Sinclair | 812e96c | 2017-03-13 16:43:37 -0400 | [diff] [blame] | 87 | void ExecuteNamedAction(const char* namedAction); |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 88 | void OnSetFieldInputFocus(FPDF_WIDESTRING focusText, |
dsinclair | 1f24890 | 2016-09-14 10:38:17 -0700 | [diff] [blame] | 89 | FPDF_DWORD nTextLen, |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 90 | bool bFocus); |
Dan Sinclair | 812e96c | 2017-03-13 16:43:37 -0400 | [diff] [blame] | 91 | void DoURIAction(const char* bsURI); |
dsinclair | 1f24890 | 2016-09-14 10:38:17 -0700 | [diff] [blame] | 92 | void DoGoToAction(int nPageIndex, |
| 93 | int zoomMode, |
| 94 | float* fPosArray, |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 95 | int sizeOfArray); |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 96 | |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 97 | UnderlyingDocumentType* GetUnderlyingDocument() const { |
| 98 | return m_pUnderlyingDoc; |
| 99 | } |
| 100 | |
Tom Sepez | 51da093 | 2015-11-25 16:05:49 -0800 | [diff] [blame] | 101 | #ifdef PDF_ENABLE_XFA |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 102 | CPDF_Document* GetPDFDocument() const { |
| 103 | return m_pUnderlyingDoc ? m_pUnderlyingDoc->GetPDFDoc() : nullptr; |
| 104 | } |
| 105 | |
dsinclair | 521b750 | 2016-11-02 13:02:28 -0700 | [diff] [blame] | 106 | CPDFXFA_Context* GetXFAContext() const { return m_pUnderlyingDoc; } |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 107 | void ResetXFADocument() { m_pUnderlyingDoc = nullptr; } |
| 108 | |
tsepez | 2599ff7 | 2016-11-08 14:38:59 -0800 | [diff] [blame] | 109 | int GetPageViewCount() const { return m_PageMap.size(); } |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 110 | |
dsinclair | 1f24890 | 2016-09-14 10:38:17 -0700 | [diff] [blame] | 111 | void DisplayCaret(FPDF_PAGE page, |
| 112 | FPDF_BOOL bVisible, |
| 113 | double left, |
| 114 | double top, |
| 115 | double right, |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 116 | double bottom); |
| 117 | int GetCurrentPageIndex(FPDF_DOCUMENT document); |
| 118 | void SetCurrentPage(FPDF_DOCUMENT document, int iCurPage); |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 119 | |
dsinclair | 1f24890 | 2016-09-14 10:38:17 -0700 | [diff] [blame] | 120 | // TODO(dsinclair): This should probably change to PDFium? |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 121 | CFX_WideString FFI_GetAppName() const { return CFX_WideString(L"Acrobat"); } |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 122 | |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 123 | CFX_WideString GetPlatform(); |
| 124 | void GotoURL(FPDF_DOCUMENT document, const CFX_WideStringC& wsURL); |
| 125 | void GetPageViewRect(FPDF_PAGE page, FS_RECTF& dstRect); |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 126 | bool PopupMenu(FPDF_PAGE page, |
| 127 | FPDF_WIDGET hWidget, |
| 128 | int menuFlag, |
| 129 | CFX_PointF pt); |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 130 | |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 131 | void Alert(FPDF_WIDESTRING Msg, FPDF_WIDESTRING Title, int Type, int Icon); |
dsinclair | 1f24890 | 2016-09-14 10:38:17 -0700 | [diff] [blame] | 132 | void EmailTo(FPDF_FILEHANDLER* fileHandler, |
| 133 | FPDF_WIDESTRING pTo, |
| 134 | FPDF_WIDESTRING pSubject, |
| 135 | FPDF_WIDESTRING pCC, |
| 136 | FPDF_WIDESTRING pBcc, |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 137 | FPDF_WIDESTRING pMsg); |
dsinclair | 1f24890 | 2016-09-14 10:38:17 -0700 | [diff] [blame] | 138 | void UploadTo(FPDF_FILEHANDLER* fileHandler, |
| 139 | int fileFlag, |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 140 | FPDF_WIDESTRING uploadTo); |
dsinclair | 1f24890 | 2016-09-14 10:38:17 -0700 | [diff] [blame] | 141 | FPDF_FILEHANDLER* OpenFile(int fileType, |
| 142 | FPDF_WIDESTRING wsURL, |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 143 | const char* mode); |
Dan Sinclair | 812e96c | 2017-03-13 16:43:37 -0400 | [diff] [blame] | 144 | CFX_RetainPtr<IFX_SeekableReadStream> DownloadFromURL(const wchar_t* url); |
| 145 | CFX_WideString PostRequestURL(const wchar_t* wsURL, |
| 146 | const wchar_t* wsData, |
| 147 | const wchar_t* wsContentType, |
| 148 | const wchar_t* wsEncode, |
| 149 | const wchar_t* wsHeader); |
| 150 | FPDF_BOOL PutRequestURL(const wchar_t* wsURL, |
| 151 | const wchar_t* wsData, |
| 152 | const wchar_t* wsEncode); |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 153 | CFX_WideString GetLanguage(); |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 154 | |
dsinclair | 577ad2c | 2016-09-22 10:20:43 -0700 | [diff] [blame] | 155 | void PageEvent(int iPageCount, uint32_t dwEventType) const; |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 156 | #else // PDF_ENABLE_XFA |
| 157 | CPDF_Document* GetPDFDocument() const { return m_pUnderlyingDoc; } |
Tom Sepez | 40e9ff3 | 2015-11-30 12:39:54 -0800 | [diff] [blame] | 158 | #endif // PDF_ENABLE_XFA |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 159 | |
Dan Sinclair | 812e96c | 2017-03-13 16:43:37 -0400 | [diff] [blame] | 160 | int JS_appAlert(const wchar_t* Msg, |
| 161 | const wchar_t* Title, |
dsinclair | 72177da | 2016-09-15 12:07:23 -0700 | [diff] [blame] | 162 | uint32_t Type, |
| 163 | uint32_t Icon); |
Dan Sinclair | 812e96c | 2017-03-13 16:43:37 -0400 | [diff] [blame] | 164 | int JS_appResponse(const wchar_t* Question, |
| 165 | const wchar_t* Title, |
| 166 | const wchar_t* Default, |
| 167 | const wchar_t* cLabel, |
Tom Sepez | 5702859 | 2016-02-01 15:49:11 -0800 | [diff] [blame] | 168 | FPDF_BOOL bPassword, |
| 169 | void* response, |
| 170 | int length); |
| 171 | void JS_appBeep(int nType); |
| 172 | CFX_WideString JS_fieldBrowse(); |
| 173 | CFX_WideString JS_docGetFilePath(); |
Dan Sinclair | 812e96c | 2017-03-13 16:43:37 -0400 | [diff] [blame] | 174 | void JS_docSubmitForm(void* formData, int length, const wchar_t* URL); |
Tom Sepez | 5702859 | 2016-02-01 15:49:11 -0800 | [diff] [blame] | 175 | void JS_docmailForm(void* mailData, |
| 176 | int length, |
| 177 | FPDF_BOOL bUI, |
Dan Sinclair | 812e96c | 2017-03-13 16:43:37 -0400 | [diff] [blame] | 178 | const wchar_t* To, |
| 179 | const wchar_t* Subject, |
| 180 | const wchar_t* CC, |
| 181 | const wchar_t* BCC, |
| 182 | const wchar_t* Msg); |
Tom Sepez | 5702859 | 2016-02-01 15:49:11 -0800 | [diff] [blame] | 183 | void JS_docprint(FPDF_BOOL bUI, |
| 184 | int nStart, |
| 185 | int nEnd, |
| 186 | FPDF_BOOL bSilent, |
| 187 | FPDF_BOOL bShrinkToFit, |
| 188 | FPDF_BOOL bPrintAsImage, |
| 189 | FPDF_BOOL bReverse, |
| 190 | FPDF_BOOL bAnnotations); |
| 191 | void JS_docgotoPage(int nPageNum); |
| 192 | |
tsepez | 4cf5515 | 2016-11-02 14:37:54 -0700 | [diff] [blame] | 193 | bool IsJSInitiated() const { return m_pInfo && m_pInfo->m_pJsPlatform; } |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 194 | CFX_ByteString GetAppName() const { return ""; } |
dsinclair | b959010 | 2016-04-27 06:38:59 -0700 | [diff] [blame] | 195 | CFX_SystemHandler* GetSysHandler() const { return m_pSysHandler.get(); } |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 196 | FPDF_FORMFILLINFO* GetFormFillInfo() const { return m_pInfo; } |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 197 | |
dsinclair | b94d7c9 | 2016-09-21 12:07:00 -0700 | [diff] [blame] | 198 | // Creates if not present. |
| 199 | CFFL_InteractiveFormFiller* GetInteractiveFormFiller(); |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 200 | CPDFSDK_AnnotHandlerMgr* GetAnnotHandlerMgr(); // Creates if not present. |
Tom Sepez | ba038bc | 2015-10-08 12:03:00 -0700 | [diff] [blame] | 201 | IJS_Runtime* GetJSRuntime(); // Creates if not present. |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 202 | CPDFSDK_ActionHandler* GetActionHander(); // Creates if not present. |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 203 | CPDFSDK_InterForm* GetInterForm(); // Creates if not present. |
Tom Sepez | 2f3dfef | 2015-03-02 15:35:26 -0800 | [diff] [blame] | 204 | |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 205 | private: |
Lei Zhang | aa8bf7e | 2015-12-24 19:13:32 -0800 | [diff] [blame] | 206 | std::unique_ptr<CPDFSDK_AnnotHandlerMgr> m_pAnnotHandlerMgr; |
| 207 | std::unique_ptr<CPDFSDK_ActionHandler> m_pActionHandler; |
| 208 | std::unique_ptr<IJS_Runtime> m_pJSRuntime; |
Nico Weber | 9d8ec5a | 2015-08-04 13:00:21 -0700 | [diff] [blame] | 209 | FPDF_FORMFILLINFO* const m_pInfo; |
tsepez | 2599ff7 | 2016-11-08 14:38:59 -0800 | [diff] [blame] | 210 | std::map<UnderlyingPageType*, std::unique_ptr<CPDFSDK_PageView>> m_PageMap; |
dsinclair | 7cbe68e | 2016-10-12 11:56:23 -0700 | [diff] [blame] | 211 | std::unique_ptr<CPDFSDK_InterForm> m_pInterForm; |
| 212 | CPDFSDK_Annot::ObservedPtr m_pFocusAnnot; |
| 213 | UnderlyingDocumentType* m_pUnderlyingDoc; |
dsinclair | b94d7c9 | 2016-09-21 12:07:00 -0700 | [diff] [blame] | 214 | std::unique_ptr<CFFL_InteractiveFormFiller> m_pFormFiller; |
dsinclair | b959010 | 2016-04-27 06:38:59 -0700 | [diff] [blame] | 215 | std::unique_ptr<CFX_SystemHandler> m_pSysHandler; |
dsinclair | 6c659ab | 2016-10-12 13:41:38 -0700 | [diff] [blame] | 216 | bool m_bChangeMask; |
| 217 | bool m_bBeingDestroyed; |
John Abd-El-Malek | 3f3b45c | 2014-05-23 17:28:10 -0700 | [diff] [blame] | 218 | }; |
| 219 | |
dsinclair | 735606d | 2016-10-05 15:47:02 -0700 | [diff] [blame] | 220 | #endif // FPDFSDK_CPDFSDK_FORMFILLENVIRONMENT_H_ |