Programmgesteuertes Festlegen von Optionen für den Rasterexport in Visio 2010 (maschinell übersetzt)

Zusammenfassung: Informationen zum programmgesteuerten Festlegen von Optionen für den Export von Microsoft Visio 2010-Diagrammen im Rasterformat (als BMP-, GIF-, JPG-, PNG- und TIF-Dateien).

Letzte Änderung: Donnerstag, 7. April 2011

Gilt für: Office 2010 | SharePoint Server 2010 | Visio 2010 | Visio Premium 2010

Inhalt dieses Artikels
Einführung
Abrufen und Festlegen von Raster exportieren Auflösung
Abrufen und Festlegen von Raster exportieren Größe
Festlegen von Eigenschaften für andere Raster exportieren
Schluss
Zusätzliche Ressourcen

Inhalt

• Einführung

• Abrufen und Festlegen von Raster exportieren Auflösung

• Abrufen und Festlegen von Raster exportieren Größe

• Festlegen von Eigenschaften für andere Raster exportieren

• Schluss

• Zusätzliche Ressourcen

Einführung

Das Visual Basic können für Applikationen (VBA)-Objektmodell verfügbar gemacht werden, indem Microsoft Visio 2010Visio 2010 Diagramme im Raster-Dateiformate (als .bmp, .gif, .jpg, .png und TIF-Dateien) zu exportieren. Dazu können Sie die Export-Methode des Objekts Page Zuweisen der entsprechenden Erweiterungs der Datei. Alternativ können Sie die Export-Methode des Master, Selection oder Shape-Objekt.

Wenn Sie Visio-Benutzeroberfläche (UI), verwenden um Diagramme im Raster Formate exportieren, angezeigt, mit dem Sie das Dialogfeld festgelegten Optionen – z. B. Auflösung, Größe, Farbformat und Hintergrund-und Transparenz – für die exportierte Datei. In Visio 2010 können Sie diese Optionen auch programmgesteuert festlegen. Dieser Artikel beschreibt, wie mit der neuen Raster-exportrelevante-Methoden und Eigenschaften des Objekts ApplicationSettings Raster Exportoptionen für die aktive Visio Seite festgelegt wird. Ein ApplicationSettings-Objekt zu erhalten, können Sie die Settings-Eigenschaft des Objekts Application.

Abrufen und Festlegen von Raster exportieren Auflösung

Exportieren von Rasterbildern Auflösung ist die Auflösung der Image-Datei beim Exportieren einer Visio Zeichnung in ein Raster unterstützten Format. GetRasterExportResolution-Methode können Sie die aktuelle Auflösung von Rasterbildern exportieren und die SetRasterExportResolution-Methode, um die Auflösung des Rasters Export gesetzt werden.

Tabelle 1 zeigt die Parameter an, dass die GetRasterExportResolution-Methode verwendet.

Tabelle 1. GetRasterExportResolution-Parameter

Der pResolution-Parameter muss eine Konstante aus der VisRasterExportResolution-Enumeration sein. Diese Konstante Werte umfassen die Bildschirmauflösung, Druckerauflösung, Quelle Auflösung und benutzerdefinierte Auflösung. pResolution gibt einen anderen Wert als benutzerdefinierte Auflösung – visRasterUseCustomResolution (3) – die Methode gibt 0 (null) für die anderen Parameter zurück. Auf der anderen Seite gibt pResolutionvisRasterUseCustomResolution, GetRasterExportResolution ungleich NULL-Werte für alle Parameter.

Die Methode selbst keinen Wert zurückgibt. Wie in den folgenden Visual Basic für Applikationen (VBA)-Codebeispiel gezeigt, erhalten Sie durch die Deklaration von Variablen mit den entsprechenden Typen in der obigen Tabelle gezeigten diese Variablen als Ausgabeparameter übergeben Werte zurückgeben. Überprüfen Sie die Werte der Variablen nach dem Ausführen der Methode.

Public Sub GetRasterExportResolution_Example()

    Dim cnstRasterExportResolution As VisRasterExportResolution
    Dim dblWidth As Double
    Dim dblHeight As Double
    Dim cnstRasterExportResolutionUnits As VisRasterExportResolutionUnits
    
    Visio.Application.Settings.GetRasterExportResolution cnstRasterExportResolution, dblWidth, dblHeight, cnstRasterExportResolutionUnits
    
    Debug.Print cnstRasterExportResolution; dblWidth; dblHeight; cnstRasterExportResolutionUnits    

End Sub

