Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

translated various comments #121

Merged
merged 5 commits into from
Mar 7, 2021
Merged
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
134 changes: 65 additions & 69 deletions main/sw/inc/shellio.hxx
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
/**************************************************************
*
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*
*************************************************************/


Expand Down Expand Up @@ -45,7 +45,7 @@
#include <errhdl.hxx>
#include <iodetect.hxx>

// einige Forward - Deklarationen
// some forward declarations
class SfxFilterContainer;
class SfxFilter;
class SfxItemPool;
Expand All @@ -65,8 +65,8 @@ class SwTextBlocks;
struct SwPosition;
struct Writer_Impl;

// ab so vielen chars wird ein mit einem ASCII/W4W-Reader eingelesener
// Absatz zwangsweise umgebrochen. Muss immer groesser als 200 sein !!!
//defines the amount of maximal characters in a paragraph.
//The force wrap is done by ASCII/W4W-reader. Must be greater than 200
#define MAX_ASCII_PARA 10000


Expand Down Expand Up @@ -106,11 +106,11 @@ public:
};

/**************** SwReader/Reader ************************/
// Basisklasse der moeglichen Optionen fuer einen speziellen Reader
// base class for different specialized readers
class Reader;
// Ruft den Reader mit seinen Optionen, Dokument, Cursor etc.
// calls the reader with its options, document, cursor etc.
class SwReader;
// SwRead ist der Pointer auf die Read-Optionen-Basisklasse
// SwRead is a pointer on the read options of the base class
typedef Reader *SwRead;

class SwgReaderOption
Expand Down Expand Up @@ -161,32 +161,32 @@ class SwReader: public SwDocFac
SvStream* pStrm;
SotStorageRef pStg;
com::sun::star::uno::Reference < com::sun::star::embed::XStorage > xStg;
SfxMedium* pMedium; // wer ein Medium haben will (W4W)
SfxMedium* pMedium; // describes file or storage (W4W)

SwPaM* pCrsr;
String aFileName;
String sBaseURL;

public:
/*
* Initiales Einlesen. Dokument wird erst beim Read(..) angelegt.
* JP 25.04.95: oder falls es mitgegeben wird, in dieses.
* Sonderfall fuer Load mit Sw3Reader
* Initial read. Document is created when function Read(...) is called
* JP 25.04.95: or if it has been passed in that one.
* special case if loaded with Sw3Reader
*/
//SwReader( SotStorage&, const String& rFilename, SwDoc *pDoc = 0 );
//SwReader( const com::sun::star::uno::Reference < com::sun::star::embed::XStorage >&, const String& rFilename, SwDoc *pDoc = 0 );
SwReader( SfxMedium&, const String& rFilename, SwDoc *pDoc = 0 );
/*
* In ein existierendes Dokument einlesen, Dokument und
* Position im Dokument werden aus dem SwPaM uebernommen.
* read into an existing document. Document and
* position within the document are taken from SwPaM.
*/
SwReader( SvStream&, const String& rFilename, const String& rBaseURL, SwPaM& );
//SwReader( SotStorage&, const String& rFilename, SwPaM& );
SwReader( SfxMedium&, const String& rFilename, SwPaM& );
SwReader( const com::sun::star::uno::Reference < com::sun::star::embed::XStorage >&, const String& rFilename, SwPaM& );

/*
* Nur SwReader::Read(...) ist die Export-Schnittstelle!!!
* only SwReader::Read(...) is the Export-Interface!!!
*/
sal_Bool NeedsPasswd( const Reader& );
sal_Bool CheckPasswd( const String&, const Reader& );
Expand All @@ -204,10 +204,10 @@ protected:



/* */
/**************** SPEZIELLE Reader ************************/
/* */
/**************** SPECIAL Readers ************************/

// spezielle - Reader koennen beides sein !! (Excel, W4W, .. )
// special - Reader can be both!! (Excel, W4W, .. )
#define SW_STREAM_READER 1
#define SW_STORAGE_READER 2

Expand All @@ -226,12 +226,12 @@ protected:
SvStream* pStrm;
SotStorageRef pStg;
com::sun::star::uno::Reference < com::sun::star::embed::XStorage > xStg;
SfxMedium* pMedium; // wer ein Medium haben will (W4W)
SfxMedium* pMedium; // describes file or storage (W4W)

SwgReaderOption aOpt;
sal_Bool bInsertMode : 1;
sal_Bool bTmplBrowseMode : 1;
sal_Bool bReadUTF8: 1; // Stream als UTF-8 interpretieren
sal_Bool bReadUTF8: 1; // interpreted stream as UTF-8
sal_Bool bBlockMode: 1;
sal_Bool bOrganizerMode : 1;
sal_Bool bHasAskTemplateName : 1;
Expand All @@ -249,14 +249,13 @@ public:
virtual void SetFltName( const String& rFltNm );
static void SetNoOutlineNum( SwDoc& rDoc );

