Edit

Share via

IDWritePaintReader::MoveToFirstChild method (dwrite_3.h)

  • Article

Sets the current position in the visual tree to the first child of the current paint element, and returns the newly-selected element's properties via the paintElement output parameter.

Syntax

HRESULT MoveToFirstChild(
  DWRITE_PAINT_ELEMENT *paintElement,
  UINT32               structSize
);

Parameters

paintElement

Type: _Out_writes_bytes_(structSize) DWRITE_PAINT_ELEMENT *

Receives the properties of the newly-selected element.

structSize

Type: UINT32 = sizeof(DWRITE_PAINT_ELEMENT)

Size of the DWRITE_PAINT_ELEMENT structure, in bytes.

Return value

A standard HRESULT error code. The return value is E_INVALIDARG if the current paint element doesn't have any children.

Remarks

You can determine (a priori from its paint type and properties) whether a paint element has children, and how many. For more info, see DWRITE_PAINT_ELEMENT.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1809 (with Windows App SDK 1.2 or later)
Header dwrite_3.h