Klasse Documents (Word VBA)
Eine Auflistung aller Document -Objekte, die derzeit in Word geöffnet sind. Um eine Documents -Klassenvariable zu verwenden, muss sie zuerst instanziert werden, beispielsweise
Dim docs as Documents
Set docs = Documents
For Each
Hier ist ein Beispiel für die Verarbeitung der Documents -Elemente in einer Sammlung
Dim doc As Document
For Each doc In Documents
Next doc
Add
Gibt ein Objekt Document zurück, das ein neues leeres Dokument repräsentiert, das der Sammlung an offenen Dokumenten hinzugefügt wurde.
Add (Template, NewTemplate, DocumentType, Visible)
Documents.Add
Arguments
Optional arguments
Die folgenden Argumente sind optional
Template (String) - Der Name der Vorlage, die für das neue Dokument verwendet werden soll.
NewTemplate (Boolean) - Bei dem Wert True wird das Dokument als eine Vorlage geöffnet.
DocumentType (WdNewDocumentType) - Kann eine der folgenden WdNewDocumentType-Konstanten sein: wdNewBlankDocument, wdNewEmailMessage, wdNewFrameset oder wdNewWebPage.
Möglichen Werte sind
wdNewBlankDocument | Leeres Dokument. |
wdNewEmailMessage | E-Mail-Nachricht. |
wdNewFrameset | Frameset. |
wdNewWebPage | Webseite. |
wdNewXMLDocument | XML-Dokument. |
Visible (Boolean) - Bei dem Wert True wird das Dokument in einem sichtbaren Fenster geöffnet.
AddBlogDocument
Gibt ein Document-Objekt zurück, das ein neues Blogdokument darstellt, das Microsoft Word für das durch die ersten drei Parameter beschriebenen Konto veröffentlicht.
Mithilfe dieser Methode wird ein Dokument erstellt und auch der angegebene Blog bei Word registriert, wenn er noch nicht registriert ist.
AddBlogDocument (ProviderID, PostURL, BlogName, PostID)
Dim strProviderID As String: strProviderID =
Dim strPostURL As String: strPostURL =
Dim strBlogName As String: strBlogName =
Dim docAddBlogDocument As Document
Set docAddBlogDocument = Documents.AddBlogDocument(ProviderID:=strProviderID, PostURL:=strPostURL, BlogName:=strBlogName)
Arguments
Hier sind die benannte Argumente :
ProviderID (String) - Eine GUID, bei der es sich um den eindeutigen Wert handelt, den ein Anbieter verwendet, wenn er sich selbst bei Word registriert.
PostURL (String) - Die URL, die beim Hinzufügen von Beiträgen zum Blog verwendet wird.
BlogName (String) - Ein Anzeigename für den Blog zur Verwendung in Word.
Optional arguments
Das folgendes Argument ist optional
PostID (String) - Die Kennung für einen vorhandenen Beitrag, mit dem das mithilfe der AddBlogDocument-Methode erstellte Dokument ausgefüllt wird.
CanCheckOut
True, wenn Microsoft Word ein angegebenes Dokument auf einem Server auschecken kann.
Damit die Vorteile der in Word integrierten Zusammenarbeitsfunktionen genutzt werden können, müssen Dokumente auf einem Microsoft SharePoint-Portalserver gespeichert werden.
CanCheckOut (FileName)
FileName: Serverpfad und Name des Dokuments.
Sub CheckInOut(docCheckOut As String)
If Documents.CanCheckOut(docCheckOut) = True Then
Documents.CheckOut docCheckOut
Else
MsgBox "You are unable to check out this document at this time."
End If
End Sub
CheckOut
Kopiert ein angegebenes Dokument zur Bearbeitung von einem Server auf einen lokalen Computer.
Damit die Vorteile der in Word integrierten Zusammenarbeitsfunktionen genutzt werden können, müssen Dokumente auf einem Microsoft SharePoint-Portalserver gespeichert werden.
CheckOut (FileName)
FileName: Der Name der auszucheckenden Datei.
Sub CheckInOut(docCheckOut As String)
If Documents.CanCheckOut(docCheckOut) = True Then
Documents.CheckOut docCheckOut
Else
MsgBox "You are unable to check out this document at this time."
End If
End Sub
Close
Schließt die angegebenen Dokumente.
Close (SaveChanges, OriginalFormat, RouteDocument)
Documents.Close
Arguments
Optional arguments
Die folgenden Argumente sind optional
SaveChanges (WdSaveOptions) - Gibt die Speichern-Aktion für das Dokument an.
Mögliche Rückgabewerte sind wdDoNotSaveChanges - Anstehende Änderungen werden nicht gespeichert, wdPromptToSaveChanges - Der Benutzer wird aufgefordert, anstehende Änderungen zu speichern, wdSaveChanges - Anstehende Änderungen werden automatisch gespeichert.
OriginalFormat (WdOriginalFormat) - Gibt das Speicherformat für das Dokument an.
Mögliche Rückgabewerte sind wdOriginalDocumentFormat, wdPromptUser - Der Benutzer wird aufgefordert, ein Dokumentformat auszuwählen, wdWordDocument - Microsoft Word-Dokument.
RouteDocument (Boolean) - True, wenn das Dokument an den nächsten Empfänger weitergeleitet werden soll.
Count
Gibt einen Wert vom Typ Long zurück, der die Anzahl der Dokumente in der Auflistung darstellt.
Dim lngCount As Long
lngCount = Documents.Count
Item
Gibt ein einzelnes Document-Objekt in einer Auflistung zurück.
Item (Index)
Index: Ein 1-basierter Index des zurückzugebenden Objekts (Long) oder der Name des Objekts (Zeichenfolge).
Sub DocumentItem()
If Documents.Count >= 1 Then
MsgBox Documents.Item(1).Name
End If
End Sub
Open
Öffnet das angegebene Dokument und fügt es der Documents-Auflistung hinzu.
Open (FileName, ConfirmConversions, ReadOnly, AddToRecentFiles, PasswordDocument, PasswordTemplate, Revert, WritePasswordDocument, WritePasswordTemplate, Format, Encoding, Visible, OpenAndRepair, DocumentDirection, NoEncodingDialog, XMLTransform)
Sub OpenDoc()
Documents.Open FileName:="C:\MyFiles\MyDoc.doc", ReadOnly:=True
End Sub
Arguments
Ein benanntes Argument
FileName (String) - Der Name des Dokuments (Pfade werden akzeptiert).
Optional arguments
Die folgenden Argumente sind optional
ConfirmConversions (Boolean) - True, um das Dialogfeld Datei konvertieren anzuzeigen, wenn die Datei nicht im Microsoft Word-Format vorliegt.
ReadOnly (Boolean) - True zum Öffnen des Dokuments im schreibgeschützten Modus.
AddToRecentFiles (Boolean) - True, wenn der Dateiname in die Liste der zuletzt verwendeten Dateien im unteren Teil des Menüs Datei aufgenommen werden soll.
PasswordDocument (String) - Das Kennwort zum Öffnen des Dokuments.
PasswordTemplate (String) - Das Kennwort zum Öffnen der Vorlage.
Revert (Boolean) - Legt fest, wie verfahren wird, wenn FileName der Dateiname eines geöffneten Dokuments ist.
WritePasswordDocument (String) - Das zum Speichern von Änderungen am Dokument erforderliche Kennwort.
WritePasswordTemplate (String) - Das Kennwort zum Speichern von Änderungen an der Vorlage.
Format (FileConverter) - Das zum Öffnen des Dokuments zu verwendende Dateikonvertierungsprogramm.
Encoding - String
Visible (Boolean) - True, wenn das Dokument in einem sichtbaren Fenster geöffnet wird.
OpenAndRepair (Boolean) - True, um das Dokument zu reparieren und so dessen Beschädigung zu vermeiden.
DocumentDirection (WdDocumentDirection) - Bestimmt den horizontalen Textfluss in einem Dokument.
Mögliche Rückgabewerte sind wdLeftToRight - Links nach Rechts, wdRightToLeft - Rechts nach Links.
NoEncodingDialog (Boolean) - True, um die Anzeige des Dialogfelds "Codierung" zu übergehen, das in Word angezeigt wird, wenn die Textcodierung nicht erkannt wird.
XMLTransform - String
OpenNoRepairDialog
Öffnet das angegebene Dokument und fügt es der Documents-Auflistung hinzu.
OpenNoRepairDialog (FileName, ConfirmConversions, ReadOnly, AddToRecentFiles, PasswordDocument, PasswordTemplate, Revert, WritePasswordDocument, WritePasswordTemplate, Format, Encoding, Visible, OpenAndRepair, DocumentDirection, NoEncodingDialog, XMLTransform)
Sub OpenDoc()
Documents.OpenNoRepairDialog FileName:="C:\MyFiles\MyDoc.doc", ReadOnly:=True
End Sub
Arguments
Ein benanntes Argument
FileName (String) - Der Name des Dokuments (Pfade werden akzeptiert).
Optional arguments
Die folgenden Argumente sind optional
ConfirmConversions (Boolean) - True, wenn das Dialogfeld Datei konvertieren angezeigt werden soll, wenn die Datei nicht im Microsoft Word-Format vorliegt.
ReadOnly (Boolean) - True zum Öffnen des Dokuments im schreibgeschützten Modus.
AddToRecentFiles (Boolean) - True, wenn der Dateiname in die Liste der zuletzt verwendeten Dateien im unteren Teil des Menüs Datei aufgenommen werden soll.
PasswordDocument (String) - Das Kennwort zum Öffnen des Dokuments.
PasswordTemplate (String) - Das Kennwort zum Öffnen der Vorlage.
Revert (Boolean) - Legt fest, wie verfahren wird, wenn FileName der Dateiname eines geöffneten Dokuments ist.
WritePasswordDocument (String) - Das zum Speichern von Änderungen am Dokument erforderliche Kennwort.
WritePasswordTemplate (String) - Das Kennwort zum Speichern von Änderungen an der Vorlage.
Format (WdOpenFormat) - Das zum Öffnen des Dokuments zu verwendende Dateikonvertierungsprogramm.
Dies sind mögliche Werte für
Encoding - String
Visible (Boolean) - True, wenn das Dokument in einem sichtbaren Fenster geöffnet wird.
OpenAndRepair (Boolean) - True, um das Dokument zu reparieren und so dessen Beschädigung zu vermeiden.
DocumentDirection (WdDocumentDirection) - Bestimmt den horizontalen Textfluss in einem Dokument.
Mögliche Rückgabewerte sind wdLeftToRight - Links nach Rechts, wdRightToLeft - Rechts nach Links.
NoEncodingDialog (Boolean) - True , um das Anzeigen des Dialogfelds Codierung zu überspringen, das von Word angezeigt wird, wenn die Textcodierung nicht erkannt werden kann.
XMLTransform (String) - Gibt die zu verwendende Transformierung an.
Save
Speichert alle Dokumente in der Documents-Auflistung.
Wenn ein Dokument noch nicht gespeichert wurde, wird der Benutzer im Dialogfeld Speichern unter aufgefordert, einen Dateinamen einzugeben.
Save (NoPrompt, OriginalFormat)
Documents.Save
Arguments
Optional arguments
Die folgenden Argumente sind optional
NoPrompt (Boolean) - True, wenn alle Dokumente automatisch in Word gespeichert werden sollen.
OriginalFormat (WdOriginalFormat) - Gibt an, wie die Dokumente gespeichert werden.
Mögliche Rückgabewerte sind wdOriginalDocumentFormat, wdPromptUser - Der Benutzer wird aufgefordert, ein Dokumentformat auszuwählen, wdWordDocument - Microsoft Word-Dokument.