SetRasterExportResolution-Methode ähnelt eng GetRasterExportResolution-Methode. SetRasterExportResolution jedoch über zwei wichtige Unterschiede verfügen:

• Die Parameter, die es dauert, sind Eingabeparameter anstelle von Ausgabeparametern.

• Alle außer den ersten Parameter resolution, sind optional, wie in Tabelle 2 gezeigt.

In Tabelle 2. SetRasterExportResolution-Parameter

Wie bei der Methode GetRasterExportResolution der Fall, ist ist der Wert des Parameters resolution eine andere Konstante als visRasterUseCustomResolution, werden alle anderen Parameter SetRasterExportResolution ignoriert, wenn Sie verwendet werden. Wenn resolutionvisRasterUseCustomResolution, SetRasterExportResolution akzeptiert Werte für alle Parameter, vorausgesetzt, dass Sie die in der Tabelle aufgeführten Einschränkungen entsprechen, und schlägt fehl, wenn der Parameter nicht vorhanden sind. Wie GetRasterExportResolution gibt SetRasterExportResolution nichts zurück.

Folgender VBA-Beispielcode veranschaulicht das Raster Export Auflösung festgelegt. Er übergibt visRasterUseCustomResolution für den Parameter resolution mitteilen, wodurch Visio, um die Werte in den verbleibenden, optionale Parameter akzeptieren.

Public Sub SetRasterExportResolution_Example()

    Dim cnstRasterExportResolution As VisRasterExportResolution
    Dim dblWidth As Double
    Dim dblHeight As Double
    Dim cnstRasterExportResolutionUnits As VisRasterExportResolutionUnits
    
    cnstRasterExportResolution = visRasterUseCustomResolution
    dblWidth = 640
    dblHeight = 480
    cnstRasterExportResolutionUnits = visRasterPixelsPerCm
    
    Visio.Application.Settings.SetRasterExportResolution cnstRasterExportResolution, dblWidth, dblHeight, cnstRasterExportResolutionUnits
    
    Debug.Print cnstRasterExportResolution; dblWidth; dblHeight; cnstRasterExportResolutionUnits    

End Sub

Wenn die SetRasterExportResolution-Methode erfolgreich ausgeführt wird, bleiben die resultierenden Einstellungen wirksam, bis Sie die Methode erneut ausführen oder ändern Sie die Einstellungen in der Benutzeroberfläche.

Abrufen und Festlegen von Raster exportieren Größe

Raster Exportgröße ist die Größe des resultierenden Bildes beim Exportieren einer Visio Zeichnung in ein Raster unterstützten Format. Die GetRasterExportSize-Methode zum Abrufen der aktuellen Größe des Rasters-Export und die SetRasterExportSize-Methode, um die Größe des Rasters exportieren können.

Tabelle 3 zeigt die Parameter an, dass die GetRasterExportSize-Methode verwendet.

Tabelle 3. GetRasterExportSize-Parameter

Der pSize-Parameter muss eine Konstante aus der VisRasterExportSize-Enumeration sein. Diese Konstante Werte umfassen die Bildschirmgröße, Drucker Größe, Quelle Größe und benutzerdefinierte Größe. Der Parameterwert pSize gibt eine andere Konstante als visRasterFitToCustomSize, GetRasterExportSize 0 (null) für die anderen Parameter. pSize gibt visRasterFitToCustomSize, GetRasterExportSize ungleich NULL-Werte für alle Parameter.

Wie die GetRasterExportResolution-Methode die GetRasterExportSize-Methode selbst keinen Wert zurückgibt. Wie in diesem Beispiel für VBA-Code dargestellt, erhalten Sie die entsprechenden Typen in der obigen Tabelle gezeigten Variablen zu deklarieren, indem Sie diese Variablen als Ausgabeparameter übergeben und überprüfen die Werte der Variablen, nach dem Ausführen der Methode zurückgegebenen Werte.

Public Sub GetRasterExportSize_Example()

    Dim cnstRasterExportSize As VisRasterExportSize
    Dim dblWidth As Double
    Dim dblHeight As Double
    Dim cnstRasterExportSizeUnits As VisRasterExportSizeUnits
    
    Visio.Application.Settings.GetRasterExportSize cnstRasterExportSize, dblWidth, dblHeight, cnstRasterExportSizeUnits
    
    Debug.Print cnstRasterExportSize; dblWidth; dblHeight; cnstRasterExportSizeUnits

End Sub

