<< Return to Main Index

< Return to Class Index

CGXLongOperation::SetStatusText

void  SetStatusText(LPCTSTR s, BOOL bCopyBuffer = TRUE);

void  SetStatusText(UINT nID);

s

Points to text buffer with the text to be displayed.

bCopyBuffer

Specifies if the buffer should be copied or if CGXLongOperation can directly use the pointer and need not copy the buffer.

nID

A string resource id for the text.

Remarks

Specifies the status text for the operation. If you have locked a lower operation level, this call will have no effect.

Note: It is recommended that you allocate the text before frequently calling SetStatusText and only pass it by pointer to SetStatusText (with bCopyBuffer = FALSE). It can decrease performance if the text buffer needs to be copied very often or if the string resource must be loaded.

In Objective Grid all status text are loaded once at initialization, and later only a pointer is passed to SetStatusText. Therefore, this call will not decrease performance even if you are frequently calling SetStyleRange or other methods.

Control-Factory Specific ->

This method has been implemented using the abstraction mechanism as discussed in the chapter "Reducing the size of your application" in the user's guide. A call to the CGXLongOperation::ImplementLongOperation method from within the control factory class' InitializeApplicationComponents method will make the concrete implementation of this method available to your application.

If no concrete implementation is available this method performs no action.

END Control-Factory Specific

See Also

CGXLongOperation::GetStatusText CGXLongOperation::FreeStatusText

CGXLongOperation

Class Overview | Class Members