IProgressDialog::SetAnimation method (shlobj_core.h)
[This method is not supported in Windows Vista or later versions.]
Specifies an Audio-Video Interleaved (AVI) clip that runs in the dialog box.
Syntax
HRESULT SetAnimation(
[in, optional] HINSTANCE hInstAnimation,
UINT idAnimation
);
Parameters
[in, optional] hInstAnimation
Type: HINSTANCE
An instance handle to the module from which the AVI resource should be loaded.
idAnimation
Type: UINT
An AVI resource identifier. To create this value, use the MAKEINTRESOURCE macro. The control loads the AVI resource from the module specified by hInstAnimation.
Return value
Type: HRESULT
Returns S_OK if successful, or an error value otherwise. In Windows Vista and later versions, always returns S_OK.
Remarks
IProgressDialog::SetAnimation cannot be called before the progress dialog is visible. Until it is displayed, the progress dialog does not have a valid HWND. The existence of that HWND can be used to determine whether IProgressDialog::SetAnimation can be called.
This method takes the instance handle specified by hInstAnimation and uses an animation control to open and run a silent AVI clip. There are several restrictions as to what types of AVI clips can be used, including the following:
- Clips cannot include sound.
- The size of the AVI clip cannot exceed 272 by 60 pixels. Smaller rectangles can be used, but they might not be properly centered.
- AVI clips must either be uncompressed or compressed with run-length (BI_RLE8) encoding. If you attempt to use an unsupported compression type, no animation is displayed.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional, Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | shlobj_core.h |
DLL | Shell32.dll (version 5.0 or later) |
See also
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για