SetRasterExportSize-Methode ähnelt eng GetRasterExportSize-Methode. SetRasterExportSize jedoch über zwei wichtige Unterschiede verfügen:

• Die Parameter, die es dauert, sind Eingabeparameter anstelle von Ausgabeparametern.

• Alle außer den ersten Parameter size, sind optional, wie in Tabelle 4 dargestellt.

In Tabelle 4. SetRasterExportSize-Parameter

Wie bei der Methode GetRasterExportSize der Fall, ist ist der Wert des Parameters size eine andere Konstante als visRasterFitToCustomSize, werden alle anderen Parameter SetRasterExportSize ignoriert, wenn Sie verwendet werden. Wenn sizevisRasterFitToCustomSize, SetRasterExportSize akzeptiert Werte für alle Parameter, vorausgesetzt, dass Sie die in der Tabelle aufgeführten Einschränkungen entsprechen, und schlägt fehl, wenn der Parameter nicht vorhanden sind. Wie GetRasterExportSize gibt SetRasterExportSize nichts zurück.

Die folgenden VBA-Code wird veranschaulicht, wie Exportgröße Raster festlegen. Er übergibt visRasterFitToCustomSize für den Parameter size mitteilen, wodurch Visio, um die Werte in den verbleibenden, optionale Parameter akzeptieren.

Public Sub SetRasterExportSize_Example()

    Dim cnstRasterExportSize As VisRasterExportSize
    Dim dblWidth As Double
    Dim dblHeight As Double
    Dim cnstRasterExportSizeUnits As VisRasterExportSizeUnits
    
    cnstRasterExportSize = visRasterFitToCustomSize
    dblWidth = 640
    dblHeight = 480
    cnstRasterExportSizeUnits = visRasterPixel
    
    Visio.Application.Settings.SetRasterExportSize cnstRasterExportSize, dblWidth, dblHeight, cnstRasterExportSizeUnits
    
    Debug.Print cnstRasterExportSize; dblWidth; dblHeight; cnstRasterExportSizeUnits    

End Sub

Wenn die SetRasterExportSize-Methode erfolgreich ausgeführt wird, bleiben die resultierenden Einstellungen wirksam, bis Sie die Methode erneut ausführen oder ändern Sie die Einstellungen in der Benutzeroberfläche.

Festlegen von Eigenschaften für andere Raster exportieren

In Visio 2010 nicht nur Raster Export Auflösung und Größe können programmgesteuert festlegen, wie zuvor gezeigt, aber auch alle anderen Rasters exportieren Optionen, die in der Visio-Benutzeroberfläche zur Verfügung stehen. Diese Optionen stehen in den verschiedenen Ausgabeoptionen Dialogfeldern (eine für jede Art von Rasterbildern), die angezeigt werden, wenn Sie Speichern unterSpeichern klicken, nachdem Sie das Raster-Typen in der Liste Dateityp ausgewählt haben. Die Optionen sind nach Dateityp Raster-, wie in Tabelle 5 dargestellt. Die Tabelle enthält die neuen Eigenschaften im ApplicationSettings-Objekt für die Exportoptionen Raster verfügbar sind.

Tabelle 5. ApplicationSettings-Raster Exporteigenschaften

Bei die oben stehenden Tabelle (aus der Spalte entsprechende Export-Formate) gibt an, dass die entsprechenden Exportformate aufgeführten der bestimmten Eigenschaftswert angewendet abhängen, finden Sie in die verknüpften Themen für Weitere Informationen.

Im Allgemeinen für jede gegebene Visio 2010-Sitzung Wenn keines dieser Eigenschaftswerte werden festgelegt (entweder programmgesteuert oder in der Benutzeroberfläche) die Einstellung dann werden der neue Standard für den Rest der Sitzung. Es ist jedoch nicht für die nächste Sitzung beibehalten.

Schluss

In Visio 2010 können Sie Optionen für das Exportieren von Master-Shapes, Seiten, Formen und Auswahl als Dateien im Raster Format programmgesteuert festlegen – Optionen, die in früheren Versionen konnten Sie nur in der Benutzeroberfläche festgelegt. Dieser Artikel stellt die neuen Methoden und Eigenschaften des Objekts ApplicationSettings, die diesen Exportvorgang ermöglichen und enthält Codebeispiele, die zeigen, wie die neuen Methoden zum Abrufen und Festlegen von Rasterbildern Export Auflösung und Größe.

Zusätzliche Ressourcen

Visio Developer Center

Blog von Visio Einblicke

Office-Client Developer Content Blog