// den Item-Set eines Frm-Formats an das alte Format anpassen
// fit the item-set of a Frm-Formats to the old Format
static void ResetFrmFmtAttrs( SfxItemSet &rFrmSet );

// die Rahmen-/Grafik-/OLE-Vorlagen an das alte Format (ohne
// Umrandung etc.) anpassen
// convert frame /graphic-/OLE-Templates to old Format (without border etc.)
static void ResetFrmFmts( SwDoc& rDoc );

// Die Filter-Vorlage laden, setzen und wieder freigeben
// load filter-template, position it and then set it free again
SwDoc* GetTemplateDoc();
sal_Bool SetTemplate( SwDoc& rDoc );
void ClearTemplate();
Expand Down Expand Up @@ -288,8 +287,8 @@ public:
private:
virtual sal_uLong Read(SwDoc &, const String& rBaseURL, SwPaM &,const String &)=0;

// alle die die Streams / Storages nicht geoeffnet brauchen,
// muessen die Methode ueberladen (W4W!!)
// all streams / storages that do need to open it must overload the method
// (W4W!!)
virtual int SetStrmStgPtr();
};

Expand Down Expand Up @@ -335,12 +334,10 @@ public:
SvStrings& rStrings ) const;
};*/

/* */
/* */
////////////////////////////////////////////////////////////////////////////

// Der uebergebene Stream muss dynamisch angelegt werden und
// vor dem Loeschen der Instanz per Stream() angefordert
// und geloescht werden!
// The passed stream has to be dynamic created and before deletion of the
// instance per Stream() requested and deleted!

class SwImpBlocks;

Expand All @@ -358,7 +355,7 @@ public:
void Flush(){}

SwDoc* GetDoc();
void ClearDoc(); // Doc-Inhalt loeschen
void ClearDoc(); // delete doc content
const String& GetName();
void SetName( const String& );
sal_uLong GetError() const { return nErr; }
Expand All @@ -367,32 +364,32 @@ public:
void SetBaseURL( const String& rURL );

sal_Bool IsOld() const;
sal_uLong ConvertToNew(); // Textbausteine konvertieren
sal_uLong ConvertToNew(); // convert AutoText entries (ger: Textbausteine)

sal_uInt16 GetCount() const; // Anzahl Textbausteine ermitteln
sal_uInt16 GetIndex( const String& ) const; // Index fuer Kurznamen ermitteln
sal_uInt16 GetLongIndex( const String& ) const; //Index fuer Langnamen ermitteln
const String& GetShortName( sal_uInt16 ) const; // Kurzname fuer Index zurueck
const String& GetLongName( sal_uInt16 ) const; // Langname fuer Index zurueck
sal_uInt16 GetCount() const; // return amount of AutoText entries
sal_uInt16 GetIndex( const String& ) const; // return Index-Number of shortnames
sal_uInt16 GetLongIndex( const String& ) const; //return Index-Number of langnamen
const String& GetShortName( sal_uInt16 ) const; // return a shortname of an index
const String& GetLongName( sal_uInt16 ) const; // return longname of an index

sal_Bool Delete( sal_uInt16 ); // Loeschen
sal_uInt16 Rename( sal_uInt16, const String*, const String* ); // Umbenennen
sal_Bool Delete( sal_uInt16 ); // delete
sal_uInt16 Rename( sal_uInt16, const String*, const String* ); // rename
sal_uLong CopyBlock( SwTextBlocks& rSource, String& rSrcShort,
const String& rLong ); // Block kopieren
const String& rLong ); // copy block

sal_Bool BeginGetDoc( sal_uInt16 ); // Textbaustein einlesen
void EndGetDoc(); // Textbaustein wieder loslassen
sal_Bool BeginGetDoc( sal_uInt16 ); // read AutoText entry
void EndGetDoc(); // release AutoText entry

sal_Bool BeginPutDoc( const String&, const String& ); // Speichern Beginn
sal_uInt16 PutDoc(); // Speichern Ende
sal_Bool BeginPutDoc( const String&, const String& ); // start save
sal_uInt16 PutDoc(); // End save

sal_uInt16 PutText( const String&, const String&, const String& ); // Speichern( Kurzn., Text)
sal_uInt16 PutText( const String&, const String&, const String& ); // save (shortname, Text)

sal_Bool IsOnlyTextBlock( sal_uInt16 ) const;
sal_Bool IsOnlyTextBlock( const String& rShort ) const;

