Modify

Opened 6 years ago

Closed 6 years ago

#2690 closed Feature Request (Fixed)

Win..... Return Value Proposal.

Reported by: mlipok Owned by: guinness
Milestone: 3.3.11.6 Component: Documentation
Version: Severity: None
Keywords: Cc:

Description

in WinGetTitle
if no title match.

vWinClose
WinMove
if window is not found.

in WinGetState
if the window is not found.

in WinGetProcess
just "-1."

in WinGetHandle
if no window matches the criteria.

in WinGetCaretPos
just "Sets the @error flag to 1."

in WinExists
otherwise.

Please consider standardizing descriptions.

Attachments (0)

Change History (5)

comment:1 Changed 6 years ago by mlipok

sorry for too short a description.
Please note that in the description of the function of Win ...., see "Return Value" for the case of "Failure" for the same event are various descriptions (I do not mean different values ​​and only way to describe).

As an example of a good / full, description, give
"if no window Matches the criteria"
but extended
"if no window Matches the criteria (Title and Text)"

I think it will harmonize documentation and facilitate understanding, especially for those who do not necessarily speak English well.

comment:2 Changed 6 years ago by Jpm

In fact the best harmonization need AutoIt code change not just the doc,
to set @error in such case.

That was not the initial AutoIt philosophy of returning error on Builtin. Only when the successful return value cannot be differentiate, the @error was set.

comment:3 Changed 6 years ago by Jpm

  • Summary changed from Win..... Retrurn Value Proposal. to Win..... Return Value Proposal.

comment:4 Changed 6 years ago by mLipok

jpm
I understood your statement.

However, perhaps my post was an understood differently than I wanted.
I'll be back over the weekend to this topic.

comment:5 Changed 6 years ago by guinness

  • Milestone set to 3.3.11.6
  • Owner set to guinness
  • Resolution set to Fixed
  • Status changed from new to closed

Fixed by revision [10136] in version: 3.3.11.6

Guidelines for posting comments:

  • You cannot re-open a ticket but you may still leave a comment if you have additional information to add.
  • In-depth discussions should take place on the forum.

For more information see the full version of the ticket guidelines here.

Add Comment

Modify Ticket

Action
as closed The owner will remain guinness.
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.