Fix and improve CreateIconFromResource(Ex) and LookupIconIdFromDirectory(Ex) documentation - #2242
Open
DJm00n wants to merge 2 commits into
Open
Fix and improve CreateIconFromResource(Ex) and LookupIconIdFromDirectory(Ex) documentation#2242DJm00n wants to merge 2 commits into
DJm00n wants to merge 2 commits into
Conversation
…from HTML to Markdown
…ory(Ex) documentation
CreateIconFromResourceEx:
- presbits: clarify the parameter accepts a single RT_ICON/RT_CURSOR image, not a
resource group directory; redirect buffer format details to Remarks
- fIcon: remove misplaced LOCALHEADER sentence (covered in the DIB format bullet in Remarks)
- cxDesired/cyDesired: clarify that zero without LR_DEFAULTSIZE uses the size stored in
presbits without scaling, rather than vaguely "the actual resource size"
- Flags: remove LR_SHARED — it does not produce sharing or caching for this function
and makes the handle impossible to destroy; remove from keyword metadata as well
- Remarks: replace boilerplate sentence with a proper description of the three accepted
buffer formats (DIB, PNG, ANI/RIFF-ACON); add ANI sizing and fIcon-ignored notes
CreateIconFromResource:
- presbits: redirect buffer format details to CreateIconFromResourceEx Remarks
- fIcon: remove misplaced LOCALHEADER sentence
- Remarks: remove boilerplate sentence; expand the wrapper description to explain the
LR_DEFAULTSIZE consequence (always default system size) and how to get a specific size
- Add Examples link
LookupIconIdFromDirectoryEx:
- cxDesired/cyDesired: document that the SM_* metric is only used when LR_DEFAULTSIZE is
set; without it, zero returns the first directory entry without size scoring
- Flags table: add the missing LR_DEFAULTSIZE entry; fix LR_MONOCHROME description
("Searches for" rather than "Creates")
- Add LR_DEFAULTSIZE to keyword metadata
LookupIconIdFromDirectory:
- Description: clarify that this wrapper passes Flags=0 (not LR_DEFAULTSIZE), so it
always returns the first directory entry without size scoring
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
CreateIconFromResourceEx:
resource group directory; redirect buffer format details to Remarks
presbits without scaling, rather than vaguely "the actual resource size"
and makes the handle impossible to destroy; remove from keyword metadata as well
buffer formats (DIB, PNG, ANI/RIFF-ACON); add ANI sizing and fIcon-ignored notes
CreateIconFromResource:
LR_DEFAULTSIZE consequence (always default system size) and how to get a specific size
LookupIconIdFromDirectoryEx:
set; without it, zero returns the first directory entry without size scoring
("Searches for" rather than "Creates")
LookupIconIdFromDirectory:
always returns the first directory entry without size scoring
Related: https://devblogs.microsoft.com/oldnewthing/?p=108925