const String& GetFileName() const; // Dateiname von pImp
sal_Bool IsReadOnly() const; // ReadOnly-Flag von pImp
const String& GetFileName() const; // filename of pImp
sal_Bool IsReadOnly() const; // ReadOnly-Flag of pImp

sal_Bool GetMacroTable( sal_uInt16 nIdx, SvxMacroTableDtor& rMacroTbl );
sal_Bool SetMacroTable( sal_uInt16 nIdx, const SvxMacroTableDtor& rMacroTbl );
Expand All @@ -414,18 +411,18 @@ SW_DLLPUBLIC SwRead SwGetReaderXML();
// END source/filter/basflt/fltini.cxx


extern sal_Bool SetHTMLTemplate( SwDoc &rDoc ); //Fuer Vorlagen aus HTML.vor laden shellio.cxx
extern sal_Bool SetHTMLTemplate( SwDoc &rDoc ); // load templates from HTML.vor (see shellio.cxx)


/* */
/* */
/////////////////////////////////////////////////////////////////////////////

/*
* Schreiben, Writer
* write, Writer
*/


/* Basis-Klasse aller Writer */
/* base class of all Writer */

class IDocumentSettingAccess;
class IDocumentStylePoolAccess;
Expand All @@ -444,7 +441,7 @@ class SW_DLLPUBLIC Writer

protected:

SwPaM* pOrigPam; // der letze zu bearbeitende Pam
SwPaM* pOrigPam; // last Pam to work on
const String* pOrigFileName;

void ResetWriter();
Expand Down Expand Up @@ -501,32 +498,32 @@ public:

const String& GetBaseURL() const { return sBaseURL;}

// suche die naechste Bookmark-Position aus der Bookmark-Tabelle
// search next bookmark position from the bookmark table
sal_Int32 FindPos_Bkmk( const SwPosition& rPos ) const;
// build a bookmark table, which is sort by the node position. The
// build a bookmark table, which is sorted by the node position. The
// OtherPos of the bookmarks also inserted.
void CreateBookmarkTbl();
// search alle Bookmarks in the range and return it in the Array
// search all bookmarks in the range and return it in the Array
sal_uInt16 GetBookmarks( const SwCntntNode& rNd,
xub_StrLen nStt, xub_StrLen nEnd,
SvPtrarr& rArr );

// lege einen neuen PaM an der Position an
// create a new PaM at the position
static SwPaM * NewSwPaM(SwDoc & rDoc,
sal_uLong const nStartIdx, sal_uLong const nEndIdx);

// kopiere ggfs. eine lokale Datei ins Internet
// if applicable, copy a local file into internet / cloud
sal_Bool CopyLocalFileToINet( String& rFileNm );

// Stream-spezifische Routinen, im Storage-Writer NICHT VERWENDEN!
// Stream-specific routines, DO NOT USE in Storage-Writer!

// Optimierung der Ausgabe auf den Stream.
// Optimizing output on stream
SvStream& OutLong( SvStream& rStrm, long nVal );
SvStream& OutULong( SvStream& rStrm, sal_uLong nVal );

// Hex-Zahl ausgeben, default ist 2.stellige Zahl
// print hexadecimal number, default is 2-digit number
SvStream& OutHex( SvStream& rStrm, sal_uLong nHex, sal_uInt8 nLen = 2 );
// 4-st. Hex-Zahl ausgeben
// print 4-digit hexadecimal number
inline SvStream& OutHex4( SvStream& rStrm, sal_uInt16 nHex )
{ return OutHex( rStrm, nHex, 4 ); }

Expand All @@ -547,15 +544,15 @@ SV_DECL_REF(Writer)
#endif
SV_IMPL_REF(Writer)

// Basisklasse fuer alle Storage-Writer
// baseclass of all Storage-Writer
class SW_DLLPUBLIC StgWriter : public Writer
{
protected:
String aFltName;
SotStorageRef pStg;
com::sun::star::uno::Reference < com::sun::star::embed::XStorage > xStg;

// Fehler beim Aufruf erzeugen
// create error at call
virtual sal_uLong WriteStream();
virtual sal_uLong WriteStorage() = 0;
virtual sal_uLong WriteMedium( SfxMedium& ) = 0;
Expand Down Expand Up @@ -589,8 +586,7 @@ public:

*/

// Schnittstellenklasse fuer den allgemeinen Zugriff auf die
// speziellen Writer
// Interface class for a generic access on special writer

class SwWriter
{
Expand Down Expand Up @@ -626,7 +622,7 @@ public:
};


/* */
/* */
/////////////////////////////////////////////////////////////////////////////

typedef Reader* (*FnGetReader)();
Expand Down