System.PrivateProfileString-Eigenschaft (Word)

  • Artikel

Gibt eine Zeichenfolge in einer Initialisierungsdatei oder der Microsoft Windows-Registrierungsdatenbank zurück oder legt diese Zeichenfolge fest. Wert vom Typ String mit Lese-/Schreibzugriff.

Syntax

Ausdruck. PrivateProfileString( _FileName_ , _Section_ , _Key_ )

Ausdruck Ein Ausdruck, der ein System-Objekt zurückgibt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
FileName Erforderlich String Der Name für die Initialisierungsdatei. Ohne angegebenen Pfad wird der Windows-Ordner vorausgesetzt.
Section Erforderlich String Der Name des Abschnitts in der Einstellungsdatei, der den Schlüssel enthält. In einer Windows-Einstellungsdatei wird der Abschnittsname zwischen Klammern vor den zugeordneten Schlüsseln angezeigt (schließen Sie die Klammern nicht mit Abschnitt ein). Wenn Sie den Wert eines Eintrags aus der Windows-Registrierung zurückgeben, sollte Section der vollständige Pfad zum Unterschlüssel sein, einschließlich der Teilstruktur (z. B. "HKEY_CURRENT_USER\Software\Microsoft\Office\version\Word\Options").
Key Erforderlich String Die Schlüsseleinstellung oder der Wert des Eintrags der Registrierungsdatenbank, den Sie abrufen möchten. In einer Windows-Initialisierungsdatei folgen auf den Schlüsselnamen ein Gleichheitszeichen (=) und die Einstellung. Wenn Sie den Wert eines Eintrags aus der Windows-Registrierungsdatenbank zurückgeben, muss Key der Name eines Eintrags in dem Unterschlüssel sein, der in Section angegeben wird (beispielsweise STARTUP-PATH).

Bemerkungen

Sie können Makros schreiben, die eine Einstellungsdatei zum Speichern und Abrufen von Einstellungen verwenden. Beispielsweise können Sie den Namen des aktiven Dokuments speichern, wenn Sie Microsoft Word beenden, sodass dieses Dokument automatisch geöffnet werden kann, wenn Sie Word zum nächsten Mal starten. Eine Einstellungsdatei ist eine Textdatei mit Informationen, die wie die Informationen in der Windows 3.x-Datei WIN.INI angeordnet sind.

Beispiel

In diesem Beispiel wird der aktuelle Dokumentname als Einstellung LastFile unter der Überschrift MacroSettings in Settings.txt festgelegt.

System.PrivateProfileString("C:\Settings.txt", "MacroSettings", _ 
 "LastFile") = ActiveDocument.FullName

In diesem Beispiel wird die Einstellung LastFile aus Settings.txt zurückgegeben. Anschließend wird das Dokument geöffnet, das in LastFile gespeichert ist.

LastFile = System.PrivateProfileString("C:\Settings.Txt", _ 
 "MacroSettings", "LastFile") 
If LastFile <> "" Then Documents.Open FileName:=LastFile

In diesem Beispiel wird der Wert eines EmailName-Eintrags aus der Windows-Registrierungsdatenbank angezeigt.

aName = System.PrivateProfileString("", _ 
 "HKEY_CURRENT_USER\Software\Microsoft\" _ 
 & "Windows\CurrentVersion\Internet Settings", "EmailName") 
MsgBox aName

Siehe auch

System-Objekt

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.