]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/common/cmndata.cpp
added non-bordered toolbar tools
[wxWidgets.git] / src / common / cmndata.cpp
... / ...
CommitLineData
1/////////////////////////////////////////////////////////////////////////////
2// Name: cmndata.cpp
3// Purpose: Common GDI data
4// Author: Julian Smart
5// Modified by:
6// Created: 01/02/97
7// RCS-ID: $Id$
8// Copyright: (c) Julian Smart
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
19
20#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
21 #pragma implementation "cmndata.h"
22#endif
23
24// For compilers that support precompilation, includes "wx.h".
25#include "wx/wxprec.h"
26
27#ifdef __BORLANDC__
28 #pragma hdrstop
29#endif
30
31#ifndef WX_PRECOMP
32 #include <stdio.h>
33 #include "wx/string.h"
34 #include "wx/utils.h"
35 #include "wx/app.h"
36#endif
37
38#include "wx/gdicmn.h"
39#include "wx/cmndata.h"
40#include "wx/log.h"
41#include "wx/prntbase.h"
42#include "wx/printdlg.h"
43
44#if wxUSE_FONTDLG
45 #include "wx/fontdlg.h"
46#endif // wxUSE_FONTDLG
47
48#if wxUSE_PRINTING_ARCHITECTURE
49 #include "wx/paper.h"
50#endif // wxUSE_PRINTING_ARCHITECTURE
51
52#if defined(__WXMSW__)
53 #include <windowsx.h>
54 #include "wx/msw/private.h"
55
56 #ifndef __SMARTPHONE__ /* of WinCE */
57 #include <commdlg.h>
58 #endif
59
60 #if defined(__WATCOMC__) || defined(__SYMANTEC__) || defined(__SALFORDC__)
61 #include <windowsx.h>
62 #include <commdlg.h>
63 #endif
64#endif // MSW
65
66#ifdef __WXMAC__
67 #include "wx/mac/private/print.h"
68#endif
69
70 #if wxUSE_PRINTING_ARCHITECTURE
71 IMPLEMENT_DYNAMIC_CLASS(wxPrintData, wxObject)
72 IMPLEMENT_DYNAMIC_CLASS(wxPrintDialogData, wxObject)
73 IMPLEMENT_DYNAMIC_CLASS(wxPageSetupDialogData, wxObject)
74 #endif // wxUSE_PRINTING_ARCHITECTURE
75
76 IMPLEMENT_DYNAMIC_CLASS(wxFontData, wxObject)
77 IMPLEMENT_DYNAMIC_CLASS(wxColourData, wxObject)
78
79#ifndef DMPAPER_USER
80 #define DMPAPER_USER 256
81#endif
82
83// ============================================================================
84// implementation
85// ============================================================================
86
87// ----------------------------------------------------------------------------
88// wxColourData
89// ----------------------------------------------------------------------------
90
91wxColourData::wxColourData()
92{
93 m_chooseFull = false;
94 m_dataColour.Set(0,0,0);
95 // m_custColours are wxNullColours initially
96}
97
98wxColourData::wxColourData(const wxColourData& data)
99 : wxObject()
100{
101 (*this) = data;
102}
103
104wxColourData::~wxColourData()
105{
106}
107
108void wxColourData::SetCustomColour(int i, const wxColour& colour)
109{
110 wxCHECK_RET( (i >= 0 && i < 16), _T("custom colour index out of range") );
111
112 m_custColours[i] = colour;
113}
114
115wxColour wxColourData::GetCustomColour(int i)
116{
117 wxCHECK_MSG( (i >= 0 && i < 16), wxColour(0,0,0),
118 _T("custom colour index out of range") );
119
120 return m_custColours[i];
121}
122
123void wxColourData::operator=(const wxColourData& data)
124{
125 int i;
126 for (i = 0; i < 16; i++)
127 m_custColours[i] = data.m_custColours[i];
128
129 m_dataColour = (wxColour&)data.m_dataColour;
130 m_chooseFull = data.m_chooseFull;
131}
132
133// ----------------------------------------------------------------------------
134// Font data
135// ----------------------------------------------------------------------------
136
137wxFontData::wxFontData()
138{
139 // Intialize colour to black.
140 m_fontColour = wxNullColour;
141
142 m_showHelp = false;
143 m_allowSymbols = true;
144 m_enableEffects = true;
145 m_minSize = 0;
146 m_maxSize = 0;
147
148 m_encoding = wxFONTENCODING_SYSTEM;
149}
150
151wxFontData::~wxFontData()
152{
153}
154
155#if wxUSE_FONTDLG
156
157wxFontDialogBase::~wxFontDialogBase()
158{
159}
160
161#endif // wxUSE_FONTDLG
162
163#if wxUSE_PRINTING_ARCHITECTURE
164// ----------------------------------------------------------------------------
165// Print data
166// ----------------------------------------------------------------------------
167
168wxPrintData::wxPrintData()
169{
170#ifdef __WXMAC__
171 m_nativePrintData = wxNativePrintData::Create() ;
172#endif
173 m_bin = wxPRINTBIN_DEFAULT;
174 m_printMode = wxPRINT_MODE_PRINTER;
175 m_printOrientation = wxPORTRAIT;
176 m_printNoCopies = 1;
177 m_printCollate = false;
178
179 // New, 24/3/99
180 m_printerName = wxEmptyString;
181 m_colour = true;
182 m_duplexMode = wxDUPLEX_SIMPLEX;
183 m_printQuality = wxPRINT_QUALITY_HIGH;
184 m_paperId = wxPAPER_A4;
185 m_paperSize = wxSize(210, 297);
186
187 m_nativeData = wxPrintFactory::GetFactory()->CreatePrintNativeData();
188}
189
190wxPrintData::wxPrintData(const wxPrintData& printData)
191 : wxObject()
192{
193 m_nativeData = NULL;
194 (*this) = printData;
195}
196
197wxPrintData::~wxPrintData()
198{
199 m_nativeData->m_ref--;
200 if (m_nativeData->m_ref == 0)
201 delete m_nativeData;
202
203#ifdef __WXMAC__
204 delete m_nativePrintData ;
205#endif
206}
207
208void wxPrintData::ConvertToNative()
209{
210#ifdef __WXMAC__
211 m_nativePrintData->TransferFrom( this ) ;
212#else
213 m_nativeData->TransferFrom( *this ) ;
214#endif
215}
216
217void wxPrintData::ConvertFromNative()
218{
219#ifdef __WXMAC__
220 m_nativePrintData->TransferTo( this ) ;
221#else
222 m_nativeData->TransferTo( *this ) ;
223#endif
224}
225
226void wxPrintData::operator=(const wxPrintData& data)
227{
228 m_printNoCopies = data.m_printNoCopies;
229 m_printCollate = data.m_printCollate;
230 m_printOrientation = data.m_printOrientation;
231 m_printerName = data.m_printerName;
232 m_colour = data.m_colour;
233 m_duplexMode = data.m_duplexMode;
234 m_printQuality = data.m_printQuality;
235 m_paperId = data.m_paperId;
236 m_paperSize = data.m_paperSize;
237 m_bin = data.m_bin;
238 m_printMode = data.m_printMode;
239 m_filename = data.m_filename;
240
241 // UnRef old m_nativeData
242 if (m_nativeData)
243 {
244 m_nativeData->m_ref--;
245 if (m_nativeData->m_ref == 0)
246 delete m_nativeData;
247 }
248 // Set Ref new one
249 m_nativeData = data.GetNativeData();
250 m_nativeData->m_ref++;
251
252#ifdef __WXMAC__
253 m_nativePrintData->CopyFrom( data.m_nativePrintData ) ;
254#endif
255}
256
257// Is this data OK for showing the print dialog?
258bool wxPrintData::Ok() const
259{
260 m_nativeData->TransferFrom( *this );
261
262 return m_nativeData->Ok();
263}
264
265// What should happen here? wxPostScriptPrintNativeData is not
266// defined unless all this is true on MSW.
267#if WXWIN_COMPATIBILITY_2_4 && wxUSE_PRINTING_ARCHITECTURE && (!defined(__WXMSW__) || wxUSE_POSTSCRIPT_ARCHITECTURE_IN_MSW)
268
269#include "wx/generic/prntdlgg.h"
270
271#if wxUSE_POSTSCRIPT
272 #define WXUNUSED_WITHOUT_PS(name) name
273#else
274 #define WXUNUSED_WITHOUT_PS(name) WXUNUSED(name)
275#endif
276
277wxString wxPrintData::GetPrinterCommand() const
278{
279#if wxUSE_POSTSCRIPT
280 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
281 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetPrinterCommand();
282#endif
283 return wxEmptyString;
284}
285
286wxString wxPrintData::GetPrinterOptions() const
287{
288#if wxUSE_POSTSCRIPT
289 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
290 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetPrinterOptions();
291#endif
292 return wxEmptyString;
293}
294
295wxString wxPrintData::GetPreviewCommand() const
296{
297#if wxUSE_POSTSCRIPT
298 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
299 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetPreviewCommand();
300#endif
301 return wxEmptyString;
302}
303
304wxString wxPrintData::GetFontMetricPath() const
305{
306#if wxUSE_POSTSCRIPT
307 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
308 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetFontMetricPath();
309#endif
310 return wxEmptyString;
311}
312
313double wxPrintData::GetPrinterScaleX() const
314{
315#if wxUSE_POSTSCRIPT
316 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
317 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetPrinterScaleX();
318#endif
319 return 1.0;
320}
321
322double wxPrintData::GetPrinterScaleY() const
323{
324#if wxUSE_POSTSCRIPT
325 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
326 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetPrinterScaleY();
327#endif
328 return 1.0;
329}
330
331long wxPrintData::GetPrinterTranslateX() const
332{
333#if wxUSE_POSTSCRIPT
334 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
335 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetPrinterTranslateX();
336#endif
337 return 0;
338}
339
340long wxPrintData::GetPrinterTranslateY() const
341{
342#if wxUSE_POSTSCRIPT
343 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
344 return ((wxPostScriptPrintNativeData*)m_nativeData)->GetPrinterTranslateY();
345#endif
346 return 0;
347}
348
349void wxPrintData::SetPrinterCommand(const wxString& WXUNUSED_WITHOUT_PS(command))
350{
351#if wxUSE_POSTSCRIPT
352 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
353 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterCommand( command );
354#endif
355}
356
357void wxPrintData::SetPrinterOptions(const wxString& WXUNUSED_WITHOUT_PS(options))
358{
359#if wxUSE_POSTSCRIPT
360 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
361 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterOptions( options );
362#endif
363}
364
365void wxPrintData::SetPreviewCommand(const wxString& WXUNUSED_WITHOUT_PS(command))
366{
367#if wxUSE_POSTSCRIPT
368 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
369 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPreviewCommand( command );
370#endif
371}
372
373void wxPrintData::SetFontMetricPath(const wxString& WXUNUSED_WITHOUT_PS(path))
374{
375#if wxUSE_POSTSCRIPT
376 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
377 ((wxPostScriptPrintNativeData*)m_nativeData)->SetFontMetricPath( path );
378#endif
379}
380
381void wxPrintData::SetPrinterScaleX(double WXUNUSED_WITHOUT_PS(x))
382{
383#if wxUSE_POSTSCRIPT
384 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
385 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterScaleX( x );
386#endif
387}
388
389void wxPrintData::SetPrinterScaleY(double WXUNUSED_WITHOUT_PS(y))
390{
391#if wxUSE_POSTSCRIPT
392 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
393 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterScaleY( y );
394#endif
395}
396
397void wxPrintData::SetPrinterScaling(double WXUNUSED_WITHOUT_PS(x), double WXUNUSED_WITHOUT_PS(y))
398{
399#if wxUSE_POSTSCRIPT
400 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
401 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterScaling( x, y );
402#endif
403}
404
405void wxPrintData::SetPrinterTranslateX(long WXUNUSED_WITHOUT_PS(x))
406{
407#if wxUSE_POSTSCRIPT
408 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
409 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterTranslateX( x );
410#endif
411}
412
413void wxPrintData::SetPrinterTranslateY(long WXUNUSED_WITHOUT_PS(y))
414{
415#if wxUSE_POSTSCRIPT
416 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
417 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterTranslateY( y );
418#endif
419}
420
421void wxPrintData::SetPrinterTranslation(long WXUNUSED_WITHOUT_PS(x), long WXUNUSED_WITHOUT_PS(y))
422{
423#if wxUSE_POSTSCRIPT
424 if (m_nativeData && wxIsKindOf(m_nativeData,wxPostScriptPrintNativeData))
425 ((wxPostScriptPrintNativeData*)m_nativeData)->SetPrinterTranslation( x, y );
426#endif
427}
428#endif
429
430// ----------------------------------------------------------------------------
431// Print dialog data
432// ----------------------------------------------------------------------------
433
434wxPrintDialogData::wxPrintDialogData()
435{
436 m_printFromPage = 0;
437 m_printToPage = 0;
438 m_printMinPage = 0;
439 m_printMaxPage = 0;
440 m_printNoCopies = 1;
441 m_printAllPages = false;
442 m_printCollate = false;
443 m_printToFile = false;
444 m_printSelection = false;
445 m_printEnableSelection = false;
446 m_printEnablePageNumbers = true;
447
448 wxPrintFactory* factory = wxPrintFactory::GetFactory();
449 m_printEnablePrintToFile = ! factory->HasOwnPrintToFile();
450
451 m_printEnableHelp = false;
452#if WXWIN_COMPATIBILITY_2_4
453 m_printSetupDialog = false;
454#endif
455}
456
457wxPrintDialogData::wxPrintDialogData(const wxPrintDialogData& dialogData)
458 : wxObject()
459{
460 (*this) = dialogData;
461}
462
463wxPrintDialogData::wxPrintDialogData(const wxPrintData& printData)
464{
465 m_printFromPage = 1;
466 m_printToPage = 0;
467 m_printMinPage = 1;
468 m_printMaxPage = 9999;
469 m_printNoCopies = 1;
470 m_printAllPages = false;
471 m_printCollate = false;
472 m_printToFile = false;
473 m_printSelection = false;
474 m_printEnableSelection = false;
475 m_printEnablePageNumbers = true;
476 m_printEnablePrintToFile = true;
477 m_printEnableHelp = false;
478#if WXWIN_COMPATIBILITY_2_4
479 m_printSetupDialog = false;
480#endif
481 m_printData = printData;
482}
483
484wxPrintDialogData::~wxPrintDialogData()
485{
486}
487
488#ifdef __WXMAC__
489
490void wxPrintDialogData::ConvertToNative()
491{
492 m_printData.ConvertToNative();
493 m_printData.m_nativePrintData->TransferFrom( this ) ;
494}
495
496void wxPrintDialogData::ConvertFromNative()
497{
498 m_printData.ConvertFromNative();
499 m_printData.m_nativePrintData->TransferTo( this ) ;
500}
501
502#endif
503
504
505void wxPrintDialogData::operator=(const wxPrintDialogData& data)
506{
507 m_printFromPage = data.m_printFromPage;
508 m_printToPage = data.m_printToPage;
509 m_printMinPage = data.m_printMinPage;
510 m_printMaxPage = data.m_printMaxPage;
511 m_printNoCopies = data.m_printNoCopies;
512 m_printAllPages = data.m_printAllPages;
513 m_printCollate = data.m_printCollate;
514 m_printToFile = data.m_printToFile;
515 m_printSelection = data.m_printSelection;
516 m_printEnableSelection = data.m_printEnableSelection;
517 m_printEnablePageNumbers = data.m_printEnablePageNumbers;
518 m_printEnableHelp = data.m_printEnableHelp;
519 m_printEnablePrintToFile = data.m_printEnablePrintToFile;
520#if WXWIN_COMPATIBILITY_2_4
521 m_printSetupDialog = data.m_printSetupDialog;
522#endif
523 m_printData = data.m_printData;
524}
525
526void wxPrintDialogData::operator=(const wxPrintData& data)
527{
528 m_printData = data;
529}
530
531// ----------------------------------------------------------------------------
532// wxPageSetupDialogData
533// ----------------------------------------------------------------------------
534
535wxPageSetupDialogData::wxPageSetupDialogData()
536{
537 m_paperSize = wxSize();
538
539 CalculatePaperSizeFromId();
540
541 m_minMarginTopLeft =
542 m_minMarginBottomRight =
543 m_marginTopLeft =
544 m_marginBottomRight = wxPoint();
545
546 // Flags
547 m_defaultMinMargins = false;
548 m_enableMargins = true;
549 m_enableOrientation = true;
550 m_enablePaper = true;
551 m_enablePrinter = true;
552 m_enableHelp = false;
553 m_getDefaultInfo = false;
554}
555
556wxPageSetupDialogData::wxPageSetupDialogData(const wxPageSetupDialogData& dialogData)
557 : wxObject()
558{
559 (*this) = dialogData;
560}
561
562wxPageSetupDialogData::wxPageSetupDialogData(const wxPrintData& printData)
563{
564 m_paperSize = wxSize();
565 m_minMarginTopLeft =
566 m_minMarginBottomRight =
567 m_marginTopLeft =
568 m_marginBottomRight = wxPoint();
569
570 // Flags
571 m_defaultMinMargins = false;
572 m_enableMargins = true;
573 m_enableOrientation = true;
574 m_enablePaper = true;
575 m_enablePrinter = true;
576 m_enableHelp = false;
577 m_getDefaultInfo = false;
578
579 m_printData = printData;
580
581 // The wxPrintData paper size overrides these values, unless the size cannot
582 // be found.
583 CalculatePaperSizeFromId();
584}
585
586wxPageSetupDialogData::~wxPageSetupDialogData()
587{
588}
589
590wxPageSetupDialogData& wxPageSetupDialogData::operator=(const wxPageSetupDialogData& data)
591{
592 m_paperSize = data.m_paperSize;
593 m_minMarginTopLeft = data.m_minMarginTopLeft;
594 m_minMarginBottomRight = data.m_minMarginBottomRight;
595 m_marginTopLeft = data.m_marginTopLeft;
596 m_marginBottomRight = data.m_marginBottomRight;
597 m_defaultMinMargins = data.m_defaultMinMargins;
598 m_enableMargins = data.m_enableMargins;
599 m_enableOrientation = data.m_enableOrientation;
600 m_enablePaper = data.m_enablePaper;
601 m_enablePrinter = data.m_enablePrinter;
602 m_getDefaultInfo = data.m_getDefaultInfo;;
603 m_enableHelp = data.m_enableHelp;
604
605 m_printData = data.m_printData;
606
607 return *this;
608}
609
610wxPageSetupDialogData& wxPageSetupDialogData::operator=(const wxPrintData& data)
611{
612 m_printData = data;
613 CalculatePaperSizeFromId();
614
615 return *this;
616}
617
618#ifdef __WXMAC__
619void wxPageSetupDialogData::ConvertToNative()
620{
621 m_printData.ConvertToNative();
622 m_printData.m_nativePrintData->TransferFrom( this ) ;
623}
624
625void wxPageSetupDialogData::ConvertFromNative()
626{
627 m_printData.ConvertFromNative ();
628 m_paperSize = m_printData.GetPaperSize() ;
629 CalculateIdFromPaperSize();
630 m_printData.m_nativePrintData->TransferTo( this ) ;
631 // adjust minimal values
632
633 if ( m_marginTopLeft.x < m_minMarginTopLeft.x )
634 m_marginTopLeft.x = m_minMarginTopLeft.x;
635
636 if ( m_marginBottomRight.x < m_minMarginBottomRight.x )
637 m_marginBottomRight.x = m_minMarginBottomRight.x;
638
639 if ( m_marginTopLeft.y < m_minMarginTopLeft.y )
640 m_marginTopLeft.y = m_minMarginTopLeft.y;
641
642 if ( m_marginBottomRight.y < m_minMarginBottomRight.y )
643 m_marginBottomRight.y = m_minMarginBottomRight.y;
644}
645#endif
646
647
648// If a corresponding paper type is found in the paper database, will set the m_printData
649// paper size id member as well.
650void wxPageSetupDialogData::SetPaperSize(const wxSize& sz)
651{
652 m_paperSize = sz;
653
654 CalculateIdFromPaperSize();
655}
656
657// Sets the wxPrintData id, plus the paper width/height if found in the paper database.
658void wxPageSetupDialogData::SetPaperSize(wxPaperSize id)
659{
660 m_printData.SetPaperId(id);
661
662 CalculatePaperSizeFromId();
663}
664
665void wxPageSetupDialogData::SetPrintData(const wxPrintData& printData)
666{
667 m_printData = printData;
668 CalculatePaperSizeFromId();
669}
670
671// Use paper size defined in this object to set the wxPrintData
672// paper id
673void wxPageSetupDialogData::CalculateIdFromPaperSize()
674{
675 wxASSERT_MSG( (wxThePrintPaperDatabase != (wxPrintPaperDatabase*) NULL),
676 wxT("wxThePrintPaperDatabase should not be NULL. Do not create global print dialog data objects.") );
677
678 wxSize sz = GetPaperSize();
679
680 wxPaperSize id = wxThePrintPaperDatabase->GetSize(wxSize(sz.x* 10, sz.y * 10));
681 if (id != wxPAPER_NONE)
682 {
683 m_printData.SetPaperId(id);
684 }
685}
686
687// Use paper id in wxPrintData to set this object's paper size
688void wxPageSetupDialogData::CalculatePaperSizeFromId()
689{
690 wxASSERT_MSG( (wxThePrintPaperDatabase != (wxPrintPaperDatabase*) NULL),
691 wxT("wxThePrintPaperDatabase should not be NULL. Do not create global print dialog data objects.") );
692
693 wxSize sz = wxThePrintPaperDatabase->GetSize(m_printData.GetPaperId());
694
695 // sz is in 10ths of a mm, while paper size is in mm
696 m_paperSize.x = sz.x / 10;
697 m_paperSize.y = sz.y / 10;
698}
699
700#endif // wxUSE_PRINTING_ARCHITECTURE