FUNCTIONUnder review

APMsgNoYes

APMsgNoYes( <cMsg>, [cTitulo] ) --> lRet

Documents historical confirmation and its interpretation limits.

APMsgNoYesAdvPL

01 · OVERVIEW

Overview

The historical manual documents a logical return and describes true on cancellation; the same work assigns true to APMsgYesNo confirmation. Do not silently apply that description to current releases. SANTOS’s example opens APMsgNoYes and ignores the return, so it does not resolve semantics. The editorial proposal records the raw value to compare each button, Escape and window closing in a test environment, without making writes depend on an unconfirmed interpretation. (Manual AdvPL, n.d., p. 334, ref. 1; SANTOS, 2020, ref. 2)

02 · SYNTAX

Syntax

APMsgNoYes( <cMsg>, [cTitulo] ) --> lRet

Parameters

cMsg

CharacterRequired

Displayed message.

cTitulo

CharacterOptional

Dialog title.

Return value

Logical; button-to-value meaning requires verification in the target release.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function EdApmsgno()
    Local lReturn
    // Compare answers in testing; no write depends on them.
    lReturn := APMsgNoYes("Choice test; no changes.", "Diagnostics")
    ConOut(cValToChar(lReturn))
Return Nil

Expected result

Displays the returned value. Record the selected action for each test; this page does not assume each button’s result. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES

Do not interchange YesNo and NoYes based on names. Check the default button and cancellation behavior before adapting business flows.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.