ArcObjects Library Reference (Carto)  

IDynamicLayer.DrawDynamicLayer Method

Draws the layer to the specified display for the given draw phase.

[Visual Basic .NET]
Public Sub DrawDynamicLayer ( _
    ByVal DynamicDrawPhase As esriDynamicDrawPhase, _
    ByVal Display As IDisplay, _
    ByVal DynamicDisplay As IDynamicDisplay _
)
[C#]
public void DrawDynamicLayer (
    esriDynamicDrawPhase DynamicDrawPhase,
    IDisplay Display,
    IDynamicDisplay DynamicDisplay
);
[C++]
HRESULT DrawDynamicLayer(
  esriDynamicDrawPhase DynamicDrawPhase,
  IDisplay* Display,
  IDynamicDisplay* DynamicDisplay
);
[C++]

Parameters

DynamicDrawPhase [in]

  DynamicDrawPhase is a parameter of type esriDynamicDrawPhase

Display [in]

  Display is a parameter of type IDisplay

DynamicDisplay [in]

  DynamicDisplay is a parameter of type IDynamicDisplay

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Remarks

Use this method to generate the Layer’s draw commands that correspond to the Dynamic Draw Phase.

Make sure to generate the draw commands at the desired Draw Phase. It is recommended for a Dynamic Layer to generate draw commands (and therefore be drawn) in one of the Dynamic Draw Phases, but not both. For example, if the layer is to be drawn only in the Immediate Phase, the method should inspect the drawing phase and only generate draw commands if enum esriDynamicDrawPhase is set to esriDDPImmediate.

Use the Dynamic Display API, and/or OpenGL API in order to generate the draw commands. In the context of the DrawDynamicLayer method, the OpenGL Rendering Context is active and is setup by the Dynamic Map.

Note: The Dynamic Display and OpenGL API's can safely be used only in the context of the IDynamicLayer.DrawDynamicLayer method and IDynamicMapEvents BeforeDynamicDraw\AfterDynamicDraw events. Any attempt to use them in any other context will result in unexpected behavior.

See Also

IDynamicLayer Interface