STImgCtl – Darstellung von Dokument und Ansichtsbereich

Methode ShowToolbar

Mit dieser Methode kann die Sichtbarkeit der im Steuerelement enthaltenen Werkzeugleiste gesteuert werden.

void ShowToolbar(int nShow);

void ShowToolbar(int nShow);

Methode ZoomIn

Mit dieser Methode wird in das angezeigte Dokument hereingezoomt. Der Zoomfaktor bleibt bei einem Dokumentenwechsel erhalten.

sbyte ZoomIn();

char ZoomIn();

Methode CanZoomIn

Mit dieser Methode kann abgefragt werden, ob ein Hereinzoomen durch ZoomIn() möglich ist.

sbyte CanZoomIn();

char CanZoomIn();

Methode ZoomOut

Mit dieser Methode wird aus dem angezeigten Dokument herausgezoomt. Der Zoomfaktor bleibt bei einem Dokumentenwechsel erhalten.

sbyte ZoomOut();

char ZoomOut();

Methode CanZoomOut

Mit dieser Methode wird aus dem angezeigten Dokument herausgezoomt. Der Zoomfaktor bleibt bei einem Dokumentenwechsel erhalten.

sbyte CanZoomOut();

char CanZoomOut();

Methode FitTo

Diese Methode ermöglicht die Einpassung des Dokuments in das Anzeigefenster.

void FitTo(short nFormat);

void FitTo(short nFormat);

Methode GetPageDimensions

Diese Methode gibt die Größe einer Seite des geladenen Dokuments zurück. Die Werte sind auf drei Nachkommastellen gerundet. Ist einer der beiden Outputparameter ein Nullpointer, wird nur der andere belegt.

int GetPageDimensions(int nPage, float* pnWidth, float* pnHeight, int nOptions);

long GetPageDimensions(long nPage, float* pnWidth, float* pnHeight, long nOptions);

Eigenschaft BorderStyle

Über diese Eigenschaft kann der Stil des Fensterrahmens des Steuerelementes gesetzt und gelesen werden.

short BorderStyle;

short BorderStyle;

Eigenschaft PageCount

Über diese Eigenschaft kann die Gesamtzahl der Seiten abgefragt werden.

int PageCount;

long PageCount;

Eigenschaft Page

Über diese Eigenschaft kann die anzuzeigende Seite gesetzt oder ihre Nummer abgefragt werden. Ist eine übergebene Seitenzahl nicht verfügbar, wird der Aufruf ignoriert.

int Page;

long Page;

Event UpdatePage

Dieses Event signalisiert, dass ein Seitenwechsel stattgefunden hat oder die aktuelle Seitenansicht erneuert wurde. Es wird ausgelöst, sobald sich die angezeigte Seite ändert, und gibt die neue Seitenzahl aus.

Im folgenden wird eine Beispiel-Implementation gezeigt, in der benutzerdefinierte Namen durch Platzhalter (%…%) ersetzt wurden.

public class _DSTImgCtlEvents_UpdatePageEvent
{
    public short nPage;

    public _DSTImgCtlEvents_UpdatePageEvent(short nPage)
    {
        this.nPage = nPage;
    }
}

this.%COMPONENT_NAME%.UpdatePage += new AxSTIMGCTLLib._DSTImgCtlEvents_UpdatePageEventHandler(this.%CALLBACK_FUNCTION%);

private void %CALLBACK_FUNCTION%(object sender, AxSTIMGCTLLib._DSTImgCtlEvents_UpdatePageEvent e);

BEGIN_EVENTSINK_MAP(%CLASS_NAME%, CDialogEx)
	ON_EVENT(%CLASS_NAME%, %COMPONENT_ID%, 2, %CALLBACK_FUNCTION%, VTS_I2)
END_EVENTSINK_MAP()
void %CALLBACK_FUNCTION%(short nPage);