Freigeben über


CAnimateCtrl::Open

Rufen Sie diese Funktion auf, um einen AVI-Klipp zu öffnen und die erste Frame anzuzeigen.

BOOL Open(
   LPCTSTR lpszFileName 
);
BOOL Open(
   UINT nID 
);

Parameter

  • lpszFileName
    Ein Objekt CString oder ein Zeiger auf eine auf NULL endende Zeichenfolge, die entweder den Namen der AVI-Datei oder den Namen einer AVI-Ressource enthält.Wenn dieser Parameter NULL ist, schließt das System den AVI-Klipp, der zuvor für das Animationssteuerung geöffnet war, sofern vorhanden.

  • nID
    Der AVI-Ressourcenbezeichner.Wenn dieser Parameter NULL ist, schließt das System den AVI-Klipp, der zuvor für das Animationssteuerung geöffnet war, sofern vorhanden.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; null andernfalls.

Hinweise

Die AVI-Ressource wird vom Modul geladen, das das Animationssteuerung erstellt hat.

Öffnen unterstützt keine Sound in einem AVI-Klipp; Sie können nur automatische AVI-Klipps öffnen.

Wenn das Animationssteuerung das ACS_AUTOPLAY Format aufweist, beginnt das Animationssteuerung automatisch die Wiedergabe des Klipps, unmittelbar nachdem es ihn geöffnet wird.Es wird fortgesetzt, um den Klipp im Hintergrund wiederzugeben, während der Thread die Ausführung fortsetzt.Wenn der Klipp erfolgtes Wiedergabe ist, wird er automatisch wiederholt.

Wenn das Animationssteuerung das ACS_CENTER Format verfügt, wird der AVI-Klipp im Steuerelement zentriert und die Größe des Steuerelements ändert sich nicht.Wenn das Animationssteuerung nicht das ACS_CENTER Format ist, wird das Steuerelement angepasst, wenn der AVI-Klipp auf die Größe der Bilder im AVI-Klipp geöffnet ist.Die Position der oberen linken Ecke des Steuerelements ändert, nicht nur die Größe des Steuerelements.

Wenn das Animationssteuerung das ACS_TRANSPARENT Format enthält, werden die erste Frame mit einem transparenten Hintergrunds anstatt die Hintergrundfarbe gezeichnet, die im Animationsclip angegeben wird.

Beispiel

Im Beispiel für CAnimateCtrl::CAnimateCtrl.

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CAnimateCtrl-Klasse

Hierarchien-Diagramm

CAnimateCtrl::Close

CAnimateCtrl::Create